NAME
glGetTexEnvfv, glGetTexEnviv
- return texture environment parameters
C SPECIFICATION
void ggllGGeettTTeexxEEnnvvffvv(
GLenum _t_a_r_g_e_t,
GLenum _p_n_a_m_e,
GLfloat _*_p_a_r_a_m_s )
void ggllGGeettTTeexxEEnnvviivv(
GLenum _t_a_r_g_e_t,
GLenum _p_n_a_m_e,
GLint _*_p_a_r_a_m_s )
PARAMETERS
-
_t_a_r_g_e_t
-
Specifies a texture environment.
Must be GGLL__TTEEXXTTUURREE__EENNVV.
-
_p_n_a_m_e
-
Specifies the symbolic name of a texture environment parameter.
Accepted values are GGLL__TTEEXXTTUURREE__EENNVV__MMOODDEE and GGLL__TTEEXXTTUURREE__EENNVV__CCOOLLOORR.
-
_p_a_r_a_m_s
-
Returns the requested data.
DESCRIPTION
ggllGGeettTTeexxEEnnvv returns in _p_a_r_a_m_s selected values of a texture environment that
was specified with ggllTTeexxEEnnvv.
_t_a_r_g_e_t specifies a texture environment.
Currently, only one texture environment is defined and supported:
GGLL__TTEEXXTTUURREE__EENNVV.
_p_n_a_m_e names a specific texture environment parameter, as follows:
-
GGLL__TTEEXXTTUURREE__EENNVV__MMOODDEE
-
_p_a_r_a_m_s returns the single-valued texture environment mode,
a symbolic constant. The initial value is GGLL__MMOODDUULLAATTEE.
-
GGLL__TTEEXXTTUURREE__EENNVV__CCOOLLOORR
-
_p_a_r_a_m_s returns four integer or floating-point values that are the
texture environment color.
Integer values,
when requested,
are linearly mapped from the internal floating-point representation
such that 1.0 maps to the most positive representable integer,
and -1.0 maps to the most negative representable integer. The initial
value is (0, 0, 0, 0).
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, ggllGGeettTTeexxEEnnvv returns
the texture environment parameters for the active texture unit.
ERRORS
GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _t_a_r_g_e_t or _p_n_a_m_e is not an
accepted value.
GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllGGeettTTeexxEEnnvv
is executed between the execution of ggllBBeeggiinn
and the corresponding execution of ggllEEnndd.
SEE ALSO
ggllAAccttiivveeTTeexxttuurreeAARRBB((33GG)),
ggllTTeexxEEnnvv((33GG))