ALLEGRO_PRIM_STORAGE(3alleg5)

✨ ALLEGRO_PRIM_STORAGE ✨

okay bestie, welcome to the Allegro 5 API</> manual page for ALLEGRO_PRIM_STORAGE 💖 this is a glow-up guide to how vertex attribute storage works, and honestly? it's giving very niche but very important 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_primitives.h>

typedef enum ALLEGRO_PRIM_STORAGE

---

🦋 DESCRIPTION 🦋

So basically this enum lists all the types of storage</> that an attribute of a custom vertex can live in 💾. Heads up though — a lot of these can only be used for ALLEGRO_PRIM_USER_ATTR attributes, and you can only get at them through shaders 🧚. And usually, no matter which storage you pick, the attribute gets converted to single precision floating point when the shader runs. lowkey unavoidable.

But here's the tea ☕: even with that conversion happening, it can still be worth using denser storage formats — like ALLEGRO_PRIM_NORMALIZED_UBYTE_4 instead of ALLEGRO_PRIM_FLOAT_4 — when bandwidth</> (aka the amount of memory sent to the GPU) is the problem, but precision isn't 🫶. slay.

---

• ALLEGRO_PRIM_FLOAT_1 — a single float 🍓

Since: 5.1.6

• ALLEGRO_PRIM_FLOAT_2 — a doublet of floats
• ALLEGRO_PRIM_FLOAT_3 — a triplet of floats
• ALLEGRO_PRIM_FLOAT_4 — a quad of floats 🍓

Since: 5.1.6

• ALLEGRO_PRIM_SHORT_2 — a doublet of shorts
• ALLEGRO_PRIM_SHORT_4 — a quad of shorts 🍓

Since: 5.1.6

• ALLEGRO_PRIM_UBYTE_4 — a quad of unsigned bytes 🍓

Since: 5.1.6

• ALLEGRO_PRIM_NORMALIZED_SHORT_2 — a doublet of shorts. before being sent to the shader, each component gets divided by 32767 ✨. each component of the resultant float doublet ranges between -1.0 and 1.0

Since: 5.1.6

• ALLEGRO_PRIM_NORMALIZED_SHORT_4 — a quad of shorts. before being sent to the shader, each component gets divided by 32767 ✨. each component of the resultant float quad ranges between -1.0 and 1.0

Since: 5.1.6

• ALLEGRO_PRIM_NORMALIZED_UBYTE_4 — a quad of unsigned bytes. before being sent to the shader, each component gets divided by 255 ✨. each component of the resultant float quad ranges between 0.0 and 1.0

Since: 5.1.6

• ALLEGRO_PRIM_NORMALIZED_USHORT_2 — a doublet of unsigned shorts. before being sent to the shader, each component gets divided by 65535 ✨. each component of the resultant float doublet ranges between 0.0 and 1.0

Since: 5.1.6

• ALLEGRO_PRIM_NORMALIZED_USHORT_4 — a quad of unsigned shorts. before being sent to the shader, each component gets divided by 65535 ✨. each component of the resultant float quad ranges between 0.0 and 1.0

Since: 5.1.6

• ALLEGRO_PRIM_HALF_FLOAT_2 — a doublet of half-precision floats. ⚠️ note that this storage format is not supported on all platforms. al_create_vertex_decl(3alleg5) will return NULL if you use it on those platforms 😭

Since: 5.1.6

• ALLEGRO_PRIM_HALF_FLOAT_4 — a quad of half-precision floats. ⚠️ note that this storage format is not supported on all platforms. al_create_vertex_decl(3alleg5) will return NULL if you use it on those platforms 😭

Since: 5.1.6

🫶 reminder bestie: those HALF_FLOAT ones are the risky queens — if your platform doesn't fw them, al_create_vertex_decl(3alleg5) hits you with a NULL. no cap.

---

👑 SEE ALSO 👑

• ALLEGRO_PRIM_ATTR(3alleg5)

---

and that's the whole page, bestie 💜</> this came straight out of the Allegro reference manual — ALLEGRO_PRIM_STORAGE(3alleg5) — go forth and declare your vertices with main character energy 🌈⭐💅