GLGETTEXGEN(3G)GLGETTEXGEN(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 GL_S, GL_T, GL_R, or
GL_Q.
pname Specifies the symbolic name of the value(s) to be returned.
Must be either GL_TEXTURE_GEN_MODE or the name of one of the
texture generation plane equations: GL_OBJECT_PLANE or
GL_EYE_PLANE.
params Returns the requested data.
DESCRIPTIONglGetTexGen 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 GL_S, GL_T, GL_R, or GL_Q.
pname specifies one of three symbolic names:
GL_TEXTURE_GEN_MODE params returns the single-valued texture
generation function, a symbolic constant.
The initial value is GL_EYE_LINEAR.
GL_OBJECT_PLANE 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.
GL_EYE_PLANE 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 GL_ARB_multitexture extension is supported, glGetTexGen
returns the texture coordinate generation parameters for the active
texture unit.
ERRORS
GL_INVALID_ENUM is generated if coord or pname is not an accepted
value.
GL_INVALID_OPERATION is generated if glGetTexGen is executed between
the execution of glBegin and the corresponding execution of glEnd.
SEE ALSOglActiveTextureARB(3G), glTexGen(3G)GLGETTEXGEN(3G)