NAME
	  fglColorPointer - define an array of colors


     FORTRAN SPECIFICATION
	  SUBROUTINE fglColorPointer( INTEGER*4	size,
				      INTEGER*4	type,
				      INTEGER*4	stride,
				      CHARACTER*8 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
	  fglColorPointer 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
	  fglInterleavedArrays.)

	  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
	  fglEnableClientState and
	  fglDisableClientState	with the argument GL_COLOR_ARRAY. If
	  enabled, the color array is used when	fglDrawArrays,
	  fglDrawElements, or fglArrayElement is called.

     NOTES
	  fglColorPointer is available only if the GL version is 1.1
	  or greater.
	  The color array is initially disabled	and isn't accessed
	  when fglArrayElement,	fglDrawArrays, or fglDrawElements is
	  called.

	  Execution of fglColorPointer is not allowed between the
	  execution of fglBegin	and the	corresponding execution	of
	  fglEnd, but an error may or may not be generated. If no
	  error	is generated, the operation is undefined.

	  fglColorPointer is typically implemented on the client side.

	  Color	array parameters are client-side state and are
	  therefore not	saved or restored by fglPushAttrib and
	  fglPopAttrib.	 Use fglPushClientAttrib and
	  fglPopClientAttrib 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
	  fglIsEnabled with argument GL_COLOR_ARRAY
	  fglGet with argument GL_COLOR_ARRAY_SIZE
	  fglGet with argument GL_COLOR_ARRAY_TYPE
	  fglGet with argument GL_COLOR_ARRAY_STRIDE
	  fglGetPointerv with argument GL_COLOR_ARRAY_POINTER

     SEE ALSO
	  fglArrayElement, fglDrawArrays, fglDrawElements,
	  fglEdgeFlagPointer,
	  fglEnable, fglGetPointerv, fglIndexPointer,
	  fglInterleavedArrays,	fglNormalPointer, fglPopClientAttrib,
	  fglPushClientAttrib, fglTexCoordPointer, fglVertexPointer