GLPRIORITIZETEXTUREMachTen Programmer’s ManGLPRIORITIZETEXTURES()

NAME
glPrioritizeTextures - set texture residence priority

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

PARAMETERS
n Specifies the number of textures to be priori-
tized.

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

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

DESCRIPTION
glPrioritizeTextures 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, glPrioritizeTextures 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; tex-
tures 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 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 textures 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
GL_INVALID_VALUE is generated if n is negative.

GL_INVALID_OPERATION is generated if glPrioritizeTextures
is executed between the execution of glBegin and the cor-
responding execution of glEnd.

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

SEE ALSO
glAreTexturesResident, glBindTexture, glCopyTexImage1D,
glCopyTexImage2D, glTexImage1D, glTexImage2D, glTexParame-
ter

MachTen 2