rename upstream-man-pages to upstream-doc
[clinton/guile-figl.git] / upstream-doc / man3 / xhtml / glGet.xml
CommitLineData
7faf1d71
AW
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
3<!-- saved from url=(0013)about:internet -->
4<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGet - OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGet"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGet — return the value or values of a selected parameter</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetBooleanv</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLboolean *  </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetDoublev</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLdouble *  </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetFloatv</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLfloat *  </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetIntegerv</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint *  </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetInteger64v</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint64 *  </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pname</code></em></span></dt><dd><p>
5 Specifies the parameter value to be returned.
6 The symbolic constants in the list below are accepted.
7 </p></dd><dt><span class="term"><em class="parameter"><code>params</code></em></span></dt><dd><p>
8 Returns the value or values of the specified parameter.
9 </p></dd></dl></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetBooleani_v</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLuint  </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLboolean *  </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetIntegeri_v</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLuint  </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint *  </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetInteger64i_v</b>(</code></td><td>GLenum  </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLuint  </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint64 *  </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters2"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pname</code></em></span></dt><dd><p>
10 Specifies the parameter value to be returned.
11 The symbolic constants in the list below are accepted.
12 </p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
13 Specifies the index of the particular element being queried.
14 </p></dd><dt><span class="term"><em class="parameter"><code>data</code></em></span></dt><dd><p>
15 Returns the value or values of the specified parameter.
16 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
17 These four commands return values for simple state variables in GL.
18 <em class="parameter"><code>pname</code></em> is a symbolic constant indicating the state variable to be returned,
19 and <em class="parameter"><code>params</code></em> is a pointer to an array of the indicated type in
20 which to place the returned data.
21 </p><p>
22 Type conversion is performed if <em class="parameter"><code>params</code></em> has a different type than
23 the state variable value being requested.
24 If <code class="function">glGetBooleanv</code> is called,
25 a floating-point (or integer) value is converted to <code class="constant">GL_FALSE</code> if
26 and only if it is 0.0 (or 0).
27 Otherwise,
28 it is converted to <code class="constant">GL_TRUE</code>.
29 If <code class="function">glGetIntegerv</code> is called, boolean values are returned as
30 <code class="constant">GL_TRUE</code> or <code class="constant">GL_FALSE</code>, and most floating-point values are
31 rounded to the nearest integer value. Floating-point colors and
32 normals, however, are returned with a linear mapping that maps 1.0 to
33 the most positive representable integer value
34 and
35 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
36
37 <mml:mn>-1.0</mml:mn>
38 </mml:math>
39 to the most negative representable integer value.
40 If <code class="function">glGetFloatv</code> or <code class="function">glGetDoublev</code> is called,
41 boolean values are returned as <code class="constant">GL_TRUE</code> or <code class="constant">GL_FALSE</code>,
42 and integer values are converted to floating-point values.
43 </p><p>
44 The following symbolic constants are accepted by <em class="parameter"><code>pname</code></em>:
45 </p><div class="variablelist"><dl><dt><span class="term"><code class="constant">GL_ACTIVE_TEXTURE</code></span></dt><dd><p>
46 </p><p>
47 <em class="parameter"><code>params</code></em> returns a single value indicating the active multitexture unit.
48 The initial value is <code class="constant">GL_TEXTURE0</code>.
49 See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>.
50 </p></dd><dt><span class="term"><code class="constant">GL_ALIASED_LINE_WIDTH_RANGE</code></span></dt><dd><p>
51 </p><p>
52 <em class="parameter"><code>params</code></em> returns a pair of values indicating the range of
53 widths supported for aliased lines. See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
54 </p></dd><dt><span class="term"><code class="constant">GL_SMOOTH_LINE_WIDTH_RANGE</code></span></dt><dd><p>
55 </p><p>
56 <em class="parameter"><code>params</code></em> returns a pair of values indicating the range of
57 widths supported for smooth (antialiased) lines. See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
58 </p></dd><dt><span class="term"><code class="constant">GL_SMOOTH_LINE_WIDTH_GRANULARITY</code></span></dt><dd><p>
59 </p><p>
60 <em class="parameter"><code>params</code></em> returns a single value indicating the level of
61 quantization applied to smooth line width parameters.
62 </p></dd><dt><span class="term"><code class="constant">GL_ARRAY_BUFFER_BINDING</code></span></dt><dd><p>
63 </p><p>
64 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
65 currently bound to the target <code class="constant">GL_ARRAY_BUFFER</code>. If no buffer object
66 is bound to this target, 0 is returned. The initial value is 0.
67 See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>.
68 </p></dd><dt><span class="term"><code class="constant">GL_BLEND</code></span></dt><dd><p>
69 </p><p>
70 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether blending is
71 enabled. The initial value is <code class="constant">GL_FALSE</code>.
72 See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a>.
73 </p></dd><dt><span class="term"><code class="constant">GL_BLEND_COLOR</code></span></dt><dd><p>
74 </p><p>
75 <em class="parameter"><code>params</code></em> returns four values,
76 the red, green, blue, and alpha values which are the components of
77 the blend color.
78 See <a href="glBlendColor.xml"><span class="citerefentry"><span class="refentrytitle">glBlendColor</span></span></a>.
79 </p></dd><dt><span class="term"><code class="constant">GL_BLEND_DST_ALPHA</code></span></dt><dd><p>
80 </p><p>
81 <em class="parameter"><code>params</code></em> returns one value,
82 the symbolic constant identifying the alpha destination blend
83 function. The initial value is <code class="constant">GL_ZERO</code>.
84 See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> and <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>.
85 </p></dd><dt><span class="term"><code class="constant">GL_BLEND_DST_RGB</code></span></dt><dd><p>
86 </p><p>
87 <em class="parameter"><code>params</code></em> returns one value,
88 the symbolic constant identifying the RGB destination blend
89 function. The initial value is <code class="constant">GL_ZERO</code>.
90 See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> and <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>.
91 </p></dd><dt><span class="term"><code class="constant">GL_BLEND_EQUATION_RGB</code></span></dt><dd><p>
92 </p><p>
93 <em class="parameter"><code>params</code></em> returns one value, a symbolic constant indicating whether
94 the RGB blend equation is <code class="constant">GL_FUNC_ADD</code>, <code class="constant">GL_FUNC_SUBTRACT</code>,
95 <code class="constant">GL_FUNC_REVERSE_SUBTRACT</code>, <code class="constant">GL_MIN</code> or <code class="constant">GL_MAX</code>.
96 See <a href="glBlendEquationSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendEquationSeparate</span></span></a>.
97 </p></dd><dt><span class="term"><code class="constant">GL_BLEND_EQUATION_ALPHA</code></span></dt><dd><p>
98 </p><p>
99 <em class="parameter"><code>params</code></em> returns one value, a symbolic constant indicating whether
100 the Alpha blend equation is <code class="constant">GL_FUNC_ADD</code>, <code class="constant">GL_FUNC_SUBTRACT</code>,
101 <code class="constant">GL_FUNC_REVERSE_SUBTRACT</code>, <code class="constant">GL_MIN</code> or <code class="constant">GL_MAX</code>.
102 See <a href="glBlendEquationSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendEquationSeparate</span></span></a>.
103 </p></dd><dt><span class="term"><code class="constant">GL_BLEND_SRC_ALPHA</code></span></dt><dd><p>
104 </p><p>
105 <em class="parameter"><code>params</code></em> returns one value,
106 the symbolic constant identifying the alpha source blend function. The initial
107 value is <code class="constant">GL_ONE</code>.
108 See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> and <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>.
109 </p></dd><dt><span class="term"><code class="constant">GL_BLEND_SRC_RGB</code></span></dt><dd><p>
110 </p><p>
111 <em class="parameter"><code>params</code></em> returns one value,
112 the symbolic constant identifying the RGB source blend function. The initial
113 value is <code class="constant">GL_ONE</code>.
114 See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> and <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>.
115 </p></dd><dt><span class="term"><code class="constant">GL_COLOR_CLEAR_VALUE</code></span></dt><dd><p>
116 </p><p>
117 <em class="parameter"><code>params</code></em> returns four values:
118 the red, green, blue, and alpha values used to clear the color buffers.
119 Integer values,
120 if requested,
121 are linearly mapped from the internal floating-point representation such
122 that 1.0 returns the most positive representable integer value,
123 and
124 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
125
126 <mml:mn>-1.0</mml:mn>
127 </mml:math>
128 returns the most negative representable integer
129 value. The initial value is (0, 0, 0, 0).
130 See <a href="glClearColor.xml"><span class="citerefentry"><span class="refentrytitle">glClearColor</span></span></a>.
131 </p></dd><dt><span class="term"><code class="constant">GL_COLOR_LOGIC_OP</code></span></dt><dd><p>
132 </p><p>
133 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether a fragment's
134 RGBA color values are merged into the framebuffer using a logical
135 operation. The initial value is <code class="constant">GL_FALSE</code>.
136 See <a href="glLogicOp.xml"><span class="citerefentry"><span class="refentrytitle">glLogicOp</span></span></a>.
137 </p></dd><dt><span class="term"><code class="constant">GL_COLOR_WRITEMASK</code></span></dt><dd><p>
138 </p><p>
139 <em class="parameter"><code>params</code></em> returns four boolean values:
140 the red, green, blue, and alpha write enables for the color
141 buffers. The initial value is (<code class="constant">GL_TRUE</code>, <code class="constant">GL_TRUE</code>,
142 <code class="constant">GL_TRUE</code>, <code class="constant">GL_TRUE</code>).
143 See <a href="glColorMask.xml"><span class="citerefentry"><span class="refentrytitle">glColorMask</span></span></a>.
144 </p></dd><dt><span class="term"><code class="constant">GL_COMPRESSED_TEXTURE_FORMATS</code></span></dt><dd><p>
145 </p><p>
146 <em class="parameter"><code>params</code></em> returns a list of symbolic
147 constants of length <code class="constant">GL_NUM_COMPRESSED_TEXTURE_FORMATS</code>
148 indicating which compressed texture formats are available.
149 See <a href="glCompressedTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage2D</span></span></a>.
150 </p></dd><dt><span class="term"><code class="constant">GL_CULL_FACE</code></span></dt><dd><p>
151 </p><p>
152 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon culling
153 is enabled. The initial value is <code class="constant">GL_FALSE</code>.
154 See <a href="glCullFace.xml"><span class="citerefentry"><span class="refentrytitle">glCullFace</span></span></a>.
155 </p></dd><dt><span class="term"><code class="constant">GL_CURRENT_PROGRAM</code></span></dt><dd><p>
156 </p><p>
157 <em class="parameter"><code>params</code></em> returns one value,
158 the name of the program object that is currently active, or 0 if no program object is active.
159 See <a href="glUseProgram.xml"><span class="citerefentry"><span class="refentrytitle">glUseProgram</span></span></a>.
160 </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_CLEAR_VALUE</code></span></dt><dd><p>
161 </p><p>
162 <em class="parameter"><code>params</code></em> returns one value,
163 the value that is used to clear the depth buffer.
164 Integer values,
165 if requested,
166 are linearly mapped from the internal floating-point representation such
167 that 1.0 returns the most positive representable integer value,
168 and
169 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
170
171 <mml:mn>-1.0</mml:mn>
172 </mml:math>
173 returns the most negative representable integer
174 value. The initial value is 1.
175 See <a href="glClearDepth.xml"><span class="citerefentry"><span class="refentrytitle">glClearDepth</span></span></a>.
176 </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_FUNC</code></span></dt><dd><p>
177 </p><p>
178 <em class="parameter"><code>params</code></em> returns one value,
179 the symbolic constant that indicates the depth comparison
180 function. The initial value is <code class="constant">GL_LESS</code>.
181 See <a href="glDepthFunc.xml"><span class="citerefentry"><span class="refentrytitle">glDepthFunc</span></span></a>.
182 </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_RANGE</code></span></dt><dd><p>
183 </p><p>
184 <em class="parameter"><code>params</code></em> returns two values:
185 the near and far mapping limits for the depth buffer.
186 Integer values,
187 if requested,
188 are linearly mapped from the internal floating-point representation such
189 that 1.0 returns the most positive representable integer value,
190 and
191 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
192
193 <mml:mn>-1.0</mml:mn>
194 </mml:math>
195 returns the most negative representable integer
196 value. The initial value is (0, 1).
197 See <a href="glDepthRange.xml"><span class="citerefentry"><span class="refentrytitle">glDepthRange</span></span></a>.
198 </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_TEST</code></span></dt><dd><p>
199 </p><p>
200 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether depth testing
201 of fragments is enabled. The initial value is <code class="constant">GL_FALSE</code>.
202 See <a href="glDepthFunc.xml"><span class="citerefentry"><span class="refentrytitle">glDepthFunc</span></span></a> and <a href="glDepthRange.xml"><span class="citerefentry"><span class="refentrytitle">glDepthRange</span></span></a>.
203 </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_WRITEMASK</code></span></dt><dd><p>
204 </p><p>
205 <em class="parameter"><code>params</code></em> returns a single boolean value indicating if the depth buffer
206 is enabled for writing. The initial value is <code class="constant">GL_TRUE</code>.
207 See <a href="glDepthMask.xml"><span class="citerefentry"><span class="refentrytitle">glDepthMask</span></span></a>.
208 </p></dd><dt><span class="term"><code class="constant">GL_DITHER</code></span></dt><dd><p>
209 </p><p>
210 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether dithering of
211 fragment colors and indices is enabled. The initial value is <code class="constant">GL_TRUE</code>.
212 </p></dd><dt><span class="term"><code class="constant">GL_DOUBLEBUFFER</code></span></dt><dd><p>
213 </p><p>
214 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether double buffering
215 is supported.
216 </p></dd><dt><span class="term"><code class="constant">GL_DRAW_BUFFER</code></span></dt><dd><p>
217 </p><p>
218 <em class="parameter"><code>params</code></em> returns one value,
219 a symbolic constant indicating which buffers are being drawn to.
220 See <a href="glDrawBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glDrawBuffer</span></span></a>. The initial value is <code class="constant">GL_BACK</code> if there
221 are back buffers, otherwise it is <code class="constant">GL_FRONT</code>.
222 </p></dd><dt><span class="term"><code class="constant">GL_DRAW_BUFFER</code><span class="emphasis"><em>i</em></span></span></dt><dd><p>
223 </p><p>
224 <em class="parameter"><code>params</code></em> returns one value,
225 a symbolic constant indicating which buffers are being drawn to by the corresponding output color.
226 See <a href="glDrawBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDrawBuffers</span></span></a>.
227 The initial value of <code class="constant">GL_DRAW_BUFFER0</code> is <code class="constant">GL_BACK</code> if there
228 are back buffers, otherwise it is <code class="constant">GL_FRONT</code>. The
229 initial values of draw buffers for all other output colors is <code class="constant">GL_NONE</code>.
230 </p></dd><dt><span class="term"><code class="constant">GL_DRAW_FRAMEBUFFER_BINDING</code></span></dt><dd><p>
231 </p><p>
232 <em class="parameter"><code>params</code></em> returns one value,
233 the name of the framebuffer object currently bound to the <code class="constant">GL_DRAW_FRAMEBUFFER</code> target.
234 If the default framebuffer is bound, this value will be zero. The initial value is zero.
235 See <a href="glBindFramebuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindFramebuffer</span></span></a>.
236 </p></dd><dt><span class="term"><code class="constant">GL_READ_FRAMEBUFFER_BINDING</code></span></dt><dd><p>
237 </p><p>
238 <em class="parameter"><code>params</code></em> returns one value,
239 the name of the framebuffer object currently bound to the <code class="constant">GL_READ_FRAMEBUFFER</code> target.
240 If the default framebuffer is bound, this value will be zero. The initial value is zero.
241 See <a href="glBindFramebuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindFramebuffer</span></span></a>.
242 </p></dd><dt><span class="term"><code class="constant">GL_ELEMENT_ARRAY_BUFFER_BINDING</code></span></dt><dd><p>
243 </p><p>
244 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
245 currently bound to the target <code class="constant">GL_ELEMENT_ARRAY_BUFFER</code>. If no buffer object
246 is bound to this target, 0 is returned. The initial value is 0.
247 See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>.
248 </p></dd><dt><span class="term"><code class="constant">GL_RENDERBUFFER_BINDING</code></span></dt><dd><p>
249 </p><p>
250 <em class="parameter"><code>params</code></em> returns a single value, the name of the renderbuffer object
251 currently bound to the target <code class="constant">GL_RENDERBUFFER</code>. If no renderbuffer object
252 is bound to this target, 0 is returned. The initial value is 0.
253 See <a href="glBindRenderbuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindRenderbuffer</span></span></a>.
254 </p></dd><dt><span class="term"><code class="constant">GL_FRAGMENT_SHADER_DERIVATIVE_HINT</code></span></dt><dd><p>
255 </p><p>
256 <em class="parameter"><code>params</code></em> returns one value,
257 a symbolic constant indicating the mode of the derivative accuracy hint
258 for fragment shaders. The initial value
259 is <code class="constant">GL_DONT_CARE</code>.
260 See <a href="glHint.xml"><span class="citerefentry"><span class="refentrytitle">glHint</span></span></a>.
261 </p></dd><dt><span class="term"><code class="constant">GL_LINE_SMOOTH</code></span></dt><dd><p>
262 </p><p>
263 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether antialiasing of
264 lines is enabled. The initial value is <code class="constant">GL_FALSE</code>.
265 See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
266 </p></dd><dt><span class="term"><code class="constant">GL_LINE_SMOOTH_HINT</code></span></dt><dd><p>
267 </p><p>
268 <em class="parameter"><code>params</code></em> returns one value,
269 a symbolic constant indicating the mode of the line antialiasing
270 hint. The initial value is <code class="constant">GL_DONT_CARE</code>.
271 See <a href="glHint.xml"><span class="citerefentry"><span class="refentrytitle">glHint</span></span></a>.
272 </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH</code></span></dt><dd><p>
273 </p><p>
274 <em class="parameter"><code>params</code></em> returns one value,
275 the line width as specified with <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>. The initial value is
276 1.
277 </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH_GRANULARITY</code></span></dt><dd><p>
278 </p><p>
279 <em class="parameter"><code>params</code></em> returns one value,
280 the width difference between adjacent supported widths for antialiased lines.
281 See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
282 </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH_RANGE</code></span></dt><dd><p>
283 </p><p>
284 <em class="parameter"><code>params</code></em> returns two values:
285 the smallest and largest supported widths for antialiased
286 lines.
287 See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
288 </p></dd><dt><span class="term"><code class="constant">GL_LOGIC_OP_MODE</code></span></dt><dd><p>
289 </p><p>
290 <em class="parameter"><code>params</code></em> returns one value,
291 a symbolic constant indicating the selected logic operation
292 mode. The initial value is <code class="constant">GL_COPY</code>.
293 See <a href="glLogicOp.xml"><span class="citerefentry"><span class="refentrytitle">glLogicOp</span></span></a>.
294 </p></dd><dt><span class="term"><code class="constant">GL_MAX_3D_TEXTURE_SIZE</code></span></dt><dd><p>
295 </p><p>
296 <em class="parameter"><code>params</code></em> returns one value,
297 a rough estimate of the largest 3D texture that the GL can handle.
298 The value must be at least 64.
299 Use <code class="constant">GL_PROXY_TEXTURE_3D</code> to determine if a texture is too large.
300 See <a href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>.
301 </p></dd><dt><span class="term"><code class="constant">GL_MAX_CLIP_DISTANCES</code></span></dt><dd><p>
302 </p><p>
303 <em class="parameter"><code>params</code></em> returns one value,
304 the maximum number of application-defined clipping distances. The value must be at least 8.
305 </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</code></span></dt><dd><p>
306 </p><p>
307 <em class="parameter"><code>params</code></em> returns one value,
308 the number of words for fragment shader uniform variables in all uniform
309 blocks (including default). The value must be at least 1.
310 See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
311 </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p>
312 </p><p>
313 <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that
314 can be used to access texture maps from the vertex shader and the fragment processor combined.
315 If both the vertex shader and the fragment processing stage access the same texture image
316 unit, then that counts as using two texture image units against this limit.
317 The value must be at least 48.
318 See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>.
319 </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</code></span></dt><dd><p>
320 </p><p>
321 <em class="parameter"><code>params</code></em> returns one value,
322 the number of words for vertex shader uniform variables in all uniform
323 blocks (including default). The value must be at least 1.
324 See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
325 </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_GEOMETRY_UNIFORM_COMPONENTS</code></span></dt><dd><p>
326 </p><p>
327 <em class="parameter"><code>params</code></em> returns one value,
328 the number of words for geometry shader uniform variables in all uniform
329 blocks (including default). The value must be at least 1.
330 See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
331 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VARYING_COMPONENTS</code></span></dt><dd><p>
332 </p><p>
333 <em class="parameter"><code>params</code></em> returns one value,
334 the number components for varying variables, which must be at least 60.
335 </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_UNIFORM_BLOCKS</code></span></dt><dd><p>
336 </p><p>
337 <em class="parameter"><code>params</code></em> returns one value,
338 the maximum number of uniform blocks per program. The value must be at least 36.
339 See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>.
340 </p></dd><dt><span class="term"><code class="constant">GL_MAX_CUBE_MAP_TEXTURE_SIZE</code></span></dt><dd><p>
341 </p><p>
342 <em class="parameter"><code>params</code></em> returns one value.
343 The value gives a rough estimate of the largest cube-map texture that
344 the GL can handle. The value must be at least 1024.
345 Use <code class="constant">GL_PROXY_TEXTURE_CUBE_MAP</code>
346 to determine if a texture is too large.
347 See <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>.
348 </p></dd><dt><span class="term"><code class="constant">GL_MAX_DRAW_BUFFERS</code></span></dt><dd><p>
349 </p><p>
350 <em class="parameter"><code>params</code></em> returns one value, the maximum number
351 of simultaneous outputs that may be written in a fragment shader.
352 The value must be at least 8.
353 See <a href="glDrawBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDrawBuffers</span></span></a>.
354 </p></dd><dt><span class="term"><code class="constant">GL_MAX_DUALSOURCE_DRAW_BUFFERS</code></span></dt><dd><p>
355 </p><p>
356 <em class="parameter"><code>params</code></em> returns one value, the maximum number
357 of active draw buffers when using dual-source blending. The value must be at least 1.
358 See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> and
359 <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>.
360 </p></dd><dt><span class="term"><code class="constant">GL_MAX_ELEMENTS_INDICES</code></span></dt><dd><p>
361 </p><p>
362 <em class="parameter"><code>params</code></em> returns one value,
363 the recommended maximum number of vertex array indices.
364 See <a href="glDrawRangeElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElements</span></span></a>.
365 </p></dd><dt><span class="term"><code class="constant">GL_MAX_ELEMENTS_VERTICES</code></span></dt><dd><p>
366 </p><p>
367 <em class="parameter"><code>params</code></em> returns one value,
368 the recommended maximum number of vertex array vertices.
369 See <a href="glDrawRangeElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElements</span></span></a>.
370 </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code></span></dt><dd><p>
371 </p><p>
372 <em class="parameter"><code>params</code></em> returns one value,
373 the maximum number of individual floating-point, integer, or boolean values that can be held
374 in uniform variable storage for a fragment shader. The value must be at least 1024.
375 See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
376 </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_UNIFORM_BLOCKS</code></span></dt><dd><p>
377 </p><p>
378 <em class="parameter"><code>params</code></em> returns one value,
379 the maximum number of uniform blocks per fragment shader. The value must be at least 12.
380 See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>.
381 </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_INPUT_COMPONENTS</code></span></dt><dd><p>
382 </p><p>
383 <em class="parameter"><code>params</code></em> returns one value,
384 the maximum number of components of the inputs read by the fragment shader, which must be at least 128.
385 </p></dd><dt><span class="term"><code class="constant">GL_MIN_PROGRAM_TEXEL_OFFSET</code></span></dt><dd><p>
386 </p><p>
387 <em class="parameter"><code>params</code></em> returns one value,
388 the minimum texel offset allowed in a texture lookup, which must be at most -8.
389 </p></dd><dt><span class="term"><code class="constant">GL_MAX_PROGRAM_TEXEL_OFFSET</code></span></dt><dd><p>
390 </p><p>
391 <em class="parameter"><code>params</code></em> returns one value,
392 the maximum texel offset allowed in a texture lookup, which must be at least 7.
393 </p></dd><dt><span class="term"><code class="constant">GL_MAX_RECTANGLE_TEXTURE_SIZE</code></span></dt><dd><p>
394 </p><p>
395 <em class="parameter"><code>params</code></em> returns one value.
396 The value gives a rough estimate of the largest rectangular texture that
397 the GL can handle. The value must be at least 1024.
398 Use <code class="constant">GL_PROXY_RECTANGLE_TEXTURE</code>
399 to determine if a texture is too large.
400 See <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>.
401 </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p>
402 </p><p>
403 <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that
404 can be used to access texture maps from the fragment shader.
405 The value must be at least 16.
406 See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>.
407 </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_LOD_BIAS</code></span></dt><dd><p>
408 </p><p>
409 <em class="parameter"><code>params</code></em> returns one value,
410 the maximum, absolute value of the texture level-of-detail bias. The
411 value must be at least 2.0.
412 </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_SIZE</code></span></dt><dd><p>
413 </p><p>
414 <em class="parameter"><code>params</code></em> returns one value.
415 The value gives a rough estimate of the largest texture that
416 the GL can handle. The value must be at least 1024.
417 Use a proxy texture target such as <code class="constant">GL_PROXY_TEXTURE_1D</code> or <code class="constant">GL_PROXY_TEXTURE_2D</code>
418 to determine if a texture is too large.
419 See <a href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a> and <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>.
420 </p></dd><dt><span class="term"><code class="constant">GL_MAX_RENDERBUFFER_SIZE</code></span></dt><dd><p>
421 </p><p>
422 <em class="parameter"><code>params</code></em> returns one value.
423 The value indicates the maximum supported size for renderbuffers.
424 See <a href="glFramebufferRenderbuffer.xml"><span class="citerefentry"><span class="refentrytitle">glFramebufferRenderbuffer</span></span></a>.
425 </p></dd><dt><span class="term"><code class="constant">GL_MAX_ARRAY_TEXTURE_LAYERS</code></span></dt><dd><p>
426 </p><p>
427 <em class="parameter"><code>params</code></em> returns one value.
428 The value indicates the maximum number of layers allowed in an array texture, and must be at least 256.
429 See <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>.
430 </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_BUFFER_SIZE</code></span></dt><dd><p>
431 </p><p>
432 <em class="parameter"><code>params</code></em> returns one value.
433 The value gives the maximum number of texels allowed in the texel array of a texture buffer object.
434 Value must be at least 65536.
435 </p></dd><dt><span class="term"><code class="constant">GL_MAX_UNIFORM_BLOCK_SIZE</code></span></dt><dd><p>
436 </p><p>
437 <em class="parameter"><code>params</code></em> returns one value,
438 the maximum size in basic machine units of a uniform block.
439 The value must be at least 16384.
440 See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>.
441 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VARYING_FLOATS</code></span></dt><dd><p>
442 </p><p>
443 <em class="parameter"><code>params</code></em> returns one value,
444 the maximum number of interpolators available for processing varying variables used by
445 vertex and fragment shaders. This value represents the number of individual floating-point
446 values that can be interpolated; varying variables declared as vectors, matrices, and arrays
447 will all consume multiple interpolators. The value must be at least 32.
448 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_ATTRIBS</code></span></dt><dd><p>
449 </p><p>
450 <em class="parameter"><code>params</code></em> returns one value,
451 the maximum number of 4-component generic vertex attributes accessible to a vertex shader.
452 The value must be at least 16.
453 See <a href="glVertexAttrib.xml"><span class="citerefentry"><span class="refentrytitle">glVertexAttrib</span></span></a>.
454 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p>
455 </p><p>
456 <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that
457 can be used to access texture maps from the vertex shader. The value may be at least 16.
458 See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>.
459 </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p>
460 </p><p>
461 <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that
462 can be used to access texture maps from the geometry shader. The value must be at least 16.
463 See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>.
464 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_UNIFORM_COMPONENTS</code></span></dt><dd><p>
465 </p><p>
466 <em class="parameter"><code>params</code></em> returns one value,
467 the maximum number of individual floating-point, integer, or boolean values that can be held
468 in uniform variable storage for a vertex shader. The value must be at least 1024.
469 See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
470 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_OUTPUT_COMPONENTS</code></span></dt><dd><p>
471 </p><p>
472 <em class="parameter"><code>params</code></em> returns one value,
473 the maximum number of components of output written by a vertex shader, which must be at least 64.
474 </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</code></span></dt><dd><p>
475 </p><p>
476 <em class="parameter"><code>params</code></em> returns one value,
477 the maximum number of individual floating-point, integer, or boolean values that can be held
478 in uniform variable storage for a geometry shader. The value must be at least 1024.
479 See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
480 </p></dd><dt><span class="term"><code class="constant">GL_MAX_SAMPLE_MASK_WORDS</code></span></dt><dd><p>
481 </p><p>
482 <em class="parameter"><code>params</code></em> returns one value,
483 the maximum number of sample mask words.
484 </p></dd><dt><span class="term"><code class="constant">GL_MAX_COLOR_TEXTURE_SAMPLES</code></span></dt><dd><p>
485 </p><p>
486 <em class="parameter"><code>params</code></em> returns one value,
487 the maximum number of samples in a color multisample texture.
488 </p></dd><dt><span class="term"><code class="constant">GL_MAX_DEPTH_TEXTURE_SAMPLES</code></span></dt><dd><p>
489 </p><p>
490 <em class="parameter"><code>params</code></em> returns one value,
491 the maximum number of samples in a multisample depth or depth-stencil texture.
492 </p></dd><dt><span class="term"><code class="constant">GL_MAX_DEPTH_TEXTURE_SAMPLES</code></span></dt><dd><p>
493 </p><p>
494 <em class="parameter"><code>params</code></em> returns one value,
495 the maximum number of samples in a multisample depth or depth-stencil texture.
496 </p></dd><dt><span class="term"><code class="constant">GL_MAX_INTEGER_SAMPLES</code></span></dt><dd><p>
497 </p><p>
498 <em class="parameter"><code>params</code></em> returns one value,
499 the maximum number of samples supported in integer format multisample buffers.
500 </p></dd><dt><span class="term"><code class="constant">GL_MAX_SERVER_WAIT_TIMEOUT</code></span></dt><dd><p>
501 </p><p>
502 <em class="parameter"><code>params</code></em> returns one value,
503 the maximum <a href="glWaitSync.xml"><span class="citerefentry"><span class="refentrytitle">glWaitSync</span></span></a> timeout interval.
504 </p></dd><dt><span class="term"><code class="constant">GL_MAX_UNIFORM_BUFFER_BINDINGS</code></span></dt><dd><p>
505 </p><p>
506 <em class="parameter"><code>params</code></em> returns one value,
507 the maximum number of uniform buffer binding points on the context, which must be at least 36.
508 </p></dd><dt><span class="term"><code class="constant">GL_MAX_UNIFORM_BLOCK_SIZE</code></span></dt><dd><p>
509 </p><p>
510 <em class="parameter"><code>params</code></em> returns one value,
511 the maximum size in basic machine units of a uniform block, which must be at least 16384.
512 </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT</code></span></dt><dd><p>
513 </p><p>
514 <em class="parameter"><code>params</code></em> returns one value,
515 the minimum required alignment for uniform buffer sizes and offsets.
516 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_UNIFORM_BLOCKS</code></span></dt><dd><p>
517 </p><p>
518 <em class="parameter"><code>params</code></em> returns one value,
519 the maximum number of uniform blocks per vertex shader. The value must be at least 12.
520 See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>.
521 </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_UNIFORM_BLOCKS</code></span></dt><dd><p>
522 </p><p>
523 <em class="parameter"><code>params</code></em> returns one value,
524 the maximum number of uniform blocks per geometry shader. The value must be at least 12.
525 See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>.
526 </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_INPUT_COMPONENTS</code></span></dt><dd><p>
527 </p><p>
528 <em class="parameter"><code>params</code></em> returns one value,
529 the maximum number of components of inputs read by a geometry shader, which must be at least 64.
530 </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_OUTPUT_COMPONENTS</code></span></dt><dd><p>
531 </p><p>
532 <em class="parameter"><code>params</code></em> returns one value,
533 the maximum number of components of outputs written by a geometry shader, which must be at least 128.
534 </p></dd><dt><span class="term"><code class="constant">GL_MAX_VIEWPORT_DIMS</code></span></dt><dd><p>
535 </p><p>
536 <em class="parameter"><code>params</code></em> returns two values:
537 the maximum supported width and height of the viewport.
538 These must be at least as large as the visible dimensions of the display
539 being rendered to.
540 See <a href="glViewport.xml"><span class="citerefentry"><span class="refentrytitle">glViewport</span></span></a>.
541 </p></dd><dt><span class="term"><code class="constant">GL_NUM_COMPRESSED_TEXTURE_FORMATS</code></span></dt><dd><p>
542 </p><p>
543 <em class="parameter"><code>params</code></em> returns a single integer value indicating the number of available
544 compressed texture formats. The minimum value is 4.
545 See <a href="glCompressedTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage2D</span></span></a>.
546 </p></dd><dt><span class="term"><code class="constant">GL_PACK_ALIGNMENT</code></span></dt><dd><p>
547 </p><p>
548 <em class="parameter"><code>params</code></em> returns one value,
549 the byte alignment used for writing pixel data to memory. The initial
550 value is 4.
551 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
552 </p></dd><dt><span class="term"><code class="constant">GL_PACK_IMAGE_HEIGHT</code></span></dt><dd><p>
553 </p><p>
554 <em class="parameter"><code>params</code></em> returns one value,
555 the image height used for writing pixel data to memory. The initial
556 value is 0.
557 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
558 </p></dd><dt><span class="term"><code class="constant">GL_PACK_LSB_FIRST</code></span></dt><dd><p>
559 </p><p>
560 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether single-bit
561 pixels being written to memory are written first to the least significant
562 bit of each unsigned byte. The initial value is <code class="constant">GL_FALSE</code>.
563 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
564 </p></dd><dt><span class="term"><code class="constant">GL_PACK_ROW_LENGTH</code></span></dt><dd><p>
565 </p><p>
566 <em class="parameter"><code>params</code></em> returns one value,
567 the row length used for writing pixel data to memory. The initial value is
568 0.
569 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
570 </p></dd><dt><span class="term"><code class="constant">GL_PACK_SKIP_IMAGES</code></span></dt><dd><p>
571 </p><p>
572 <em class="parameter"><code>params</code></em> returns one value,
573 the number of pixel images skipped before the first pixel is written
574 into memory. The initial value is 0.
575 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
576 </p></dd><dt><span class="term"><code class="constant">GL_PACK_SKIP_PIXELS</code></span></dt><dd><p>
577 </p><p>
578 <em class="parameter"><code>params</code></em> returns one value,
579 the number of pixel locations skipped before the first pixel is written
580 into memory. The initial value is 0.
581 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
582 </p></dd><dt><span class="term"><code class="constant">GL_PACK_SKIP_ROWS</code></span></dt><dd><p>
583 </p><p>
584 <em class="parameter"><code>params</code></em> returns one value,
585 the number of rows of pixel locations skipped before the first pixel is written
586 into memory. The initial value is 0.
587 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
588 </p></dd><dt><span class="term"><code class="constant">GL_PACK_SWAP_BYTES</code></span></dt><dd><p>
589 </p><p>
590 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether the bytes of
591 two-byte and four-byte pixel indices and components are swapped before being
592 written to memory. The initial value is <code class="constant">GL_FALSE</code>.
593 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
594 </p></dd><dt><span class="term"><code class="constant">GL_PIXEL_PACK_BUFFER_BINDING</code></span></dt><dd><p>
595 </p><p>
596 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
597 currently bound to the target <code class="constant">GL_PIXEL_PACK_BUFFER</code>. If no buffer object
598 is bound to this target, 0 is returned. The initial value is 0.
599 See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>.
600 </p></dd><dt><span class="term"><code class="constant">GL_PIXEL_UNPACK_BUFFER_BINDING</code></span></dt><dd><p>
601 </p><p>
602 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
603 currently bound to the target <code class="constant">GL_PIXEL_UNPACK_BUFFER</code>. If no buffer object
604 is bound to this target, 0 is returned. The initial value is 0.
605 See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>.
606 </p></dd><dt><span class="term"><code class="constant">GL_POINT_FADE_THRESHOLD_SIZE</code></span></dt><dd><p>
607 </p><p>
608 <em class="parameter"><code>params</code></em> returns one value,
609 the point size threshold for determining the point size.
610 See <a href="glPointParameter.xml"><span class="citerefentry"><span class="refentrytitle">glPointParameter</span></span></a>.
611 </p></dd><dt><span class="term"><code class="constant">GL_PRIMITIVE_RESTART_INDEX</code></span></dt><dd><p>
612 </p><p>
613 <em class="parameter"><code>params</code></em> returns one value,
614 the current primitive restart index. The initial value is 0.
615 See <a href="glPrimitiveRestartIndex.xml"><span class="citerefentry"><span class="refentrytitle">glPrimitiveRestartIndex</span></span></a>.
616 </p></dd><dt><span class="term"><code class="constant">GL_PROVOKING_VERTEX</code></span></dt><dd><p>
617 </p><p>
618 <em class="parameter"><code>params</code></em> returns one value,
619 the currently selected provoking vertex convention. The initial value is <code class="constant">GL_LAST_VERTEX_CONVENTION</code>.
620 See <a href="glProvokingVertex.xml"><span class="citerefentry"><span class="refentrytitle">glProvokingVertex</span></span></a>.
621 </p></dd><dt><span class="term"><code class="constant">GL_POINT_SIZE</code></span></dt><dd><p>
622 </p><p>
623 <em class="parameter"><code>params</code></em> returns one value,
624 the point size as specified by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
625 The initial value is 1.
626 </p></dd><dt><span class="term"><code class="constant">GL_POINT_SIZE_GRANULARITY</code></span></dt><dd><p>
627 </p><p>
628 <em class="parameter"><code>params</code></em> returns one value,
629 the size difference between adjacent supported sizes for antialiased points.
630 See <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
631 </p></dd><dt><span class="term"><code class="constant">GL_POINT_SIZE_RANGE</code></span></dt><dd><p>
632 </p><p>
633 <em class="parameter"><code>params</code></em> returns two values:
634 the smallest and largest supported sizes for antialiased
635 points. The smallest size must be at most 1, and the largest size must
636 be at least 1.
637 See <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
638 </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_FACTOR</code></span></dt><dd><p>
639 </p><p>
640 <em class="parameter"><code>params</code></em> returns one value,
641 the scaling factor used to determine the variable offset that is added
642 to the depth value of each fragment generated when a polygon is
643 rasterized. The initial value is 0.
644 See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>.
645 </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_UNITS</code></span></dt><dd><p>
646 </p><p>
647 <em class="parameter"><code>params</code></em> returns one value.
648 This value is multiplied by an implementation-specific value and then
649 added to the depth value of each fragment
650 generated when a polygon is rasterized. The initial value is 0.
651 See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>.
652 </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_FILL</code></span></dt><dd><p>
653 </p><p>
654 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon offset
655 is enabled for polygons in fill mode. The initial value is <code class="constant">GL_FALSE</code>.
656 See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>.
657 </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_LINE</code></span></dt><dd><p>
658 </p><p>
659 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon offset
660 is enabled for polygons in line mode. The initial value is <code class="constant">GL_FALSE</code>.
661 See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>.
662 </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_POINT</code></span></dt><dd><p>
663 </p><p>
664 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon offset
665 is enabled for polygons in point mode. The initial value is <code class="constant">GL_FALSE</code>.
666 See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>.
667 </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_SMOOTH</code></span></dt><dd><p>
668 </p><p>
669 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether antialiasing of
670 polygons is enabled. The initial value is <code class="constant">GL_FALSE</code>.
671 See <a href="glPolygonMode.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonMode</span></span></a>.
672 </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_SMOOTH_HINT</code></span></dt><dd><p>
673 </p><p>
674 <em class="parameter"><code>params</code></em> returns one value,
675 a symbolic constant indicating the mode of the polygon antialiasing
676 hint. The initial value is <code class="constant">GL_DONT_CARE</code>.
677 See <a href="glHint.xml"><span class="citerefentry"><span class="refentrytitle">glHint</span></span></a>.
678 </p></dd><dt><span class="term"><code class="constant">GL_READ_BUFFER</code></span></dt><dd><p>
679 </p><p>
680 <em class="parameter"><code>params</code></em> returns one value,
681 a symbolic constant indicating which color buffer is selected for
682 reading. The initial value is <code class="constant">GL_BACK</code> if there is a back buffer,
683 otherwise it is <code class="constant">GL_FRONT</code>.
684 See
685 <a href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>.
686 </p></dd><dt><span class="term"><code class="constant">GL_SAMPLE_BUFFERS</code></span></dt><dd><p>
687 </p><p>
688 <em class="parameter"><code>params</code></em> returns a single integer value indicating the number of sample buffers
689 associated with the framebuffer.
690 See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>.
691 </p></dd><dt><span class="term"><code class="constant">GL_SAMPLE_COVERAGE_VALUE</code></span></dt><dd><p>
692 </p><p>
693 <em class="parameter"><code>params</code></em> returns a single positive floating-point value indicating the
694 current sample coverage value.
695 See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>.
696 </p></dd><dt><span class="term"><code class="constant">GL_SAMPLE_COVERAGE_INVERT</code></span></dt><dd><p>
697 </p><p>
698 <em class="parameter"><code>params</code></em> returns a single boolean value indicating if the temporary
699 coverage value should be inverted.
700 See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>.
701 </p></dd><dt><span class="term"><code class="constant">GL_SAMPLER_BINDING</code></span></dt><dd><p>
702 </p><p>
703 <em class="parameter"><code>params</code></em> returns a single value, the name of the sampler object
704 currently bound to the active texture unit. The initial value is 0.
705 See <a href="glBindSampler.xml"><span class="citerefentry"><span class="refentrytitle">glBindSampler</span></span></a>.
706 </p></dd><dt><span class="term"><code class="constant">GL_SAMPLES</code></span></dt><dd><p>
707 </p><p>
708 <em class="parameter"><code>params</code></em> returns a single integer value indicating the coverage mask size.
709 See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>.
710 </p></dd><dt><span class="term"><code class="constant">GL_SCISSOR_BOX</code></span></dt><dd><p>
711 </p><p>
712 <em class="parameter"><code>params</code></em> returns four values:
713 the
714 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math>
715 and
716 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math>
717 window coordinates of the scissor box,
718 followed by its width and height.
719 Initially the
720 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math>
721 and
722 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math>
723 window coordinates are both 0 and the
724 width and height are set to the size of the window.
725 See <a href="glScissor.xml"><span class="citerefentry"><span class="refentrytitle">glScissor</span></span></a>.
726 </p></dd><dt><span class="term"><code class="constant">GL_SCISSOR_TEST</code></span></dt><dd><p>
727 </p><p>
728 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether scissoring is
729 enabled. The initial value is <code class="constant">GL_FALSE</code>.
730 See <a href="glScissor.xml"><span class="citerefentry"><span class="refentrytitle">glScissor</span></span></a>.
731 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_FAIL</code></span></dt><dd><p>
732 </p><p>
733 <em class="parameter"><code>params</code></em> returns one value,
734 a symbolic constant indicating what action is taken for back-facing polygons when the stencil
735 test fails. The initial value is <code class="constant">GL_KEEP</code>.
736 See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>.
737 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_FUNC</code></span></dt><dd><p>
738 </p><p>
739 <em class="parameter"><code>params</code></em> returns one value,
740 a symbolic constant indicating what function is used for back-facing polygons to compare the
741 stencil reference value with the stencil buffer value. The initial value
742 is <code class="constant">GL_ALWAYS</code>.
743 See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>.
744 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_PASS_DEPTH_FAIL</code></span></dt><dd><p>
745 </p><p>
746 <em class="parameter"><code>params</code></em> returns one value,
747 a symbolic constant indicating what action is taken for back-facing polygons when the stencil
748 test passes,
749 but the depth test fails. The initial value is <code class="constant">GL_KEEP</code>.
750 See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>.
751 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_PASS_DEPTH_PASS</code></span></dt><dd><p>
752 </p><p>
753 <em class="parameter"><code>params</code></em> returns one value,
754 a symbolic constant indicating what action is taken for back-facing polygons when the stencil
755 test passes and the depth test passes. The initial value is <code class="constant">GL_KEEP</code>.
756 See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>.
757 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_REF</code></span></dt><dd><p>
758 </p><p>
759 <em class="parameter"><code>params</code></em> returns one value,
760 the reference value that is compared with the contents of the stencil
761 buffer for back-facing polygons. The initial value is 0.
762 See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>.
763 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_VALUE_MASK</code></span></dt><dd><p>
764 </p><p>
765 <em class="parameter"><code>params</code></em> returns one value,
766 the mask that is used for back-facing polygons to mask both the stencil reference value and the
767 stencil buffer value before they are compared. The initial value is all 1's.
768 See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>.
769 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_WRITEMASK</code></span></dt><dd><p>
770 </p><p>
771 <em class="parameter"><code>params</code></em> returns one value,
772 the mask that controls writing of the stencil bitplanes for back-facing polygons. The initial value
773 is all 1's.
774 See <a href="glStencilMaskSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilMaskSeparate</span></span></a>.
775 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_CLEAR_VALUE</code></span></dt><dd><p>
776 </p><p>
777 <em class="parameter"><code>params</code></em> returns one value,
778 the index to which the stencil bitplanes are cleared. The initial value is
779 0.
780 See <a href="glClearStencil.xml"><span class="citerefentry"><span class="refentrytitle">glClearStencil</span></span></a>.
781 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_FAIL</code></span></dt><dd><p>
782 </p><p>
783 <em class="parameter"><code>params</code></em> returns one value,
784 a symbolic constant indicating what action is taken when the stencil
785 test fails. The initial value is <code class="constant">GL_KEEP</code>.
786 See <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>.
787 This stencil state only affects non-polygons
788 and front-facing polygons. Back-facing polygons use separate stencil state.
789 See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>.
790 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_FUNC</code></span></dt><dd><p>
791 </p><p>
792 <em class="parameter"><code>params</code></em> returns one value,
793 a symbolic constant indicating what function is used to compare the
794 stencil reference value with the stencil buffer value. The initial value
795 is <code class="constant">GL_ALWAYS</code>.
796 See <a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>.
797 This stencil state only affects non-polygons
798 and front-facing polygons. Back-facing polygons use separate stencil state.
799 See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>.
800 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_PASS_DEPTH_FAIL</code></span></dt><dd><p>
801 </p><p>
802 <em class="parameter"><code>params</code></em> returns one value,
803 a symbolic constant indicating what action is taken when the stencil
804 test passes,
805 but the depth test fails. The initial value is <code class="constant">GL_KEEP</code>.
806 See <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>.
807 This stencil state only affects non-polygons
808 and front-facing polygons. Back-facing polygons use separate stencil state.
809 See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>.
810 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_PASS_DEPTH_PASS</code></span></dt><dd><p>
811 </p><p>
812 <em class="parameter"><code>params</code></em> returns one value,
813 a symbolic constant indicating what action is taken when the stencil
814 test passes and the depth test passes. The initial value is <code class="constant">GL_KEEP</code>.
815 See <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>.
816 This stencil state only affects non-polygons
817 and front-facing polygons. Back-facing polygons use separate stencil state.
818 See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>.
819 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_REF</code></span></dt><dd><p>
820 </p><p>
821 <em class="parameter"><code>params</code></em> returns one value,
822 the reference value that is compared with the contents of the stencil
823 buffer. The initial value is 0.
824 See <a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>.
825 This stencil state only affects non-polygons
826 and front-facing polygons. Back-facing polygons use separate stencil state.
827 See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>.
828 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_TEST</code></span></dt><dd><p>
829 </p><p>
830 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether stencil testing
831 of fragments is enabled. The initial value is <code class="constant">GL_FALSE</code>.
832 See <a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a> and <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>.
833 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_VALUE_MASK</code></span></dt><dd><p>
834 </p><p>
835 <em class="parameter"><code>params</code></em> returns one value,
836 the mask that is used to mask both the stencil reference value and the
837 stencil buffer value before they are compared. The initial value is all 1's.
838 See <a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>.
839 This stencil state only affects non-polygons
840 and front-facing polygons. Back-facing polygons use separate stencil state.
841 See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>.
842 </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_WRITEMASK</code></span></dt><dd><p>
843 </p><p>
844 <em class="parameter"><code>params</code></em> returns one value,
845 the mask that controls writing of the stencil bitplanes. The initial value
846 is all 1's.
847 See <a href="glStencilMask.xml"><span class="citerefentry"><span class="refentrytitle">glStencilMask</span></span></a>.
848 This stencil state only affects non-polygons
849 and front-facing polygons. Back-facing polygons use separate stencil state.
850 See <a href="glStencilMaskSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilMaskSeparate</span></span></a>.
851 </p></dd><dt><span class="term"><code class="constant">GL_STEREO</code></span></dt><dd><p>
852 </p><p>
853 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether stereo buffers
854 (left and right) are supported.
855 </p></dd><dt><span class="term"><code class="constant">GL_SUBPIXEL_BITS</code></span></dt><dd><p>
856 </p><p>
857 <em class="parameter"><code>params</code></em> returns one value,
858 an estimate of the number of bits of subpixel resolution that are used to
859 position rasterized geometry in window coordinates. The value must be at least 4.
860 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_1D</code></span></dt><dd><p>
861 </p><p>
862 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
863 currently bound to the target <code class="constant">GL_TEXTURE_1D</code>. The initial value is 0.
864 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
865 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_1D_ARRAY</code></span></dt><dd><p>
866 </p><p>
867 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
868 currently bound to the target <code class="constant">GL_TEXTURE_1D_ARRAY</code>. The initial value is 0.
869 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
870 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D</code></span></dt><dd><p>
871 </p><p>
872 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
873 currently bound to the target <code class="constant">GL_TEXTURE_2D</code>. The initial value is 0.
874 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
875 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D_ARRAY</code></span></dt><dd><p>
876 </p><p>
877 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
878 currently bound to the target <code class="constant">GL_TEXTURE_2D_ARRAY</code>. The initial value is 0.
879 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
880 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D_MULTISAMPLE</code></span></dt><dd><p>
881 </p><p>
882 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
883 currently bound to the target <code class="constant">GL_TEXTURE_2D_MULTISAMPLE</code>. The initial value is 0.
884 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
885 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY</code></span></dt><dd><p>
886 </p><p>
887 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
888 currently bound to the target <code class="constant">GL_TEXTURE_2D_MULTISAMPLE_ARRAY</code>. The initial value is 0.
889 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
890 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_3D</code></span></dt><dd><p>
891 </p><p>
892 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
893 currently bound to the target <code class="constant">GL_TEXTURE_3D</code>. The initial value is 0.
894 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
895 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_BUFFER</code></span></dt><dd><p>
896 </p><p>
897 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
898 currently bound to the target <code class="constant">GL_TEXTURE_BUFFER</code>. The initial value is 0.
899 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
900 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_CUBE_MAP</code></span></dt><dd><p>
901 </p><p>
902 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
903 currently bound to the target <code class="constant">GL_TEXTURE_CUBE_MAP</code>. The initial value is 0.
904 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
905 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_RECTANGLE</code></span></dt><dd><p>
906 </p><p>
907 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture
908 currently bound to the target <code class="constant">GL_TEXTURE_RECTANGLE</code>. The initial value is 0.
909 See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>.
910 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_COMPRESSION_HINT</code></span></dt><dd><p>
911 </p><p>
912 <em class="parameter"><code>params</code></em> returns a single value indicating the mode of the texture
913 compression hint. The initial value is <code class="constant">GL_DONT_CARE</code>.
914 </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BUFFER_BINDING</code></span></dt><dd><p>
915 </p><p>
916 <em class="parameter"><code>params</code></em> returns a single value, the name of the texture buffer object
917 currently bound. The initial value is 0.
918 See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>.
919 </p></dd><dt><span class="term"><code class="constant">GL_TIMESTAMP</code></span></dt><dd><p>
920 </p><p>
921 <em class="parameter"><code>params</code></em> returns a single value, the 64-bit value of the current
922 GL time.
923 See <a href="glQueryCounter.xml"><span class="citerefentry"><span class="refentrytitle">glQueryCounter</span></span></a>.
924 </p></dd><dt><span class="term"><code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_BINDING</code></span></dt><dd><p>
925 </p><p>
926 When used with non-indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegerv</code>),
927 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
928 currently bound to the target <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER</code>. If no buffer object
929 is bound to this target, 0 is returned.
930 When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegeri_v</code>),
931 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
932 bound to the indexed transform feedback attribute stream. The initial value is 0 for all targets.
933 See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>, <a href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>, and
934 <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>.
935 </p></dd><dt><span class="term"><code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_START</code></span></dt><dd><p>
936 </p><p>
937 When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>),
938 <em class="parameter"><code>params</code></em> returns a single value, the start offset of the binding range for each
939 transform feedback attribute stream. The initial value is 0 for all streams.
940 See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>.
941 </p></dd><dt><span class="term"><code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_SIZE</code></span></dt><dd><p>
942 </p><p>
943 When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>),
944 <em class="parameter"><code>params</code></em> returns a single value, the size of the binding range for each
945 transform feedback attribute stream. The initial value is 0 for all streams.
946 See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>.
947 </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_BINDING</code></span></dt><dd><p>
948 </p><p>
949 When used with non-indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegerv</code>),
950 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
951 currently bound to the target <code class="constant">GL_UNIFORM_BUFFER</code>. If no buffer object
952 is bound to this target, 0 is returned.
953 When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegeri_v</code>),
954 <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
955 bound to the indexed uniform buffer binding point. The initial value is 0 for all targets.
956 See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>, <a href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>, and
957 <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>.
958 </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_START</code></span></dt><dd><p>
959 </p><p>
960 When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>),
961 <em class="parameter"><code>params</code></em> returns a single value, the start offset of the binding range for each
962 indexed uniform buffer binding. The initial value is 0 for all bindings.
963 See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>.
964 </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_SIZE</code></span></dt><dd><p>
965 </p><p>
966 When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>),
967 <em class="parameter"><code>params</code></em> returns a single value, the size of the binding range for each
968 indexed uniform buffer binding. The initial value is 0 for all bindings.
969 See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>.
970 </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT</code></span></dt><dd><p>
971 </p><p>
972 <em class="parameter"><code>params</code></em> returns a single value, the minimum required alignment
973 for uniform buffer sizes and offset. The initial value is 1.
974 See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>.
975 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_ALIGNMENT</code></span></dt><dd><p>
976 </p><p>
977 <em class="parameter"><code>params</code></em> returns one value,
978 the byte alignment used for reading pixel data from memory. The initial
979 value is 4.
980 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
981 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_IMAGE_HEIGHT</code></span></dt><dd><p>
982 </p><p>
983 <em class="parameter"><code>params</code></em> returns one value,
984 the image height used for reading pixel data from memory. The initial
985 is 0.
986 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
987 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_LSB_FIRST</code></span></dt><dd><p>
988 </p><p>
989 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether single-bit
990 pixels being read from memory are read first from the least significant
991 bit of each unsigned byte. The initial value is <code class="constant">GL_FALSE</code>.
992 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
993 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_ROW_LENGTH</code></span></dt><dd><p>
994 </p><p>
995 <em class="parameter"><code>params</code></em> returns one value,
996 the row length used for reading pixel data from memory. The initial value
997 is 0.
998 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
999 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SKIP_IMAGES</code></span></dt><dd><p>
1000 </p><p>
1001 <em class="parameter"><code>params</code></em> returns one value,
1002 the number of pixel images skipped before the first pixel is read
1003 from memory. The initial value is 0.
1004 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
1005 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SKIP_PIXELS</code></span></dt><dd><p>
1006 </p><p>
1007 <em class="parameter"><code>params</code></em> returns one value,
1008 the number of pixel locations skipped before the first pixel is read
1009 from memory. The initial value is 0.
1010 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
1011 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SKIP_ROWS</code></span></dt><dd><p>
1012 </p><p>
1013 <em class="parameter"><code>params</code></em> returns one value,
1014 the number of rows of pixel locations skipped before the first pixel is read
1015 from memory. The initial value is 0.
1016 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
1017 </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SWAP_BYTES</code></span></dt><dd><p>
1018 </p><p>
1019 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether the bytes of
1020 two-byte and four-byte pixel indices and components are swapped after being
1021 read from memory. The initial value is <code class="constant">GL_FALSE</code>.
1022 See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
1023 </p></dd><dt><span class="term"><code class="constant">GL_NUM_EXTENSIONS</code></span></dt><dd><p>
1024 </p><p>
1025 <em class="parameter"><code>params</code></em> returns one value,
1026 the number of extensions supported by the GL implementation for the current context.
1027 See <a href="glGetString.xml"><span class="citerefentry"><span class="refentrytitle">glGetString</span></span></a>.
1028 </p></dd><dt><span class="term"><code class="constant">GL_MAJOR_VERSION</code></span></dt><dd><p>
1029 </p><p>
1030 <em class="parameter"><code>params</code></em> returns one value,
1031 the major version number of the OpenGL API supported by the current context.
1032 </p></dd><dt><span class="term"><code class="constant">GL_MINOR_VERSION</code></span></dt><dd><p>
1033 </p><p>
1034 <em class="parameter"><code>params</code></em> returns one value,
1035 the minor version number of the OpenGL API supported by the current context.
1036 </p></dd><dt><span class="term"><code class="constant">GL_CONTEXT_FLAGS</code></span></dt><dd><p>
1037 </p><p>
1038 <em class="parameter"><code>params</code></em> returns one value,
1039 the flags with which the context was created (such as debugging functionality).
1040 </p></dd><dt><span class="term"><code class="constant">GL_VERTEX_PROGRAM_POINT_SIZE</code></span></dt><dd><p>
1041 </p><p>
1042 <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether vertex
1043 program point size mode is enabled. If enabled, and a vertex shader is active, then the
1044 point size is taken from the shader built-in <code class="code">gl_PointSize</code>. If disabled,
1045 and a vertex shader is active, then the point size is taken from the point state as specified
1046 by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
1047 The initial value is <code class="constant">GL_FALSE</code>.
1048 </p></dd><dt><span class="term"><code class="constant">GL_VIEWPORT</code></span></dt><dd><p>
1049 </p><p>
1050 <em class="parameter"><code>params</code></em> returns four values:
1051 the
1052 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math>
1053 and
1054 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math>
1055 window coordinates of the viewport,
1056 followed by its width and height.
1057 Initially the
1058 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math>
1059 and
1060 <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math>
1061 window coordinates are both set to 0,
1062 and the width and height are set to the width and height of the window into
1063 which the GL will do its rendering.
1064 See <a href="glViewport.xml"><span class="citerefentry"><span class="refentrytitle">glViewport</span></span></a>.
1065 </p></dd></dl></div><p>
1066 Many of the boolean parameters can also be queried more easily using
1067 <a href="glIsEnabled.xml"><span class="citerefentry"><span class="refentrytitle">glIsEnabled</span></span></a>.
1068 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
1069 The following parameters return the associated value for the active texture unit:
1070 <code class="constant">GL_TEXTURE_1D</code>, <code class="constant">GL_TEXTURE_BINDING_1D</code>,
1071 <code class="constant">GL_TEXTURE_2D</code>, <code class="constant">GL_TEXTURE_BINDING_2D</code>,
1072 <code class="constant">GL_TEXTURE_3D</code> and <code class="constant">GL_TEXTURE_BINDING_3D</code>.
1073 </p><p>
1074 <code class="constant">GL_MAX_RECTANGLE_TEXTURE_SIZE</code>, <code class="constant">GL_MAX_TEXTURE_BUFFER_SIZE</code>,
1075 <code class="constant">GL_UNIFORM_BUFFER_BINDING</code>, <code class="constant">GL_TEXTURE_BUFFER_BINDING</code>,
1076 <code class="constant">GL_MAX_VERTEX_UNIFORM_BLOCKS</code>, <code class="constant">GL_MAX_FRAGMENT_UNIFORM_BLOCKS</code>,
1077 <code class="constant">GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</code>, <code class="constant">GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</code>
1078 <code class="constant">GL_MAX_COMBINED_UNIFORM_BLOCKS</code>, <code class="constant">GL_MAX_UNIFORM_BLOCK_SIZE</code>,
1079 and <code class="constant">GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT</code>
1080 are available only if the GL version is 3.1 or greater.
1081 </p><p>
1082 <code class="constant">GL_MAX_COMBINED_GEOMETRY_UNIFORM_COMPONENTS</code>, <code class="constant">GL_MAX_GEOMETRY_UNIFORM_BLOCKS</code>,
1083 <code class="constant">GL_MAX_GEOMETRY_INPUT_COMPONENTS</code>, <code class="constant">GL_MAX_GEOMETRY_OUTPUT_COMPONENTS</code>,
1084 <code class="constant">GL_MAX_GEOMETRY_OUTPUT_VERTICES</code>, <code class="constant">GL_MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS</code> and
1085 <code class="constant">GL_MAX_GEOMETRY_TEXTURE_IMAGE_UNITS</code> are available only if the GL version is 3.2 or greater.
1086 </p><p>
1087 <code class="function">glGetInteger64v</code> and <code class="function">glGetInteger64i_v</code> are available only if
1088 the GL version is 3.2 or greater.
1089 </p><p>
1090 <code class="constant">GL_MAX_DUALSOURCE_DRAW_BUFFERS</code>, <code class="constant">GL_SAMPLER_BINDING</code>, and
1091 <code class="constant">GL_TIMESTAMP</code> are available only if the GL version is 3.3 or greater.
1092 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
1093 <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>pname</code></em> is not an accepted value.
1094 </p><p>
1095 <code class="constant">GL_INVALID_VALUE</code> is generated on any of <code class="function">glGetBooleani_v</code>,
1096 <code class="function">glGetIntegeri_v</code>, or <code class="function">glGetInteger64i_v</code> if
1097 <em class="parameter"><code>index</code></em> is outside of the valid range for the indexed state <em class="parameter"><code>target</code></em>.
1098 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
1099 <a href="glGetActiveUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetActiveUniform</span></span></a>,
1100 <a href="glGetAttachedShaders.xml"><span class="citerefentry"><span class="refentrytitle">glGetAttachedShaders</span></span></a>,
1101 <a href="glGetAttribLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetAttribLocation</span></span></a>,
1102 <a href="glGetBufferParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetBufferParameter</span></span></a>,
1103 <a href="glGetBufferPointerv.xml"><span class="citerefentry"><span class="refentrytitle">glGetBufferPointerv</span></span></a>,
1104 <a href="glGetBufferSubData.xml"><span class="citerefentry"><span class="refentrytitle">glGetBufferSubData</span></span></a>,
1105 <a href="glGetCompressedTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetCompressedTexImage</span></span></a>,
1106 <a href="glGetError.xml"><span class="citerefentry"><span class="refentrytitle">glGetError</span></span></a>,
1107 <a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>,
1108 <a href="glGetProgramInfoLog.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgramInfoLog</span></span></a>,
1109 <a href="glGetQueryiv.xml"><span class="citerefentry"><span class="refentrytitle">glGetQueryiv</span></span></a>,
1110 <a href="glGetQueryObject.xml"><span class="citerefentry"><span class="refentrytitle">glGetQueryObject</span></span></a>,
1111 <a href="glGetShader.xml"><span class="citerefentry"><span class="refentrytitle">glGetShader</span></span></a>,
1112 <a href="glGetShaderInfoLog.xml"><span class="citerefentry"><span class="refentrytitle">glGetShaderInfoLog</span></span></a>,
1113 <a href="glGetShaderSource.xml"><span class="citerefentry"><span class="refentrytitle">glGetShaderSource</span></span></a>,
1114 <a href="glGetString.xml"><span class="citerefentry"><span class="refentrytitle">glGetString</span></span></a>,
1115 <a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>,
1116 <a href="glGetTexLevelParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexLevelParameter</span></span></a>,
1117 <a href="glGetTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexParameter</span></span></a>,
1118 <a href="glGetUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniform</span></span></a>,
1119 <a href="glGetUniformLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformLocation</span></span></a>,
1120 <a href="glGetVertexAttrib.xml"><span class="citerefentry"><span class="refentrytitle">glGetVertexAttrib</span></span></a>,
1121 <a href="glGetVertexAttribPointerv.xml"><span class="citerefentry"><span class="refentrytitle">glGetVertexAttribPointerv</span></span></a>,
1122 <a href="glIsEnabled.xml"><span class="citerefentry"><span class="refentrytitle">glIsEnabled</span></span></a>
1123 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
1124 Copyright <span class="trademark"></span>© 1991-2006
1125 Silicon Graphics, Inc. This document is licensed under the SGI
1126 Free Software B License. For details, see
1127 <a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
1128 </p></div></div></body></html>