5
.ds Dt 24 September 1999
9
.ds Xs 38862 5 prioritizetextures.gl
10
.TH GLPRIORITIZETEXTURES 3G
12
.B "glPrioritizeTextures
13
\- set texture residence priority
16
void \f3glPrioritizeTextures\fP(
19
.ta \w'\f3void \fPglPrioritizeTextures( 'u
20
const GLuint \fI*textures\fP,
21
const GLclampf \fI*priorities\fP )
25
.TP \w'\fIpriorities\fP\ \ 'u
27
Specifies the number of textures to be prioritized.
30
Specifies an array containing the names of the textures to be prioritized.
33
Specifies an array containing the texture priorities.
34
A priority given in an element of \f2priorities\fP applies to the texture
35
named by the corresponding element of \f2textures\fP.
37
\%\f3glPrioritizeTextures\fP assigns the \f2n\fP texture priorities given in \f2priorities\fP to the
38
\f2n\fP textures named in \f2textures\fP.
41
a ``working set'' of textures that are resident in texture memory.
42
These textures may be bound to a texture target much more efficiently
43
than textures that are not resident.
44
By specifying a priority for each texture,
45
\%\f3glPrioritizeTextures\fP allows applications to guide the GL implementation in determining
46
which textures should be resident.
48
The priorities given in \f2priorities\fP are clamped to the range [0,\1]
49
before they are assigned.
50
0 indicates the lowest priority; textures with priority 0
51
are least likely to be resident.
52
1 indicates the highest priority; textures with priority 1
53
are most likely to be resident.
54
However, textures are not guaranteed to be resident until they are used.
56
\%\f3glPrioritizeTextures\fP silently ignores attempts to prioritize texture 0, or any texture
57
name that does not correspond to an existing texture.
59
\%\f3glPrioritizeTextures\fP does not require that any of the textures named by \f2textures\fP
60
be bound to a texture target.
61
\%\f3glTexParameter\fP may also be used to set a texture's priority,
62
but only if the texture is currently bound.
63
This is the only way to set the priority of a default texture.
65
\%\f3glPrioritizeTextures\fP is available only if the GL version is 1.1 or greater.
67
\%\f3GL_INVALID_VALUE\fP is generated if \f2n\fP is negative.
69
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glPrioritizeTextures\fP is executed
70
between the execution of \%\f3glBegin\fP and the corresponding
71
execution of \%\f3glEnd\fP.
73
\%\f3glGetTexParameter\fP with parameter name \%\f3GL_TEXTURE_PRIORITY\fP
74
retrieves the priority of a currently bound texture.
76
\%\f3glAreTexturesResident(3G)\fP,
77
\%\f3glBindTexture(3G)\fP,
78
\%\f3glCopyTexImage1D(3G)\fP,
79
\%\f3glCopyTexImage2D(3G)\fP,
80
\%\f3glTexImage1D(3G)\fP,
81
\%\f3glTexImage2D(3G)\fP,
82
\%\f3glTexImage3D(3G)\fP,
83
\%\f3glTexParameter(3G)\fP