al_get_def...der_source(3)

✨ al_get_default_shader_source(3) ✨

ok so this is from the Library Functions Manual, aka the Allegro 5 API docs, and bestie it's literally the page that hands you free shader code 🎀

---

🌸 SYNOPSIS 🌸

like, here's how you call it:

#include <allegro5/allegro.h>

char const *al_get_default_shader_source(ALLEGRO_SHADER_PLATFORM platform,
   ALLEGRO_SHADER_TYPE type)

---

💜 DESCRIPTION 💜

So this function returns a string, right? And that string contains the source code to Allegro's default vertex or pixel shader that's appropriate for whatever platform you passed in. it's giving "here's a shader, you're welcome" 💅

Quick vibe check on the values:

• ALLEGRO_SHADER_AUTO means GLSL gets used if OpenGL is being used, otherwise HLSL. iykyk ✨
• but heads up — ALLEGRO_SHADER_AUTO requires that there is a current display set on the calling thread. no current display? that's a whole situation, don't do that 🙈

Also, fr fr: this function can return NULL if Allegro was built without support for shaders of the selected platform. so like, do a vibe check on that return value, bestie 😭

---

⭐ SINCE ⭐

5.1.6 — she's been iconic since 5.1.6 🫶

---

🦋 SEE ALSO 🦋

• al_attach_shader_source(3) — go read this one next, it's the natural next step 💖

---

that's the whole page ✨ this came out of the Allegro reference manual, so credit where credit's due 👑 mwah, go write some slay shaders 💜🌸