NAME¶
glGetTexParameter - return texture parameter values
C SPECIFICATION¶
void glGetTexParameterfv(GLenum target,
GLenum pname,
GLfloat * params);
void glGetTexParameteriv(GLenum target,
GLenum pname,
GLint * params);
void
glGetTexParameterIiv(GLenum target,
GLenum pname,
GLint * params);
void
glGetTexParameterIuiv(GLenum target,
GLenum pname,
GLuint * params);
PARAMETERS¶
target
Specifies the symbolic name of the target texture.
GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_1D_ARRAY,
GL_TEXTURE_2D_ARRAY, GL_TEXTURE_3D, GL_TEXTURE_RECTANGLE,
GL_TEXTURE_CUBE_MAP, and GL_TEXTURE_CUBE_MAP_ARRAY are
accepted.
pname
Specifies the symbolic name of a texture parameter.
GL_DEPTH_STENCIL_TEXTURE_MODE, GL_TEXTURE_BASE_LEVEL,
GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_COMPARE_MODE,
GL_TEXTURE_COMPARE_FUNC, GL_TEXTURE_IMMUTABLE_FORMAT,
GL_TEXTURE_IMMUTABLE_LEVELS, GL_TEXTURE_LOD_BIAS,
GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MAX_LEVEL,
GL_TEXTURE_MAX_LOD, GL_TEXTURE_MIN_FILTER,
GL_TEXTURE_MIN_LOD, GL_TEXTURE_SWIZZLE_R,
GL_TEXTURE_SWIZZLE_G, GL_TEXTURE_SWIZZLE_B,
GL_TEXTURE_SWIZZLE_A, GL_TEXTURE_SWIZZLE_RGBA,
GL_TEXTURE_VIEW_MIN_LAYER, GL_TEXTURE_VIEW_MIN_LEVEL,
GL_TEXTURE_VIEW_NUM_LAYERS, GL_TEXTURE_VIEW_NUM_LEVELS,
GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, and
GL_TEXTURE_WRAP_R 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. GL_TEXTURE_1D, GL_TEXTURE_2D,
GL_TEXTURE_3D, GL_TEXTURE_1D_ARRAY,
GL_TEXTURE_2D_ARRAY, GL_TEXTURE_RECTANGLE,
GL_TEXTURE_CUBE_MAP, GL_TEXTURE_CUBE_MAP_ARRAY specify one-,
two-, or three-dimensional, one-dimensional array, two-dimensional array,
rectangle, cube-mapped or cube-mapped array texturing, respectively.
pname accepts the same symbols as glTexParameter(), with the
same interpretations:
GL_DEPTH_STENCIL_TEXTURE_MODE
Returns the single-value depth stencil texture mode, a
symbolic constant. The initial value is GL_DEPTH_COMPONENT.
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_SWIZZLE_R
Returns the red component swizzle. The initial value is
GL_RED.
GL_TEXTURE_SWIZZLE_G
Returns the green component swizzle. The initial value is
GL_GREEN.
GL_TEXTURE_SWIZZLE_B
Returns the blue component swizzle. The initial value is
GL_BLUE.
GL_TEXTURE_SWIZZLE_A
Returns the alpha component swizzle. The initial value is
GL_ALPHA.
GL_TEXTURE_SWIZZLE_RGBA
Returns the component swizzle for all channels in a
single query.
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_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_TEXTURE_VIEW_MIN_LEVEL
Returns a single-valued base level of a texture view
relative to its parent. The initial value is 0. See
glTextureView().
GL_TEXTURE_VIEW_NUM_LEVELS
Returns a single-valued number of levels of detail of a
texture view. See glTextureView().
GL_TEXTURE_VIEW_MIN_LAYER
Returns a single-valued first level of a texture array
view relative to its parent. See glTextureView().
GL_TEXTURE_VIEW_NUM_LAYERS
Returns a single-valued number of layers in a texture
array view. See glTextureView().
GL_TEXTURE_IMMUTABLE_LEVELS
Returns a single-valued number of immutable texture
levels in a texture view. See glTextureView().
In addition to the parameters that may be set with
glTexParameter(), glGetTexParameter accepts the following
read-only parameters:
GL_TEXTURE_IMMUTABLE_FORMAT
Returns non-zero if the texture has an immutable format.
Textures become immutable if their storage is specified with
glTexStorage1D(), glTexStorage2D() or glTexStorage3D().
The initial value is GL_FALSE.
NOTES¶
If an error is generated, no change is made to the contents of
params.
GL_DEPTH_STENCIL_TEXTURE_MODE,
GL_TEXTURE_VIEW_MIN_LEVEL, GL_TEXTURE_VIEW_NUM_LEVELS,
GL_TEXTURE_VIEW_MIN_LAYER, GL_TEXTURE_VIEW_NUM_LAYERS and
GL_TEXTURE_IMMUTABLE_LEVELS are available only if the GL version is
4.3 or greater.
ERRORS¶
GL_INVALID_ENUM is generated if target or
pname is not an accepted value.
SEE ALSO¶
glTexParameter(), glTexStorage1D(),
glTexStorage2D(), glTexStorage3D(), glTextureView()
COPYRIGHT¶
Copyright © 1991-2006 Silicon Graphics, Inc. Copyright
© 2010-2012 Khronos Group. This document is licensed under the SGI
Free Software B License. For details, see
http://oss.sgi.com/projects/FreeB/.