glColorPointer man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

GLCOLORPOINTER(3gl)					   GLCOLORPOINTER(3gl)

NAME
       glColorPointer - define an array of colors

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

PARAMETERS
       size	Specifies the number of components per color. Must be 3 or 4.

       type	Specifies  the data type of each color component in the array.
		Symbolic  constants   GL_BYTE,	 GL_UNSIGNED_BYTE,   GL_SHORT,
		GL_UNSIGNED_SHORT,   GL_INT,  GL_UNSIGNED_INT,	GL_FLOAT,  and
		GL_DOUBLE are accepted.

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

       pointer	Specifies a pointer to the first component of the first	 color
		element in the array.

DESCRIPTION
       glColorPointer  specifies  the  location and data format of an array of
       color components to use when rendering.	size specifies the  number  of
       components per color, and must be 3 or 4.  type specifies the data type
       of each color component, and stride specifies the byte stride from  one
       color  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	color  array is specified, size, type, stride, and pointer are
       saved as client-side state.

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

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

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

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

       glColorPointer is typically implemented on the client side.

       Color 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 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_COLOR_ARRAY
       glGet with argument GL_COLOR_ARRAY_SIZE
       glGet with argument GL_COLOR_ARRAY_TYPE
       glGet with argument GL_COLOR_ARRAY_STRIDE
       glGetPointerv with argument GL_COLOR_ARRAY_POINTER

SEE ALSO
       glArrayElement, glDrawArrays, glDrawElements, glEdgeFlagPointer,
       glEnable, glGetPointerv, glIndexPointer, glInterleavedArrays, glNormal‐
       Pointer,	  glPopClientAttrib,   glPushClientAttrib,  glTexCoordPointer,
       glVertexPointer

				   15 Mar 97		   GLCOLORPOINTER(3gl)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net