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函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
目標 或 查詢 不是接受的值。 |
|
在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。 |
備註
glGetMaterial函式會在參數中傳回材質臉部參數pname的值或值。
如果產生錯誤，則不會對 參數的內容進行任何變更。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|