1991-2006
Silicon Graphics, Inc.
2010-2013
Khronos Group
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
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-2013 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
http://oss.sgi.com/projects/FreeB/.