set_color(3)

✨ set_color(3) ✨

okay bestie, welcome to the Allegro manual 💖 this one's a little guy but it's IMPORTANT, so let's go 🫶

🌸 NAME 🌸

set_color — sets the specified palette entry to the specified RGB triplet. it's giving Allegro game programming library energy 💅

🎀 SYNOPSIS 🎀

#include <allegro.h>

void set_color(int index, const RGB *p);

🦋 DESCRIPTION 🦋

okay so, set_color sets the specified palette entry to the specified RGB triplet. that's the whole vibe, literally. you hand it an index and a pointer to an RGB, and it slots that colour right into your palette 🎨

BUT — and this is the part where you gotta pay attention, no cap — unlike the other palette functions, this one does NOT do any retrace synchronisation 😭 so if you just raw-dog it mid-frame you're gonna get snow problems on your screen. the fix? call vsync() before it, and you're golden ✨

example, bestie:

RGB rgb;
...
vsync();
set_color(192, &rgb);

see how the vsync() comes first? that's the whole trick, iykyk 👑

🌈 SEE ALSO 🌈

• set_palette(3)
• get_color(3)
• _set_color(3)
• ex12bit(3)
• exrgbhsv(3)
• exscroll(3)

and that's the whole page, periodt 💜 this was the Allegro manual, version 4.4.3 — mwah, go make something pretty with it 🍓🧚💖