set_blender_mode_ex(3alleg4)

📦 version 4.4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 set_blender_mode_ex — the Allegro manual, but make it cute 💖

okay bestie, you're in the Allegro game programming library docs and this one is a certified baddie, let's go ✨

🌸 NAME 🌸

set_blender_mode_ex</ppurple> — it's literally an even more complex version of set_blender_mode(). yes, more. she said "and I took that personally." 💅 Allegro game programming library, periodt.

🎀 SYNOPSIS 🎀

#include <allegro.h>

void set_blender_mode_ex(BLENDER_FUNC b15, b16, b24, b32, b15x, b16x,
b24x, int r, g, b, a);

look at all those parameters. seven blender funcs plus four ints. it's giving maximalist icon and honestly? we respect it 🫶

🦋 DESCRIPTION 🦋

so. you already know set_blender_mode(), right? well this is that but she went to glow-up bootcamp and came back with a way more complete set of blender routines. no cap.

here's the tea on who does what 👇

  • b15, b16, b24, and b32 — these are the ones that get called when you're drawing pixels onto destinations of the same format. matching energy, love that for them. ✨
  • b15x, b16x, and b24x — these babies get used by draw_trans_sprite() and draw_trans_rle_sprite() when you're drawing RGBA images onto destination bitmaps of another format. crossing format lines, iconic, we support it. 💜

and now the important part, don't skip this, it's lowkey the whole plot: these blenders will be passed a 32-bit x parameter, along with a y value of a different color depth, and they must try to do something sensible in response. 😭 yeah. sensible. bestie the blender has to improvise, and honestly same.

fr fr — those mismatched-format blenders don't get a clean matching pair, they get handed a 32-bit x and a y at a different depth and are just expected to cope. character development, honestly.

🍓 SEE ALSO 🍓

go read those too, they're the supporting cast and they ate 💖

and that's the whole page, bestie!! 🎀 this was Allegro, version 4.4.3, and you just read set_blender_mode_ex(3alleg4) — mwah, go blend something gorgeous 💅✨👑

📦 where this page comes from