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

FreeBSD Manual Pages

  
 
  

home | help
GLVERTEXPOINTER()					     GLVERTEXPOINTER()

NAME
       glVertexPointer - define	an array of vertex data

C SPECIFICATION
       void glVertexPointer( GLint size,
			     GLenum type,
			     GLsizei stride,
			     const GLvoid *pointer )

       delim $$

PARAMETERS
       size	Specifies  the number of coordinates per vertex; must be 2, 3,
		or 4. The initial value	is 4.

       type	Specifies the data type	of each	coordinate in the array.  Sym-
		bolic  constants GL_SHORT, GL_INT, GL_FLOAT, and GL_DOUBLE are
		accepted. The initial value is GL_FLOAT.

       stride	Specifies the byte offset  between  consecutive	 vertexes.  If
		stride	is 0, the vertexes are understood to be	tightly	packed
		in the array. The initial value
		is 0.

       pointer	Specifies a pointer to the first coordinate of the first  ver-
		tex in the array.

DESCRIPTION
       glVertexPointer	specifies  the location	and data format	of an array of
       vertex coordinates to use when rendering.  size specifies the number of
       coordinates  per	 vertex	 and  type  the	 data type of the coordinates.
       stride specifies	the byte stride	from one vertex	to the	next  allowing
       vertexes	 and  attributes to be packed into a single array or stored in
       separate	arrays.	 (Single-array storage may be more efficient  on  some
       implementations;	 see  glInterleavedArrays.)   When  a  vertex array is
       specified, size,	type, stride, and pointer  are	saved  as  client-side
       state.

       To enable and disable the vertex	array, call glEnableClientState	and
       glDisableClientState with the argument GL_VERTEX_ARRAY. If enabled, the
       vertex array is used when glDrawArrays, glDrawElements, or  glArrayEle-
       ment is called.

       Use glDrawArrays	to construct a sequence	of primitives (all of the same
       type) from prespecified vertex and vertex attribute arrays.  Use	 glAr-
       rayElement  to  specify	primitives by indexing vertexes	and vertex at-
       tributes	 and glDrawElements to construct a sequence of	primitives  by
       indexing	vertexes and vertex attributes.

NOTES
       glVertexPointer is available only if the	GL version is 1.1 or greater.

       The  vertex  array  is initially	disabled and isn't accessed when glAr-
       rayElement, glDrawElements or glDrawArrays is called.

       Execution of glVertexPointer is not allowed between  the	 execution  of
       glBegin	and  the corresponding execution of glEnd, but an error	may or
       may not be generated. If	no error is generated, the operation is	 unde-
       fined.

       glVertexPointer is typically implemented	on the client side.

       Vertex  array  parameters  are  client-side state and are therefore not
       saved or	restored by glPushAttrib and glPopAttrib.  Use glPushClientAt-
       trib and	glPopClientAttrib instead.

ERRORS
       GL_INVALID_VALUE	is generated if	size is	not 2, 3, or 4.

       GL_INVALID_ENUM is generated if type is is not an accepted value.

       GL_INVALID_VALUE	is generated if	stride is negative.

ASSOCIATED GETS
       glIsEnabled with	argument GL_VERTEX_ARRAY
       glGet with argument GL_VERTEX_ARRAY_SIZE
       glGet with argument GL_VERTEX_ARRAY_TYPE
       glGet with argument GL_VERTEX_ARRAY_STRIDE
       glGetPointerv with argument GL_VERTEX_ARRAY_POINTER

SEE ALSO
       glArrayElement, glColorPointer, glDrawArrays, glDrawElements,
       glEdgeFlagPointer, glEnable, glGetPointerv, glIndexPointer,
       glInterleavedArrays,  glNormalPointer,  glPopClientAttrib, glPushClien-
       tAttrib,	glTexCoordPointer

							     GLVERTEXPOINTER()

NAME | C SPECIFICATION | PARAMETERS | DESCRIPTION | NOTES | ERRORS | ASSOCIATED GETS | SEE ALSO

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

home | help