NAME

glGetTexParameterfv, glGetTexParameteriv - return texture parameter values

C SPECIFICATION

void ggllGGeettTTeexxPPaarraammeetteerrffvv( GLenum _t_a_r_g_e_t,
                          GLenum _p_n_a_m_e,
                          GLfloat _*_p_a_r_a_m_s )
void ggllGGeettTTeexxPPaarraammeetteerriivv( GLenum _t_a_r_g_e_t,
                          GLenum _p_n_a_m_e,
                          GLint _*_p_a_r_a_m_s )

delim $$

PARAMETERS

_t_a_r_g_e_t
Specifies the symbolic name of the target texture. GGLL__TTEEXXTTUURREE__11DD,GGLL__TTEEXXTTUURREE__22DD, and GGLL__TTEEXXTTUURREE__33DD are accepted.
_p_n_a_m_e
Specifies the symbolic name of a texture parameter. GGLL__TTEEXXTTUURREE__MMAAGG__FFIILLTTEERR, GGLL__TTEEXXTTUURREE__MMIINN__FFIILLTTEERR, GGLL__TTEEXXTTUURREE__MMIINN__LLOODD, GGLL__TTEEXXTTUURREE__MMAAXX__LLOODD, GGLL__TTEEXXTTUURREE__BBAASSEE__LLEEVVEELL, GGLL__TTEEXXTTUURREE__MMAAXX__LLEEVVEELL, GGLL__TTEEXXTTUURREE__WWRRAAPP__SS, GGLL__TTEEXXTTUURREE__WWRRAAPP__TT, GGLL__TTEEXXTTUURREE__WWRRAAPP__RR, GGLL__TTEEXXTTUURREE__BBOORRDDEERR__CCOOLLOORR, GGLL__TTEEXXTTUURREE__PPRRIIOORRIITTYY, and GGLL__TTEEXXTTUURREE__RREESSIIDDEENNTT are accepted.
_p_a_r_a_m_s
Returns the texture parameters.

DESCRIPTION

ggllGGeettTTeexxPPaarraammeetteerr returns in _p_a_r_a_m_s the value or values of the texture parameter specified as _p_n_a_m_e. _t_a_r_g_e_t defines the target texture, either GGLL__TTEEXXTTUURREE__11DD, GGLL__TTEEXXTTUURREE__22DD, or GGLL__TTEEXXTTUURREE__33DD to specify one-, two-, or three-dimensional texturing. _p_n_a_m_e accepts the same symbols as ggllTTeexxPPaarraammeetteerr, with the same interpretations:
GGLL__TTEEXXTTUURREE__MMAAGG__FFIILLTTEERR
Returns the single-valued texture magnification filter, a symbolic constant. The initial value is GGLL__LLIINNEEAARR.
GGLL__TTEEXXTTUURREE__MMIINN__FFIILLTTEERR
Returns the single-valued texture minification filter, a symbolic constant. The initial value is GGLL__NNEEAARREESSTT__MMIIPPMMAAPP__LLIINNEEAARR.
GGLL__TTEEXXTTUURREE__MMIINN__LLOODD
Returns the single-valued texture minimum level-of-detail value. The initial value is $-1000$.
GGLL__TTEEXXTTUURREE__MMAAXX__LLOODD
Returns the single-valued texture maximum level-of-detail value. The initial value is 1000.
GGLL__TTEEXXTTUURREE__BBAASSEE__LLEEVVEELL
Returns the single-valued base texture mipmap level. The initial value is 0.
GGLL__TTEEXXTTUURREE__MMAAXX__LLEEVVEELL
Returns the single-valued maximum texture mipmap array level. The initial value is 1000.
GGLL__TTEEXXTTUURREE__WWRRAAPP__SS
Returns the single-valued wrapping function for texture coordinate $s$, a symbolic constant. The initial value is GGLL__RREEPPEEAATT.
GGLL__TTEEXXTTUURREE__WWRRAAPP__TT
Returns the single-valued wrapping function for texture coordinate $t$, a symbolic constant. The initial value is GGLL__RREEPPEEAATT.
GGLL__TTEEXXTTUURREE__WWRRAAPP__RR
Returns the single-valued wrapping function for texture coordinate $r$, a symbolic constant. The initial value is GGLL__RREEPPEEAATT.
GGLL__TTEEXXTTUURREE__BBOORRDDEERR__CCOOLLOORR
Returns four integer or floating-point numbers that comprise the RGBA color of the texture border. Floating-point values are returned in the range [0, 1]. Integer values are returned as a linear mapping of 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).
GGLL__TTEEXXTTUURREE__PPRRIIOORRIITTYY
Returns the residence priority of the target texture (or the named texture bound to it). The initial value is 1. See ggllPPrriioorriittiizzeeTTeexxttuurreess.
GGLL__TTEEXXTTUURREE__RREESSIIDDEENNTT
Returns the residence status of the target texture. If the value returned in _p_a_r_a_m_s is GGLL__TTRRUUEE, the texture is resident in texture memory. See ggllAArreeTTeexxttuurreessRReessiiddeenntt.

NOTES

GGLL__TTEEXXTTUURREE__PPRRIIOORRIITTYY and GGLL__TTEEXXTTUURREE__RREESSIIDDEENNTT are available only if the GL version is 1.1 or greater.

GGLL__TTEEXXTTUURREE__33DD, GGLL__TTEEXXTTUURREE__MMIINN__LLOODD, GGLL__TTEEXXTTUURREE__MMAAXX__LLOODD, GGLL__TTEEXXTTUURREE__BBAASSEE__LLEEVVEELL, GGLL__TTEEXXTTUURREE__MMAAXX__LLEEVVEELL, and GGLL__TTEEXXTTUURREE__WWRRAAPP__RR are available only if the GL version is 1.2 or greater.

If an error is generated, no change is made to the contents of _p_a_r_a_m_s.

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 ggllGGeettTTeexxPPaarraammeetteerr is executed between the execution of ggllBBeeggiinn and the corresponding execution of ggllEEnndd.

SEE ALSO

ggllAArreeTTeexxttuurreessRReessiiddeenntt((33GG)), ggllPPrriioorriittiizzeeTTeexxttuurreess((33GG)), ggllTTeexxPPaarraammeetteerr((33GG))