funzione glGetColorTableParameterivEXT

Le funzioni glGetColorTableParameterfvEXT e glGetColorTableParameterivEXT ottengono i parametri della tavolozza dalle tabelle dei colori.

Sintassi

void WINAPI glGetColorTableParameterivEXT(
   GLenum target,
   GLenum pname,
   GLint  *params
);

Parametri

target

Trama di destinazione della tavolozza per cui si desiderano dati dei parametri. Deve essere TEXTURE_1D, TEXTURE_2D, PROXY_TEXTURE_1D o PROXY_TEXTURE_2D.

Pname

Costante simbolica per il tipo di dati dei parametri della tavolozza puntati da params.

Di seguito sono riportate le costanti simboliche accettate e i loro significati.

Valore	Significato
GL_COLOR_TABLE_FORMAT_EXT	Restituisce il formato interno specificato dalla chiamata più recente a glColorTableEXT o al valore predefinito.
GL_COLOR_TABLE_WIDTH_EXT	Restituisce la larghezza della tavolozza corrente.
GL_COLOR_TABLE_RED_SIZE_EXT	Restituisce le dimensioni effettive usate internamente per archiviare il componente rosso dei dati del tavolozza.
GL_COLOR_TABLE_GREEN_SIZE_EXT	Restituisce le dimensioni effettive usate internamente per archiviare il componente verde dei dati del tavolozza.
GL_COLOR_TABLE_BLUE_SIZE_EXT	Restituisce le dimensioni effettive usate internamente per archiviare il componente blu dei dati del tavolozza.
GL_COLOR_TABLE_ALPHA_SIZE_EXT	Restituisce le dimensioni effettive usate internamente per archiviare il componente alfa dei dati del tavolozza.

params

Punta ai dati dei parametri della tabella dei colori specificati dal parametro pname .

Valore restituito

Questa funzione non restituisce un valore.

Commenti

Si usano le funzioni glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT per recuperare dati di parametri specifici dalle tabelle dei colori impostate con glColorTableEXT per le tavolozze di trama di destinazione. È anche possibile usare queste funzioni per determinare il numero di voci della tabella dei colori restituite da glGetColorTableEXT .

Quando il parametro di destinazione è GL_PROXY_TEXTURE_1D o GL_PROXY_TEXTURE_2D e l'implementazione non supporta i valori specificati per il formato o la larghezza, glColorTableEXT non può creare la tabella colori richiesta. In questo caso, la tabella dei colori è vuota e tutti i parametri recuperati saranno zero. È possibile determinare se OpenGL supporta un determinato formato e dimensioni della tabella dei colori chiamando glColorTableEXT con una destinazione proxy e quindi chiamando glGetColorTableParameterivEXT o glGetColorTableParameterfvEXT per determinare se il parametro di larghezza corrisponde a quello impostato da glColorTableEXT. Se la larghezza recuperata è zero, la richiesta di tabella dei colori da glColorTable non è riuscita. Se la larghezza recuperata non è zero, è possibile chiamare glColorTable con la destinazione reale con TEXTURE_1D o TEXTURE_2D per impostare la tabella dei colori.

Le funzioni glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT sono funzioni di estensione che non fanno parte della libreria OpenGL standard, ma fanno parte dell'estensione GL_EXT_paletted_texture. Per verificare se l'implementazione di OpenGL supporta glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT, chiamare glGetString(GL_EXTENSIONS). Se restituisce GL_EXT_paletted_texture, sono supportati glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT . Per ottenere l'indirizzo della funzione di una funzione di estensione, chiamare wglGetProcAddress.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h

Vedi anche

glColorSubTableEXT

glColorTableEXT

glGetColorTableEXT

glGetColorTableParameterfvEXT

wglGetProcAddress