glGetMaterialfv 函式

glGetMaterialfv和glGetMaterialiv函式會傳回材料參數。

語法

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

參數

臉

指定正在查詢兩個材質的哪一個。 接受GL_FRONT或GL_BACK，分別代表正面和後端材質。

pname

要傳回的材質參數。 接受下列值。

值	意義
GL_AMBIENT	params參數會傳回四個整數或浮點值，代表材質的環境反射。 當要求時，整數值會從內部浮點表示線性對應，讓 1.0 對應至最正表示的整數值，而 -1.0 會對應至最負數的可表示整數值。 如果內部值超出範圍 [-1，1]，則對應的整數傳回值未定義。
GL_DIFFUSE	params參數會傳回四個整數或浮點值，代表材質的擴散反射。 當要求時，整數值會從內部浮點表示線性對應，讓 1.0 對應至最正表示的整數值，而 -1.0 會對應至最負數的可表示整數值。 如果內部值超出範圍 [-1，1]，則對應的整數傳回值未定義。
GL_SPECULAR	params參數會傳回四個整數或浮點值，代表材質的反射。 當要求時，整數值會從內部浮點表示線性對應，讓 1.0 對應至最正表示的整數值，而 -1.0 會對應至最負數的可表示整數值。 如果內部值超出範圍 [-1，1]，則對應的整數傳回值未定義。
GL_EMISSION	params參數會傳回四個整數或浮點值，代表材質的發出光線強度。 當要求時，整數值會從內部浮點表示線性對應，讓 1.0 對應至最正表示的整數值，而 -1.0 會對應至最負數的可表示整數值。 如果內部值超出範圍 [-1，1]，則對應的整數傳回值未定義。
GL_SHININESS	params參數會傳回一個整數或浮點值，代表材質的反射指數。 當要求時，整數值會藉由將內部浮點值四捨五入至最接近的整數值來計算。
GL_COLOR_INDEXES	params參數會傳回三個整數或浮點值，代表材質的環境、擴散和反射索引。 這些索引僅適用于色彩索引光源。 (其他參數全都僅用於 RGBA 光源。) 要求時，會藉由將內部浮點值四捨五入至最接近的整數值來計算。

params

傳回要求的資料。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_ENUM	目標 或 查詢 不是接受的值。
GL_INVALID_OPERATION	在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

備註

glGetMaterial函式會在參數中傳回材質臉部參數pname的值或值。

如果產生錯誤，則不會對 參數的內容進行任何變更。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Gl.h
程式庫	Opengl32.lib
DLL	Opengl32.dll

另請參閱

glBegin

glEnd

glMaterial