glPrioritizeTextures fonction)

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 à classer par ordre de priorité.

texture

Pointeur vers le premier élément d’un tableau contenant les noms des textures à classer par ordre de priorité.

priorité

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

Nom Signification
_valeur non valide du GL _
n était une valeur négative.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glPrioritizeTextures affecte les n textures de texture spécifiées dans le paramètre priorités 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 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.

En spécifiant une priorité pour chaque texture, la fonction glPrioritizeTextures vous permet de déterminer les textures qui doivent résider.

Les éléments de priorité de texture des priorités sont bloqués à la plage [ 0,0, 1,0 ] avant d’être attribués. Zéro indique la priorité la plus faible ; par conséquent, les textures avec la priorité zéro sont les moins susceptibles d’être résidentes. La valeur 1,0 indique la priorité la plus élevée ; par conséquent, les textures avec la priorité 1,0 sont très probablement résidentes. Toutefois, il n’est pas garanti que les textures résident tant qu’elles ne sont pas liées.

La fonction glPrioritizeTextures ignore les tentatives de hiérarchisation de texture 0, ou 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 des glPrioritizeTextures dans des listes d’affichage.

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

Notes

La fonction glPrioritizeTextures est disponible uniquement dans OpenGL version 1,1 ou ultérieure.

Spécifications

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

glAreTexturesResident

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter