glGetTexParameter(3g)

1GLGETTEXPARAMETER(3G)           [FIXME: 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
19       void glGetTextureParameterfv(GLuint texture, GLenum pname,
20                                    GLfloat *params);
21
22       void glGetTextureParameteriv(GLuint texture, GLenum pname,
23                                    GLint *params);
24
25       void glGetTextureParameterIiv(GLuint texture, GLenum pname,
26                                     GLint *params);
27
28       void glGetTextureParameterIuiv(GLuint texture, GLenum pname,
29                                      GLuint *params);
30

PARAMETERS

32       target
33           Specifies the target to which the texture is bound for
34           glGetTexParameterfv, glGetTexParameteriv, glGetTexParameterIiv, and
35           glGetTexParameterIuiv functions.  GL_TEXTURE_1D,
36           GL_TEXTURE_1D_ARRAY, GL_TEXTURE_2D, GL_TEXTURE_2D_ARRAY,
37           GL_TEXTURE_2D_MULTISAMPLE, GL_TEXTURE_2D_MULTISAMPLE_ARRAY,
38           GL_TEXTURE_3D, GL_TEXTURE_CUBE_MAP, GL_TEXTURE_RECTANGLE, and
39           GL_TEXTURE_CUBE_MAP_ARRAY are accepted.
40
41       texture
42           Specifies the texture object name for glGetTextureParameterfv,
43           glGetTextureParameteriv, glGetTextureParameterIiv, and
44           glGetTextureParameterIuiv functions.
45
46       pname
47           Specifies the symbolic name of a texture parameter.
48           GL_DEPTH_STENCIL_TEXTURE_MODE, GL_IMAGE_FORMAT_COMPATIBILITY_TYPE,
49           GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_BORDER_COLOR,
50           GL_TEXTURE_COMPARE_MODE, GL_TEXTURE_COMPARE_FUNC,
51           GL_TEXTURE_IMMUTABLE_FORMAT, GL_TEXTURE_IMMUTABLE_LEVELS,
52           GL_TEXTURE_LOD_BIAS, GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MAX_LEVEL,
53           GL_TEXTURE_MAX_LOD, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MIN_LOD,
54           GL_TEXTURE_SWIZZLE_R, GL_TEXTURE_SWIZZLE_G, GL_TEXTURE_SWIZZLE_B,
55           GL_TEXTURE_SWIZZLE_A, GL_TEXTURE_SWIZZLE_RGBA, GL_TEXTURE_TARGET,
56           GL_TEXTURE_VIEW_MIN_LAYER, GL_TEXTURE_VIEW_MIN_LEVEL,
57           GL_TEXTURE_VIEW_NUM_LAYERS, GL_TEXTURE_VIEW_NUM_LEVELS,
58           GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, and GL_TEXTURE_WRAP_R are
59           accepted.
60
61       params
62           Returns the texture parameters.
63

DESCRIPTION

65       glGetTexParameter and glGetTextureParameter return in params the value
66       or values of the texture parameter specified as pname.  target defines
67       the target texture.  GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D,
68       GL_TEXTURE_1D_ARRAY, GL_TEXTURE_2D_ARRAY, GL_TEXTURE_RECTANGLE,
69       GL_TEXTURE_CUBE_MAP, GL_TEXTURE_CUBE_MAP_ARRAY,
70       GL_TEXTURE_2D_MULTISAMPLE, or GL_TEXTURE_2D_MULTISAMPLE_ARRAY specify
71       one-, two-, or three-dimensional, one-dimensional array,
72       two-dimensional array, rectangle, cube-mapped or cube-mapped array,
73       two-dimensional multisample, or two-dimensional multisample array
74       texturing, respectively.  pname accepts the same symbols as
75       glTexParameter(), with the same interpretations:
76
77       GL_DEPTH_STENCIL_TEXTURE_MODE
78           Returns the single-value depth stencil texture mode, a symbolic
79           constant. The initial value is GL_DEPTH_COMPONENT.
80
81       GL_TEXTURE_MAG_FILTER
82           Returns the single-valued texture magnification filter, a symbolic
83           constant. The initial value is GL_LINEAR.
84
85       GL_TEXTURE_MIN_FILTER
86           Returns the single-valued texture minification filter, a symbolic
87           constant. The initial value is GL_NEAREST_MIPMAP_LINEAR.
88
89       GL_TEXTURE_MIN_LOD
90           Returns the single-valued texture minimum level-of-detail value.
91           The initial value is -1000.
92
93       GL_TEXTURE_MAX_LOD
94           Returns the single-valued texture maximum level-of-detail value.
95           The initial value is 1000.
96
97       GL_TEXTURE_BASE_LEVEL
98           Returns the single-valued base texture mipmap level. The initial
99           value is 0.
100
101       GL_TEXTURE_MAX_LEVEL
102           Returns the single-valued maximum texture mipmap array level. The
103           initial value is 1000.
104
105       GL_TEXTURE_SWIZZLE_R
106           Returns the red component swizzle. The initial value is GL_RED.
107
108       GL_TEXTURE_SWIZZLE_G
109           Returns the green component swizzle. The initial value is GL_GREEN.
110
111       GL_TEXTURE_SWIZZLE_B
112           Returns the blue component swizzle. The initial value is GL_BLUE.
113
114       GL_TEXTURE_SWIZZLE_A
115           Returns the alpha component swizzle. The initial value is GL_ALPHA.
116
117       GL_TEXTURE_SWIZZLE_RGBA
118           Returns the component swizzle for all channels in a single query.
119
120       GL_TEXTURE_WRAP_S
121           Returns the single-valued wrapping function for texture coordinate
122           s, a symbolic constant. The initial value is GL_REPEAT.
123
124       GL_TEXTURE_WRAP_T
125           Returns the single-valued wrapping function for texture coordinate
126           t, a symbolic constant. The initial value is GL_REPEAT.
127
128       GL_TEXTURE_WRAP_R
129           Returns the single-valued wrapping function for texture coordinate
130           r, a symbolic constant. The initial value is GL_REPEAT.
131
132       GL_TEXTURE_BORDER_COLOR
133           Returns four integer or floating-point numbers that comprise the
134           RGBA color of the texture border. Floating-point values are
135           returned in the range 0 1. Integer values are returned as a linear
136           mapping of the internal floating-point representation such that 1.0
137           maps to the most positive representable integer and -1.0 maps to
138           the most negative representable integer. The initial value is (0,
139           0, 0, 0).
140
141       GL_TEXTURE_COMPARE_MODE
142           Returns a single-valued texture comparison mode, a symbolic
143           constant. The initial value is GL_NONE. See glTexParameter().
144
145       GL_TEXTURE_COMPARE_FUNC
146           Returns a single-valued texture comparison function, a symbolic
147           constant. The initial value is GL_LEQUAL. See glTexParameter().
148
149       GL_TEXTURE_VIEW_MIN_LEVEL
150           Returns a single-valued base level of a texture view relative to
151           its parent. The initial value is 0. See glTextureView().
152
153       GL_TEXTURE_VIEW_NUM_LEVELS
154           Returns a single-valued number of levels of detail of a texture
155           view. See glTextureView().
156
157       GL_TEXTURE_VIEW_MIN_LAYER
158           Returns a single-valued first level of a texture array view
159           relative to its parent. See glTextureView().
160
161       GL_TEXTURE_VIEW_NUM_LAYERS
162           Returns a single-valued number of layers in a texture array view.
163           See glTextureView().
164
165       GL_TEXTURE_IMMUTABLE_LEVELS
166           Returns a single-valued number of immutable texture levels in a
167           texture view. See glTextureView().
168
169       In addition to the parameters that may be set with glTexParameter(),
170       glGetTexParameter and glGetTextureParameter accept the following
171       read-only parameters:
172
173       GL_IMAGE_FORMAT_COMPATIBILITY_TYPE
174           Returns the matching criteria use for the texture when used as an
175           image texture. Can return GL_IMAGE_FORMAT_COMPATIBILITY_BY_SIZE,
176           GL_IMAGE_FORMAT_COMPATIBILITY_BY_CLASS or GL_NONE.
177
178       GL_TEXTURE_IMMUTABLE_FORMAT
179           Returns non-zero if the texture has an immutable format. Textures
180           become immutable if their storage is specified with
181           glTexStorage1D(), glTexStorage2D() or glTexStorage3D(). The initial
182           value is GL_FALSE.
183
184       GL_TEXTURE_TARGET
185           Returns the effective target of the texture object. For
186           glGetTex*Parameter functions, this is the target parameter. For
187           glGetTextureParameter*, it is the target to which the texture was
188           initially bound when it was created, or the value of the target
189           parameter to the call to glCreateTextures which created the
190           texture.
191

NOTES

193       If an error is generated, no change is made to the contents of params.
194
195       GL_IMAGE_FORMAT_COMPATIBILITY_TYPE is available only if the GL version
196       is 4.2 or greater.
197
198       GL_DEPTH_STENCIL_TEXTURE_MODE, GL_TEXTURE_VIEW_MIN_LEVEL,
199       GL_TEXTURE_VIEW_NUM_LEVELS, GL_TEXTURE_VIEW_MIN_LAYER,
200       GL_TEXTURE_VIEW_NUM_LAYERS and GL_TEXTURE_IMMUTABLE_LEVELS are
201       available only if the GL version is 4.3 or greater.
202
203       GL_TEXTURE_TARGET are available only if the GL version is 4.5 or
204       greater.
205

ERRORS

207       GL_INVALID_ENUM is generated if pname is not an accepted value.
208
209       GL_INVALID_ENUM error is generated by glGetTexParameter if the
210       effective target is not one of the accepted texture targets.
211
212       GL_INVALID_OPERATION is generated by glGetTextureParameter* if texture
213       is not the name of an existing texture object.
214

VERSION SUPPORT

216       ┌──────────────────────────┬───────────────────────────────────────────────────────────────────────┐
217       │                          │                OpenGL Version                                         │
218       ├──────────────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
219       │Function                  │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
220       │/                         │     │     │     │     │     │     │     │     │     │     │     │     │
221       │Feature                   │     │     │     │     │     │     │     │     │     │     │     │     │
222       │Name                      │     │     │     │     │     │     │     │     │     │     │     │     │
223       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
224       │glGetTexParameterIiv      │  -  │  -  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
225       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
226       │glGetTexParameterIuiv     │  -  │  -  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
227       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
228       │glGetTexParameterfv       │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
229       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
230       │glGetTexParameteriv       │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
231       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
232       │glGetTextureParameterIiv  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │
233       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
234       │glGetTextureParameterIuiv │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │
235       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
236       │glGetTextureParameterfv   │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │
237       ├──────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
238       │glGetTextureParameteriv   │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │
239       └──────────────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘
240

COPYRIGHT

254       Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2014
255       Khronos Group. This document is licensed under the SGI Free Software B
256       License. For details, see http://oss.sgi.com/projects/FreeB/.
257

COPYRIGHT

259       Copyright © 1991-2006 Silicon Graphics, Inc.
260       Copyright © 2010-2014 Khronos Group
261
262
263
264[FIXME: source]                   03/06/2019             GLGETTEXPARAMETER(3G)