glGetMaterial man page on Oracle

Man page or keyword search:  
man Server   33470 pages
apropos Keyword Search (all sections)
Output format
Oracle logo
[printable version]

GLGETMATERIAL(3G)		 OpenGL Manual		     GLGETMATERIAL(3G)

NAME
       glGetMaterial - 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
	   params returns four integer or floating-point values representing
	   the specular 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, 0, 0, 1).

       GL_EMISSION
	   params returns four integer or floating-point values representing
	   the emitted light intensity 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, 0, 0, 1).

       GL_SHININESS
	   params returns one integer or floating-point value representing the
	   specular exponent of the material. Integer values, when requested,
	   are computed by rounding the internal floating-point value to the
	   nearest integer value. The initial value is 0.

       GL_COLOR_INDEXES
	   params returns three integer or 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.) Integer values, when
	   requested, are computed by rounding the internal floating-point
	   values to the nearest integer values.

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

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

       GL_INVALID_OPERATION is generated if glGetMaterial is executed between
       the execution of glBegin() and the corresponding execution of glEnd().

SEE ALSO
       glMaterial()

COPYRIGHT
       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
       under the SGI Free Software B License. For details, see
       http://oss.sgi.com/projects/FreeB/.

AUTHORS
       opengl.org

opengl.org			  04/29/2014		     GLGETMATERIAL(3G)
[top]

List of man pages available for Oracle

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net