glGetMaterialiv 函数
glGetMaterialfv 和 glGetMaterialiv 函数返回材料参数。
语法
void WINAPI glGetMaterialiv(
GLenum face,
GLenum pname,
GLint *params
);
参数
-
脸
-
指定查询这两种材料中的哪一种。 接受GL_FRONT或GL_BACK，分别表示正面和背面材料。
-
pname
-
要返回的材料参数。 接受以下值。
值 含义 - GL_AMBIENT
params 参数返回四个整数或浮点值，表示材料的环境反射率。 整数值在请求时从内部浮点表示形式线性映射，使 1.0 映射到最正的可表示整数值，而 -1.0 映射到最负的可表示整数值。 如果内部值在 [-1，1] 范围之外，则相应的整数返回值未定义。 - GL_DIFFUSE
参数返回四个整数或浮点值，表示材料的漫射反射率。 整数值在请求时从内部浮点表示形式线性映射，使 1.0 映射到最正的可表示整数值，而 -1.0 映射到最负的可表示整数值。 如果内部值在 [-1，1] 范围之外，则相应的整数返回值未定义。 - GL_SPECULAR
参数返回四个整数或浮点值，表示材料的反射率。 整数值在请求时从内部浮点表示形式线性映射，使 1.0 映射到最正的可表示整数值，而 -1.0 映射到最负的可表示整数值。 如果内部值在 [-1，1] 范围之外，则相应的整数返回值未定义。 - GL_EMISSION
参数返回四个整数或浮点值，表示材料发出的光强度。 整数值在请求时从内部浮点表示形式线性映射，使 1.0 映射到最正的可表示整数值，而 -1.0 映射到最负的可表示整数值。 如果内部值在 [-1，1] 范围之外，则相应的整数返回值未定义。 - GL_SHININESS
参数返回一个整数或浮点值，表示材料的反射指数。 整数值在请求时通过将内部浮点值舍入为最接近的整数值来计算。 - GL_COLOR_INDEXES
参数返回三个整数或浮点值，表示材料的环境索引、漫射索引和反射索引。 这些索引仅用于颜色索引照明。 (其他参数仅用于 RGBA 照明。) 整数值，当请求时，通过将内部浮点值舍入为最接近的整数值来计算。 -
params
-
返回请求的数据。
返回值
此函数不返回值。
错误代码
glGetError 函数可以检索以下错误代码。
| 名称 | 含义 |
|---|---|
|
target 或 query 不是接受的值。 |
|
在对 glBegin 的调用和对 glEnd 的相应调用之间调用了函数。 |
备注
glGetMaterial 函数在参数中返回材料面参数 pname 的值。
如果生成错误，则不会对 参数的内容进行更改。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|