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 |
|---|---|
|
n était une valeur négative. |
|
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:
- glGetTexParameter avec le nom de paramètre _ priorité de texture GL _
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 |
|
| Bibliothèque |
|
| DLL |
|