fonction glPrioritizeTextures

La fonction glPrioritizeTextures définit la priorité de résidence des textures.

Syntaxe

void WINAPI glPrioritizeTextures(
         GLsizei  n,
   const GLuint   *textures,
   const GLclampf *priorities
);

Paramètres

n

Nombre de textures à hiérarchiser.

Textures

Pointeur vers le premier élément d’un tableau contenant les noms des textures à hiérarchiser.

Priorités

Pointeur vers le premier élément d’un tableau contenant les priorités de texture. Une priorité donnée dans un élément du paramètre priority s’applique à la texture nommée par l’élément correspondant du paramètre textures .

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

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

Notes

La fonction glPrioritizeTextures affecte les n priorités de texture spécifiées dans le paramètre priorities aux n textures nommées dans le paramètre textures . Sur les ordinateurs avec une quantité limitée de mémoire de texture, OpenGL établit un « ensemble de travail » de textures résidant 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.

En spécifiant une priorité pour chaque texture, la fonction glPrioritizeTextures vous permet de déterminer quelles textures doivent être résidentes.

Les éléments de priorités de texture dans les priorités sont limités à la plage [0.0, 1.0] avant d’être attribués. Zéro indique la priorité la plus basse ; ainsi, les textures avec priorité zéro sont moins susceptibles d’être résidentes. La valeur 1.0 indique la priorité la plus élevée ; ainsi, les textures de priorité 1.0 sont plus susceptibles d’être résidentes. Toutefois, il n’est pas garanti que les textures soient résidentes tant qu’elles ne sont pas liées.

La fonction glPrioritizeTextures ignore les tentatives de hiérarchisation de la texture 0 ou de tout nom de texture qui ne correspond pas à une texture existante. Aucune des fonctions nommées par le paramètre textures ne doit être liée à une cible de texture.

Si une texture est actuellement liée, vous pouvez également utiliser la fonction glTexParameter pour définir sa priorité. Il s’agit de la seule façon de définir la priorité d’une texture par défaut.

Vous pouvez inclure glPrioritizeTextures dans les listes d’affichage.

La fonction suivante récupère la priorité d’une texture actuellement liée à glPrioritizeTextures :

• glGetTexParameter avec le nom de paramètre GL_TEXTURE_PRIORITY

Spécifications

Voir aussi

glAreTexturesResident

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter