C SPECIFICATION

       void GLAPIENTRY glPrioritizeTextures( GLsizei GLsizei )

PARAMETERS

       GLsizei  Specifies the number of textures to be prioritized.

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

       _param3  Specifies an array containing the texture priorities.  A  pri-
                ority  given  in  an element of _param3 applies to the texture
                named by the corresponding element of _param2.

DESCRIPTION

       glPrioritizeTextures assigns the GLsizei texture  priorities  given  in
       _param3 to the GLsizei textures named in _param2.

       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, glPrioritizeTextures allows applications  to
       guide  the  GL  implementation  in determining which textures should be
       resident.

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

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

       glPrioritizeTextures does not require that any of the textures named by
       _param2 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.

NOTES

       glPrioritizeTextures  is  available  only  if  the GL version is 1.1 or
       greater.

ERRORS

       GL_INVALID_VALUE is generated if GLsizei is negative.

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

ASSOCIATED GETS