*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> glAreTexturesResident (3)              
Title
Content
Arch
Section
 

glAreTexturesResident(3G)

Contents


NAME    [Toc]    [Back]

       glAreTexturesResident  -  determine if textures are loaded
       in texture memory

SYNOPSIS    [Toc]    [Back]

       GLboolean glAreTexturesResident(
               GLsizei n,
               const GLuint *textures,
               GLboolean *residences );

PARAMETERS    [Toc]    [Back]

       Specifies the number of textures to be queried.  Specifies
       an  array  containing  the  names  of  the  textures to be
       queried.  Specifies an array in which  the  texture  residence
  status  is returned. The residence status of a texture
 named by an element of textures is  returned  in  the
       corresponding element of residences.

DESCRIPTION    [Toc]    [Back]

       GL establishes a ``working set'' of textures that are resident
 in texture memory. These textures can be bound to  a
       texture  target  much  more efficiently than textures that
       are not resident.

       glAreTexturesResident() queries the texture residence status
  of  the n textures named by the elements of textures.
       If all the named textures are resident, glAreTexturesResident()
 returns GL_TRUE, and the contents of residences are
       undisturbed. If not all the named textures  are  resident,
       glAreTexturesResident()  returns  GL_FALSE,  and  detailed
       status is returned in the n elements of residences. If  an
       element  of  residences is GL_TRUE, then the texture named
       by the corresponding element of textures is resident.

       The residence status of a single bound texture may also be
       queried  by  calling  glGetTexParameter()  with the target
       argument set to the target to which the texture is  bound,
       and the pname argument set to GL_TEXTURE_RESIDENT. This is
       the only way that the residence status of a  default  texture
 can be queried.

NOTES    [Toc]    [Back]

       glAreTexturesResident()  is  available only if the GL version
 is 1.1 or greater.

       glAreTexturesResident() returns the  residency  status  of
       the  textures at the time of invocation. It does not guarantee
 that the textures will remain resident at any  other
       time.

       If  textures reside in virtual memory (there is no texture
       memory), they are considered always resident.

       Some implementations may not  load  a  texture  until  the
       first use of that texture.







ERRORS    [Toc]    [Back]

       GL_INVALID_VALUE is generated if n is negative.

       GL_INVALID_VALUE  is  generated if any element in textures
       is 0 or does not name a texture. In that case,  the  function
  returns  GL_FALSE  and the contents of residences is
       indeterminate.

       GL_INVALID_OPERATION is  generated  if  glAreTexturesResident()
  is executed between the execution of glBegin() and
       the corresponding execution of glEnd().

ASSOCIATED GETS    [Toc]    [Back]

       glGetTexParameter() with parameter  name  GL_TEXTURE_RESIDENT
  retrieves  the residence status of a currently bound
       texture.

SEE ALSO    [Toc]    [Back]

      
      
       glBindTexture(3),  glGetTexParameter(3),  glPrioritizeTextures(3),   glTexImage1D(3),   glTexImage2D(3),   glTexImage3D(3), glTexParameter(3)



                                        glAreTexturesResident(3G)
[ Back ]
 Similar pages
Name OS Title
istexloaded IRIX returns whether the texture with the passed id is resident in texture memory
glistexture IRIX determine if a name corresponds to a texture
glIsTexture Tru64 determine if a name corresponds to a texture
glistextureext IRIX determine if a name corresponds to a texture
mincore FreeBSD determine residency of memory pages
mincore NetBSD determine residency of memory pages
mincore OpenBSD determine residency of memory pages
pmap_mincore FreeBSD determine if a virtual address is resident in physical memory
gldeletetextures IRIX delete named textures
gldeletetexturesext IRIX delete named textures
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service