glGetMaterial

Name

glGetMaterialfv, glGetMaterialxv - return material parameters values

void glGetMaterialfv(GLenum face,
    GLenum pname,
    GLfloat * params)

void glGetMaterialxv(GLenum face,
    GLenum pname,
    GLfixed * params)

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.

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.

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

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

This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.