glGetTexParameteriv(3g)

1GLGETTEXPARAMETER(3G)            OpenGL Manual           GLGETTEXPARAMETER(3G)
2
3
4

NAME

6       glGetTexParameter - return texture parameter values
7

C SPECIFICATION

9       void glGetTexParameterfv(GLenum target, GLenum pname,
10                                GLfloat * params);
11
12       void glGetTexParameteriv(GLenum target, GLenum pname, GLint * params);
13
14       void glGetTexParameterIiv(GLenum target, GLenum pname, GLint * params);
15
16       void glGetTexParameterIuiv(GLenum target, GLenum pname,
17                                  GLuint * params);
18

PARAMETERS

20       target
21           Specifies the symbolic name of the target texture.  GL_TEXTURE_1D,
22           GL_TEXTURE_2D, GL_TEXTURE_1D_ARRAY, GL_TEXTURE_2D_ARRAY,
23           GL_TEXTURE_3D, GL_TEXTURE_RECTANGLE, GL_TEXTURE_CUBE_MAP, and
24           GL_TEXTURE_CUBE_MAP_ARRAY are accepted.
25
26       pname
27           Specifies the symbolic name of a texture parameter.
28           GL_DEPTH_STENCIL_TEXTURE_MODE, GL_TEXTURE_BASE_LEVEL,
29           GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_COMPARE_MODE,
30           GL_TEXTURE_COMPARE_FUNC, GL_TEXTURE_IMMUTABLE_FORMAT,
31           GL_TEXTURE_IMMUTABLE_LEVELS, GL_TEXTURE_LOD_BIAS,
32           GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MAX_LEVEL, GL_TEXTURE_MAX_LOD,
33           GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MIN_LOD, GL_TEXTURE_SWIZZLE_R,
34           GL_TEXTURE_SWIZZLE_G, GL_TEXTURE_SWIZZLE_B, GL_TEXTURE_SWIZZLE_A,
35           GL_TEXTURE_SWIZZLE_RGBA, GL_TEXTURE_VIEW_MIN_LAYER,
36           GL_TEXTURE_VIEW_MIN_LEVEL, GL_TEXTURE_VIEW_NUM_LAYERS,
37           GL_TEXTURE_VIEW_NUM_LEVELS, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T,
38           and GL_TEXTURE_WRAP_R are accepted.
39
40       params
41           Returns the texture parameters.
42

DESCRIPTION

