NAME
	  fglGetPixelMapfv, fglGetPixelMapuiv, fglGetPixelMapusv -
	  return the specified pixel map


     FORTRAN SPECIFICATION
	  SUBROUTINE fglGetPixelMapfv( INTEGER*4 map,
				       CHARACTER*8 values )
	  SUBROUTINE fglGetPixelMapuiv(	INTEGER*4 map,
					CHARACTER*8 values )
	  SUBROUTINE fglGetPixelMapusv(	INTEGER*4 map,
					CHARACTER*8 values )


     PARAMETERS
	  map	  Specifies the	name of	the pixel map to return.
		  Accepted values are GL_PIXEL_MAP_I_TO_I,
		  GL_PIXEL_MAP_S_TO_S, GL_PIXEL_MAP_I_TO_R,
		  GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B,
		  GL_PIXEL_MAP_I_TO_A, GL_PIXEL_MAP_R_TO_R,
		  GL_PIXEL_MAP_G_TO_G, GL_PIXEL_MAP_B_TO_B, and
		  GL_PIXEL_MAP_A_TO_A.

	  values  Returns the pixel map	contents.

     DESCRIPTION
	  See the fglPixelMap reference	page for a description of the
	  acceptable values for	the map	parameter.  fglGetPixelMap
	  returns in values the	contents of the	pixel map specified in
	  map.	Pixel maps are used during the execution of
	  fglReadPixels, fglDrawPixels,	fglCopyPixels, fglTexImage1D,
	  and fglTexImage2D to map color indices, stencil indices,
	  color	components, and	depth components to other values.

	  Unsigned integer values, if requested, are linearly mapped
	  from the internal fixed or floating-point representation
	  such that 1.0	maps to	the largest representable integer
	  value, and 0.0 maps to 0.  Return unsigned integer values
	  are undefined	if the map value was not in the	range [0,1].

	  To determine the required size of map, call fglGet with the
	  appropriate symbolic constant.

     NOTES
	  If an	error is generated, no change is made to the contents
	  of values.

     ERRORS
	  GL_INVALID_ENUM is generated if map is not an	accepted
	  value.

	  GL_INVALID_OPERATION is generated if fglGetPixelMap is
	  executed between the execution of fglBegin and the
	  corresponding	execution of fglEnd.

     ASSOCIATED	GETS
	  fglGet with argument GL_PIXEL_MAP_I_TO_I_SIZE
	  fglGet with argument GL_PIXEL_MAP_S_TO_S_SIZE
	  fglGet with argument GL_PIXEL_MAP_I_TO_R_SIZE
	  fglGet with argument GL_PIXEL_MAP_I_TO_G_SIZE
	  fglGet with argument GL_PIXEL_MAP_I_TO_B_SIZE
	  fglGet with argument GL_PIXEL_MAP_I_TO_A_SIZE
	  fglGet with argument GL_PIXEL_MAP_R_TO_R_SIZE
	  fglGet with argument GL_PIXEL_MAP_G_TO_G_SIZE
	  fglGet with argument GL_PIXEL_MAP_B_TO_B_SIZE
	  fglGet with argument GL_PIXEL_MAP_A_TO_A_SIZE
	  fglGet with argument GL_MAX_PIXEL_MAP_TABLE

     SEE ALSO
	  fglCopyPixels, fglDrawPixels,	fglPixelMap, fglPixelTransfer,
	  fglReadPixels, fglTexImage1D,	fglTexImage2D