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 prior‐
                ity 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 res‐
       ident.

       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 prior‐
       ity;  textures with priority 1 are most likely to be resident.  However,
       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
       glGetTexParameter  with parameter name GL_TEXTURE_PRIORITY retrieves the
       priority of a currently bound texture.

SEE ALSO

Man(1) output converted with man2html