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