glGetTexParameter — return texture parameter values
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); |
target Specifies the symbolic name of the target texture. GL_TEXTURE_2D, GL_TEXTURE_2D_ARRAY, GL_TEXTURE_2D_MULTISAMPLE, GL_TEXTURE_2D_MULTISAMPLE_ARRAY, GL_TEXTURE_3D, 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_IMAGE_FORMAT_COMPATIBILITY_TYPE, GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_COMPARE_FUNC, GL_TEXTURE_COMPARE_MODE, GL_TEXTURE_IMMUTABLE_FORMAT, GL_TEXTURE_IMMUTABLE_LEVELS, 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_WRAP_S, GL_TEXTURE_WRAP_T, GL_TEXTURE_WRAP_R, and GL_TEXTURE_BORDER_COLOR are accepted.
params Returns the texture parameters.
glGetTexParameter returns in params the value or values of the texture parameter specified as pname. target defines the target texture. GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_2D_ARRAY, GL_TEXTURE_CUBE_MAP, GL_TEXTURE_CUBE_MAP_ARRAY, GL_TEXTURE_2D_MULTISAMPLE, and GL_TEXTURE_2D_MULTISAMPLE_ARRAY, specify two- or three-dimensional, two-dimensional array, cube-mapped, 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_IMAGE_FORMAT_COMPATIBILITY_TYPE Returns the single-valued image format compatibility matching criteria. This can be one of GL_IMAGE_FORMAT_COMPATIBILITY_BY_CLASS or GL_IMAGE_FORMAT_COMPATIBILITY_BY_SIZE.
GL_TEXTURE_BASE_LEVEL Returns the single-valued base texture mipmap level. The initial value is 0.
GL_TEXTURE_COMPARE_FUNC Returns a single-valued texture comparison function, a symbolic constant. The initial value is GL_LEQUAL. See glTexParameter.
GL_TEXTURE_COMPARE_MODE Returns a single-valued texture comparison mode, a symbolic constant. The initial value is GL_NONE. See glTexParameter.
GL_TEXTURE_IMMUTABLE_FORMAT Returns a single-value boolean representing the immutability of the texture format and size. initial value is GL_FALSE. See glTexStorage2D.
GL_TEXTURE_IMMUTABLE_LEVELS Returns a single-valued number of texture levels in an immutable texture. See glTexStorage2D.
GL_TEXTURE_MAG_FILTER Returns the single-valued texture magnification filter, a symbolic constant. The initial value is GL_LINEAR.
GL_TEXTURE_MAX_LEVEL Returns the single-valued maximum texture mipmap array level. 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_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 .
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_WRAP_S Returns the single-valued wrapping function for texture coordinate , a symbolic constant. The initial value is GL_REPEAT.
GL_TEXTURE_WRAP_T Returns the single-valued wrapping function for texture coordinate , a symbolic constant. The initial value is GL_REPEAT.
GL_TEXTURE_WRAP_R Returns the single-valued wrapping function for texture coordinate , 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 . 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 maps to the most negative representable integer. The initial value is (0, 0, 0, 0).
If an error is generated, no change is made to the contents of params.
GL_INVALID_ENUM is generated if target or pname is not an accepted value.
| OpenGL ES API Version | ||||
|---|---|---|---|---|
| Function Name | 2.0 | 3.0 | 3.1 | 3.2 |
glGetTexParameterfv | ✔ | ✔ | ✔ | ✔ |
glGetTexParameteriv | ✔ | ✔ | ✔ | ✔ |
glGetTexParameterIiv | - | - | - | ✔ |
glGetTexParameterIuiv | - | - | - | ✔ |
Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2015 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see https://khronos.org/registry/OpenGL-Refpages/LICENSES/LicenseRef-FreeB.txt.