NAME
	  fglPrioritizeTextures	- set texture residence	priority


     FORTRAN SPECIFICATION
	  SUBROUTINE fglPrioritizeTextures( INTEGER*4 n,
					    CHARACTER*8	textures,
					    CHARACTER*8	priorities )


     PARAMETERS
	  n	      Specifies	the number of textures to be
		      prioritized.

	  textures    Specifies	an array containing the	names of the
		      textures to be prioritized.

	  priorities  Specifies	an array containing the	texture
		      priorities.  A priority given in an element of
		      priorities applies to the	texture	named by the
		      corresponding element of textures.

     DESCRIPTION
	  fglPrioritizeTextures	assigns	the n texture priorities given
	  in priorities	to the n textures named	in textures.

	  The GL establishes a ``working set'' of textures that	are
	  resident in texture memory.  These textures may be bound to
	  a texture target much	more efficiently than textures that
	  are not resident.  By	specifying a priority for each
	  texture, fglPrioritizeTextures allows	applications to	guide
	  the GL implementation	in determining which textures should
	  be resident.

	  The priorities given in priorities are clamped to the	range
	  [0,1]	before they are	assigned.  0 indicates the lowest
	  priority; textures with priority 0 are least likely to be
	  resident.  1 indicates the highest priority; textures	with
	  priority 1 are most likely to	be resident.  However,
	  textures are not guaranteed to be resident until they	are
	  used.

	  fglPrioritizeTextures	silently ignores attempts to
	  prioritize texture 0,	or any texture name that does not
	  correspond to	an existing texture.

	  fglPrioritizeTextures	does not require that any of the
	  textures named by textures be	bound to a texture target.
	  fglTexParameter may also be used to set a texture's
	  priority, but	only if	the texture is currently bound.	 This
	  is the only way to set the priority of a default texture.

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

     ERRORS
	  GL_INVALID_VALUE is generated	if n is	negative.

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

     ASSOCIATED	GETS
	  fglGetTexParameter with parameter name GL_TEXTURE_PRIORITY
	  retrieves the	priority of a currently	bound texture.

     SEE ALSO
	  fglAreTexturesResident, fglBindTexture, fglCopyTexImage1D,
	  fglCopyTexImage2D, fglTexImage1D, fglTexImage2D,
	  fglTexParameter