Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_draw_prim(3)						       al_draw_prim(3)

NAME
       al_draw_prim - Allegro 5	API

SYNOPSIS
	      #include <allegro5/allegro_primitives.h>

	      int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl,
		 ALLEGRO_BITMAP* texture, int start, int end, int type)

DESCRIPTION
       Draws a subset of the passed vertex buffer.

       Parameters:

       o texture - Texture to use, pass	0 to use only color shaded primitves

       o vtxs -	Pointer	to an array of vertices

       o decl -	Pointer	to a vertex declaration.  If set to NULL, the vertices
	 are assumed to	be of the ALLEGRO_VERTEX type

       o start - Start index of	the subset of the vertex buffer	to draw

       o end - One past	the last index of subset of the	vertex buffer to draw

       o type -	A member of the	ALLEGRO_PRIM_TYPE(3)  enumeration,  specifying
	 what kind of primitive	to draw

       Returns:	Number of primitives drawn

       For example to draw a textured triangle you could use:

	      ALLEGRO_COLOR white = al_map_rgb_f(1, 1, 1);
	      ALLEGRO_VERTEX v[] = {
		  {.x =	128, .y	= 0, .z	= 0, .color = white, .u	= 128, .v = 0},
		  {.x =	0, .y =	256, .z	= 0, .color = white, .u	= 0, .v	= 256},
		  {.x =	256, .y	= 256, .z = 0, .color =	white, .u = 256, .v = 256}};
	      al_draw_prim(v, NULL, texture, 0,	3, ALLEGRO_PRIM_TRIANGLE_LIST);

SEE ALSO
       ALLEGRO_VERTEX(3),     ALLEGRO_PRIM_TYPE(3),    ALLEGRO_VERTEX_DECL(3),
       al_draw_indexed_prim(3)

Allegro	reference manual				       al_draw_prim(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=al_draw_prim&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help