glPrioritizeTexturesEXT(3G)    OpenGL Reference	   glPrioritizeTexturesEXT(3G)



NAME
     glPrioritizeTexturesEXT - set texture residence priority


C SPECIFICATION
     void glPrioritizeTexturesEXT( GLsizei n,
				   const GLuint	*textures,
				   const GLclampf *priorities )


PARAMETERS
     n		 The number of textures	to be prioritized.

     textures	 An array containing the names of the textures to be
		 prioritized.

     priorities	 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
     glPrioritizeTexturesEXT assigns the n texture priorities given in
     priorities	to the n textures named	in textures.

     On	machines with a	limited	amount of texture memory, OpenGL 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, glPrioritizeTexturesEXT allows applications to guide the OpenGL
     implementation in determining which textures should be resident.

     The priorities given in priorities	are clamped to the range [0.0, 1.0]
     before being assigned.  Zero indicates the	lowest priority, and hence
     textures with priority zero are least likely to be	resident.  One
     indicates the highest priority, and hence textures	with priority one are
     most likely to be resident.  However, textures are	not guaranteed to be
     resident until they are bound.

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

     glPrioritizeTexturesEXT does not require that any of the textures named
     by	textures be bound to a texture target.	glTexParameter 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.

     glPrioritizeTexturesEXT is	included in display lists.







									Page 1






glPrioritizeTexturesEXT(3G)    OpenGL Reference	   glPrioritizeTexturesEXT(3G)



NOTES
     glPrioritizeTexturesEXT is	part of	the EXT_texture_object extension.  See
     glIntro for more information about	using extensions.

ERRORS
     GL_INVALID_VALUE is generated if n	is negative.

     GL_INVALID_OPERATION is generated if glPrioritizeTexturesEXT is executed
     between the execution of glBegin and the corresponding execution of
     glEnd.

ASSOCIATED GETS
     glGetTexParameter with parameter name GL_TEXTURE_PRIORITY_EXT retrieves
     the priority of a currently-bound texture.


SEE ALSO
     glAreTexturesResidentEXT, glBindTextureEXT, glTexImage1D, glTexImage2D,
     glTexImage3DEXT, glTexParameter.




































									Page 2