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

NAME

6       glPrioritizeTextures - set texture residence priority
7

C SPECIFICATION

9       void glPrioritizeTextures(GLsizei n, const GLuint * textures,
10                                 const GLclampf * priorities);
11

PARAMETERS

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

DESCRIPTION

26       glPrioritizeTextures assigns the n texture priorities given in
27       priorities 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 before
37       they are assigned. 0 indicates the lowest priority; textures with
38       priority 0 are least likely to be resident. 1 indicates the highest
39       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
48       used 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
64       the priority of a currently bound texture.
65

SEE ALSO

67       glAreTexturesResident(), glBindTexture(), glCopyTexImage1D(),
68       glCopyTexImage2D(), glTexImage1D(), glTexImage2D(), glTexImage3D(),
69       glTexParameter()
70
72       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
73       under the SGI Free Software B License. For details, see
74       http://oss.sgi.com/projects/FreeB/.
75

AUTHORS

77       opengl.org
78
79
80
81opengl.org                        06/10/2014          GLPRIORITIZETEXTURES(3G)
Impressum