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 函数可以检索以下错误代码。

名称	含义
GL_INVALID_ENUM	target 或 query 不是接受的值。
GL_INVALID_OPERATION	在对 glBegin 的调用和对 glEnd 的相应调用之间调用了函数。

备注

glGetMaterial 函数在参数中返回材料面参数 pname 的值。

如果生成错误，则不会对 参数的内容进行更改。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Gl.h
库	Opengl32.lib
DLL	Opengl32.dll

另请参阅

glBegin

glEnd

glMaterial