Unix/Linux Go Back    


CentOS 7.0 - man page for glprioritizetextures (centos section 3G)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


GLPRIORITIZETEXTURES(3G)		  OpenGL Manual 		 GLPRIORITIZETEXTURES(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 prioritized.

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

       priorities
	   Specifies an array containing the texture priorities. 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; 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 textures 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.

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(), glBindTexture(), glCopyTexImage1D(), glCopyTexImage2D(),
       glTexImage1D(), glTexImage2D(), glTexImage3D(), glTexParameter()

COPYRIGHT
       Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI
       Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.

AUTHORS
       opengl.org

opengl.org				    06/10/2014			 GLPRIORITIZETEXTURES(3G)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 07:14 PM.