MirOS Manual: glPrioritizeTextures(3)

GLPRIORITIZETEXTURES(UNIX Programmer's MaGLPRIORITIZETEXTURES(3G)

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 prior-
                 ities. A priority given in an element of priori-
                 ties 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; textures 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 prioritize
     texture 0, or any texture name that does not correspond 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 priority,
     but only if the texture is currently bound. This is the only
     way to set the priority of a default texture.

MirOS BSD #10-current   Printed 20.2.2012                       1

GLPRIORITIZETEXTURES(UNIX Programmer's MaGLPRIORITIZETEXTURES(3G)

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
     corresponding execution of glEnd.

ASSOCIATED GETS

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

SEE ALSO

     glAreTexturesResident(3G), glBindTexture(3G),
     glCopyTexImage1D(3G), glCopyTexImage2D(3G),
     glTexImage1D(3G), glTexImage2D(3G), glTexImage3D(3G),
     glTexParameter(3G)

MirOS BSD #10-current   Printed 20.2.2012                       2

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.