GLGETTEXPARAMETER(3G)GLGETTEXPARAMETER(3G)NAME
glGetTexParameterfv, glGetTexParameteriv - return texture parameter
values
C SPECIFICATION
void glGetTexParameterfv( GLenum target,
GLenum pname,
GLfloat *params )
void glGetTexParameteriv( GLenum target,
GLenum pname,
GLint *params )
delim $$
PARAMETERS
target Specifies the symbolic name of the target texture.
GL_TEXTURE_1D,GL_TEXTURE_2D, and GL_TEXTURE_3D 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,
and GL_TEXTURE_RESIDENT are accepted.
params Returns the texture parameters.
DESCRIPTION
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, or GL_TEXTURE_3D to specify one-,
two-, or three-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_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_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_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.
NOTES
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.
If an error is generated, no change is made to the contents of params.
ERRORS
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.
SEE ALSOglAreTexturesResident(3G), glPrioritizeTextures(3G), glTexParameter(3G)
March 1, 2011
