draw_sprite_ex(3)

✨ draw_sprite_ex(3) ✨

okay bestie, welcome to the Allegro manual 💖 this one lives in section 3, and it's about drawing a sprite that can be flipped, blended or tinted — all in one gloriously extra little function. no cap.

---

🌸 NAME 🌸

draw_sprite_ex — draws an optionally flipped / blended / tinted sprite onto the bitmap. it's part of the Allegro game programming library, and yes it ate. 💅

---

🎀 SYNOPSIS 🎀

#include <allegro.h>

void draw_sprite_ex(BITMAP *bmp, BITMAP *sprite, int x, int y, int mode,
int flip);

look at her. five arguments. bmp is where it lands, sprite is what lands, x and y are where, and then mode and flip decide how — which is the whole point of this function existing, fr fr. 🌈

---

🦋 DESCRIPTION 🦋

so the way this works is: she draws the sprite image onto the destination bitmap using whatever you put in the mode argument, and she optionally flips the sprite in the orientation you specify with the flip argument. two little dials, infinite vibes. ✨

first dial, the mode argument — this is the one that says how the sprite is gonna get drawn onto the destination bitmap:

• DRAW_SPRITE_NORMAL — draws a masked sprite, exactly like draw_sprite() does 👑
• DRAW_SPRITE_LIT — draws a tinted sprite, like draw_lit_sprite() 🌞
• DRAW_SPRITE_TRANS — draws a blended sprite, like draw_trans_sprite() 🫧

second dial, the flip argument — this one sets the flipping orientation:

• DRAW_SPRITE_NO_FLIP = 0 — do not perform flipping. she stays exactly as she is, no notes 💤
• DRAW_SPRITE_H_FLIP — flip horizontally. mirror mode, main character energy 🪞
• DRAW_SPRITE_V_FLIP — flip vertically. upside-down era, lowkey unhinged 🙃
• DRAW_SPRITE_VH_FLIP — flip both vertically and horizontally. chaos. iconic. both at once 🔥

ngl the note that DRAW_SPRITE_NO_FLIP equals 0 is doing a lot of work here — that's your "default" vibe, so if you just pass 0 you get a regular un-flipped sprite. 💖

---

👑 SEE ALSO 👑

go read these next, bestie, they're the whole friend group:

• draw_sprite(3)
• draw_sprite_v_flip(3)
• draw_sprite_h_flip(3)
• draw_trans_sprite(3)
• draw_lit_sprite(3)
• extrans2(3)

---

and that's the page, babes 🎀 this was Allegro version 4.4.3, draw_sprite_ex(3), signing off — go draw something gorgeous, you've got this 🫶💜