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 )
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.
DESCRIPTIONglGetTexParameter 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 con‐
stant. 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 tex‐
ture 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. Float‐
ing-point values are returned in the
range [0, 1]. Integer values are
returned as a linear mapping of the
internal floating-point representa‐
tion such that 1.0 maps to the most
positive representable integer and
-1.0 maps to the most negative rep‐
resentable 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 mem‐
ory. 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 ALSO
glAreTexturesResident, glPrioritizeTextures, glTexParameter
GLGETTEXPARAMETER(3G)