fonction glAreTexturesResident

La fonction glAreTexturesResident détermine si les objets de texture spécifiés résident dans la mémoire de texture.

Syntaxe

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

Paramètres

n

Nombre de textures à interroger.

Textures

Adresse d’un tableau contenant les noms des textures à interroger.

Résidences

Adresse d’un tableau dans lequel la résidence de texture status est retournée. La status de résidence d’une texture nommée par un élément de textures est retournée dans l’élément de résidences correspondant.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Name	Signification
GL_INVALID_VALUE	n était une valeur négative, un élément dans les textures était zéro ou un élément dans les textures ne contenait pas d’identificateur de texture.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

Sur les ordinateurs avec une quantité limitée de mémoire de texture, OpenGL établit un ensemble de textures qui résident dans la mémoire de texture. Ces textures peuvent être liées à une cible de texture beaucoup plus efficacement que les textures qui ne sont pas résidentes.

La fonction glAreTexturesResident interroge la résidence de texture status des n textures nommées par les éléments de textures. Si toutes les textures nommées sont résidentes, glAreTexturesResident retourne GL_TRUE et le contenu des résidences n’est pas perturbé. Si l’une des textures nommées n’est pas résidente, glAreTexturesResident retourne GL_FALSE et status détaillée est retournée dans les n éléments de résidences.

Si un élément de résidences est GL_TRUE, la texture nommée par l’élément de textures correspondant réside dans la mémoire de texture.

Pour interroger la status de résidence d’une seule texture liée, appelez glGetTexParameter avec le paramètre cible défini sur la texture cible à laquelle la cible est liée et définissez le paramètre pname sur GL_TEXTURE_RESIDENT. Vous devez utiliser cette méthode pour interroger le status résident d’une texture par défaut.

Vous ne pouvez pas inclure glAreTexturesResident dans les listes d’affichage.

La fonction glAreTexturesResident renvoie la résidence status des textures au moment de l’appel. Il ne garantit pas que les textures resteront résidentes à tout autre moment.

Si les textures résident dans la mémoire virtuelle (il n’y a pas de mémoire de texture), elles sont considérées comme toujours résidentes.

Notes

La fonction glAreTexturesResident est disponible uniquement dans OpenGL version 1.1 ou ultérieure.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glBindTexture

glEnd

glGetTexParameter

glPrioritizeTextures

glTexImage1D

glTexImage2D