HP c3700 - Workstation, Reference Manual, Page: 219 / 486

G
glGetTexLevelParameter
Chapter 7
219
glGetTexLevelParameter
glGetTexLevelParameterfv, glGetTexLevelParameteriv
: return texture
parameter values for a specific level of detail.
C Specification
void glGetTexLevelParameterfv(
GLenum target,
GLint level,
GLenum pname
GLfloat *params)
void glGetTexLevelParameteriv(
GLenum target,
GLint level,
GLenum pname,
GLint *params)
Parameters
target Specifies the symbolic name of the target texture, either
GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D,
or GL_PROXY_TEXTURE_2D.
level Specifies the level-of-detail number of the desired image. Level 0 is the
base image level. Level n is the nth mipmap reduction image.
pname Specifies the symbolic name of a texture parameter.
GL_TEXTURE_WIDTH, GL_TEXTURE_HEIGHT,
GL_TEXTURE_INTERNAL_FORMAT, GL_TEXTURE_BORDER,
GL_TEXTURE_RED_SIZE,
GL_TEXTURE_GREEN_SIZE,GL_TEXTURE_BLUE_SIZE,
GL_TEXTURE_ALPHA_SIZE, GL_TEXTURE_LUMINANCE_SIZE,
and GL_TEXTURE_INTENSITY_SIZE are accepted.
params Returns the requested data.
Description
glGetTexLevelParameter returns in params texture parameter values for a specific
level-of-detail value, specified as level. target defines the target texture, either
GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D, or
GL_PROXY_TEXTURE_2D.
GL_MAX_TEXTURE_SIZE is 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 glGetTexLevelParameter, 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.