fglAreTexturesResident(3G)

NAME
     fglAreTexturesResident - determine if textures are loaded in texture
     memory


FORTRAN SPECIFICATION
     LOGICAL*1 fglAreTexturesResident( INTEGER*4 n,
                                       CHARACTER*8 textures,
                                       CHARACTER*8 residences )


PARAMETERS
     n           Specifies the number of textures to be queried.

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

     residences  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
     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.

     fglAreTexturesResident queries the texture residence status of the n
     textures named by the elements of textures.  If all the named textures
     are resident, fglAreTexturesResident returns GL_TRUE, and the contents of
     residences are undisturbed.  If not all the named textures are resident,
     fglAreTexturesResident 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 fglGetTexParameter 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
     fglAreTexturesResident is available only if the GL version is 1.1 or
     greater.

     fglAreTexturesResident 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
     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 fglAreTexturesResident is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.

ASSOCIATED GETS
     fglGetTexParameter with parameter name GL_TEXTURE_RESIDENT retrieves the
     residence status of a currently bound texture.


SEE ALSO
     fglBindTexture, fglGetTexParameter, fglPrioritizeTextures, fglTexImage1D,
     fglTexImage2D, fglTexImage3D, fglTexParameter