masked_stretch_blit(3alleg4)

💅 masked_stretch_blit — the glow-up blit

okay bestie, so this one lives in the Allegro game programming library (that's the manual name, and yes we're citing it up top because that's how we do), and it's the one you call when you need to scale a rectangular area while skipping every pixel that matches the mask color. no cap. it's giving "stretch, but make it masked" ✨

✨ SYNOPSIS ✨

#include <allegro.h>

void masked_stretch_blit(BITMAP *source, BITMAP *dest, int source_x,
source_y, source_w, source_h, int dest_x, dest_y, dest_w, dest_h);

🌸 DESCRIPTION 🌸

So here's the tea 🍓: this is exactly like masked_blit(), except it can scale images — which means the source rectangle and the destination rectangle literally do not have to be the same size. glow up, resize, whatever, she's flexible 💁♀️

but now the serious part, and I need you to actually listen bestie 🫶: this routine doesn't do as much safety checking as the regular masked_blit(). specifically:

• you have to be careful not to copy from areas outside the source bitmap. she will not stop you. she will not warn you. she trusts you way too much 😭
• also the source must be a memory bitmap. that's not a suggestion, that's the vibe check, and it's mandatory 💀

example time, here's the whole thing verbatim:

BITMAP *hud_overlay;
...
/* Stretch hud overlay over the screen. */
masked_stretch_blit(hud_overlay, screen, 0, 0,
                    hud_overlay->w, hud_overlay->h,
                    0, 0, SCREEN_W, SCREEN_H);

see how she took hud_overlay's own ->w and ->h and stretched the whole thing across SCREEN_W and SCREEN_H? main character energy 👑

👀 SEE ALSO 👀

• blit(3alleg4)
• masked_blit(3alleg4)
• stretch_blit(3alleg4)
• stretch_sprite(3alleg4)

and that's the whole page, babe 🎀 this was brought to you by Allegro, version 4.4.3 — that's the source and the version, fr fr, no date on this one so we're just shouting out the release 💖 go stretch something, carefully, love you 🦋