funzione glPixelMapfv
La funzione glPixelMapfv configura mappe di trasferimento pixel.
Sintassi
void WINAPI glPixelMapfv(
GLenum map,
GLsizei mapsize,
const GLfloat *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
-
Dimensione 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 è stato accettato. |
|
mapsize è negativo o maggiore di GL_PIXEL_MAP_TABLE. |
|
la mappa era 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 mappe 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 tabelle di traduzione o mappe, usate da glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexImage2D, glTexSubImage1D e glTexSubImage2D. L'uso di queste mappe è descritto completamente nell'argomento glPixelTransfer e in parte negli argomenti relativi ai comandi pixel e texture image. In questo argomento viene descritta solo la specifica delle mappe.
Il parametro della mappa è un nome della mappa simbolica, 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 in una mappa possono essere specificate come numeri a virgola mobile a precisione singola, interi brevi senza segno o interi lunghi senza segno. Esegue il mapping dei valori dei componenti colore (tutti i GL_PIXEL_MAP_I_TO_I e GL_PIXEL_MAP_S_TO_S) conservano 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 bloccato all'intervallo [0,1]. I valori integer senza segno specificati da glPixelMapusv e glPixelMapuiv vengono convertiti in modo lineare in modo lineare, in modo che il numero intero rappresentabile più grande mappa a 1,0 e zero esegue il mapping a 0,0.
Esegue il mapping degli 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 zero a destra del punto binario.
La tabella seguente mostra le dimensioni iniziali e i valori per ognuna delle mappe. Le mappe indicizzate da indici di colore o stencil devono avere mapsize = 2 ^ n per alcuni n o risultati non definiti. Le dimensioni massime consentite per ogni mappa dipendono dall'implementazione e possono essere determinate chiamando glGet con l'argomento GL_MAX_PIXEL_MAP_TABLE. Il massimo singolo 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 dei colori | indice dei colori | 1 | 0,0 |
| GL_PIXEL_MAP_S_TO_S | Indice stencil | Indice stencil | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_R | indice dei colori | R | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_G | indice dei colori | G | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_B | indice dei colori | B | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_A | indice dei colori | 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 |
|