*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> OpenGL/glindexpointerext (3)              


glIndexPointerEXT(3G)	       OpenGL Reference		 glIndexPointerEXT(3G)

NAME    [Toc]    [Back]

     glIndexPointerEXT - define	an array of color indexes

C SPECIFICATION    [Toc]    [Back]

     void glIndexPointerEXT( GLenum type,
			     GLsizei stride,
			     GLsizei count,
			     const GLvoid *pointer )

PARAMETERS    [Toc]    [Back]

     type     Specifies	the data type of each color index in the array.
	      Symbolic constants GL_SHORT, GL_INT, GL_FLOAT, or	GL_DOUBLE_EXT,
	      are accepted.

     stride   Specifies	the byte offset	between	consecutive color indexes.  If
	      stride is	zero the color indexes are understood to be tightly
	      packed in	the array.

     count    Specifies	the number of indexes, counting	from the first,	that
	      are static.

     pointer  Specifies	a pointer to the first index in	the array.

DESCRIPTION    [Toc]    [Back]

     glIndexPointerEXT specifies the location and data format of an array of
     color indexes to use when rendering using the vertex array	extension.
     type specifies the	data type of each color	index and stride gives the
     byte stride from one color	index to the next allowing vertices and
     attributes	to be packed into a single array or stored in separate arrays.
     (Single-array storage may be more efficient on some implementations.)
     count indicates the number	of array elements (counting from the first)
     that are static. Static elements may be modified by the application, but
     once they are modified, the application must explicitly respecify the
     array before using	it for any rendering. When a color index array is
     specified,	type, stride, count and	pointer	are saved as client-side
     state, and	static array elements may be cached by the implementation.

     The color index array is enabled and disabled using glEnable and
     glDisable with the	argument GL_INDEX_ARRAY_EXT. If	enabled, the color
     index array is used when glDrawArraysEXT or glArrayElementEXT is called.

     Use glDrawArraysEXT to define a sequence of primitives (all of the	same
     type) from	pre-specified vertex and vertex	attribute arrays.  Use
     glArrayElementEXT to specify primitives by	indexing vertices and vertex

NOTES    [Toc]    [Back]

     Non-static	array elements are not accessed	until glArrayElementEXT	or
     glDrawArraysEXT is	executed.

									Page 1

glIndexPointerEXT(3G)	       OpenGL Reference		 glIndexPointerEXT(3G)

     By	default	the color index	array is disabled and it won't be accessed
     when glArrayElementEXT or glDrawArraysEXT is called.

     Although it is not	an error to call glIndexPointerEXT between the
     execution of glBegin and the corresponding	execution of glEnd, the
     results are undefined.

     glIndexPointerEXT will typically be implemented on	the client side	with
     no	protocol.

     Since the color index array parameters are	client side state, they	are
     not saved or restored by glPushAttrib and glPopAttrib.

     glIndexPointerEXT commands	are not	entered	into display lists.

     glIndexPointerEXT is part of the EXT_vertex_array extension, not part of
     the core GL command set. If GL_EXT_vertex_array is	included in the	string
     returned by glGetString, when called with argument	GL_EXTENSIONS,
     extension EXT_vertex_array	is supported.

ERRORS    [Toc]    [Back]

     GL_INVALID_ENUM is	generated if type is not an accepted value.

     GL_INVALID_VALUE is generated if stride or	count is negative.

ASSOCIATED GETS    [Toc]    [Back]

     glIsEnabled with argument GL_INDEX_ARRAY_EXT
     glGet with	argument GL_INDEX_ARRAY_SIZE_EXT
     glGet with	argument GL_INDEX_ARRAY_TYPE_EXT
     glGet with	argument GL_INDEX_ARRAY_STRIDE_EXT
     glGet with	argument GL_INDEX_ARRAY_COUNT_EXT
     glGetPointervEXT with argument GL_INDEX_ARRAY_POINTER_EXT

     On	RealityEngine, RealityEngine2, and VTX systems,	do not enable or
     between a call to glNewList and the corresponding call to glEndList.
     Instead, enable or	disable	before the call	to glNewList.

									Page 2

glIndexPointerEXT(3G)	       OpenGL Reference		 glIndexPointerEXT(3G)

SEE ALSO    [Toc]    [Back]

     glArrayElementEXT,	glColorPointerEXT, glDrawArraysEXT,
     glEdgeFlagPointerEXT, glEnable, glGetPointervEXT, glNormalPointerEXT,
     glTexCoordPointerEXT, glVertexPointerEXT

									PPPPaaaaggggeeee 3333
[ Back ]
 Similar pages
Name OS Title
if_nameindex Tru64 Return an array of all interface names and indexes
if_freenameindex Tru64 Free dynamic memory allocated to the array of interface names and indexes
glnormalpointer IRIX define an array of normals
glnormalpointerext IRIX define a array of normals
glColorPointer Tru64 define an array of colors
glcolorpointer IRIX define an array of colors
glcolorpointerext IRIX define a array of colors
glNormalPointer Tru64 define an array of normals
gledgeflagpointer IRIX define an array of edge flags
gledgeflagpointerext IRIX define an array of edge flags
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service