Condividi tramite


funzione glGetPixelMapfv

Le funzioni glGetPixelMapfv, glGetPixelMapuiv e glGetPixelMapusv restituiscono la mappa pixel specificata.

Sintassi

void WINAPI glGetPixelMapfv(
   GLenum  map,
   GLfloat *values
);

Parametri

map

Nome della mappa pixel da restituire. I valori accettati sono 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, GL_PIXEL_MAP_I_TO_A, GL_PIXEL_MAP_R_TO_R, GL_PIXEL_MAP_G_TO_G, GL_PIXEL_MAP_B_TO_B, e GL_PIXEL_MAP_A_TO_A.

Valori

Restituisce il contenuto della mappa pixel.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome Significato
GL_INVALID_ENUM
map non è un valore accettato.
GL_INVALID_OPERATION
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

Per una descrizione dei valori accettabili per il parametro map, vedere glPixelMap. La funzione glGetPixelMap restituisce nei valori il contenuto della mappa pixel specificata nella mappa. Usare le mappe pixel durante l'esecuzione di glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D e glTexImage2D per eseguire il mapping di indici di colore, indici di stencil, componenti di colore e componenti di profondità ad altri valori.

I valori interi senza segno, se richiesti, vengono mappati in modo lineare dalla rappresentazione interna a virgola mobile o fissa in modo che 1,0 eseseguono il mapping al valore intero rappresentabile più grande e 0,0 viene mappato a zero. Restituisce valori integer senza segno non definiti se il valore della mappa non è compreso nell'intervallo [0,1].

Per determinare le dimensioni necessarie della mappa, chiamare glGet con la costante simbolica appropriata.

Se viene generato un errore, non viene apportata alcuna modifica al contenuto dei valori.

Le funzioni seguenti recuperano informazioni correlate a glGetPixelMap:

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
Gl.h
Libreria
Opengl32.lib
DLL
Opengl32.dll

Vedi anche

glBegin

glCopyPixels

glDrawPixels

glEnd

glGet

glPixelMap

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D