GLGETTEXPARAMETER(3G)UNIX Programmer's ManuaGLGETTEXPARAMETER(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.
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 con-
stant. 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
MirBSD #10-current Printed 2021-12-07 1
GLGETTEXPARAMETER(3G)UNIX Programmer's ManuaGLGETTEXPARAMETER(3G)
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 ini-
tial 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
MirBSD #10-current Printed 2021-12-07 2
GLGETTEXPARAMETER(3G)UNIX Programmer's ManuaGLGETTEXPARAMETER(3G)
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 tex-
ture. 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 ALSO
glAreTexturesResident(3G), glPrioritizeTextures(3G),
glTexParameter(3G)
MirBSD #10-current Printed 2021-12-07 3