NAME
glGetTexLevelParameterfv, glGetTexLevelParameteriv
- return texture parameter values for a specific level of detail
C SPECIFICATION
void ggllGGeettTTeexxLLeevveellPPaarraammeetteerrffvv(
GLenum _t_a_r_g_e_t,
GLint _l_e_v_e_l,
GLenum _p_n_a_m_e,
GLfloat _*_p_a_r_a_m_s )
void ggllGGeettTTeexxLLeevveellPPaarraammeetteerriivv(
GLenum _t_a_r_g_e_t,
GLint _l_e_v_e_l,
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,
either GGLL__TTEEXXTTUURREE__11DD, GGLL__TTEEXXTTUURREE__22DD, GGLL__TTEEXXTTUURREE__33DD,
GGLL__PPRROOXXYY__TTEEXXTTUURREE__11DD, GGLL__PPRROOXXYY__TTEEXXTTUURREE__22DD, or
GGLL__PPRROOXXYY__TTEEXXTTUURREE__33DD.
-
_l_e_v_e_l
-
Specifies the level-of-detail number of the desired image.
Level 0 is the base image level.
Level $n$ is the $n$th mipmap reduction image.
-
_p_n_a_m_e
-
Specifies the symbolic name of a texture parameter.
GGLL__TTEEXXTTUURREE__WWIIDDTTHH,
GGLL__TTEEXXTTUURREE__HHEEIIGGHHTT,
GGLL__TTEEXXTTUURREE__DDEEPPTTHH,
GGLL__TTEEXXTTUURREE__IINNTTEERRNNAALL__FFOORRMMAATT,
GGLL__TTEEXXTTUURREE__BBOORRDDEERR,
GGLL__TTEEXXTTUURREE__RREEDD__SSIIZZEE,
GGLL__TTEEXXTTUURREE__GGRREEEENN__SSIIZZEE,
GGLL__TTEEXXTTUURREE__BBLLUUEE__SSIIZZEE,
GGLL__TTEEXXTTUURREE__AALLPPHHAA__SSIIZZEE,
GGLL__TTEEXXTTUURREE__LLUUMMIINNAANNCCEE__SSIIZZEE, and
GGLL__TTEEXXTTUURREE__IINNTTEENNSSIITTYY__SSIIZZEE are accepted.
-
_p_a_r_a_m_s
-
Returns the requested data.
DESCRIPTION
ggllGGeettTTeexxLLeevveellPPaarraammeetteerr returns in _p_a_r_a_m_s texture parameter values for a specific
level-of-detail value,
specified as _l_e_v_e_l.
_t_a_r_g_e_t defines the target texture,
either GGLL__TTEEXXTTUURREE__11DD, GGLL__TTEEXXTTUURREE__22DD, GGLL__TTEEXXTTUURREE__33DD,
GGLL__PPRROOXXYY__TTEEXXTTUURREE__11DD,
GGLL__PPRROOXXYY__TTEEXXTTUURREE__22DD, or
GGLL__PPRROOXXYY__TTEEXXTTUURREE__33DD.
GGLL__MMAAXX__TTEEXXTTUURREE__SSIIZZEE, and GGLL__MMAAXX__33DD__TTEEXXTTUURREE__SSIIZZEE are not really
descriptive enough.
It has to report the largest square texture image that can be
accommodated with mipmaps and borders,
but a long skinny texture, or a texture without mipmaps and borders, may
easily fit in texture memory.
The proxy targets allow the user to more accurately query
whether the GL can accommodate a texture of a given configuration.
If the texture cannot be accommodated, the texture state variables, which
may be queried with ggllGGeettTTeexxLLeevveellPPaarraammeetteerr, are set to 0. If the texture can be accommodated,
the texture state values will be set as they would be set for a
non-proxy target.
_p_n_a_m_e specifies the texture parameter whose value or values
will be returned.
The accepted parameter names are as follows:
-
GGLL__TTEEXXTTUURREE__WWIIDDTTHH
-
_p_a_r_a_m_s returns a single value,
the width of the texture image.
This value includes the border of the texture image. The initial value is
0.
-
GGLL__TTEEXXTTUURREE__HHEEIIGGHHTT
-
_p_a_r_a_m_s returns a single value,
the height of the texture image.
This value includes the border of the texture image. The initial value is
0.
-
GGLL__TTEEXXTTUURREE__DDEEPPTTHH
-
_p_a_r_a_m_s returns a single value,
the depth of the texture image.
This value includes the border of the texture image. The initial value is
0.
-
GGLL__TTEEXXTTUURREE__IINNTTEERRNNAALL__FFOORRMMAATT
-
_p_a_r_a_m_s returns a single value,
the internal of the texture image.
-
GGLL__TTEEXXTTUURREE__BBOORRDDEERR
-
_p_a_r_a_m_s returns a single value,
the width in pixels of the border of the texture image. The initial value
is 0.
-
GGLL__TTEEXXTTUURREE__RREEDD__SSIIZZEE,
-
-
GGLL__TTEEXXTTUURREE__GGRREEEENN__SSIIZZEE,
-
-
GGLL__TTEEXXTTUURREE__BBLLUUEE__SSIIZZEE,
-
-
GGLL__TTEEXXTTUURREE__AALLPPHHAA__SSIIZZEE,
-
-
GGLL__TTEEXXTTUURREE__LLUUMMIINNAANNCCEE__SSIIZZEE,
-
-
GGLL__TTEEXXTTUURREE__IINNTTEENNSSIITTYY__SSIIZZEE
-
The internal storage resolution of an individual component.
The resolution chosen by the GL will be a close match for the resolution
requested by the user with the component argument of ggllTTeexxIImmaaggee11DD,
ggllTTeexxIImmaaggee22DD, ggllTTeexxIImmaaggee33DD, ggllCCooppyyTTeexxIImmaaggee11DD, and
ggllCCooppyyTTeexxIImmaaggee22DD. The initial value is 0.
NOTES
If an error is generated,
no change is made to the contents of _p_a_r_a_m_s.
GGLL__TTEEXXTTUURREE__IINNTTEERRNNAALL__FFOORRMMAATT is available only if the GL version is
1.1 or greater. In version 1.0, use GGLL__TTEEXXTTUURREE__CCOOMMPPOONNEENNTTSS
instead.
GGLL__PPRROOXXYY__TTEEXXTTUURREE__11DD and GGLL__PPRROOXXYY__TTEEXXTTUURREE__22DD are
available only if the GL version is 1.1 or greater.
GGLL__TTEEXXTTUURREE__33DD, GGLL__PPRROOXXYY__TTEEXXTTUURREE__33DD, and GGLL__TTEEXXTTUURREE__DDEEPPTTHH
are available only if the GL version is 1.2 or greater.
When the GGLL__AARRBB__mmuullttiitteexxttuurree extension is supported, ggllGGeettTTeexxLLeevveellPPaarraammeetteerr returns
the texture level 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__VVAALLUUEE is generated if _l_e_v_e_l is less than 0.
GGLL__IINNVVAALLIIDD__VVAALLUUEE may be generated if _l_e_v_e_l is greater
than $ log sub 2$ _m_a_x,
where _m_a_x is the returned value of GGLL__MMAAXX__TTEEXXTTUURREE__SSIIZZEE.
GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllGGeettTTeexxLLeevveellPPaarraammeetteerr
is executed between the execution of ggllBBeeggiinn
and the corresponding execution of ggllEEnndd.
SEE ALSO
ggllAAccttiivveeTTeexxttuurreeAARRBB((33GG)),
ggllGGeettTTeexxPPaarraammeetteerr((33GG)),
ggllCCooppyyTTeexxIImmaaggee11DD((33GG)),
ggllCCooppyyTTeexxIImmaaggee22DD((33GG)),
ggllCCooppyyTTeexxSSuubbIImmaaggee11DD((33GG)),
ggllCCooppyyTTeexxSSuubbIImmaaggee22DD((33GG)),
ggllCCooppyyTTeexxSSuubbIImmaaggee33DD((33GG)),
ggllTTeexxEEnnvv((33GG)),
ggllTTeexxGGeenn((33GG)),
ggllTTeexxIImmaaggee11DD((33GG)),
ggllTTeexxIImmaaggee22DD((33GG)),
ggllTTeexxIImmaaggee33DD((33GG)),
ggllTTeexxSSuubbIImmaaggee11DD((33GG)),
ggllTTeexxSSuubbIImmaaggee22DD((33GG)),
ggllTTeexxSSuubbIImmaaggee33DD((33GG)),
ggllTTeexxPPaarraammeetteerr((33GG))