glGetTexParameter — return texture parameter values
void glGetTexParameterfv( | GLenum | target, |
| GLenum | pname, | |
| GLfloat * | params); |
void glGetTexParameteriv( | GLenum | target, |
| GLenum | pname, | |
| GLint * | params); |
target
Specifies the symbolic name of the target texture.
GL_TEXTURE_1D,
GL_TEXTURE_2D,
GL_TEXTURE_3D, and
GL_TEXTURE_CUBE_MAP
are accepted.
pname
Specifies the symbolic name of a texture parameter.
GL_TEXTURE_MAG_FILTER,
GL_TEXTURE_MIN_FILTER,
GL_TEXTURE_MIN_LOD,
GL_TEXTURE_MAX_LOD,
GL_TEXTURE_BASE_LEVEL,
GL_TEXTURE_MAX_LEVEL,
GL_TEXTURE_WRAP_S,
GL_TEXTURE_WRAP_T,
GL_TEXTURE_WRAP_R,
GL_TEXTURE_BORDER_COLOR,
GL_TEXTURE_PRIORITY,
GL_TEXTURE_RESIDENT,
GL_TEXTURE_COMPARE_MODE,
GL_TEXTURE_COMPARE_FUNC,
GL_DEPTH_TEXTURE_MODE, and
GL_GENERATE_MIPMAP
are accepted.
paramsReturns the texture parameters.
glGetTexParameter returns in params the value or values of the texture parameter
specified as pname.
target defines the target texture,
either GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, or GL_TEXTURE_CUBE_MAP,
to specify one-, two-, or three-dimensional or cube-mapped texturing.
pname accepts the same symbols as glTexParameter,
with the same interpretations:
GL_TEXTURE_MAG_FILTER
Returns the single-valued texture magnification filter,
a symbolic constant. The initial value is GL_LINEAR.
GL_TEXTURE_MIN_FILTER
Returns the single-valued texture minification filter,
a symbolic constant. The initial value is GL_NEAREST_MIPMAP_LINEAR.
GL_TEXTURE_MIN_LOD
Returns the single-valued texture minimum level-of-detail value. The
initial value is
GL_TEXTURE_MAX_LODReturns the single-valued texture maximum level-of-detail value. The initial value is 1000.
GL_TEXTURE_BASE_LEVELReturns the single-valued base texture mipmap level. The initial value is 0.
GL_TEXTURE_MAX_LEVELReturns the single-valued maximum texture mipmap array level. The initial value is 1000.
GL_TEXTURE_WRAP_S
Returns the single-valued wrapping function for texture coordinate
GL_REPEAT.
GL_TEXTURE_WRAP_T
Returns the single-valued wrapping function for texture coordinate
GL_REPEAT.
GL_TEXTURE_WRAP_R
Returns the single-valued wrapping function for texture coordinate
GL_REPEAT.
GL_TEXTURE_BORDER_COLOR
Returns four integer or floating-point numbers that comprise the RGBA color
of the texture border.
Floating-point values are returned in the range
GL_TEXTURE_PRIORITYReturns the residence priority of the target texture (or the named texture bound to it). The initial value is 1. See glPrioritizeTextures.
GL_TEXTURE_RESIDENT
Returns the residence status of the target texture.
If the value returned in params is GL_TRUE, the texture is
resident in texture memory.
See glAreTexturesResident.
GL_TEXTURE_COMPARE_MODE
Returns a single-valued texture comparison mode, a symbolic constant. The
initial value is GL_NONE. See glTexParameter.
GL_TEXTURE_COMPARE_FUNC
Returns a single-valued texture comparison function, a symbolic constant. The
initial value is GL_LEQUAL. See glTexParameter.
GL_DEPTH_TEXTURE_MODE
Returns a single-valued texture format indicating how the depth values
should be converted into color components. The initial value is
GL_LUMINANCE. See glTexParameter.
GL_GENERATE_MIPMAPReturns a single boolean value indicating if automatic mipmap level updates are enabled. See glTexParameter.
GL_TEXTURE_PRIORITY and GL_TEXTURE_RESIDENT are
available only if the GL version is 1.1 or greater.
GL_TEXTURE_3D,
GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL,
GL_TEXTURE_MAX_LEVEL, and GL_TEXTURE_WRAP_R are available only
if the GL version is 1.2 or greater.
GL_TEXTURE_COMPARE_MODE, GL_TEXTURE_COMPARE_FUNC, and
GL_GENERATE_MIPMAP is available only if the GL version is 1.4 or
greater.
If an error is generated,
no change is made to the contents of params.
GL_INVALID_ENUM is generated if target or pname is not an
accepted value.
GL_INVALID_OPERATION is generated if glGetTexParameter
is executed between the execution of glBegin
and the corresponding execution of glEnd.
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.