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))