GLGETTEXPARAMETER()MachTen Programmer’s ManualGLGETTEXPARAMETER()

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 and GL_TEXTURE_2D are accepted.

pname Specifies the symbolic name of a texture parame-
ter. 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.

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 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 magnifi-
cation filter, a sym-
bolic constant. The
initial value is
GL_LINEAR.

GL_TEXTURE_MIN_FILTER Returns the single-
valued texture minifi-
cation filter, a sym-
bolic constant. The
initial value is
GL_NEAREST_MIPMAP_LINEAR.

GL_TEXTURE_WRAP_S Returns the single-
valued wrapping func-
tion for texture coor-
dinate $s$, a symbolic
constant. The initial
value is GL_REPEAT.

GL_TEXTURE_WRAP_T Returns the single-
valued wrapping func-
tion for texture
coordinate $t$, a sym-
bolic 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 repre-
sentation such that 1.0
maps to the most posi-
tive 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 glPrioritizeTex-
tures.

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 glAreTex-
turesResident.

NOTES
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 con-
tents 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 corre-
sponding execution of glEnd.

SEE ALSO
glAreTexturesResident, glPrioritizeTextures, glTexParame-
ter

MachTen 2