glAreTexturesResident fonction)

La fonction glAreTexturesResident détermine si les objets 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.

texture

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

foyers

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

Codes d’erreur

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

Name Signification
_valeur non valide du GL _
n était une valeur négative, un élément dans textures était égal à zéro, ou un élément dans les textures ne contenait pas d’identificateur de texture.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Remarques

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

La fonction glAreTexturesResident interroge l’état de résidence des n textures désignées par les éléments de textures. Si toutes les textures nommées résident, glAreTexturesResident retourne _ la valeur 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 l’état détaillé est retourné dans les n éléments de résidences.

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

Pour interroger l’état de résidence d’une texture à liaison unique, appelez glGetTexParameter avec le paramètre target défini sur la texture cible à laquelle la cible est liée et définissez le paramètre pname sur la texture du grand livre _ _ résident. Vous devez utiliser cette méthode pour interroger l’État résident d’une texture par défaut.

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

La fonction glAreTexturesResident retourne l’état de résidence des textures au moment de l’appel. Cela ne garantit pas que les textures restent résidentes à tout 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