glGetMaterial

Name

glGetMaterial — return material parameters values

C Specification

`void fsfuncglGetMaterialfv(`	GLenum `face`,
	GLenum `pname`,
	GLfloat * `params)`;

`void fsfuncglGetMaterialxv(`	GLenum `face`,
	GLenum `pname`,
	GLfixed * `params)`;

Parameters

face: Specifies which of the two materials is being queried. GL_FRONT or GL_BACK are accepted, representing the front and back materials, respectively.
pname: Specifies the material parameter to return. Accepted symbolic names are GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR, GL_EMISSION, and GL_SHININESS.
params: Returns the requested data.

Description

glGetMaterial returns in params the value or values of parameter pname of material face.

Five parameters are defined:

GL_AMBIENT: params returns four fixed-point or floating-point values that specify the ambient RGBA reflectance of the material. The values are not clamped. The initial ambient reflectance is (0.2, 0.2, 0.2, 1.0).
GL_DIFFUSE: params returns four fixed-point or floating-point values that specify the diffuse RGBA reflectance of the material. The values are not clamped. The initial diffuse reflectance is (0.8, 0.8, 0.8, 1.0).
GL_SPECULAR: params returns four fixed-point or floating-point values that specify the specular RGBA reflectance of the material. The values are not clamped. The initial specular reflectance is (0, 0, 0, 1).
GL_EMISSION: params returns four fixed-point or floating-point values that specify the RGBA emitted light intensity of the material. The values are not clamped. The initial emission intensity is (0, 0, 0, 1).
GL_SHININESS: params returns a single fixed-point or floating-point value that specifies the RGBA specular exponent of the material. The initial specular exponent is 0.

Notes

If an error is generated, no change is made to the contents of params.

In OpenGL ES there is only one material shared by the front and back. Therefore querying GL_FRONT and querying GL_BACK will always return the same value.

Errors

GL_INVALID_ENUM is generated if face or pname is not an accepted value.