create_color_table(3)

okay bestie, welcome to create_color_table(3) from the Allegro manual 💖 this one is lowkey iconic for custom effects, no cap.

✨ NAME ✨

create_color_table — Fills a color mapping table for customised effects. Allegro game programming library. 💅

🦋 SYNOPSIS 🦋

first the include, then the signature, copy-paste exact bestie:

#include <allegro.h>

void create_color_table(COLOR_MAP *table, const PALETTE pal, void
(*blend)(PALETTE pal, int x, int y, RGB *rgb), void (*callback)(int
pos));

💅 DESCRIPTION 💅

okay so here's the tea: this fills the specified color mapping table with lookup data for doing customised effects with the specified palette, and it calls the blend function to determine the results of each color combination. slay ✨

your blend routine will be passed a pointer to the palette and the two indices of the colors which are to be combined, and it should fill in the RGB structure with the desired result in 0-63 format. then Allegro will search the palette for the closest match to the RGB color that you requested, so it doesn't matter if the palette has no exact match for this color. it's giving "close enough is still cute" 💖

if the callback function is not NULL, it will be called 256 times during the calculation, allowing you to display a progress indicator. that's your little loading-bar moment, bestie 🎀

example, literally right here:

          COLOR_MAP greyscale_table;
          ...
          void return_grey_color(const PALETTE pal,
                                 int x, int y, RGB *rgb)
          {
             ...
          }
          ...
             /* Build a color lookup table for greyscale effect. */
             create_color_table(&greyscale_table, pal,
                                return_grey_color, NULL);

👑 SEE ALSO 👑

go read these next, bestie, they're all in the group chat:

• color_map(3)
• create_light_table(3)
• create_trans_table(3)
• create_blender_table(3)
• draw_trans_sprite(3)
• draw_lit_sprite(3)
• draw_gouraud_sprite(3)
• rgb_map(3)
• excolmap(3)

and that's the whole page 💖 signing off from the Allegro manual, version 4.4.3, create_color_table(3) — periodt ✨🫶