GLGETEXPARAMETER(3G) GLGETEXPARAMETER(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.
GLTEXTURE1D,GLTEXTURE2D, and GLTEXTURE3D are accepted.
pname Specifies the symbolic name of a texture parameter.
GLTEXTUREMAGFILTER, GLTEXTUREMINFILTER,
GLTEXTUREMINLOD, GLTEXTUREMAXLOD, GLTEXTUREBASELEVEL,
GLTEXTUREMAXLEVEL, GLTEXTUREWRAPS, GLTEXTUREWRAPT,
GLTEXTUREWRAPR, GLTEXTUREBORDERCOLOR,
GLTEXTUREPRIORITY, and GLTEXTURERESIDENT 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 GLTEXTURE1D, GLTEXTURE2D, or GLTEXTURE3D to specify one-,
two-, or three-dimensional texturing. pname accepts the same symbols
as glTexParameter, with the same interpretations:
GLTEXTUREMAGFILTER Returns the single-valued texture
magnification filter, a symbolic
constant. The initial value is
GLINEAR.
GLTEXTUREMINFILTER Returns the single-valued texture
minification filter, a symbolic con-
stant. The initial value is
GLNEARESTMIPMAPLINEAR.
GLTEXTUREMINLOD Returns the single-valued texture
minimum level-of-detail value. The
initial value is -1000.
GLTEXTUREMAXLOD Returns the single-valued texture
maximum level-of-detail value. The
initial value is 1000.
GLTEXTUREBASELEVEL Returns the single-valued base tex-
ture mipmap level. The initial
value is 0.
GLTEXTUREMAXLEVEL Returns the single-valued maximum
texture mipmap array level. The
initial value is 1000.
GLTEXTUREWRAPS Returns the single-valued wrapping
function for texture coordinate s, a
symbolic constant. The initial value
is GLREPEAT.
GLTEXTUREWRAPT Returns the single-valued wrapping
function for texture coordinate t, a
symbolic constant. The initial value
is GLREPEAT.
GLTEXTUREWRAPR Returns the single-valued wrapping
function for texture coordinate r, a
symbolic constant. The initial value
is GLREPEAT.
GLTEXTUREBORDERCOLOR 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).
GLTEXTUREPRIORITY Returns the residence priority of
the target texture (or the named
texture bound to it). The initial
value is 1. See
glPrioritizeTextures.
GLTEXTURERESIDENT Returns the residence status of the
target texture. If the value
returned in params is GLTRUE, the
texture is resident in texture mem-
ory. See glAreTexturesResident.
NOTES
GLTEXTUREPRIORITY and GLTEXTURERESIDENT are available only if the
GL version is 1.1 or greater.
GLTEXTURE3D, GLTEXTUREMINLOD, GLTEXTUREMAXLOD,
GLTEXTUREBASELEVEL, GLTEXTUREMAXLEVEL, and GLTEXTUREWRAPR 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.
ERORS
GLINVALIDENUM is generated if target or pname is not an accepted
value.
GLINVALIDOPERATION is generated if glGetTexParameter is executed
between the execution of glBegin and the corresponding execution of
glEnd.
SEE ALSO
glAreTexturesResident, glPrioritizeTextures, glTexParameter
GLGETEXPARAMETER(3G)
|
