ALLEGRO_PRIM_BUFFER_FLAGS(3)

💅 ALLEGRO_PRIM_BUFFER_FLAGS 💅

okay so bestie, welcome to the Allegro 5 API section of the Allegro reference manual — this one's short and sweet, no cap 🍓

---

✨ NAME ✨

ALLEGRO_PRIM_BUFFER_FLAGS — literally just the Allegro 5 API being its iconic self 🎀

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_primitives.h>

typedef enum ALLEGRO_PRIM_BUFFER_FLAGS

that's it, that's the whole vibe check 💜

---

🦋 DESCRIPTION 🦋

so these are the flags you pass to tell the driver how you want your vertex buffer or index buffer to be made 💫 like, it's giving "letting the driver know what's up before it commits", iykyk.

• ALLEGRO_PRIM_BUFFER_STREAM — hints to the driver that this buffer gets written to often but only used a few times per frame 👀 like a group chat you're always typing in but barely scrolling back through. main character energy, lowkey.
• ALLEGRO_PRIM_BUFFER_STATIC — hints to the driver that the buffer is written to once and then used often ✨ set it and forget it, the way that a good playlist just stays on repeat. obsessed.
• ALLEGRO_PRIM_BUFFER_DYNAMIC — hints to the driver that the buffer is written to often and used often 🔥 both. it's doing the most and honestly? slay.
• ALLEGRO_PRIM_BUFFER_READWRITE — specifies that you want to be able read from this buffer 🙈 by default this is disabled for performance, so it's lowkey off unless you ask. and heads up bestie: some platforms (like OpenGL ES) do not support reading from vertex buffers, so if you pass this flag to al_create_vertex_buffer or al_create_index_buffer the call will fail 💀 not a vibe. protect your error handling fr fr.

⚠️ real talk: that last one is not a drill. pass ALLEGRO_PRIM_BUFFER_READWRITE on a platform that doesn't support it and the create call just fails. check your return values, queen 👑

---

⭐ SINCE ⭐

5.1.3 — she's been here since 5.1.3 and she's been serving ever since 👑

---

🫶 SEE ALSO 🫶

• al_create_vertex_buffer(3)
• al_create_index_buffer(3)

go read those next, they're the ones actually doing the work 💖

---

that's the page, bestie 🌈 courtesy of the Allegro reference manual — Allegro 5 API, since version 5.1.3. now go build something iconic 🧚‍♀️💫