Provided by: opengl-4-man-doc_1.0~svn33624-1_all bug

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                                         │
       ├──────────────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
       │Function2.02.13.03.13.23.34.04.14.24.34.44.5 │
       │/                         │     │     │     │     │     │     │     │     │     │     │     │     │
       │Feature                   │     │     │     │     │     │     │     │     │     │     │     │     │
       │Name                      │     │     │     │     │     │     │     │     │     │     │     │     │
       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │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
       http://oss.sgi.com/projects/FreeB/.

COPYRIGHT

       Copyright © 1991-2006 Silicon Graphics, Inc.
       Copyright © 2010-2014 Khronos Group

[FIXME: source]                             01/03/2018                      GLGETTEXPARAMETER(3G)