draw_compiled_sprite(3)

💖 draw_compiled_sprite — the Allegro manual, but make it bestie edition 💖

okay so this is draw_compiled_sprite(3) from the Allegro game programming library, and we're gonna get you fluent in it, no cap ✨

🌸 NAME 🌸

draw_compiled_sprite — draws a compiled sprite, and honestly? she just does what it says on the tin. part of the Allegro game programming library, periodt 💅

🦋 SYNOPSIS 🦋

#include <allegro.h>

void draw_compiled_sprite(BITMAP *bmp, const COMPILED_SPRITE *sprite,
int x, int y);

look at that signature, she's gorgeous, she's compact, she takes four arguments and returns void because she's not here to give you feedback, she's here to paint 🎀

✨ DESCRIPTION ✨

So the whole vibe is: this function draws a compiled sprite onto a bitmap, at the position you tell it. Slap it down at x, y, done, iconic. 🫶

BUT — and this is the part where you gotta pay attention, bestie — the sprite must have been compiled for the correct type of bitmap (linear or planar). If you compiled it for one flavor and try to draw it onto the other, that's not a vibe check she's gonna pass. Get the types matching or don't come crying to me 😭

Also? This function does not support clipping. Not a little clipping, not a medium clipping. None. Zero. Nada. She will not politely trim your sprite at the edges of the bitmap, she will simply not do that. 💀

Hint: if not being able to clip compiled sprites is a problem — and like, fair, it can be — a neat trick is to set up a work surface (a memory bitmap, a mode-X virtual screen, or whatever, we're not picky) that's a bit bigger than you really need, and then use the middle of it as your screen. That way you can draw slightly off the edge without any trouble... 👑 lowkey genius, honestly. free real estate in the margins.

👑 SEE ALSO 👑

go read these next, they're the friend group and they all slay:

• get_compiled_sprite(3) — the one who makes the compiled sprite in the first place 🧚
• draw_sprite(3) — the classic, the original main character 🌈
• draw_rle_sprite(3) — another sprite-drawing baddie with a different compression situation 💜
• bitmap_mask_color(3) — for when you're being all transparent and mysterious 🍓

mwah 💋 that's the whole page. written up for the Allegro manual, version 4.4.3, and yeah she's an older queen but she still eats, fr fr. go draw something cute, bestie 💅✨🌸