glPrioritizeTextures(3gl)

1GLPRIORITIZETEXTURES(3G)                              GLPRIORITIZETEXTURES(3G)
2
3
4

NAME

6       glPrioritizeTextures - set texture residence priority
7
8

C SPECIFICATION

10       void glPrioritizeTextures( GLsizei n,
11                                  const GLuint *textures,
12                                  const GLclampf *priorities )
13
14

PARAMETERS

16       n           Specifies the number of textures to be prioritized.
17
18       textures    Specifies  an array containing the names of the textures to
19                   be prioritized.
20
21       priorities  Specifies an array containing the  texture  priorities.   A
22                   priority  given  in an element of priorities applies to the
23                   texture named by the corresponding element of textures.
24

DESCRIPTION

26       glPrioritizeTextures assigns the n texture priorities given in  priori‐
27       ties to the n textures named in textures.
28
29       The  GL  establishes a ``working set'' of textures that are resident in
30       texture memory.  These textures may be bound to a texture  target  much
31       more  efficiently than textures that are not resident.  By specifying a
32       priority for each texture, glPrioritizeTextures allows applications  to
33       guide  the  GL  implementation  in determining which textures should be
34       resident.
35
36       The priorities given in priorities  are  clamped  to  the  range  [0,1]
37       before  they  are  assigned.  0 indicates the lowest priority; textures
38       with priority 0 are least likely to be resident.  1 indicates the high‐
39       est  priority; textures with priority 1 are most likely to be resident.
40       However, textures are not guaranteed to  be  resident  until  they  are
41       used.
42
43       glPrioritizeTextures silently ignores attempts to prioritize texture 0,
44       or any texture name that does not correspond to an existing texture.
45
46       glPrioritizeTextures does not require that any of the textures named by
47       textures be bound to a texture target.  glTexParameter may also be used
48       to set a texture's priority, but  only  if  the  texture  is  currently
49       bound.  This is the only way to set the priority of a default texture.
50

NOTES

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

ERRORS

56       GL_INVALID_VALUE is generated if n is negative.
57
58       GL_INVALID_OPERATION is generated if glPrioritizeTextures  is  executed
59       between  the  execution  of  glBegin and the corresponding execution of
60       glEnd.
61

ASSOCIATED GETS

63       glGetTexParameter with parameter name GL_TEXTURE_PRIORITY retrieves the
64       priority of a currently bound texture.
65