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