glGetTexParameter — return texture parameter values
void glGetTexParameterfv( | GLenum target, |
| GLenum pname, | |
GLfloat * params); |
void glGetTexParameteriv( | GLenum target, |
| GLenum pname, | |
GLint * params); |
target Specifies the symbolic name of the target texture. GL_TEXTURE_2D, GL_TEXTURE_2D_ARRAY, GL_TEXTURE_3D, and GL_TEXTURE_CUBE_MAP are accepted.
pname Specifies the symbolic name of a texture parameter. GL_DEPTH_STENCIL_TEXTURE_MODE, 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, and GL_TEXTURE_WRAP_R 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, and GL_TEXTURE_CUBE_MAP specify two- or three-dimensional, two-dimensional array, or cube-mapped 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.
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 |
glGetTexParameterfv | ✔ | ✔ | ✔ |
glGetTexParameteriv | ✔ | ✔ | ✔ |
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 https://web.archive.org/web/20171022161616/http://oss.sgi.com/projects/FreeB/.