glGetMaterialfv 函数
glGetMaterialfv 和 glGetMaterialiv 函数返回材料参数。
语法
void WINAPI glGetMaterialfv(
GLenum face,
GLenum pname,
GLfloat *params
);
parameters
-
脸
-
指定正在查询两种材料中的哪一种。 接受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 函数可以检索以下错误代码。
| 名称 | 含义 |
|---|---|
|
target 或 query 不是接受的值。 |
|
函数是在 对 glBegin 的调用和对 glEnd 的相应调用之间调用的。 |
备注
glGetMaterial 函数在参数中返回材料面的参数 pname 的值。
如果生成错误，则不会更改 参数的内容。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|