GLGETTEXPARAMETER(3gl)GLGETTEXPARAMETER(3gl)NAME
glGetTexParameterfv, glGetTexParameteriv - return texture parameter
values
C SPECIFICATION
void glGetTexParameterfv( GLenum target,
GLenum pname,
GLfloat *params )
void glGetTexParameteriv( GLenum target,
GLenum pname,
GLint *params )
PARAMETERS
target Specifies the symbolic name of the target texture. GL_TEX‐
TURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_CUBE_MAP, and
GL_DETAIL_TEXTURE_2D_SGIS are accepted.
pname Specifies the symbolic name of a texture parameter. GL_TEX‐
TURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_WRAP_S,
GL_TEXTURE_WRAP_T, GL_TEXTURE_WRAP_R, GL_TEXTURE_BORDER_COLOR,
GL_TEXTURE_PRIORITY, GL_TEXTURE_RESIDENT, GL_TEXTURE_MIN_LOD,
GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL, GL_TEX‐
TURE_MAX_LEVEL, GL_TEXTURE_LOD_BIAS_S_SGIX, GL_TEX‐
TURE_LOD_BIAS_T_SGIX, GL_TEXTURE_LOD_BIAS_R_SGIX, GL_POST_TEX‐
TURE_FILTER_SCALE_SGIX, GL_POST_TEXTURE_FILTER_BIAS_SGIX,
GL_DETAIL_TEXTURE_FUNC_POINTS_SGIS, GL_DETAIL_TEX‐
TURE_LEVEL_SGIS, GL_DETAIL_TEXTURE_MODE_SGIS, GL_SHARPEN_TEX‐
TURE_FUNC_POINTS_SGIS, GL_TEXTURE_MAX_ANISOTROPY_EXT, GL_TEX‐
TURE_FILTER4_SIZE_SGIS, and GL_TEXTURE_MEMORY_SIZE_SUN are
accepted.
params Returns the texture parameters.
DESCRIPTION
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_TEX‐
TURE_CUBE_MAP, to specify one- two-, 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 con‐
stant. The initial value is GL_NEAR‐
EST_MIPMAP_LINEAR.
GL_TEXTURE_WRAP_S Returns the single-valued wrapping
function for texture coordinate s, a
symbolic constant. The initial value
is GL_REPEAT.
GL_TEXTURE_WRAP_T Returns the single-valued wrapping
function for texture coordinate t, a
symbolic constant. The initial value
is GL_REPEAT.
GL_TEXTURE_WRAP_R Returns the single-valued wrapping
function for texture coordinate r, a
symbolic constant. The initial value
is GL_REPEAT.
GL_TEXTURE_BORDER_COLOR Returns four integer or floating-
point numbers that comprise the RGBA
color of the texture border. Float‐
ing-point values are returned in the
range [0, 1]. Integer values are
returned as a linear mapping of the
internal floating-point representa‐
tion such that 1.0 maps to the most
positive representable integer and
-1.0 maps to the most negative rep‐
resentable integer. The initial
value is (0, 0, 0, 0).
GL_TEXTURE_PRIORITY Returns the residence priority of
the target texture (or the named
texture bound to it). The initial
value is 1. See glPrioritizeTex‐
tures.
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 mem‐
ory. See glAreTexturesResident.
GL_TEXTURE_MIN_LOD Returns the minimum level-of-detail
number for the target texture. If
the calculated level-of-detail value
is smaller than GL_TEXTURE_MIN_LOD,
it is clamped to GL_TEXTURE_MIN_LOD.
The initial value is 0.
GL_TEXTURE_MAX_LOD Returns the maximum level-of-detail
number for the target texture. If
the calculated level-of-detail value
is larger than GL_TEXTURE_MAX_LOD,
it is clamped to GL_TEXTURE_MAX_LOD.
The initial value is 1000.
GL_TEXTURE_BASE_LEVEL Returns the base level-of-detail
number for the target texture. The
main mipmap for the target texture
is defined at GL_TEXTURE_BASE_LEVEL.
The initial value is 0.
GL_TEXTURE_MAX_LEVEL Returns the maximum level-of-detail
number for the target texture. The
mipmaps for the target texture are
defined through GL_TEX‐
TURE_MAX_LEVEL.
GL_TEXTURE_LOD_BIAS_S_SGIX Returns the bias applied to s in the
level-of-detail calculation. The
initial value is 0.
GL_TEXTURE_LOD_BIAS_T_SGIX Returns the bias applied to t in the
level-of-detail calculation. The
initial value is 0.
GL_TEXTURE_LOD_BIAS_R_SGIX Returns the bias applied to r in the
level-of-detail calculation. The
initial value is 0.
GL_POST_TEXTURE_FILTER_SCALE_SGIX Returns four floating-point values
that comprise the RGBA scale factors
of the texture color in params. The
initial scale values are (1, 1, 1,
1).
GL_POST_TEXTURE_FILTER_BIAS_SGIX Returns four floating-point values
that comprise the RGBA bias values
of the texture color in params. The
initial bias values are (0, 0, 0,
0).
GL_DETAIL_TEXTURE_FUNC_POINTS_SGIS Returns the number of pairs in the
detail texture function.
GL_DETAIL_TEXTURE_LEVEL_SGIS Returns the detail level.
GL_DETAIL_TEXTURE_MODE_SGIS Returns the detail mode either
GL_ADD or GL_MODULATE.
GL_SHARPEN_TEXTURE_FUNC_POINTS_SGIS
Returns the number of pairs in the
sharpen texture function.
GL_TEXTURE_MAX_ANISOTROPY_EXT Returns the current setting of maxi‐
mum degree of anisotropy, which is a
floating-point value. The initial
value for maximum degree of anisot‐
ropy is 1.0.
GL_TEXTURE_FILTER4_SIZE_SGIS Returns an array of one floating-
point value in params, which is the
size of the Fitler4 weight table.
This is an implementation-defined
constant. For more information on
texture Filter4 filtering see glTex‐
FilterFuncSGIS.
GL_TEXTURE_MEMORY_SIZE_SUN Returns the amount of memory (in
terms of bytes) that the texture
object with texture images of base
level through max level consumes.
NOTES
GL_TEXTURE_PRIORITY and GL_TEXTURE_RESIDENT are only available if the
GL version is 1.1 or greater.
If an error is generated, no change is made to the contents of params.
ERRORS
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. GL_INVALID_VALUE is generated if pname is GL_DETAIL_TEX‐
TURE_MODE_SGIS and param is not GL_ADD or GL_MODULATE or params does
not point to GL_ADD or GL_MODULATE.
GL_INVALID_ENUM is generated if glGetTexParameteriv or glGetTexParame‐
terfv parameter <pname> is GL_TEXTURE_FILTER4_SIZE_SGIS and parameter
<target> is not TEXTURE_1D or TEXTURE_2D.
SEE ALSO
glAreTexturesResident, glPrioritizeTextures, glTexParameter
31 May 01 GLGETTEXPARAMETER(3gl)