funzione glPrioritizeTextures
La funzione glPrioritizeTextures imposta la priorità di residenza delle trame.
Sintassi
void WINAPI glPrioritizeTextures(
GLsizei n,
const GLuint *textures,
const GLclampf *priorities
);
Parametri
-
n
-
Numero di trame da classificare in ordine di priorità.
-
Texture
-
Puntatore al primo elemento di una matrice contenente i nomi delle trame da assegnare alle priorità.
-
Priorità
-
Puntatore al primo elemento di una matrice contenente le priorità della trama. Una priorità specificata in un elemento del parametro priorità si applica alla trama denominata dall'elemento corrispondente del parametro trame .
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
n era un valore negativo. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glPrioritizeTextures assegna le priorità n della trama specificate nel parametro priorità alle ntrame denominate nel parametro trame. Nei computer con una quantità limitata di memoria trama, OpenGL stabilisce un "set di lavoro" di trame residenti nella memoria trama. Queste trame possono essere associate a una destinazione di trama molto più efficiente rispetto alle trame che non sono residenti.
Specificando una priorità per ogni trama, la funzione glPrioritizeTextures consente di determinare quali trame devono essere residenti.
Gli elementi delle priorità della trama nelle priorità vengono bloccati nell'intervallo [0,0, 1,0] prima di essere assegnato. Zero indica la priorità più bassa; pertanto le trame con priorità zero sono meno probabile che siano residenti. Il valore 1.0 indica la priorità più alta; quindi le trame con priorità 1.0 sono probabilmente residenti. Tuttavia, le trame non sono garantite per essere residenti fino a quando non sono associate.
La funzione glPrioritizeTextures ignora i tentativi di priorità della trama 0 o qualsiasi nome di trama che non corrisponde a una trama esistente. Nessuna delle funzioni denominate dal parametro trame deve essere associata a una destinazione trama.
Se una trama è attualmente associata, è anche possibile usare la funzione glTexParameter per impostare la relativa priorità. Questo è l'unico modo per impostare la priorità di una trama predefinita.
È possibile includere glPrioritizeTextures negli elenchi di visualizzazione.
La funzione seguente recupera la priorità di una trama attualmente associata a glPrioritizeTextures:
- glGetTexParameter con nome di parametro GL_TEXTURE_PRIORITY
Nota
La funzione glPrioritizeTextures è disponibile solo in OpenGL versione 1.1 o successiva.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|