1al_create_vertex_buffer(3) al_create_vertex_buffer(3)
2
3
4
6 al_create_vertex_buffer - Allegro 5 API
7
9 #include <allegro5/allegro_primitives.h>
10
11 ALLEGRO_VERTEX_BUFFER* al_create_vertex_buffer(ALLEGRO_VERTEX_DECL* decl,
12 const void* initial_data, int num_vertices, int flags)
13
15 Creates a vertex buffer. Can return NULL if the buffer could not be
16 created (e.g. the system only supports write-only buffers).
17
18 Note:
19
20 This is an advanced feature, often unsupported on lower-end
21 video cards. Be extra mindful of this function failing and make
22 arrangements for fallback drawing functionality or a nice error
23 message for users with such lower-end cards.
24
25 Parameters:
26
27 • decl - Vertex type that this buffer will hold. NULL implies that
28 this buffer will hold ALLEGRO_VERTEX(3) vertices
29
30 • initial_data - Memory buffer to copy from to initialize the vertex
31 buffer. Can be NULL, in which case the buffer is uninitialized.
32
33 • num_vertices - Number of vertices the buffer will hold
34
35 • flags - A combination of the ALLEGRO_PRIM_BUFFER_FLAGS(3) flags spec‐
36 ifying how this buffer will be created. Passing 0 is the same as
37 passing ALLEGRO_PRIM_BUFFER_STATIC.
38
40 5.1.3
41
43 ALLEGRO_VERTEX_BUFFER(3), al_destroy_vertex_buffer(3)
44
45
46
47Allegro reference manual al_create_vertex_buffer(3)