glGetTexParameterfv, glGetTexParameteriv - 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
and GL_TEXTURE_2D are accepted.
- pname
- Specifies the symbolic name of a texture parameter.
GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER,
GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T,
GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_PRIORITY, and
GL_TEXTURE_RESIDENT 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, either GL_TEXTURE_1D or GL_TEXTURE_2D, to specify one-
or two-dimensional 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_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_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_PRIORITY
- Returns 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_PRIORITY and GL_TEXTURE_RESIDENT are only available if
the GL version is 1.1 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.
glAreTexturesResident, glPrioritizeTextures, glTexParameter