- Name
-
gl.GetMaterial -- return material parameters
- Synopsis
-
paramsArray = gl.GetMaterial(face, pname)
- Function
-
gl.GetMaterial()
returns a table containing the value or values of parameter pname
of material face
. The following
six parameters can be passed in pname
:
#GL_AMBIENT
-
Returns four floating-point values representing the ambient reflectance of the material. The initial value is (0.2, 0.2, 0.2, 1.0)
#GL_DIFFUSE
-
Returns four floating-point values representing the diffuse reflectance of the material. The initial value is (0.8, 0.8, 0.8, 1.0).
#GL_SPECULAR
-
Returns four floating-point values representing the specular reflectance of the material. The initial value is (0, 0, 0, 1).
#GL_EMISSION
-
Returns four floating-point values representing the emitted light intensity of the material. The initial value is (0, 0, 0, 1).
#GL_SHININESS
-
Returns one floating-point value representing the specular exponent of the material. The initial value is 0.
#GL_COLOR_INDEXES
-
Returns three floating-point values representing the ambient, diffuse, and specular indices of the material. These
indices are used only for color index lighting. (All the other parameters are used only for RGBA lighting.)
Please consult an OpenGL reference manual for more information.
- Inputs
-
- 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 (see above for possible values)
- Results
-
- paramsArray
- table containing the requested data
- Errors
-
#GL_INVALID_ENUM
is generated if face
or pname
is not an accepted value.
#GL_INVALID_OPERATION
is generated if gl.GetMaterial()
is executed between the execution of gl.Begin() and the corresponding execution of gl.End() .