glGetTexParameter man page on Oracle
[printable version]
GLGETTEXPARAMETER(3G) OpenGL Manual GLGETTEXPARAMETER(3G)
NAME
glGetTexParameter - return texture parameter values
C SPECIFICATION
void glGetTexParameterfv(GLenum target, GLenum pname,
GLfloat * params);
void glGetTexParameteriv(GLenum target, GLenum pname, GLint * params);
void glGetTexParameterIiv(GLenum target, GLenum pname, GLint * params);
void glGetTexParameterIuiv(GLenum target, GLenum pname,
GLuint * params);
PARAMETERS
target
Specifies the symbolic name of the target texture. GL_TEXTURE_1D,
GL_TEXTURE_2D, GL_TEXTURE_1D_ARRAY, GL_TEXTURE_2D_ARRAY,
GL_TEXTURE_3D, GL_TEXTURE_RECTANGLE, GL_TEXTURE_CUBE_MAP, and
GL_TEXTURE_CUBE_MAP_ARRAY are accepted.
pname
Specifies the symbolic name of a texture parameter.
GL_DEPTH_STENCIL_TEXTURE_MODE, GL_TEXTURE_BASE_LEVEL,
GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_COMPARE_MODE,
GL_TEXTURE_COMPARE_FUNC, GL_TEXTURE_IMMUTABLE_FORMAT,
GL_TEXTURE_IMMUTABLE_LEVELS, GL_TEXTURE_LOD_BIAS,
GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MAX_LEVEL, GL_TEXTURE_MAX_LOD,
GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MIN_LOD, GL_TEXTURE_SWIZZLE_R,
GL_TEXTURE_SWIZZLE_G, GL_TEXTURE_SWIZZLE_B, GL_TEXTURE_SWIZZLE_A,
GL_TEXTURE_SWIZZLE_RGBA, GL_TEXTURE_VIEW_MIN_LAYER,
GL_TEXTURE_VIEW_MIN_LEVEL, GL_TEXTURE_VIEW_NUM_LAYERS,
GL_TEXTURE_VIEW_NUM_LEVELS, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T,
and GL_TEXTURE_WRAP_R 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.
GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_1D_ARRAY,
GL_TEXTURE_2D_ARRAY, GL_TEXTURE_RECTANGLE, GL_TEXTURE_CUBE_MAP,
GL_TEXTURE_CUBE_MAP_ARRAY specify one-, two-, or three-dimensional,
one-dimensional array, two-dimensional array, rectangle, cube-mapped or
cube-mapped array texturing, respectively. pname accepts the same
symbols as glTexParameter(), with the same interpretations:
GL_DEPTH_STENCIL_TEXTURE_MODE
Returns the single-value depth stencil texture mode, a symbolic
constant. The initial value is GL_DEPTH_COMPONENT.
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_SWIZZLE_R
Returns the red component swizzle. The initial value is GL_RED.
GL_TEXTURE_SWIZZLE_G
Returns the green component swizzle. The initial value is GL_GREEN.
GL_TEXTURE_SWIZZLE_B
Returns the blue component swizzle. The initial value is GL_BLUE.
GL_TEXTURE_SWIZZLE_A
Returns the alpha component swizzle. The initial value is GL_ALPHA.
GL_TEXTURE_SWIZZLE_RGBA
Returns the component swizzle for all channels in a single query.
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_COMPARE_MODE
Returns a single-valued texture comparison mode, a symbolic
constant. The initial value is GL_NONE. See glTexParameter().
GL_TEXTURE_COMPARE_FUNC
Returns a single-valued texture comparison function, a symbolic
constant. The initial value is GL_LEQUAL. See glTexParameter().
GL_TEXTURE_VIEW_MIN_LEVEL
Returns a single-valued base level of a texture view relative to
its parent. The initial value is 0. See glTextureView().
GL_TEXTURE_VIEW_NUM_LEVELS
Returns a single-valued number of levels of detail of a texture
view. See glTextureView().
GL_TEXTURE_VIEW_MIN_LAYER
Returns a single-valued first level of a texture array view
relative to its parent. See glTextureView().
GL_TEXTURE_VIEW_NUM_LAYERS
Returns a single-valued number of layers in a texture array view.
See glTextureView().
GL_TEXTURE_IMMUTABLE_LEVELS
Returns a single-valued number of immutable texture levels in a
texture view. See glTextureView().
In addition to the parameters that may be set with glTexParameter(),
glGetTexParameter accepts the following read-only parameters:
GL_TEXTURE_IMMUTABLE_FORMAT
Returns non-zero if the texture has an immutable format. Textures
become immutable if their storage is specified with
glTexStorage1D(), glTexStorage2D() or glTexStorage3D(). The initial
value is GL_FALSE.
NOTES
If an error is generated, no change is made to the contents of params.
GL_DEPTH_STENCIL_TEXTURE_MODE, GL_TEXTURE_VIEW_MIN_LEVEL,
GL_TEXTURE_VIEW_NUM_LEVELS, GL_TEXTURE_VIEW_MIN_LAYER,
GL_TEXTURE_VIEW_NUM_LAYERS and GL_TEXTURE_IMMUTABLE_LEVELS are
available only if the GL version is 4.3 or greater.
ERRORS
GL_INVALID_ENUM is generated if target or pname is not an accepted
value.
SEE ALSO
glTexParameter(), glTexStorage1D(), glTexStorage2D(), glTexStorage3D(),
glTextureView()
COPYRIGHT
Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2012
Khronos Group. This document is licensed under the SGI Free Software B
License. For details, see http://oss.sgi.com/projects/FreeB/.
AUTHORS
opengl.org
opengl.org 04/29/2014 GLGETTEXPARAMETER(3G)
[top]
List of man pages available for Oracle
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
|
Vote for polarhome
|
