funzione glGetMaterialiv

Articolo
06/12/2023

Le funzioni glGetMaterialfv e glGetMaterialiv restituiscono parametri materiali.

Sintassi

void WINAPI glGetMaterialiv(
   GLenum face,
   GLenum pname,
   GLint  *params
);

Parametri

Faccia

Specifica quale dei due materiali viene sottoposto a query. GL_FRONT o GL_BACK vengono accettati, rappresentando rispettivamente i materiali anteriori e posteriore.

Pname

Parametro material da restituire. Vengono accettati i valori seguenti.

Valore	Significato
GL_AMBIENT	Il parametro params restituisce quattro valori integer o a virgola mobile che rappresentano la riflessione ambientale del materiale. I valori interi, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1,0 e il valore intero rappresentabile più positivo e -1,0 e -1,0 eseseguono il mapping al valore intero rappresentabile più negativo. Se il valore interno non rientra nell'intervallo [-1,1], il valore restituito integer 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 interi, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1,0 e il valore intero rappresentabile più positivo e -1,0 e -1,0 eseseguono il mapping al valore intero rappresentabile più negativo. Se il valore interno non rientra nell'intervallo [-1,1], il valore restituito integer corrispondente non è definito.
GL_SPECULAR	Il parametro params restituisce quattro valori integer o a virgola mobile che rappresentano la reflection speculare del materiale. I valori interi, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1,0 e il valore intero rappresentabile più positivo e -1,0 e -1,0 eseseguono il mapping al valore intero rappresentabile più negativo. Se il valore interno non rientra nell'intervallo [-1,1], il valore restituito integer corrispondente non è definito.
GL_EMISSION	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano l'intensità di luce emessa del materiale. I valori interi, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1,0 e il valore intero rappresentabile più positivo e -1,0 e -1,0 eseseguono il mapping al valore intero rappresentabile più negativo. Se il valore interno non rientra nell'intervallo [-1,1], il valore restituito integer 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 interi, se richiesti, vengono calcolati arrotondando il valore interno a virgola mobile al valore intero più vicino.
GL_COLOR_INDEXES	Il parametro params restituisce tre valori integer o a virgola mobile che rappresentano gli indici ambientali, diffusi e speculari del materiale. Usare questi indici solo per l'illuminazione dell'indice di colore. Gli altri parametri vengono usati solo per l'illuminazione RGBA. I valori interi, se richiesti, vengono calcolati arrotondando i valori interni a virgola mobile 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	target o query non è un valore 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 parametri il valore o i valori del parametro pname del viso materiale.

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

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