G
glGetMaterial
Chapter 7
201
glGetMaterial
glGetMaterialfv, glGetMaterialiv: return material parameters.
C Specification
void glGetMaterialfv(
GLenum face,
GLenum pname,
GLfloat *params)
void glGetMaterialiv(
GLenum face,
GLenum pname,
GLint *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. GL_AMBIENT,
GL_DIFFUSE, GL_SPECULAR, GL_EMISSION, GL_SHININESS,
and GL_COLOR_INDEXES are accepted.
params Returns the requested data.
Description
glGetMaterial returns in params the value or values of parameter pname of material
face. Six parameters are defined:
GL_AMBIENT
params returns four integer or floating-point values representing the ambient
reflectance of the material. Integer values, when requested, are linearly mapped from
the internal floating-point representation such that 1.0 maps to the most positive
representable integer value, and- 1.0 maps to the most negative representable integer
value. If the internal value is outside the range [- 1, 1], the corresponding integer return
value is undefined. The initial value is (0.2, 0.2, 0.2, 1.0).
GL_DIFFUSE
params returns four integer or floating-point values representing the diffuse reflectance
of the material. Integer values, when requested, are linearly mapped from the internal
floating-point representation such that 1.0 maps to the most positive representable
integer value, and - 1.0 maps to the most negative representable integer value. If the
internal value is outside the range [- 1, 1], the corresponding integer return value is
undefined. The initial value is (0.8, 0.8, 0.8, 1.0).
GL_SPECULAR