Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GLPRIORITIZETEXTURES()					GLPRIORITIZETEXTURES()

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  priori-
       ties 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]  be-
       fore 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,  glCopyTexIm-
       age2D, glTexImage1D, glTexImage2D, glTexParameter

							GLPRIORITIZETEXTURES()

NAME | C SPECIFICATION | PARAMETERS | DESCRIPTION | NOTES | ERRORS | ASSOCIATED GETS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=glPrioritizeTextures&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help