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.
Copyright © 2003-2004 Silicon Graphics, Inc.
This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.