al_create_index_buffer(3)

💖 NAME 💖

al_create_index_buffer — Allegro 5 API.

Okay bestie, welcome to the al_create_index_buffer(3) page from the Library Functions Manual — yes, we're in Allegro 5 API territory, and this one's lowkey advanced. 🫶

✨ SYNOPSIS ✨

#include <allegro5/allegro_primitives.h>

ALLEGRO_INDEX_BUFFER* al_create_index_buffer(int index_size,
    const void* initial_data, int num_indices, int flags)

🦋 DESCRIPTION 🦋

So this function creates an index buffer. It can return NULL if the buffer could not be created (e.g. the system only supports write-only buffers). No cap.

⚠️ Note: This is an advanced feature, often unsupported on lower-end video cards. Be extra mindful of this function failing and make arrangements for fallback drawing functionality or a nice error message for users with such lower-end cards. This is important, fr fr.

🎀 Parameters 🎀

• index_size — Size of the index in bytes. Supported sizes are 2 for short integers and 4 for integers. slay.
• initial_data — Memory buffer to copy from to initialize the index buffer. Can be NULL, in which case the buffer is uninitialized.
• num_indices — Number of indices the buffer will hold.
• flags — A combination of the ALLEGRO_PRIM_BUFFER_FLAGS(3) flags specifying how this buffer will be created. Passing 0 is the same as passing ALLEGRO_PRIM_BUFFER_STATIC.

🌸 SINCE 🌸

Version 5.1.8 — iconic since then, periodt. ✨

💜 SEE ALSO 💜

• ALLEGRO_INDEX_BUFFER(3)
• al_destroy_index_buffer(3)

Both are very much giving "check these next, bestie." 💅

---

mwah 💋 — source/version: Allegro reference manual; date: not listed on the page, so we're leaving that mysterious. Byeee! 🫶🌈