getr(3alleg4)

💖 getr, getg, getb, geta — the Allegro color-splitting girlies 💖

okay bestie, so this is getr(3alleg4), straight out of the Allegro manual, and it's literally the four functions you need when you've got a packed color and you wanna know what's inside it. let's go ✨

✨ NAME ✨

getr, getg, getb, geta — pull one single color component out of whatever pixel format you're currently rocking. part of the Allegro game programming library, obviously 💅

✨ SYNOPSIS ✨

#include <allegro.h>

int getr(int c);

int getg(int c);

int getb(int c);

int geta(int c);

✨ DESCRIPTION ✨

so here's the vibe: you hand these functions a color c that's already in the format your current video mode is using, and they hand you back one of the red, green, blue, or alpha components. the components range 0-255, bestie, so you get a nice full byte of range 🎀

the way that works is that these are the smart ones — they peek at your current setup and call the preceding 8, 15, 16, 24, or 32-bit get functions as appropriate. so you don't gotta remember which depth you're in. iconic, honestly 👑

⚠️ heads up: the alpha part is only meaningful for 32-bit pixels. don't come crying to me when geta gives you nonsense at other depths, i warned you 💀

here's the example, verbatim, no notes:

int r, g, b, color_value;

color_value = getpixel(screen, 100, 100);
r = getr(color_value);
g = getg(color_value);
b = getb(color_value);

look at that. grab a pixel, crack it open, get your channels. main character energy fr fr 🌸

✨ SEE ALSO ✨

• getr8(3alleg4)
• getr_depth(3alleg4)
• makecol(3alleg4)
• set_color_depth(3alleg4)
• exalpha(3alleg4)

okay that's the whole page, you're welcome 🫶 this was Allegro, version 4.4.3 — go forth and extract your color components, bestie, you're gonna slay 💖✨🦋