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