al_create_shader(3)

✨ al_create_shader(3) — Allegro 5 API cutie from the Library Functions Manual ✨

okay so this is the al_create_shader(3) page, bestie, and it's giving we're making shader objects energy 💅. The manual name is Library Functions Manual; the API is Allegro 5. Let's go 🎀

---

🎀 NAME 🎀

al_create_shader — Allegro 5 API. Lowkey the function that creates a shader object, and that's the whole vibe check 💖

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

ALLEGRO_SHADER *al_create_shader(ALLEGRO_SHADER_PLATFORM platform)

🦋 DESCRIPTION 🦋

It creates a shader object. Main character behavior only ✨

The platform argument is one of the ALLEGRO_SHADER_PLATFORM(3) values, and it specifies the type of shader object to create, plus which language is used to program the shader. So it's not just decoration — it's telling the shader who it is 🫶.

The shader platform must be compatible with the type of display you'll use the shader with. For example, you cannot create and use a HLSL shader on an OpenGL display, nor a GLSL shader on a Direct3D display. It's giving "wrong outfit for the wrong event" — the compatibility check is real 👑

The ALLEGRO_SHADER_AUTO value automatically chooses the appropriate platform for the display currently targeted by the calling thread; there must be such a display. It will create a GLSL shader for an OpenGL display, and a HLSL shader for a Direct3D display. Auto-pick, no cap 🌈.

Returns the shader object on success. Otherwise, returns NULL. So if you get NULL, that's the universe saying "not today" 😭.

⭐ SINCE ⭐

5.1.0 — vintage but iconic 💜

💖 SEE ALSO 💖

• al_attach_shader_source(3)
• al_attach_shader_source_file(3)
• al_build_shader(3)
• al_use_shader(3)
• al_destroy_shader(3)
• al_get_shader_platform(3)

---

And that's a wrap, bestie 🎀 — this came from the Allegro reference manual as the al_create_shader(3) page, with the since 5.1.0 energy. No date line on this footer, so we're not inventing one; just pure Allegro reference manual vibes ✨💅.