al_lock_vertex_buffer(3alleg5)

💖 al_lock_vertex_buffer — Allegro 5 API ✨

okay bestie, welcome to al_lock_vertex_buffer(3alleg5), the manual page you didn't know you needed 🫶

---

🌸 NAME 🌸

al_lock_vertex_buffer — Allegro 5 API, and yes that's the whole name, she's simple and she slays 💅

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_primitives.h>

void* al_lock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer, int offset,
   int length, int flags)

---

🦋 DESCRIPTION 🦋

So what she does is lock a vertex buffer so you can actually get in there and access its data 👑 like she's holding the door open for you while you rearrange the furniture, and when you're done you gotta let her go (that's al_unlock_vertex_buffer, we'll get to her).

She will return NULL if any of these things happen, and not in a cute way:

• the parameters are invalid 🙈
• you asked to read from a write only buffer (bestie. no. that's not how that works 💀)
• the buffer is already locked — she's busy, she's booked, she's not doing double duty fr fr

🎀 Parameters 🎀

• buffer — the vertex buffer you wanna lock 💜 literally the thing you're locking
• offset — the vertex index where your locked range starts, like "begin here pls"
• length — how many vertices you're locking, count them, be precise 🍓
• flags — one of ALLEGRO_LOCK_READONLY, ALLEGRO_LOCK_WRITEONLY or ALLEGRO_LOCK_READWRITE ⭐

---

🌈 SINCE 🌈

5.1.3 — she's been iconic since 5.1.3, no cap 🧚

---

💫 SEE ALSO 💫

• ALLEGRO_VERTEX_BUFFER(3alleg5) — the whole vertex buffer situation 👑
• al_unlock_vertex_buffer(3alleg5) — the one who lets go, the other half of the duo, they're giving main character energy together 🫶

---

and that's the page!! Allegro reference manual, al_lock_vertex_buffer(3alleg5), the source and version and date of it all — mwah 💖 go lock something (and unlock it, please, we beg) ✨