NAME
glGetTexGendv, glGetTexGenfv, glGetTexGeniv
- return texture coordinate generation parameters
C SPECIFICATION
void ggllGGeettTTeexxGGeennddvv(
GLenum _c_o_o_r_d,
GLenum _p_n_a_m_e,
GLdouble _*_p_a_r_a_m_s )
void ggllGGeettTTeexxGGeennffvv(
GLenum _c_o_o_r_d,
GLenum _p_n_a_m_e,
GLfloat _*_p_a_r_a_m_s )
void ggllGGeettTTeexxGGeenniivv(
GLenum _c_o_o_r_d,
GLenum _p_n_a_m_e,
GLint _*_p_a_r_a_m_s )
delim $$
PARAMETERS
-
_c_o_o_r_d
-
Specifies a texture coordinate.
Must be
GGLL__SS,
GGLL__TT,
GGLL__RR, or
GGLL__QQ.
-
_p_n_a_m_e
-
Specifies the symbolic name of the value(s) to be returned.
Must be either GGLL__TTEEXXTTUURREE__GGEENN__MMOODDEE
or the name of one of the texture generation plane equations:
GGLL__OOBBJJEECCTT__PPLLAANNEE or GGLL__EEYYEE__PPLLAANNEE.
-
_p_a_r_a_m_s
-
Returns the requested data.
DESCRIPTION
ggllGGeettTTeexxGGeenn returns in _p_a_r_a_m_s selected parameters of a texture coordinate
generation function that was specified using ggllTTeexxGGeenn.
_c_o_o_r_d names one of the (_s, _t, _r, _q)
texture coordinates,
using the symbolic constant
GGLL__SS,
GGLL__TT,
GGLL__RR, or
GGLL__QQ.
_p_n_a_m_e specifies one of three symbolic names:
-
GGLL__TTEEXXTTUURREE__GGEENN__MMOODDEE
-
_p_a_r_a_m_s returns the single-valued texture generation function,
a symbolic constant. The initial value is GGLL__EEYYEE__LLIINNEEAARR.
-
GGLL__OOBBJJEECCTT__PPLLAANNEE
-
_p_a_r_a_m_s 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.
-
GGLL__EEYYEE__PPLLAANNEE
-
_p_a_r_a_m_s returns the four plane equation coefficients that specify
eye linear-coordinate 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 ggllTTeexxGGeenn,
unless the modelview matrix was identity when ggllTTeexxGGeenn was called.
NOTES
If an error is generated,
no change is made to the contents of _p_a_r_a_m_s.
When the GGLL__AARRBB__mmuullttiitteexxttuurree extension is supported, ggllGGeettTTeexxGGeenn returns
the texture coordinate generation parameters for the active texture unit.
ERRORS
GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _c_o_o_r_d or _p_n_a_m_e is not an
accepted value.
GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllGGeettTTeexxGGeenn
is executed between the execution of ggllBBeeggiinn
and the corresponding execution of ggllEEnndd.
SEE ALSO
ggllAAccttiivveeTTeexxttuurreeAARRBB((33GG)),
ggllTTeexxGGeenn((33GG))