clear_to_color(3alleg4)

✨ clear_to_color ✨

okay bestie, so this is a page from the Allegro manual — yes, the Allegro game programming library, the whole <rainbow>clear_to_color(3alleg4)</rainbow> situation 💖

💅 NAME 💅

clear_to_color — literally wipes your bitmap clean and paints it the exact color you asked for 🎨 and yeah, it's part of the Allegro game programming library.

🦋 SYNOPSIS 🦋

#include <allegro.h>

void clear_to_color(BITMAP *bitmap, int color);

that's it. two args. no drama. periodt ✨

🌸 DESCRIPTION 🌸

so the whole vibe is: it clears the bitmap to the specified color 🫶 like, every pixel in that BITMAP gets replaced with the color you hand it. that's the entire job and it does it flawlessly, no notes 👑

here's the example, and yes it's iconic:

/* Clear the screen to red. */
clear_to_color(bmp, makecol(255, 0, 0));

not me pointing out that bmp is the BITMAP and makecol(255, 0, 0) is the red — that's the color argument being built right there in the call, iykyk 💅

🎀 SEE ALSO 🎀

• clear_bitmap(3alleg4) — the sibling function, go read it too bestie
• makecol(3alleg4) — how you actually make the color value you're passing in

okay that's the whole page!! 🦋✨ this came straight out of the Allegro manual, version 4.4.3 — yes, version 4.4.3, no cap — and it's all about clear_to_color(3alleg4). mwah, go clear some bitmaps 💖💅🌸