al_use_shader(3)

💖 al_use_shader(3) 💖

🎀 NAME 🎀

al_use_shader — the Allegro 5 API page from the Library Functions Manual, and yes bestie, we are getting into it ✨

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

bool al_use_shader(ALLEGRO_SHADER *shader)

💅 DESCRIPTION 💅

okay so al_use_shader() is literally how you tell Allegro to use the shader for subsequent drawing operations on the current target bitmap. main character energy for your draw setup 👑

Pass NULL to stop using any shader on the current target bitmap — that's the "no shader, no problem" move, and it's valid 💖

It returns true on success 🎀. Otherwise it returns false, e.g. because the shader is incompatible with the target bitmap — and that's the vibe check failing, no cap 😭.

🌸 SINCE 🌸

5.1.6 — she's been serving since then, periodt 👑

🦋 SEE ALSO 🦋

• al_destroy_shader(3)
• al_set_shader_sampler(3)
• al_set_shader_matrix(3)
• al_set_shader_int(3)
• al_set_shader_float(3)
• al_set_shader_bool(3)
• al_set_shader_int_vector(3)
• al_set_shader_float_vector(3)
• al_get_current_shader(3)

go give these besties a read 🫶

---

Cute sign-off from the Allegro reference manual, page al_use_shader(3) — the footer has no date showing, so no invented timestamp, just source/version energy and a sparkly bye 💖🌈✨