GLGETTEXPARAMETER
Section: [FIXME: manual] (3G)
Updated: 01/26/2021
Page Index
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);
-
void glGetTextureParameterfv(GLuint texture, GLenum pname, GLfloat *params);
-
void glGetTextureParameteriv(GLuint texture, GLenum pname, GLint *params);
-
void glGetTextureParameterIiv(GLuint texture, GLenum pname, GLint *params);
-
void glGetTextureParameterIuiv(GLuint texture, GLenum pname, GLuint *params);
PARAMETERS
target
-
- Specifies the target to which the texture is bound for
glGetTexParameterfv,
glGetTexParameteriv,
glGetTexParameterIiv, and
glGetTexParameterIuiv
functions.
GL_TEXTURE_1D,
GL_TEXTURE_1D_ARRAY,
GL_TEXTURE_2D,
GL_TEXTURE_2D_ARRAY,
GL_TEXTURE_2D_MULTISAMPLE,
GL_TEXTURE_2D_MULTISAMPLE_ARRAY,
GL_TEXTURE_3D,
GL_TEXTURE_CUBE_MAP,
GL_TEXTURE_RECTANGLE, and
GL_TEXTURE_CUBE_MAP_ARRAY
are accepted.
texture
-
Specifies the texture object name for
glGetTextureParameterfv,
glGetTextureParameteriv,
glGetTextureParameterIiv, and
glGetTextureParameterIuiv
functions.
pname
-
Specifies the symbolic name of a texture parameter.
GL_DEPTH_STENCIL_TEXTURE_MODE,
GL_IMAGE_FORMAT_COMPATIBILITY_TYPE,
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_TARGET,
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
and
glGetTextureParameter
return 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,
GL_TEXTURE_2D_MULTISAMPLE, or
GL_TEXTURE_2D_MULTISAMPLE_ARRAY
specify one-, two-, or three-dimensional, one-dimensional array, two-dimensional array, rectangle, cube-mapped or cube-mapped array, two-dimensional multisample, or two-dimensional multisample 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
and
glGetTextureParameter
accept the following read-only parameters:
GL_IMAGE_FORMAT_COMPATIBILITY_TYPE
-
Returns the matching criteria use for the texture when used as an image texture. Can return
GL_IMAGE_FORMAT_COMPATIBILITY_BY_SIZE,
GL_IMAGE_FORMAT_COMPATIBILITY_BY_CLASS
or
GL_NONE.
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.
GL_TEXTURE_TARGET
-
Returns the effective target of the texture object. For
glGetTex*Parameter
functions, this is the target parameter. For
glGetTextureParameter*, it is the target to which the texture was initially bound when it was created, or the value of the target parameter to the call to
glCreateTextures
which created the texture.
NOTES
If an error is generated, no change is made to the contents of
params.
GL_IMAGE_FORMAT_COMPATIBILITY_TYPE
is available only if the GL version is 4.2 or greater.
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.
GL_TEXTURE_TARGET
are available only if the GL version is 4.5 or greater.
ERRORS
GL_INVALID_ENUM
is generated if
pname
is not an accepted value.
GL_INVALID_ENUM
error is generated by
glGetTexParameter
if the effective
target
is not one of the accepted texture targets.
GL_INVALID_OPERATION
is generated by
glGetTextureParameter*
if
texture
is not the name of an existing texture object.
VERSION SUPPORT
|
|
OpenGL Version
|
|
Function / Feature Name
|
2.0
|
2.1
|
3.0
|
3.1
|
3.2
|
3.3
|
4.0
|
4.1
|
4.2
|
4.3
|
4.4
|
4.5
|
|
glGetTexParameterIiv
|
-
|
-
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
|
glGetTexParameterIuiv
|
-
|
-
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
|
glGetTexParameterfv
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
|
glGetTexParameteriv
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
✔
|
|
glGetTextureParameterIiv
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
✔
|
|
glGetTextureParameterIuiv
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
✔
|
|
glGetTextureParameterfv
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
✔
|
|
glGetTextureParameteriv
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
✔
|
SEE ALSO
glTexParameter(),
glTextureParameter,
glTexStorage1D(),
glTexStorage2D(),
glTexStorage3D(),
glTextureStorage1D,
glTextureStorage2D,
glTextureStorage3D,
glTextureView()
COPYRIGHT
Copyright
©
1991-2006 Silicon Graphics, Inc. Copyright
©
2010-2014 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see
m[blue]http://oss.sgi.com/projects/FreeB/m[].
COPYRIGHT
Copyright © 1991-2006 Silicon Graphics, Inc.
Copyright © 2010-2014 Khronos Group