funzione glGetMaterialfv

Articolo
06/13/2023

Le funzioni glGetMaterialfv e glGetMaterialiv restituiscono parametri materiali.

Sintassi

void WINAPI glGetMaterialfv(
   GLenum  face,
   GLenum  pname,
   GLfloat *params
);

Parametri

Faccia

Specifica quale dei due materiali viene sottoposto a query. GL_FRONT o GL_BACK sono accettati, rappresentando rispettivamente i materiali frontali e indietro.

Pname

Parametro del materiale da restituire. I valori seguenti vengono accettati.

Valore	Significato
GL_AMBIENT	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano la riflessione ambientale del materiale. I valori integer, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1.0 esegue il mapping al valore intero rappresentabile più positivo e -1.0 esegue il mapping al valore intero rappresentabile più negativo. Se il valore interno non è compreso nell'intervallo [-1,1], il valore restituito intero corrispondente non è definito.
GL_DIFFUSE	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano la riflessione diffusa del materiale. I valori integer, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1.0 esegue il mapping al valore intero rappresentabile più positivo e -1.0 esegue il mapping al valore intero rappresentabile più negativo. Se il valore interno non è compreso nell'intervallo [-1,1], il valore restituito intero corrispondente non è definito.
GL_SPECULAR	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano la riflessione speculare del materiale. I valori integer, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1.0 esegue il mapping al valore intero rappresentabile più positivo e -1.0 esegue il mapping al valore intero rappresentabile più negativo. Se il valore interno non è compreso nell'intervallo [-1,1], il valore restituito intero corrispondente non è definito.
GL_EMISSION	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano l'intensità di luce generata del materiale. I valori integer, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1.0 esegue il mapping al valore intero rappresentabile più positivo e -1.0 esegue il mapping al valore intero rappresentabile più negativo. Se il valore interno non è compreso nell'intervallo [-1,1], il valore restituito intero corrispondente non è definito.
GL_SHININESS	Il parametro params restituisce un valore intero o a virgola mobile che rappresenta l'esponente speculare del materiale. I valori integer, quando richiesto, vengono calcolati arrotondando il valore a virgola mobile interna al valore intero più vicino.
GL_COLOR_INDEXES	Il parametro params restituisce tre valori integer o a virgola mobile che rappresentano gli indici ambient, diffusi e speculari del materiale. Usare questi indici solo per l'illuminazione dell'indice colore. Gli altri parametri vengono usati solo per l'illuminazione RGBA. I valori integer, quando richiesto, vengono calcolati arrotondando i valori a virgola mobile interna ai valori integer più vicini.

params

Restituisce i dati richiesti.

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	destinazione o query non è stato accettato.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glGetMaterial restituisce in params il valore o i valori del parametro pname del viso materiale.

Se viene generato un errore, non viene apportata alcuna modifica al contenuto di params.

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
glEnd
glMaterial

Condividi tramite