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

FreeBSD Manual Pages

  
 
  

home | help
GLTEXCOORDPOINTER()					   GLTEXCOORDPOINTER()

NAME
       glTexCoordPointer - define an array of texture coordinates

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

       delim $$

PARAMETERS
       size	Specifies the number of	coordinates per	array element. Must be
		1, 2, 3	or 4. The initial value	is 4.

       type	Specifies the data type	of each	texture	coordinate.   Symbolic
		constants  GL_SHORT,  GL_INT,  GL_FLOAT,  or GL_DOUBLE are ac-
		cepted.	The initial value is GL_FLOAT.

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

       pointer	Specifies a pointer to the first coordinate of the first  ele-
		ment in	the array.

DESCRIPTION
       glTexCoordPointer specifies the location	and data format	of an array of
       texture coordinates to use when rendering.  size	specifies  the	number
       of  coordinates per element, and	must be	1, 2, 3, or 4.	type specifies
       the data	type of	each texture coordinate	and stride specifies the  byte
       stride  from  one  array	 element to the	next allowing vertexes and at-
       tributes	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 texture coordinate	 array	is  specified,
       size, type, stride, and pointer are saved client-side state.

       To  enable  and	disable	 the  texture coordinate array,	call glEnable-
       ClientState and glDisableClientState with the  argument	GL_TEXTURE_CO-
       ORD_ARRAY.  If  enabled,	 the texture coordinate	array is used when gl-
       DrawArrays, glDrawElements or
       glArrayElement 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
       glTexCoordPointer is available  only  if	 the  GL  version  is  1.1  or
       greater.

       The  texture coordinate array is	initially disabled and it won't	be ac-
       cessed when
       glArrayElement, glDrawElements or glDrawArrays is called.

       Execution of glTexCoordPointer 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.

       glTexCoordPointer  is  typically	implemented on the client side with no
       protocol.

       The texture coordinate array parameters are client-side state  and  are
       therefore  not  saved or	restored by glPushAttrib and glPopAttrib.  Use
       glPushClientAttrib and
       glPopClientAttrib instead.

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

       GL_INVALID_ENUM is generated if type is not an accepted value.

       GL_INVALID_VALUE	is generated if	stride is negative.

ASSOCIATED GETS
       glIsEnabled with	argument GL_TEXTURE_COORD_ARRAY
       glGet with argument GL_TEXTURE_COORD_ARRAY_SIZE
       glGet with argument GL_TEXTURE_COORD_ARRAY_TYPE
       glGetPointerv with argument GL_TEXTURE_COORD_ARRAY_POINTER

SEE ALSO
       glArrayElement, glColorPointer, glDrawArrays, glDrawElements,
       glEdgeFlagPointer, glEnable, glGetPointerv,  glIndexPointer,  glNormal-
       Pointer,	 glPopClientAttrib,  glPushClientAttrib, glTexCoord, glVertex-
       Pointer

							   GLTEXCOORDPOINTER()

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=glTexCoordPointer&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help