1991-2006
Silicon Graphics, Inc.
glGetTexParameter
3G
glGetTexParameter
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_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.
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_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
-1000
.
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
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.
Floating-point values are returned in the range
0
1
.
Integer values are returned as a linear mapping of the internal floating-point
representation such that 1.0 maps to the most positive representable
integer and
-1.0
maps to the most negative representable
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 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.
Notes
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.
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.
See Also
glAreTexturesResident,
glPrioritizeTextures,
glTexParameter
Copyright
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/.