- set texture residence priority



C SPECIFICATION


PARAMETERS

       _param1  Specifies  the  number  of textures to be priori-
                tized.

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

       _param3  Specifies an array containing the texture priori-
                ties.  A priority given in an element of  _param3
                applies to the texture named by the corresponding
                element of _param2.


DESCRIPTION

       glPrioritizeTextures assigns the _param1  texture  priori-
       ties  given  in  _param3  to the _param1 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 priority 0 are least likely to  be
       resident.  1 indicates the highest priority; textures with
       priority 1 are most likely to be resident.  However,  tex-
       tures  are  not  guaranteed  to be resident until they are
       used.

       glPrioritizeTextures silently ignores attempts to  priori-
       tize  texture  0, or any texture name that does not corre-
       spond to an existing texture.

       glPrioritizeTextures does not require that any of the tex-
       tures  named  by  _param2  be  bound  to a texture target.
       glTexParameter may also be used to set a texture's  prior-
       ity,  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

       glTexImage3D, glTexParameter



                                                                1