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_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, and GL_TEXTURE_CUBE_MAP are accepted.
pname Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, GL_TEXTURE_WRAP_R, GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_PRIORITY, GL_TEXTURE_RESIDENT, GL_TEXTURE_COMPARE_MODE, GL_TEXTURE_COMPARE_FUNC, GL_DEPTH_TEXTURE_MODE, and GL_GENERATE_MIPMAP are accepted.
paramsReturns the texture parameters.
glGetTexParameter returns in params the value or values of the texture parameter specified as pname. target defines the target texture, either GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, or GL_TEXTURE_CUBE_MAP, to specify one-, two-, or three-dimensional or cube-mapped texturing. pname accepts the same symbols as glTexParameter, with the same interpretations:
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_LODReturns the single-valued texture minimum level-of-detail value. The initial value is .
GL_TEXTURE_MAX_LODReturns the single-valued texture maximum level-of-detail value. The initial value is 1000.
GL_TEXTURE_BASE_LEVELReturns the single-valued base texture mipmap level. The initial value is 0.
GL_TEXTURE_MAX_LEVELReturns the single-valued maximum texture mipmap array level. The initial value is 1000.
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_COLORReturns 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).
GL_TEXTURE_PRIORITYReturns the residence priority of the target texture (or the named texture bound to it). The initial value is 1. See glPrioritizeTextures.
GL_TEXTURE_RESIDENT Returns the residence status of the target texture. If the value returned in params is GL_TRUE, the texture is resident in texture memory. See glAreTexturesResident.
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_DEPTH_TEXTURE_MODE Returns a single-valued texture format indicating how the depth values should be converted into color components. The initial value is GL_LUMINANCE. See glTexParameter.
GL_GENERATE_MIPMAPReturns a single boolean value indicating if automatic mipmap level updates are enabled. See glTexParameter.
GL_TEXTURE_PRIORITY and GL_TEXTURE_RESIDENT are available only if the GL version is 1.1 or greater.
GL_TEXTURE_3D, GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, and GL_TEXTURE_WRAP_R are available only if the GL version is 1.2 or greater.
GL_TEXTURE_COMPARE_MODE, GL_TEXTURE_COMPARE_FUNC, and GL_GENERATE_MIPMAP is available only if the GL version is 1.4 or greater.
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.
GL_INVALID_OPERATION is generated if glGetTexParameter is executed between the execution of glBegin and the corresponding execution of glEnd.
Copyright © 1991-2006 Silicon Graphics, Inc. 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/.