1GLGETTEXPARAMETER(3G) GLGETTEXPARAMETER(3G)
2
6 glGetTexParameterfv, glGetTexParameteriv - return texture parameter
7 values
8
11 void glGetTexParameterfv( GLenum target,
12 GLenum pname,
13 GLfloat *params )
14 void glGetTexParameteriv( GLenum target,
15 GLenum pname,
16 GLint *params )
17
20 target Specifies the symbolic name of the target texture.
21 GL_TEXTURE_1D,GL_TEXTURE_2D, and GL_TEXTURE_3D are accepted.
22 pname Specifies the symbolic name of a texture parameter.
24 GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER,
25 GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL,
26 GL_TEXTURE_MAX_LEVEL, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T,
27 GL_TEXTURE_WRAP_R, GL_TEXTURE_BORDER_COLOR,
28 GL_TEXTURE_PRIORITY, and GL_TEXTURE_RESIDENT are accepted.
29 params Returns the texture parameters.
31
33 glGetTexParameter returns in params the value or values of the texture
34 parameter specified as pname. target defines the target texture,
35 either GL_TEXTURE_1D, GL_TEXTURE_2D, or GL_TEXTURE_3D to specify one-,
36 two-, or three-dimensional texturing. pname accepts the same symbols
37 as glTexParameter, with the same interpretations:
38 GL_TEXTURE_MAG_FILTER Returns the single-valued texture
40 magnification filter, a symbolic
41 constant. The initial value is
42 GL_LINEAR.
43 GL_TEXTURE_MIN_FILTER Returns the single-valued texture
45 minification filter, a symbolic con‐
46 stant. The initial value is
47 GL_NEAREST_MIPMAP_LINEAR.
48 GL_TEXTURE_MIN_LOD Returns the single-valued texture
50 minimum level-of-detail value. The
51 initial value is −1000.
52 GL_TEXTURE_MAX_LOD Returns the single-valued texture
54 maximum level-of-detail value. The
55 initial value is 1000.
56 GL_TEXTURE_BASE_LEVEL Returns the single-valued base tex‐
58 ture mipmap level. The initial
59 value is 0.
60 GL_TEXTURE_MAX_LEVEL Returns the single-valued maximum
62 texture mipmap array level. The
63 initial value is 1000.
64 GL_TEXTURE_WRAP_S Returns the single-valued wrapping
66 function for texture coordinate s, a
67 symbolic constant. The initial value
68 is GL_REPEAT.
69 GL_TEXTURE_WRAP_T Returns the single-valued wrapping
71 function for texture coordinate t, a
72 symbolic constant. The initial value
73 is GL_REPEAT.
74 GL_TEXTURE_WRAP_R Returns the single-valued wrapping
76 function for texture coordinate r, a
77 symbolic constant. The initial value
78 is GL_REPEAT.
79 GL_TEXTURE_BORDER_COLOR Returns four integer or floating-
81 point numbers that comprise the RGBA
82 color of the texture border. Float‐
83 ing-point values are returned in the
84 range [0, 1]. Integer values are
85 returned as a linear mapping of the
86 internal floating-point representa‐
87 tion such that 1.0 maps to the most
88 positive representable integer and
89 -1.0 maps to the most negative rep‐
90 resentable integer. The initial
91 value is (0, 0, 0, 0).
92 GL_TEXTURE_PRIORITY Returns the residence priority of
94 the target texture (or the named
95 texture bound to it). The initial
96 value is 1. See
97 glPrioritizeTextures.
98 GL_TEXTURE_RESIDENT Returns the residence status of the
100 target texture. If the value
101 returned in params is GL_TRUE, the
102 texture is resident in texture mem‐
103 ory. See glAreTexturesResident.
104
106 GL_TEXTURE_PRIORITY and GL_TEXTURE_RESIDENT are available only if the
107 GL version is 1.1 or greater.
108 GL_TEXTURE_3D, GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD,
110 GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, and GL_TEXTURE_WRAP_R are
111 available only if the GL version is 1.2 or greater.
112 If an error is generated, no change is made to the contents of params.
114
116 GL_INVALID_ENUM is generated if target or pname is not an accepted
117 value.
118 GL_INVALID_OPERATION is generated if glGetTexParameter is executed
120 between the execution of glBegin and the corresponding execution of
121 glEnd.
122
124 glAreTexturesResident(3G), glPrioritizeTextures(3G), glTexParameter(3G)
125 GLGETTEXPARAMETER(3G)