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.
params
Returns 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_LOD
Returns the single-valued texture maximum level-of-detail value. The initial value is 1000.
GL_TEXTURE_BASE_LEVEL
Returns the single-valued base texture mipmap level. The initial value is 0.
GL_TEXTURE_MAX_LEVEL
Returns 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_PRIORITY
Returns 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_MIPMAP
Returns 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/.