funzione glPixelMapuiv
La funzione glPixelMapuiv configura le mappe di trasferimento pixel.
Sintassi
void WINAPI glPixelMapuiv(
GLenum map,
GLsizei mapsize,
const GLuint *values
);
Parametri
-
map
-
Nome della mappa simbolica. Le dieci mappe sono le seguenti.
Valore Significato - GL_PIXEL_MAP_I_TO_I
Esegue il mapping degli indici di colore agli indici di colore. - GL_PIXEL_MAP_S_TO_S
Esegue il mapping degli indici stencil agli indici stencil. - GL_PIXEL_MAP_I_TO_R
Esegue il mapping degli indici di colore ai componenti rossi. - GL_PIXEL_MAP_I_TO_G
Esegue il mapping degli indici di colore ai componenti verdi. - GL_PIXEL_MAP_I_TO_B
Esegue il mapping degli indici di colore ai componenti blu. - GL_PIXEL_MAP_I_TO_A
Esegue il mapping degli indici di colore ai componenti alfa. - GL_PIXEL_MAP_R_TO_R
Esegue il mapping dei componenti rossi ai componenti rossi. - GL_PIXEL_MAP_G_TO_G
Esegue il mapping dei componenti verdi ai componenti verdi. - GL_PIXEL_MAP_B_TO_B
Esegue il mapping dei componenti blu ai componenti blu. - GL_PIXEL_MAP_A_TO_A
Esegue il mapping dei componenti alfa ai componenti alfa. -
mappezza
-
Dimensioni della mappa definita.
-
Valori
-
Matrice di valori mappati .
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
map non è un valore accettato. |
|
mapsize è negativo o maggiore di GL_PIXEL_MAP_TABLE. |
|
la mappa è stata GL_PIXEL_MAP_I_TO_I, GL_PIXEL_MAP_S_TO_S, GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B o GL_PIXEL_MAP_I_TO_A e mapsize non era una potenza di due. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glPixelMap configura le tabelle di conversione o le mappe usate da glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexSubImage1D e glTexSubImage2D. L'uso di queste mappe è descritto completamente nell'argomento glPixelTransfer e in parte negli argomenti per i comandi pixel e texture image. In questo argomento viene descritta solo la specifica delle mappe.
Il parametro map è un nome simbolico della mappa, che indica una delle dieci mappe da impostare. Il parametro mapsize specifica il numero di voci nella mappa e i valori sono un puntatore a una matrice di valori mappati .
Le voci di una mappa possono essere specificate come numeri a virgola mobile e precisione singola, interi brevi senza segno o interi lunghi senza segno. Le mappe che archiviano i valori dei componenti colore (tutti i valori GL_PIXEL_MAP_I_TO_I e GL_PIXEL_MAP_S_TO_S) mantengono i valori in formato a virgola mobile, con dimensioni mantissa e esponenti non specificate. I valori a virgola mobile specificati da glPixelMapfv vengono convertiti direttamente nel formato a virgola mobile interna di queste mappe e quindi bloccati nell'intervallo [0,1]. I valori integer senza segno specificati da glPixelMapusv e glPixelMapuiv vengono convertiti in modo lineare in modo che il numero intero rappresentabile più grande sia mappato a 1,0 e zero esegue il mapping a 0,0.
Esegue il mapping che archivia indici, GL_PIXEL_MAP_I_TO_I e GL_PIXEL_MAP_S_TO_S, mantiene i valori in formato a virgola fissa, con un numero non specificato di bit a destra del punto binario. I valori a virgola mobile specificati da glPixelMapfv vengono convertiti direttamente nel formato a virgola fissa interna di queste mappe. I valori integer senza segno specificati da glPixelMapusv e glPixelMapuiv specificano valori integer, con tutti gli zeri a destra del punto binario.
Nella tabella seguente vengono illustrati i valori e le dimensioni iniziali per ognuna delle mappe. Le mappe indicizzate da indici color o stencil devono avere mappe = 2 ^ n per alcuni n o i risultati non sono definiti. La dimensione massima consentita per ogni mappa dipende dall'implementazione e può essere determinata chiamando glGet con l'argomento GL_MAX_PIXEL_MAP_TABLE. Il singolo valore massimo si applica a tutte le mappe ed è almeno 32.
| Mappa | Indice di ricerca | Valore di ricerca | Dimensioni iniziali | Valore iniziale |
|---|---|---|---|---|
| GL_PIXEL_MAP_I_TO_I | indice colore | indice colore | 1 | 0,0 |
| GL_PIXEL_MAP_S_TO_S | indice stencil | indice stencil | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_R | indice colore | R | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_G | indice colore | G | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_B | indice colore | B | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_A | indice colore | A | 1 | 0,0 |
| GL_PIXEL_MAP_R_TO_R | R | R | 1 | 0,0 |
| GL_PIXEL_MAP_G_TO_G | G | G | 1 | 0,0 |
| GL_PIXEL_MAP_B_TO_B | B | B | 1 | 0,0 |
| GL_PIXEL_MAP_A_TO_A | A | A | 1 | 0,0 |
Le funzioni seguenti recuperano informazioni correlate a glPixelMap:
glGet con argomento GL_PIXEL_MAP_I_TO_I_SIZE
glGet con argomento GL_PIXEL_MAP_S_TO_S_SIZE
glGet con argomento GL_PIXEL_MAP_I_TO_R_SIZE
glGet con argomento GL_PIXEL_MAP_I_TO_G_SIZE
glGet con argomento GL_PIXEL_MAP_I_TO_B_SIZE
glGet con argomento GL_PIXEL_MAP_I_TO_A_SIZE
glGet con argomento GL_PIXEL_MAP_R_TO_R_SIZE
glGet con argomento GL_PIXEL_MAP_G_TO_G_SIZE
glGet con argomento GL_PIXEL_MAP_B_TO_B_SIZE
glGet con argomento GL_PIXEL_MAP_A_TO_A_SIZE
glGet con argomento GL_MAX_PIXEL_MAP_TABLE
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|