GLGETEXGEN(3G) GLGETEXGEN(3G)
NAME
glGetTexGendv,, glGetTexGenfv,, glGetTexGeniv - return texture coordinate
generation parameters
C SPECIFICATION
void glGetTexGendv( GLenum coord,
GLenum pname,
GLdouble *params )
void glGetTexGenfv( GLenum coord,
GLenum pname,
GLfloat *params )
void glGetTexGeniv( GLenum coord,
GLenum pname,
GLint *params )
PARAMETERS
coord Specifies a texture coordinate. Must be GLS, GLT, GLR, or
GLQ.
pname Specifies the symbolic name of the value(s) to be returned.
Must be either GLTEXTUREGENMODE or the name of one of the
texture generation plane equations: GLOBJECTPLANE or
GLEYEPLANE.
params Returns the requested data.
DESCRIPTION
glGetTexGen returns in params selected parameters of a texture coordi-
nate generation function that was specified using glTexGen. coord
names one of the (s, t, r, q) texture coordinates, using the symbolic
constant GLS, GLT, GLR, or GLQ.
pname specifies one of three symbolic names:
GLTEXTUREGENMODE params returns the single-valued texture
generation function, a symbolic constant.
The initial value is GLEYELINEAR.
GLOBJECTPLANE params returns the four plane equation
coefficients that specify object linear-
coordinate generation. Integer values,
when requested, are mapped directly from
the internal floating-point representation.
GLEYEPLANE params returns the four plane equation
coefficients that specify eye linear-coor-
dinate generation. Integer values, when
requested, are mapped directly from the
internal floating-point representation.
The returned values are those maintained in
eye coordinates. They are not equal to the
values specified using glTexGen, unless the
modelview matrix was identity when glTexGen
was called.
NOTES
If an error is generated, no change is made to the contents of params.
When the GLARBmultitexture extension is supported, glGetTexGen
returns the texture coordinate generation parameters for the active
texture unit.
ERORS
GLINVALIDENUM is generated if coord or pname is not an accepted
value.
GLINVALIDOPERATION is generated if glGetTexGen is executed between
the execution of glBegin and the corresponding execution of glEnd.
SEE ALSO
glActiveTextureARB, glTexGen
GLGETEXGEN(3G)
|