44       glGetTexParameter returns in params the value or values of the texture
45       parameter specified as pname.  target defines the target texture.
46       GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_1D_ARRAY,
47       GL_TEXTURE_2D_ARRAY, GL_TEXTURE_RECTANGLE, GL_TEXTURE_CUBE_MAP,
48       GL_TEXTURE_CUBE_MAP_ARRAY specify one-, two-, or three-dimensional,
49       one-dimensional array, two-dimensional array, rectangle, cube-mapped or
50       cube-mapped array texturing, respectively.  pname accepts the same
51       symbols as glTexParameter(), with the same interpretations:
52
53       GL_DEPTH_STENCIL_TEXTURE_MODE
54           Returns the single-value depth stencil texture mode, a symbolic
55           constant. The initial value is GL_DEPTH_COMPONENT.
56
57       GL_TEXTURE_MAG_FILTER
58           Returns the single-valued texture magnification filter, a symbolic
59           constant. The initial value is GL_LINEAR.
60
61       GL_TEXTURE_MIN_FILTER
62           Returns the single-valued texture minification filter, a symbolic
63           constant. The initial value is GL_NEAREST_MIPMAP_LINEAR.
64
65       GL_TEXTURE_MIN_LOD
66           Returns the single-valued texture minimum level-of-detail value.
67           The initial value is -1000.
68
69       GL_TEXTURE_MAX_LOD
70           Returns the single-valued texture maximum level-of-detail value.
71           The initial value is 1000.
72
73       GL_TEXTURE_BASE_LEVEL
74           Returns the single-valued base texture mipmap level. The initial
75           value is 0.
76
77       GL_TEXTURE_MAX_LEVEL
78           Returns the single-valued maximum texture mipmap array level. The
79           initial value is 1000.
80
81       GL_TEXTURE_SWIZZLE_R
82           Returns the red component swizzle. The initial value is GL_RED.
83
84       GL_TEXTURE_SWIZZLE_G
85           Returns the green component swizzle. The initial value is GL_GREEN.
86
87       GL_TEXTURE_SWIZZLE_B
88           Returns the blue component swizzle. The initial value is GL_BLUE.
89
90       GL_TEXTURE_SWIZZLE_A
91           Returns the alpha component swizzle. The initial value is GL_ALPHA.
92
93       GL_TEXTURE_SWIZZLE_RGBA
94           Returns the component swizzle for all channels in a single query.
95
96       GL_TEXTURE_WRAP_S
97           Returns the single-valued wrapping function for texture coordinate
98           s, a symbolic constant. The initial value is GL_REPEAT.
99
100       GL_TEXTURE_WRAP_T
101           Returns the single-valued wrapping function for texture coordinate
102           t, a symbolic constant. The initial value is GL_REPEAT.
103
104       GL_TEXTURE_WRAP_R
105           Returns the single-valued wrapping function for texture coordinate
106           r, a symbolic constant. The initial value is GL_REPEAT.
107
108       GL_TEXTURE_BORDER_COLOR
109           Returns four integer or floating-point numbers that comprise the
110           RGBA color of the texture border. Floating-point values are
111           returned in the range 0 1. Integer values are returned as a linear
112           mapping of the internal floating-point representation such that 1.0
113           maps to the most positive representable integer and -1.0 maps to
114           the most negative representable integer. The initial value is (0,
115           0, 0, 0).
116
117       GL_TEXTURE_COMPARE_MODE
118           Returns a single-valued texture comparison mode, a symbolic
119           constant. The initial value is GL_NONE. See glTexParameter().
120
121       GL_TEXTURE_COMPARE_FUNC
122           Returns a single-valued texture comparison function, a symbolic
123           constant. The initial value is GL_LEQUAL. See glTexParameter().
124
125       GL_TEXTURE_VIEW_MIN_LEVEL
126           Returns a single-valued base level of a texture view relative to
127           its parent. The initial value is 0. See glTextureView().
128
129       GL_TEXTURE_VIEW_NUM_LEVELS
130           Returns a single-valued number of levels of detail of a texture
131           view. See glTextureView().
132
133       GL_TEXTURE_VIEW_MIN_LAYER
134           Returns a single-valued first level of a texture array view
135           relative to its parent. See glTextureView().
136
137       GL_TEXTURE_VIEW_NUM_LAYERS
138           Returns a single-valued number of layers in a texture array view.
139           See glTextureView().
140
141       GL_TEXTURE_IMMUTABLE_LEVELS
142           Returns a single-valued number of immutable texture levels in a
143           texture view. See glTextureView().
144
145       In addition to the parameters that may be set with glTexParameter(),
146       glGetTexParameter accepts the following read-only parameters:
147
148       GL_TEXTURE_IMMUTABLE_FORMAT
149           Returns non-zero if the texture has an immutable format. Textures
150           become immutable if their storage is specified with
151           glTexStorage1D(), glTexStorage2D() or glTexStorage3D(). The initial
152           value is GL_FALSE.
153

NOTES

155       If an error is generated, no change is made to the contents of params.
156
157       GL_DEPTH_STENCIL_TEXTURE_MODE, GL_TEXTURE_VIEW_MIN_LEVEL,
158       GL_TEXTURE_VIEW_NUM_LEVELS, GL_TEXTURE_VIEW_MIN_LAYER,
159       GL_TEXTURE_VIEW_NUM_LAYERS and GL_TEXTURE_IMMUTABLE_LEVELS are
160       available only if the GL version is 4.3 or greater.
161

ERRORS

163       GL_INVALID_ENUM is generated if target or pname is not an accepted
164       value.
165

COPYRIGHT

171       Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2012
172       Khronos Group. This document is licensed under the SGI Free Software B
173       License. For details, see http://oss.sgi.com/projects/FreeB/.
174

AUTHORS

176       opengl.org
177
178
179
180opengl.org                        06/10/2014             GLGETTEXPARAMETER(3G)