al_draw_indexed_buffer(3)

✨ NAME ✨

al_draw_indexed_buffer — Allegro 5 API. This is the al_draw_indexed_buffer(3) page from the Library Functions Manual, bestie, and it's all about drawing an indexed slice of a vertex buffer without losing your mind 💅.

🌈 SYNOPSIS 🌈

#include <allegro5/allegro_primitives.h>

int al_draw_indexed_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer,
   ALLEGRO_BITMAP* texture, ALLEGRO_INDEX_BUFFER* index_buffer,
   int start, int end, int type)

🦋 DESCRIPTION 🦋

Okay so al_draw_indexed_buffer draws a subset of the passed vertex buffer. It uses an index buffer to specify which vertices to use. Both buffers must not be locked. No cap, that part is serious. Additionally, to draw onto memory bitmaps or with memory bitmap textures, both buffers must support reading — meaning they must be created with ALLEGRO_PRIM_BUFFER_READWRITE. Literally required, bestie 🫶.

Parameters are giving main-character energy:

• vertex_buffer — the vertex buffer to draw.
• texture — the texture to use; pass NULL to use only color-shaded primitives.
• index_buffer — the index buffer to use.
• start — start index of the subset of the index buffer to draw.
• end — one past the last index of the subset of the index buffer to draw.
• type — a member of the ALLEGRO_PRIM_TYPE(3) enumeration, specifying what kind of primitive to draw. Note that ALLEGRO_PRIM_LINE_LOOP and ALLEGRO_PRIM_POINT_LIST are not supported — don't even try it 😭.

Returns: Number of primitives drawn 🔥.

🚨 Quick vibe check: both buffers must not be locked. Locked buffers are a no-go for this function, periodt.

🎀 SINCE 🎀

5.1.8 — she's been around since 5.1.8, iconic 💖.

🔗 SEE ALSO 🔗

• ALLEGRO_VERTEX_BUFFER(3)
• ALLEGRO_INDEX_BUFFER(3)
• ALLEGRO_PRIM_TYPE(3)

---

Sign-off: this page lives in the Allegro reference manual — no version or date stamped in the footer, just pure Allegro reference manual energy 🫶✨.