Commit | Line | Data |
---|---|---|
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 4 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">glGetFloati_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>GLfloat * </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">glGetDoublei_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>GLdouble * </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_ARRAY_BUFFER_BINDING</code></span></dt><dd><p> | |
55 | </p><p> | |
56 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
57 | currently bound to the target <code class="constant">GL_ARRAY_BUFFER</code>. If no buffer object | |
58 | is bound to this target, 0 is returned. The initial value is 0. | |
59 | See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>. | |
60 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND</code></span></dt><dd><p> | |
61 | </p><p> | |
62 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether blending is | |
63 | enabled. The initial value is <code class="constant">GL_FALSE</code>. | |
64 | See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a>. | |
65 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND_COLOR</code></span></dt><dd><p> | |
66 | </p><p> | |
67 | <em class="parameter"><code>params</code></em> returns four values, | |
68 | the red, green, blue, and alpha values which are the components of | |
69 | the blend color. | |
70 | See <a href="glBlendColor.xml"><span class="citerefentry"><span class="refentrytitle">glBlendColor</span></span></a>. | |
71 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND_DST_ALPHA</code></span></dt><dd><p> | |
72 | </p><p> | |
73 | <em class="parameter"><code>params</code></em> returns one value, | |
74 | the symbolic constant identifying the alpha destination blend | |
75 | function. The initial value is <code class="constant">GL_ZERO</code>. | |
76 | 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>. | |
77 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND_DST_RGB</code></span></dt><dd><p> | |
78 | </p><p> | |
79 | <em class="parameter"><code>params</code></em> returns one value, | |
80 | the symbolic constant identifying the RGB destination blend | |
81 | function. The initial value is <code class="constant">GL_ZERO</code>. | |
82 | 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>. | |
83 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND_EQUATION_RGB</code></span></dt><dd><p> | |
84 | </p><p> | |
85 | <em class="parameter"><code>params</code></em> returns one value, a symbolic constant indicating whether | |
86 | the RGB blend equation is <code class="constant">GL_FUNC_ADD</code>, <code class="constant">GL_FUNC_SUBTRACT</code>, | |
87 | <code class="constant">GL_FUNC_REVERSE_SUBTRACT</code>, <code class="constant">GL_MIN</code> or <code class="constant">GL_MAX</code>. | |
88 | See <a href="glBlendEquationSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendEquationSeparate</span></span></a>. | |
89 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND_EQUATION_ALPHA</code></span></dt><dd><p> | |
90 | </p><p> | |
91 | <em class="parameter"><code>params</code></em> returns one value, a symbolic constant indicating whether | |
92 | the Alpha blend equation is <code class="constant">GL_FUNC_ADD</code>, <code class="constant">GL_FUNC_SUBTRACT</code>, | |
93 | <code class="constant">GL_FUNC_REVERSE_SUBTRACT</code>, <code class="constant">GL_MIN</code> or <code class="constant">GL_MAX</code>. | |
94 | See <a href="glBlendEquationSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendEquationSeparate</span></span></a>. | |
95 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND_SRC_ALPHA</code></span></dt><dd><p> | |
96 | </p><p> | |
97 | <em class="parameter"><code>params</code></em> returns one value, | |
98 | the symbolic constant identifying the alpha source blend function. The initial | |
99 | value is <code class="constant">GL_ONE</code>. | |
100 | 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>. | |
101 | </p></dd><dt><span class="term"><code class="constant">GL_BLEND_SRC_RGB</code></span></dt><dd><p> | |
102 | </p><p> | |
103 | <em class="parameter"><code>params</code></em> returns one value, | |
104 | the symbolic constant identifying the RGB source blend function. The initial | |
105 | value is <code class="constant">GL_ONE</code>. | |
106 | 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>. | |
107 | </p></dd><dt><span class="term"><code class="constant">GL_COLOR_CLEAR_VALUE</code></span></dt><dd><p> | |
108 | </p><p> | |
109 | <em class="parameter"><code>params</code></em> returns four values: | |
110 | the red, green, blue, and alpha values used to clear the color buffers. | |
111 | Integer values, | |
112 | if requested, | |
113 | are linearly mapped from the internal floating-point representation such | |
114 | that 1.0 returns the most positive representable integer value, | |
115 | and | |
116 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
117 | ||
118 | <mml:mn>-1.0</mml:mn> | |
119 | </mml:math> | |
120 | returns the most negative representable integer | |
121 | value. The initial value is (0, 0, 0, 0). | |
122 | See <a href="glClearColor.xml"><span class="citerefentry"><span class="refentrytitle">glClearColor</span></span></a>. | |
123 | </p></dd><dt><span class="term"><code class="constant">GL_COLOR_LOGIC_OP</code></span></dt><dd><p> | |
124 | </p><p> | |
125 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether a fragment's | |
126 | RGBA color values are merged into the framebuffer using a logical | |
127 | operation. The initial value is <code class="constant">GL_FALSE</code>. | |
128 | See <a href="glLogicOp.xml"><span class="citerefentry"><span class="refentrytitle">glLogicOp</span></span></a>. | |
129 | </p></dd><dt><span class="term"><code class="constant">GL_COLOR_WRITEMASK</code></span></dt><dd><p> | |
130 | </p><p> | |
131 | <em class="parameter"><code>params</code></em> returns four boolean values: | |
132 | the red, green, blue, and alpha write enables for the color | |
133 | buffers. The initial value is (<code class="constant">GL_TRUE</code>, <code class="constant">GL_TRUE</code>, | |
134 | <code class="constant">GL_TRUE</code>, <code class="constant">GL_TRUE</code>). | |
135 | See <a href="glColorMask.xml"><span class="citerefentry"><span class="refentrytitle">glColorMask</span></span></a>. | |
136 | </p></dd><dt><span class="term"><code class="constant">GL_COMPRESSED_TEXTURE_FORMATS</code></span></dt><dd><p> | |
137 | </p><p> | |
138 | <em class="parameter"><code>params</code></em> returns a list of symbolic | |
139 | constants of length <code class="constant">GL_NUM_COMPRESSED_TEXTURE_FORMATS</code> | |
140 | indicating which compressed texture formats are available. | |
141 | See <a href="glCompressedTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage2D</span></span></a>. | |
142 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_SHADER_STORAGE_BLOCKS</code></span></dt><dd><p> | |
143 | </p><p> | |
144 | <em class="parameter"><code>params</code></em> returns one value, | |
145 | the maximum number of active shader storage blocks that may be accessed by a compute shader. | |
146 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_SHADER_STORAGE_BLOCKS</code></span></dt><dd><p> | |
147 | </p><p> | |
148 | <em class="parameter"><code>params</code></em> returns one value, | |
149 | the maximum total number of active shader storage blocks that may be accessed by all active shaders. | |
150 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_UNIFORM_BLOCKS</code></span></dt><dd><p> | |
151 | </p><p> | |
152 | <em class="parameter"><code>params</code></em> returns one value, | |
153 | the maximum number of uniform blocks per compute shader. The value must be at least 14. | |
154 | See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>. | |
155 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p> | |
156 | </p><p> | |
157 | <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that | |
158 | can be used to access texture maps from the compute shader. The value may be at least 16. | |
159 | See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>. | |
160 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
161 | </p><p> | |
162 | <em class="parameter"><code>params</code></em> returns one value, | |
163 | the maximum number of individual floating-point, integer, or boolean values that can be held | |
164 | in uniform variable storage for a compute shader. The value must be at least 1024. | |
165 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
166 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_ATOMIC_COUNTERS</code></span></dt><dd><p> | |
167 | </p><p> | |
168 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counters available to compute shaders. | |
169 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_ATOMIC_COUNTER_BUFFERS</code></span></dt><dd><p> | |
170 | </p><p> | |
171 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counter buffers that may be accessed by a compute shader. | |
172 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_COMPUTE_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
173 | </p><p> | |
174 | <em class="parameter"><code>params</code></em> returns one value, | |
175 | the number of words for compute shader uniform variables in all uniform | |
176 | blocks (including default). The value must be at least 1. | |
177 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
178 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_WORK_GROUP_INVOCATIONS</code></span></dt><dd><p> | |
179 | </p><p> | |
180 | <em class="parameter"><code>params</code></em> returns one value, | |
181 | the number of invocations in a single local work group | |
182 | (i.e., the product of the three dimensions) that may | |
183 | be dispatched to a compute shader. | |
184 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_WORK_GROUP_COUNT</code></span></dt><dd><p> | |
185 | </p><p> | |
186 | Accepted by the indexed versions of <code class="function">glGet</code>. | |
187 | <em class="parameter"><code>params</code></em> the maximum number of work | |
188 | groups that may be dispatched to a compute shader. Indices | |
189 | 0, 1, and 2 correspond to the X, Y and Z dimensions, respectively. | |
190 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMPUTE_WORK_GROUP_SIZE</code></span></dt><dd><p> | |
191 | </p><p> | |
192 | Accepted by the indexed versions of <code class="function">glGet</code>. | |
193 | <em class="parameter"><code>params</code></em> the maximum size of a work | |
194 | groups that may be used during compilation of a compute shader. Indices | |
195 | 0, 1, and 2 correspond to the X, Y and Z dimensions, respectively. | |
196 | </p></dd><dt><span class="term"><code class="constant">GL_DISPATCH_INDIRECT_BUFFER_BINDING</code></span></dt><dd><p> | |
197 | </p><p> | |
198 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
199 | currently bound to the target <code class="constant">GL_DISPATCH_INDIRECT_BUFFER</code>. If no buffer object | |
200 | is bound to this target, 0 is returned. The initial value is 0. | |
201 | See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>. | |
202 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_DEBUG_GROUP_STACK_DEPTH</code></span></dt><dd><p> | |
203 | </p><p> | |
204 | <em class="parameter"><code>params</code></em> returns a single value, the maximum depth of the | |
205 | debug message group stack. | |
206 | </p></dd><dt><span class="term"><code class="constant">GL_DEBUG_GROUP_STACK_DEPTH</code></span></dt><dd><p> | |
207 | </p><p> | |
208 | <em class="parameter"><code>params</code></em> returns a single value, the current depth of the | |
209 | debug message group stack. | |
210 | </p></dd><dt><span class="term"><code class="constant">GL_CONTEXT_FLAGS</code></span></dt><dd><p> | |
211 | </p><p> | |
212 | <em class="parameter"><code>params</code></em> returns one value, | |
213 | the flags with which the context was created (such as debugging functionality). | |
214 | </p></dd><dt><span class="term"><code class="constant">GL_CULL_FACE</code></span></dt><dd><p> | |
215 | </p><p> | |
216 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon culling | |
217 | is enabled. The initial value is <code class="constant">GL_FALSE</code>. | |
218 | See <a href="glCullFace.xml"><span class="citerefentry"><span class="refentrytitle">glCullFace</span></span></a>. | |
219 | </p></dd><dt><span class="term"><code class="constant">GL_CURRENT_PROGRAM</code></span></dt><dd><p> | |
220 | </p><p> | |
221 | <em class="parameter"><code>params</code></em> returns one value, | |
222 | the name of the program object that is currently active, or 0 if no program object is active. | |
223 | See <a href="glUseProgram.xml"><span class="citerefentry"><span class="refentrytitle">glUseProgram</span></span></a>. | |
224 | </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_CLEAR_VALUE</code></span></dt><dd><p> | |
225 | </p><p> | |
226 | <em class="parameter"><code>params</code></em> returns one value, | |
227 | the value that is used to clear the depth buffer. | |
228 | Integer values, | |
229 | if requested, | |
230 | are linearly mapped from the internal floating-point representation such | |
231 | that 1.0 returns the most positive representable integer value, | |
232 | and | |
233 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
234 | ||
235 | <mml:mn>-1.0</mml:mn> | |
236 | </mml:math> | |
237 | returns the most negative representable integer | |
238 | value. The initial value is 1. | |
239 | See <a href="glClearDepth.xml"><span class="citerefentry"><span class="refentrytitle">glClearDepth</span></span></a>. | |
240 | </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_FUNC</code></span></dt><dd><p> | |
241 | </p><p> | |
242 | <em class="parameter"><code>params</code></em> returns one value, | |
243 | the symbolic constant that indicates the depth comparison | |
244 | function. The initial value is <code class="constant">GL_LESS</code>. | |
245 | See <a href="glDepthFunc.xml"><span class="citerefentry"><span class="refentrytitle">glDepthFunc</span></span></a>. | |
246 | </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_RANGE</code></span></dt><dd><p> | |
247 | </p><p> | |
248 | <em class="parameter"><code>params</code></em> returns two values: | |
249 | the near and far mapping limits for the depth buffer. | |
250 | Integer values, | |
251 | if requested, | |
252 | are linearly mapped from the internal floating-point representation such | |
253 | that 1.0 returns the most positive representable integer value, | |
254 | and | |
255 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"> | |
256 | ||
257 | <mml:mn>-1.0</mml:mn> | |
258 | </mml:math> | |
259 | returns the most negative representable integer | |
260 | value. The initial value is (0, 1). | |
261 | See <a href="glDepthRange.xml"><span class="citerefentry"><span class="refentrytitle">glDepthRange</span></span></a>. | |
262 | </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_TEST</code></span></dt><dd><p> | |
263 | </p><p> | |
264 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether depth testing | |
265 | of fragments is enabled. The initial value is <code class="constant">GL_FALSE</code>. | |
266 | 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>. | |
267 | </p></dd><dt><span class="term"><code class="constant">GL_DEPTH_WRITEMASK</code></span></dt><dd><p> | |
268 | </p><p> | |
269 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating if the depth buffer | |
270 | is enabled for writing. The initial value is <code class="constant">GL_TRUE</code>. | |
271 | See <a href="glDepthMask.xml"><span class="citerefentry"><span class="refentrytitle">glDepthMask</span></span></a>. | |
272 | </p></dd><dt><span class="term"><code class="constant">GL_DITHER</code></span></dt><dd><p> | |
273 | </p><p> | |
274 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether dithering of | |
275 | fragment colors and indices is enabled. The initial value is <code class="constant">GL_TRUE</code>. | |
276 | </p></dd><dt><span class="term"><code class="constant">GL_DOUBLEBUFFER</code></span></dt><dd><p> | |
277 | </p><p> | |
278 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether double buffering | |
279 | is supported. | |
280 | </p></dd><dt><span class="term"><code class="constant">GL_DRAW_BUFFER</code></span></dt><dd><p> | |
281 | </p><p> | |
282 | <em class="parameter"><code>params</code></em> returns one value, | |
283 | a symbolic constant indicating which buffers are being drawn to. | |
284 | 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 | |
285 | are back buffers, otherwise it is <code class="constant">GL_FRONT</code>. | |
286 | </p></dd><dt><span class="term"><code class="constant">GL_DRAW_BUFFER</code><span class="emphasis"><em>i</em></span></span></dt><dd><p> | |
287 | </p><p> | |
288 | <em class="parameter"><code>params</code></em> returns one value, | |
289 | a symbolic constant indicating which buffers are being drawn to by the corresponding output color. | |
290 | See <a href="glDrawBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDrawBuffers</span></span></a>. | |
291 | The initial value of <code class="constant">GL_DRAW_BUFFER0</code> is <code class="constant">GL_BACK</code> if there | |
292 | are back buffers, otherwise it is <code class="constant">GL_FRONT</code>. The | |
293 | initial values of draw buffers for all other output colors is <code class="constant">GL_NONE</code>. | |
294 | </p></dd><dt><span class="term"><code class="constant">GL_DRAW_FRAMEBUFFER_BINDING</code></span></dt><dd><p> | |
295 | </p><p> | |
296 | <em class="parameter"><code>params</code></em> returns one value, | |
297 | the name of the framebuffer object currently bound to the <code class="constant">GL_DRAW_FRAMEBUFFER</code> target. | |
298 | If the default framebuffer is bound, this value will be zero. The initial value is zero. | |
299 | See <a href="glBindFramebuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindFramebuffer</span></span></a>. | |
300 | </p></dd><dt><span class="term"><code class="constant">GL_READ_FRAMEBUFFER_BINDING</code></span></dt><dd><p> | |
301 | </p><p> | |
302 | <em class="parameter"><code>params</code></em> returns one value, | |
303 | the name of the framebuffer object currently bound to the <code class="constant">GL_READ_FRAMEBUFFER</code> target. | |
304 | If the default framebuffer is bound, this value will be zero. The initial value is zero. | |
305 | See <a href="glBindFramebuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindFramebuffer</span></span></a>. | |
306 | </p></dd><dt><span class="term"><code class="constant">GL_ELEMENT_ARRAY_BUFFER_BINDING</code></span></dt><dd><p> | |
307 | </p><p> | |
308 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
309 | currently bound to the target <code class="constant">GL_ELEMENT_ARRAY_BUFFER</code>. If no buffer object | |
310 | is bound to this target, 0 is returned. The initial value is 0. | |
311 | See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>. | |
312 | </p></dd><dt><span class="term"><code class="constant">GL_FRAGMENT_SHADER_DERIVATIVE_HINT</code></span></dt><dd><p> | |
313 | </p><p> | |
314 | <em class="parameter"><code>params</code></em> returns one value, | |
315 | a symbolic constant indicating the mode of the derivative accuracy hint | |
316 | for fragment shaders. The initial value | |
317 | is <code class="constant">GL_DONT_CARE</code>. | |
318 | See <a href="glHint.xml"><span class="citerefentry"><span class="refentrytitle">glHint</span></span></a>. | |
319 | </p></dd><dt><span class="term"><code class="constant">GL_IMPLEMENTATION_COLOR_READ_FORMAT</code></span></dt><dd><p> | |
320 | </p><p> | |
321 | <em class="parameter"><code>params</code></em> returns a single GLenum value indicating | |
322 | the implementation's preferred pixel data format. | |
323 | See <a href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>. | |
324 | </p></dd><dt><span class="term"><code class="constant">GL_IMPLEMENTATION_COLOR_READ_TYPE</code></span></dt><dd><p> | |
325 | </p><p> | |
326 | <em class="parameter"><code>params</code></em> returns a single GLenum value indicating | |
327 | the implementation's preferred pixel data type. | |
328 | See <a href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>. | |
329 | </p></dd><dt><span class="term"><code class="constant">GL_LINE_SMOOTH</code></span></dt><dd><p> | |
330 | </p><p> | |
331 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether antialiasing of | |
332 | lines is enabled. The initial value is <code class="constant">GL_FALSE</code>. | |
333 | See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>. | |
334 | </p></dd><dt><span class="term"><code class="constant">GL_LINE_SMOOTH_HINT</code></span></dt><dd><p> | |
335 | </p><p> | |
336 | <em class="parameter"><code>params</code></em> returns one value, | |
337 | a symbolic constant indicating the mode of the line antialiasing | |
338 | hint. The initial value is <code class="constant">GL_DONT_CARE</code>. | |
339 | See <a href="glHint.xml"><span class="citerefentry"><span class="refentrytitle">glHint</span></span></a>. | |
340 | </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH</code></span></dt><dd><p> | |
341 | </p><p> | |
342 | <em class="parameter"><code>params</code></em> returns one value, | |
343 | the line width as specified with <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>. The initial value is | |
344 | 1. | |
345 | </p></dd><dt><span class="term"><code class="constant">GL_LAYER_PROVOKING_VERTEX</code></span></dt><dd><p> | |
346 | </p><p> | |
347 | <em class="parameter"><code>params</code></em> returns one value, | |
348 | the implementation dependent specifc vertex of a primitive that is used to select the rendering layer. | |
349 | If the value returned is equivalent to <code class="constant">GL_PROVOKING_VERTEX</code>, then the vertex | |
350 | selection follows the convention specified by | |
351 | <a href="glProvokingVertex.xml"><span class="citerefentry"><span class="refentrytitle">glProvokingVertex</span></span></a>. | |
352 | If the value returned is equivalent to <code class="constant">GL_FIRST_VERTEX_CONVENTION</code>, then the | |
353 | selection is always taken from the first vertex in the primitive. | |
354 | If the value returned is equivalent to <code class="constant">GL_LAST_VERTEX_CONVENTION</code>, then the | |
355 | selection is always taken from the last vertex in the primitive. | |
356 | If the value returned is equivalent to <code class="constant">GL_UNDEFINED_VERTEX</code>, then the | |
357 | selection is not guaranteed to be taken from any specific vertex in the primitive. | |
7faf1d71 AW |
358 | </p></dd><dt><span class="term"><code class="constant">GL_LOGIC_OP_MODE</code></span></dt><dd><p> |
359 | </p><p> | |
360 | <em class="parameter"><code>params</code></em> returns one value, | |
361 | a symbolic constant indicating the selected logic operation | |
362 | mode. The initial value is <code class="constant">GL_COPY</code>. | |
363 | See <a href="glLogicOp.xml"><span class="citerefentry"><span class="refentrytitle">glLogicOp</span></span></a>. | |
364 | </p></dd><dt><span class="term"><code class="constant">GL_MAJOR_VERSION</code></span></dt><dd><p> | |
365 | </p><p> | |
366 | <em class="parameter"><code>params</code></em> returns one value, | |
367 | the major version number of the OpenGL API supported by the current context. | |
368 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_3D_TEXTURE_SIZE</code></span></dt><dd><p> | |
369 | </p><p> | |
370 | <em class="parameter"><code>params</code></em> returns one value, | |
371 | a rough estimate of the largest 3D texture that the GL can handle. | |
372 | The value must be at least 64. | |
373 | Use <code class="constant">GL_PROXY_TEXTURE_3D</code> to determine if a texture is too large. | |
374 | See <a href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>. | |
375 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_ARRAY_TEXTURE_LAYERS</code></span></dt><dd><p> | |
376 | </p><p> | |
377 | <em class="parameter"><code>params</code></em> returns one value. | |
378 | The value indicates the maximum number of layers allowed in an array texture, and must be at least 256. | |
379 | See <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>. | |
380 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_CLIP_DISTANCES</code></span></dt><dd><p> | |
381 | </p><p> | |
382 | <em class="parameter"><code>params</code></em> returns one value, | |
383 | the maximum number of application-defined clipping distances. The value must be at least 8. | |
384 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COLOR_TEXTURE_SAMPLES</code></span></dt><dd><p> | |
385 | </p><p> | |
386 | <em class="parameter"><code>params</code></em> returns one value, | |
387 | the maximum number of samples in a color multisample texture. | |
388 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_ATOMIC_COUNTERS</code></span></dt><dd><p> | |
389 | </p><p> | |
390 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counters available to all active shaders. | |
391 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
392 | </p><p> | |
393 | <em class="parameter"><code>params</code></em> returns one value, | |
394 | the number of words for fragment shader uniform variables in all uniform | |
395 | blocks (including default). The value must be at least 1. | |
396 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
397 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_GEOMETRY_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
398 | </p><p> | |
399 | <em class="parameter"><code>params</code></em> returns one value, | |
400 | the number of words for geometry shader uniform variables in all uniform | |
401 | blocks (including default). The value must be at least 1. | |
402 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
403 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p> | |
404 | </p><p> | |
405 | <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that | |
406 | can be used to access texture maps from the vertex shader and the fragment processor combined. | |
407 | If both the vertex shader and the fragment processing stage access the same texture image | |
408 | unit, then that counts as using two texture image units against this limit. | |
409 | The value must be at least 48. | |
410 | See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>. | |
411 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_UNIFORM_BLOCKS</code></span></dt><dd><p> | |
412 | </p><p> | |
413 | <em class="parameter"><code>params</code></em> returns one value, | |
414 | the maximum number of uniform blocks per program. The value must be at least 36. | |
415 | See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>. | |
416 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
417 | </p><p> | |
418 | <em class="parameter"><code>params</code></em> returns one value, | |
419 | the number of words for vertex shader uniform variables in all uniform | |
420 | blocks (including default). The value must be at least 1. | |
421 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
422 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_CUBE_MAP_TEXTURE_SIZE</code></span></dt><dd><p> | |
423 | </p><p> | |
424 | <em class="parameter"><code>params</code></em> returns one value. | |
425 | The value gives a rough estimate of the largest cube-map texture that | |
426 | the GL can handle. The value must be at least 1024. | |
427 | Use <code class="constant">GL_PROXY_TEXTURE_CUBE_MAP</code> | |
428 | to determine if a texture is too large. | |
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_DEPTH_TEXTURE_SAMPLES</code></span></dt><dd><p> | |
431 | </p><p> | |
432 | <em class="parameter"><code>params</code></em> returns one value, | |
433 | the maximum number of samples in a multisample depth or depth-stencil texture. | |
434 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_DRAW_BUFFERS</code></span></dt><dd><p> | |
435 | </p><p> | |
436 | <em class="parameter"><code>params</code></em> returns one value, the maximum number | |
437 | of simultaneous outputs that may be written in a fragment shader. | |
438 | The value must be at least 8. | |
439 | See <a href="glDrawBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDrawBuffers</span></span></a>. | |
c7b31271 | 440 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</code></span></dt><dd><p> |
7faf1d71 AW |
441 | </p><p> |
442 | <em class="parameter"><code>params</code></em> returns one value, the maximum number | |
443 | of active draw buffers when using dual-source blending. The value must be at least 1. | |
444 | See <a href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a> and | |
445 | <a href="glBlendFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFuncSeparate</span></span></a>. | |
446 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_ELEMENTS_INDICES</code></span></dt><dd><p> | |
447 | </p><p> | |
448 | <em class="parameter"><code>params</code></em> returns one value, | |
449 | the recommended maximum number of vertex array indices. | |
450 | See <a href="glDrawRangeElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElements</span></span></a>. | |
451 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_ELEMENTS_VERTICES</code></span></dt><dd><p> | |
452 | </p><p> | |
453 | <em class="parameter"><code>params</code></em> returns one value, | |
454 | the recommended maximum number of vertex array vertices. | |
455 | See <a href="glDrawRangeElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElements</span></span></a>. | |
456 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_ATOMIC_COUNTERS</code></span></dt><dd><p> | |
457 | </p><p> | |
458 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counters available to fragment shaders. | |
459 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_SHADER_STORAGE_BLOCKS</code></span></dt><dd><p> | |
460 | </p><p> | |
461 | <em class="parameter"><code>params</code></em> returns one value, | |
462 | the maximum number of active shader storage blocks that may be accessed by a fragment shader. | |
463 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_INPUT_COMPONENTS</code></span></dt><dd><p> | |
464 | </p><p> | |
465 | <em class="parameter"><code>params</code></em> returns one value, | |
466 | the maximum number of components of the inputs read by the fragment shader, which must be at least 128. | |
467 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
468 | </p><p> | |
469 | <em class="parameter"><code>params</code></em> returns one value, | |
470 | the maximum number of individual floating-point, integer, or boolean values that can be held | |
471 | in uniform variable storage for a fragment shader. The value must be at least 1024. | |
472 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
473 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_UNIFORM_VECTORS</code></span></dt><dd><p> | |
474 | </p><p> | |
475 | <em class="parameter"><code>params</code></em> returns one value, | |
476 | the maximum number of individual 4-vectors of floating-point, integer, or boolean values | |
477 | that can be held | |
478 | in uniform variable storage for a fragment shader. The value is equal to the value of | |
479 | <code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code> divided by 4 and must be at least 256. | |
480 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
481 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAGMENT_UNIFORM_BLOCKS</code></span></dt><dd><p> | |
482 | </p><p> | |
483 | <em class="parameter"><code>params</code></em> returns one value, | |
484 | the maximum number of uniform blocks per fragment shader. The value must be at least 12. | |
485 | See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>. | |
486 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAMEBUFFER_WIDTH</code></span></dt><dd><p> | |
487 | </p><p> | |
488 | <em class="parameter"><code>params</code></em> returns one value, | |
489 | the maximum width for a framebuffer that has no attachments, which must be at least 16384. | |
490 | See <a href="glFramebufferParameter.xml"><span class="citerefentry"><span class="refentrytitle">glFramebufferParameter</span></span></a>. | |
491 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAMEBUFFER_HEIGHT</code></span></dt><dd><p> | |
492 | </p><p> | |
493 | <em class="parameter"><code>params</code></em> returns one value, | |
494 | the maximum height for a framebuffer that has no attachments, which must be at least 16384. | |
495 | See <a href="glFramebufferParameter.xml"><span class="citerefentry"><span class="refentrytitle">glFramebufferParameter</span></span></a>. | |
496 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAMEBUFFER_LAYERS</code></span></dt><dd><p> | |
497 | </p><p> | |
498 | <em class="parameter"><code>params</code></em> returns one value, | |
499 | the maximum number of layers for a framebuffer that has no attachments, which must be at least 2048. | |
500 | See <a href="glFramebufferParameter.xml"><span class="citerefentry"><span class="refentrytitle">glFramebufferParameter</span></span></a>. | |
501 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_FRAMEBUFFER_SAMPLES</code></span></dt><dd><p> | |
502 | </p><p> | |
503 | <em class="parameter"><code>params</code></em> returns one value, | |
504 | the maximum samples in a framebuffer that has no attachments, which must be at least 4. | |
505 | See <a href="glFramebufferParameter.xml"><span class="citerefentry"><span class="refentrytitle">glFramebufferParameter</span></span></a>. | |
506 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_ATOMIC_COUNTERS</code></span></dt><dd><p> | |
507 | </p><p> | |
508 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counters available to geometry shaders. | |
509 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_SHADER_STORAGE_BLOCKS</code></span></dt><dd><p> | |
510 | </p><p> | |
511 | <em class="parameter"><code>params</code></em> returns one value, | |
512 | the maximum number of active shader storage blocks that may be accessed by a geometry shader. | |
513 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_INPUT_COMPONENTS</code></span></dt><dd><p> | |
514 | </p><p> | |
515 | <em class="parameter"><code>params</code></em> returns one value, | |
516 | the maximum number of components of inputs read by a geometry shader, which must be at least 64. | |
517 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_OUTPUT_COMPONENTS</code></span></dt><dd><p> | |
518 | </p><p> | |
519 | <em class="parameter"><code>params</code></em> returns one value, | |
520 | the maximum number of components of outputs written by a geometry shader, which must be at least 128. | |
521 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p> | |
522 | </p><p> | |
523 | <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that | |
524 | can be used to access texture maps from the geometry shader. The value must be at least 16. | |
525 | See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>. | |
526 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_UNIFORM_BLOCKS</code></span></dt><dd><p> | |
527 | </p><p> | |
528 | <em class="parameter"><code>params</code></em> returns one value, | |
529 | the maximum number of uniform blocks per geometry shader. The value must be at least 12. | |
530 | See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>. | |
531 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
532 | </p><p> | |
533 | <em class="parameter"><code>params</code></em> returns one value, | |
534 | the maximum number of individual floating-point, integer, or boolean values that can be held | |
535 | in uniform variable storage for a geometry shader. The value must be at least 1024. | |
536 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
537 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_INTEGER_SAMPLES</code></span></dt><dd><p> | |
538 | </p><p> | |
539 | <em class="parameter"><code>params</code></em> returns one value, | |
540 | the maximum number of samples supported in integer format multisample buffers. | |
541 | </p></dd><dt><span class="term"><code class="constant">GL_MIN_MAP_BUFFER_ALIGNMENT</code></span></dt><dd><p> | |
542 | </p><p> | |
543 | <em class="parameter"><code>params</code></em> returns one value, | |
544 | the minimum alignment in basic machine units of pointers returned from<a href="glMapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glMapBuffer</span></span></a> | |
545 | and <a href="glMapBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glMapBufferRange</span></span></a>. This value must be a power of two and must | |
546 | be at least 64. | |
547 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_LABEL_LENGTH</code></span></dt><dd><p> | |
548 | </p><p> | |
549 | <em class="parameter"><code>params</code></em> returns one value, | |
550 | the maximum length of a label that may be assigned to an object. | |
551 | See <a href="glObjectLabel.xml"><span class="citerefentry"><span class="refentrytitle">glObjectLabel</span></span></a> and | |
552 | <a href="glObjectPtrLabel.xml"><span class="citerefentry"><span class="refentrytitle">glObjectPtrLabel</span></span></a>. | |
553 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_PROGRAM_TEXEL_OFFSET</code></span></dt><dd><p> | |
554 | </p><p> | |
555 | <em class="parameter"><code>params</code></em> returns one value, | |
556 | the maximum texel offset allowed in a texture lookup, which must be at least 7. | |
557 | </p></dd><dt><span class="term"><code class="constant">GL_MIN_PROGRAM_TEXEL_OFFSET</code></span></dt><dd><p> | |
558 | </p><p> | |
559 | <em class="parameter"><code>params</code></em> returns one value, | |
560 | the minimum texel offset allowed in a texture lookup, which must be at most -8. | |
561 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_RECTANGLE_TEXTURE_SIZE</code></span></dt><dd><p> | |
562 | </p><p> | |
563 | <em class="parameter"><code>params</code></em> returns one value. | |
564 | The value gives a rough estimate of the largest rectangular texture that | |
565 | the GL can handle. The value must be at least 1024. | |
c7b31271 | 566 | Use <code class="constant">GL_PROXY_TEXTURE_RECTANGLE</code> |
7faf1d71 AW |
567 | to determine if a texture is too large. |
568 | See <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>. | |
569 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_RENDERBUFFER_SIZE</code></span></dt><dd><p> | |
570 | </p><p> | |
571 | <em class="parameter"><code>params</code></em> returns one value. | |
572 | The value indicates the maximum supported size for renderbuffers. | |
573 | See <a href="glFramebufferRenderbuffer.xml"><span class="citerefentry"><span class="refentrytitle">glFramebufferRenderbuffer</span></span></a>. | |
574 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_SAMPLE_MASK_WORDS</code></span></dt><dd><p> | |
575 | </p><p> | |
576 | <em class="parameter"><code>params</code></em> returns one value, | |
577 | the maximum number of sample mask words. | |
578 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_SERVER_WAIT_TIMEOUT</code></span></dt><dd><p> | |
579 | </p><p> | |
580 | <em class="parameter"><code>params</code></em> returns one value, | |
581 | the maximum <a href="glWaitSync.xml"><span class="citerefentry"><span class="refentrytitle">glWaitSync</span></span></a> timeout interval. | |
582 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_SHADER_STORAGE_BUFFER_BINDINGS</code></span></dt><dd><p> | |
583 | </p><p> | |
584 | <em class="parameter"><code>params</code></em> returns one value, | |
585 | the maximum number of shader storage buffer binding points on the context, which must be at least 8. | |
586 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TESS_CONTROL_ATOMIC_COUNTERS</code></span></dt><dd><p> | |
587 | </p><p> | |
588 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counters available to tessellation control shaders. | |
589 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TESS_EVALUATION_ATOMIC_COUNTERS</code></span></dt><dd><p> | |
590 | </p><p> | |
591 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counters available to tessellation evaluation shaders. | |
592 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TESS_CONTROL_SHADER_STORAGE_BLOCKS</code></span></dt><dd><p> | |
593 | </p><p> | |
594 | <em class="parameter"><code>params</code></em> returns one value, | |
595 | the maximum number of active shader storage blocks that may be accessed by a tessellation control shader. | |
596 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TESS_EVALUATION_SHADER_STORAGE_BLOCKS</code></span></dt><dd><p> | |
597 | </p><p> | |
598 | <em class="parameter"><code>params</code></em> returns one value, | |
599 | the maximum number of active shader storage blocks that may be accessed by a tessellation evaluation shader. | |
600 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_BUFFER_SIZE</code></span></dt><dd><p> | |
601 | </p><p> | |
602 | <em class="parameter"><code>params</code></em> returns one value. | |
603 | The value gives the maximum number of texels allowed in the texel array of a texture buffer object. | |
604 | Value must be at least 65536. | |
605 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p> | |
606 | </p><p> | |
607 | <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that | |
608 | can be used to access texture maps from the fragment shader. | |
609 | The value must be at least 16. | |
610 | See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>. | |
611 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_LOD_BIAS</code></span></dt><dd><p> | |
612 | </p><p> | |
613 | <em class="parameter"><code>params</code></em> returns one value, | |
614 | the maximum, absolute value of the texture level-of-detail bias. The | |
615 | value must be at least 2.0. | |
616 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_SIZE</code></span></dt><dd><p> | |
617 | </p><p> | |
618 | <em class="parameter"><code>params</code></em> returns one value. | |
619 | The value gives a rough estimate of the largest texture that | |
620 | the GL can handle. The value must be at least 1024. | |
621 | Use a proxy texture target such as <code class="constant">GL_PROXY_TEXTURE_1D</code> or <code class="constant">GL_PROXY_TEXTURE_2D</code> | |
622 | to determine if a texture is too large. | |
623 | 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>. | |
624 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_UNIFORM_BUFFER_BINDINGS</code></span></dt><dd><p> | |
625 | </p><p> | |
626 | <em class="parameter"><code>params</code></em> returns one value, | |
627 | the maximum number of uniform buffer binding points on the context, which must be at least 36. | |
628 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_UNIFORM_BLOCK_SIZE</code></span></dt><dd><p> | |
629 | </p><p> | |
630 | <em class="parameter"><code>params</code></em> returns one value, | |
631 | the maximum size in basic machine units of a uniform block, which must be at least 16384. | |
632 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_UNIFORM_LOCATIONS</code></span></dt><dd><p> | |
633 | </p><p> | |
634 | <em class="parameter"><code>params</code></em> returns one value, | |
635 | the maximum number of explicitly assignable uniform locations, which must be at least 1024. | |
636 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VARYING_COMPONENTS</code></span></dt><dd><p> | |
637 | </p><p> | |
638 | <em class="parameter"><code>params</code></em> returns one value, | |
639 | the number components for varying variables, which must be at least 60. | |
640 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VARYING_VECTORS</code></span></dt><dd><p> | |
641 | </p><p> | |
642 | <em class="parameter"><code>params</code></em> returns one value, | |
643 | the number 4-vectors for varying variables, which is equal to the value of | |
644 | <code class="constant">GL_MAX_VARYING_COMPONENTS</code> and must be at least 15. | |
645 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VARYING_FLOATS</code></span></dt><dd><p> | |
646 | </p><p> | |
647 | <em class="parameter"><code>params</code></em> returns one value, | |
648 | the maximum number of interpolators available for processing varying variables used by | |
649 | vertex and fragment shaders. This value represents the number of individual floating-point | |
650 | values that can be interpolated; varying variables declared as vectors, matrices, and arrays | |
651 | will all consume multiple interpolators. The value must be at least 32. | |
652 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_ATOMIC_COUNTERS</code></span></dt><dd><p> | |
653 | </p><p> | |
654 | <em class="parameter"><code>params</code></em> returns a single value, the maximum number of atomic counters available to vertex shaders. | |
655 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_ATTRIBS</code></span></dt><dd><p> | |
656 | </p><p> | |
657 | <em class="parameter"><code>params</code></em> returns one value, | |
658 | the maximum number of 4-component generic vertex attributes accessible to a vertex shader. | |
659 | The value must be at least 16. | |
660 | See <a href="glVertexAttrib.xml"><span class="citerefentry"><span class="refentrytitle">glVertexAttrib</span></span></a>. | |
661 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_SHADER_STORAGE_BLOCKS</code></span></dt><dd><p> | |
662 | </p><p> | |
663 | <em class="parameter"><code>params</code></em> returns one value, | |
664 | the maximum number of active shader storage blocks that may be accessed by a vertex shader. | |
665 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p> | |
666 | </p><p> | |
667 | <em class="parameter"><code>params</code></em> returns one value, the maximum supported texture image units that | |
668 | can be used to access texture maps from the vertex shader. The value may be at least 16. | |
669 | See <a href="glActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glActiveTexture</span></span></a>. | |
670 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_UNIFORM_COMPONENTS</code></span></dt><dd><p> | |
671 | </p><p> | |
672 | <em class="parameter"><code>params</code></em> returns one value, | |
673 | the maximum number of individual floating-point, integer, or boolean values that can be held | |
674 | in uniform variable storage for a vertex shader. The value must be at least 1024. | |
675 | See <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>. | |
676 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_UNIFORM_VECTORS</code></span></dt><dd><p> | |
677 | </p><p> | |
678 | <em class="parameter"><code>params</code></em> returns one value, | |
679 | the maximum number of 4-vectors that may be held in uniform variable storage for the vertex | |
680 | shader. The value of <code class="constant">GL_MAX_VERTEX_UNIFORM_VECTORS</code> is equal to the | |
681 | value of <code class="constant">GL_MAX_VERTEX_UNIFORM_COMPONENTS</code> and must be at least | |
682 | 256. | |
683 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_OUTPUT_COMPONENTS</code></span></dt><dd><p> | |
684 | </p><p> | |
685 | <em class="parameter"><code>params</code></em> returns one value, | |
686 | the maximum number of components of output written by a vertex shader, which must be at least 64. | |
687 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_UNIFORM_BLOCKS</code></span></dt><dd><p> | |
688 | </p><p> | |
689 | <em class="parameter"><code>params</code></em> returns one value, | |
690 | the maximum number of uniform blocks per vertex shader. The value must be at least 12. | |
691 | See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>. | |
692 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VIEWPORT_DIMS</code></span></dt><dd><p> | |
693 | </p><p> | |
694 | <em class="parameter"><code>params</code></em> returns two values: | |
695 | the maximum supported width and height of the viewport. | |
696 | These must be at least as large as the visible dimensions of the display | |
697 | being rendered to. | |
698 | See <a href="glViewport.xml"><span class="citerefentry"><span class="refentrytitle">glViewport</span></span></a>. | |
699 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VIEWPORTS</code></span></dt><dd><p> | |
700 | </p><p> | |
701 | <em class="parameter"><code>params</code></em> returns one value, the maximum number | |
702 | of simultaneous viewports that are supported. | |
703 | The value must be at least 16. | |
704 | See <a href="glViewportIndexed.xml"><span class="citerefentry"><span class="refentrytitle">glViewportIndexed</span></span></a>. | |
705 | </p></dd><dt><span class="term"><code class="constant">GL_MINOR_VERSION</code></span></dt><dd><p> | |
706 | </p><p> | |
707 | <em class="parameter"><code>params</code></em> returns one value, | |
708 | the minor version number of the OpenGL API supported by the current context. | |
709 | </p></dd><dt><span class="term"><code class="constant">GL_NUM_COMPRESSED_TEXTURE_FORMATS</code></span></dt><dd><p> | |
710 | </p><p> | |
711 | <em class="parameter"><code>params</code></em> returns a single integer value indicating the number of available | |
712 | compressed texture formats. The minimum value is 4. | |
713 | See <a href="glCompressedTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage2D</span></span></a>. | |
714 | </p></dd><dt><span class="term"><code class="constant">GL_NUM_EXTENSIONS</code></span></dt><dd><p> | |
715 | </p><p> | |
716 | <em class="parameter"><code>params</code></em> returns one value, | |
717 | the number of extensions supported by the GL implementation for the current context. | |
718 | See <a href="glGetString.xml"><span class="citerefentry"><span class="refentrytitle">glGetString</span></span></a>. | |
719 | </p></dd><dt><span class="term"><code class="constant">GL_NUM_PROGRAM_BINARY_FORMATS</code></span></dt><dd><p> | |
720 | </p><p> | |
721 | <em class="parameter"><code>params</code></em> returns one value, | |
722 | the number of program binary formats supported by the implementation. | |
723 | </p></dd><dt><span class="term"><code class="constant">GL_NUM_SHADER_BINARY_FORMATS</code></span></dt><dd><p> | |
724 | </p><p> | |
725 | <em class="parameter"><code>params</code></em> returns one value, | |
726 | the number of binary shader formats supported by the implementation. If this value is | |
727 | greater than zero, then the implementation supports loading binary shaders. If it is | |
728 | zero, then the loading of binary shaders by the implementation is not supported. | |
729 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_ALIGNMENT</code></span></dt><dd><p> | |
730 | </p><p> | |
731 | <em class="parameter"><code>params</code></em> returns one value, | |
732 | the byte alignment used for writing pixel data to memory. The initial | |
733 | value is 4. | |
734 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
735 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_IMAGE_HEIGHT</code></span></dt><dd><p> | |
736 | </p><p> | |
737 | <em class="parameter"><code>params</code></em> returns one value, | |
738 | the image height used for writing pixel data to memory. The initial | |
739 | value is 0. | |
740 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
741 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_LSB_FIRST</code></span></dt><dd><p> | |
742 | </p><p> | |
743 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether single-bit | |
744 | pixels being written to memory are written first to the least significant | |
745 | bit of each unsigned byte. The initial value is <code class="constant">GL_FALSE</code>. | |
746 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
747 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_ROW_LENGTH</code></span></dt><dd><p> | |
748 | </p><p> | |
749 | <em class="parameter"><code>params</code></em> returns one value, | |
750 | the row length used for writing pixel data to memory. The initial value is | |
751 | 0. | |
752 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
753 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_SKIP_IMAGES</code></span></dt><dd><p> | |
754 | </p><p> | |
755 | <em class="parameter"><code>params</code></em> returns one value, | |
756 | the number of pixel images skipped before the first pixel is written | |
757 | into memory. The initial value is 0. | |
758 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
759 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_SKIP_PIXELS</code></span></dt><dd><p> | |
760 | </p><p> | |
761 | <em class="parameter"><code>params</code></em> returns one value, | |
762 | the number of pixel locations skipped before the first pixel is written | |
763 | into memory. The initial value is 0. | |
764 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
765 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_SKIP_ROWS</code></span></dt><dd><p> | |
766 | </p><p> | |
767 | <em class="parameter"><code>params</code></em> returns one value, | |
768 | the number of rows of pixel locations skipped before the first pixel is written | |
769 | into memory. The initial value is 0. | |
770 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
771 | </p></dd><dt><span class="term"><code class="constant">GL_PACK_SWAP_BYTES</code></span></dt><dd><p> | |
772 | </p><p> | |
773 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether the bytes of | |
774 | two-byte and four-byte pixel indices and components are swapped before being | |
775 | written to memory. The initial value is <code class="constant">GL_FALSE</code>. | |
776 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
777 | </p></dd><dt><span class="term"><code class="constant">GL_PIXEL_PACK_BUFFER_BINDING</code></span></dt><dd><p> | |
778 | </p><p> | |
779 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
780 | currently bound to the target <code class="constant">GL_PIXEL_PACK_BUFFER</code>. If no buffer object | |
781 | is bound to this target, 0 is returned. The initial value is 0. | |
782 | See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>. | |
783 | </p></dd><dt><span class="term"><code class="constant">GL_PIXEL_UNPACK_BUFFER_BINDING</code></span></dt><dd><p> | |
784 | </p><p> | |
785 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
786 | currently bound to the target <code class="constant">GL_PIXEL_UNPACK_BUFFER</code>. If no buffer object | |
787 | is bound to this target, 0 is returned. The initial value is 0. | |
788 | See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>. | |
789 | </p></dd><dt><span class="term"><code class="constant">GL_POINT_FADE_THRESHOLD_SIZE</code></span></dt><dd><p> | |
790 | </p><p> | |
791 | <em class="parameter"><code>params</code></em> returns one value, | |
792 | the point size threshold for determining the point size. | |
793 | See <a href="glPointParameter.xml"><span class="citerefentry"><span class="refentrytitle">glPointParameter</span></span></a>. | |
794 | </p></dd><dt><span class="term"><code class="constant">GL_PRIMITIVE_RESTART_INDEX</code></span></dt><dd><p> | |
795 | </p><p> | |
796 | <em class="parameter"><code>params</code></em> returns one value, | |
797 | the current primitive restart index. The initial value is 0. | |
798 | See <a href="glPrimitiveRestartIndex.xml"><span class="citerefentry"><span class="refentrytitle">glPrimitiveRestartIndex</span></span></a>. | |
799 | </p></dd><dt><span class="term"><code class="constant">GL_PROGRAM_BINARY_FORMATS</code></span></dt><dd><p> | |
800 | </p><p> | |
801 | <em class="parameter"><code>params</code></em> an array of <code class="constant">GL_NUM_PROGRAM_BINARY_FORMATS</code> values, | |
802 | indicating the proram binary formats supported by the implementation. | |
803 | </p></dd><dt><span class="term"><code class="constant">GL_PROGRAM_PIPELINE_BINDING</code></span></dt><dd><p> | |
804 | </p><p> | |
805 | <em class="parameter"><code>params</code></em> a single value, the name of the currently bound program pipeline | |
806 | object, or zero if no program pipeline object is bound. | |
807 | See <a href="glBindProgramPipeline.xml"><span class="citerefentry"><span class="refentrytitle">glBindProgramPipeline</span></span></a>. | |
c7b31271 DH |
808 | </p></dd><dt><span class="term"><code class="constant">GL_PROGRAM_POINT_SIZE</code></span></dt><dd><p> |
809 | </p><p> | |
810 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether vertex | |
811 | program point size mode is enabled. If enabled, then the | |
812 | point size is taken from the shader built-in <code class="code">gl_PointSize</code>. If disabled, | |
813 | then the point size is taken from the point state as specified | |
814 | by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>. | |
815 | The initial value is <code class="constant">GL_FALSE</code>. | |
7faf1d71 AW |
816 | </p></dd><dt><span class="term"><code class="constant">GL_PROVOKING_VERTEX</code></span></dt><dd><p> |
817 | </p><p> | |
818 | <em class="parameter"><code>params</code></em> returns one value, | |
819 | the currently selected provoking vertex convention. The initial value is <code class="constant">GL_LAST_VERTEX_CONVENTION</code>. | |
820 | See <a href="glProvokingVertex.xml"><span class="citerefentry"><span class="refentrytitle">glProvokingVertex</span></span></a>. | |
821 | </p></dd><dt><span class="term"><code class="constant">GL_POINT_SIZE</code></span></dt><dd><p> | |
822 | </p><p> | |
823 | <em class="parameter"><code>params</code></em> returns one value, | |
824 | the point size as specified by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>. | |
825 | The initial value is 1. | |
826 | </p></dd><dt><span class="term"><code class="constant">GL_POINT_SIZE_GRANULARITY</code></span></dt><dd><p> | |
827 | </p><p> | |
828 | <em class="parameter"><code>params</code></em> returns one value, | |
829 | the size difference between adjacent supported sizes for antialiased points. | |
830 | See <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>. | |
831 | </p></dd><dt><span class="term"><code class="constant">GL_POINT_SIZE_RANGE</code></span></dt><dd><p> | |
832 | </p><p> | |
833 | <em class="parameter"><code>params</code></em> returns two values: | |
834 | the smallest and largest supported sizes for antialiased | |
835 | points. The smallest size must be at most 1, and the largest size must | |
836 | be at least 1. | |
837 | See <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>. | |
838 | </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_FACTOR</code></span></dt><dd><p> | |
839 | </p><p> | |
840 | <em class="parameter"><code>params</code></em> returns one value, | |
841 | the scaling factor used to determine the variable offset that is added | |
842 | to the depth value of each fragment generated when a polygon is | |
843 | rasterized. The initial value is 0. | |
844 | See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>. | |
845 | </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_UNITS</code></span></dt><dd><p> | |
846 | </p><p> | |
847 | <em class="parameter"><code>params</code></em> returns one value. | |
848 | This value is multiplied by an implementation-specific value and then | |
849 | added to the depth value of each fragment | |
850 | generated when a polygon is rasterized. The initial value is 0. | |
851 | See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>. | |
852 | </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_FILL</code></span></dt><dd><p> | |
853 | </p><p> | |
854 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon offset | |
855 | is enabled for polygons in fill mode. The initial value is <code class="constant">GL_FALSE</code>. | |
856 | See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>. | |
857 | </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_LINE</code></span></dt><dd><p> | |
858 | </p><p> | |
859 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon offset | |
860 | is enabled for polygons in line mode. The initial value is <code class="constant">GL_FALSE</code>. | |
861 | See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>. | |
862 | </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_OFFSET_POINT</code></span></dt><dd><p> | |
863 | </p><p> | |
864 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether polygon offset | |
865 | is enabled for polygons in point mode. The initial value is <code class="constant">GL_FALSE</code>. | |
866 | See <a href="glPolygonOffset.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonOffset</span></span></a>. | |
867 | </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_SMOOTH</code></span></dt><dd><p> | |
868 | </p><p> | |
869 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether antialiasing of | |
870 | polygons is enabled. The initial value is <code class="constant">GL_FALSE</code>. | |
871 | See <a href="glPolygonMode.xml"><span class="citerefentry"><span class="refentrytitle">glPolygonMode</span></span></a>. | |
872 | </p></dd><dt><span class="term"><code class="constant">GL_POLYGON_SMOOTH_HINT</code></span></dt><dd><p> | |
873 | </p><p> | |
874 | <em class="parameter"><code>params</code></em> returns one value, | |
875 | a symbolic constant indicating the mode of the polygon antialiasing | |
876 | hint. The initial value is <code class="constant">GL_DONT_CARE</code>. | |
877 | See <a href="glHint.xml"><span class="citerefentry"><span class="refentrytitle">glHint</span></span></a>. | |
878 | </p></dd><dt><span class="term"><code class="constant">GL_READ_BUFFER</code></span></dt><dd><p> | |
879 | </p><p> | |
880 | <em class="parameter"><code>params</code></em> returns one value, | |
881 | a symbolic constant indicating which color buffer is selected for | |
882 | reading. The initial value is <code class="constant">GL_BACK</code> if there is a back buffer, | |
883 | otherwise it is <code class="constant">GL_FRONT</code>. | |
884 | See | |
885 | <a href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>. | |
886 | </p></dd><dt><span class="term"><code class="constant">GL_RENDERBUFFER_BINDING</code></span></dt><dd><p> | |
887 | </p><p> | |
888 | <em class="parameter"><code>params</code></em> returns a single value, the name of the renderbuffer object | |
889 | currently bound to the target <code class="constant">GL_RENDERBUFFER</code>. If no renderbuffer object | |
890 | is bound to this target, 0 is returned. The initial value is 0. | |
891 | See <a href="glBindRenderbuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindRenderbuffer</span></span></a>. | |
892 | </p></dd><dt><span class="term"><code class="constant">GL_SAMPLE_BUFFERS</code></span></dt><dd><p> | |
893 | </p><p> | |
894 | <em class="parameter"><code>params</code></em> returns a single integer value indicating the number of sample buffers | |
895 | associated with the framebuffer. | |
896 | See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>. | |
897 | </p></dd><dt><span class="term"><code class="constant">GL_SAMPLE_COVERAGE_VALUE</code></span></dt><dd><p> | |
898 | </p><p> | |
899 | <em class="parameter"><code>params</code></em> returns a single positive floating-point value indicating the | |
900 | current sample coverage value. | |
901 | See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>. | |
902 | </p></dd><dt><span class="term"><code class="constant">GL_SAMPLE_COVERAGE_INVERT</code></span></dt><dd><p> | |
903 | </p><p> | |
904 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating if the temporary | |
905 | coverage value should be inverted. | |
906 | See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>. | |
907 | </p></dd><dt><span class="term"><code class="constant">GL_SAMPLER_BINDING</code></span></dt><dd><p> | |
908 | </p><p> | |
909 | <em class="parameter"><code>params</code></em> returns a single value, the name of the sampler object | |
910 | currently bound to the active texture unit. The initial value is 0. | |
911 | See <a href="glBindSampler.xml"><span class="citerefentry"><span class="refentrytitle">glBindSampler</span></span></a>. | |
912 | </p></dd><dt><span class="term"><code class="constant">GL_SAMPLES</code></span></dt><dd><p> | |
913 | </p><p> | |
914 | <em class="parameter"><code>params</code></em> returns a single integer value indicating the coverage mask size. | |
915 | See <a href="glSampleCoverage.xml"><span class="citerefentry"><span class="refentrytitle">glSampleCoverage</span></span></a>. | |
916 | </p></dd><dt><span class="term"><code class="constant">GL_SCISSOR_BOX</code></span></dt><dd><p> | |
917 | </p><p> | |
918 | <em class="parameter"><code>params</code></em> returns four values: | |
919 | the | |
920 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math> | |
921 | and | |
922 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math> | |
923 | window coordinates of the scissor box, | |
924 | followed by its width and height. | |
925 | Initially the | |
926 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math> | |
927 | and | |
928 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math> | |
929 | window coordinates are both 0 and the | |
930 | width and height are set to the size of the window. | |
931 | See <a href="glScissor.xml"><span class="citerefentry"><span class="refentrytitle">glScissor</span></span></a>. | |
932 | </p></dd><dt><span class="term"><code class="constant">GL_SCISSOR_TEST</code></span></dt><dd><p> | |
933 | </p><p> | |
934 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether scissoring is | |
935 | enabled. The initial value is <code class="constant">GL_FALSE</code>. | |
936 | See <a href="glScissor.xml"><span class="citerefentry"><span class="refentrytitle">glScissor</span></span></a>. | |
937 | </p></dd><dt><span class="term"><code class="constant">GL_SHADER_COMPILER</code></span></dt><dd><p> | |
938 | </p><p> | |
939 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether an online shader | |
940 | compiler is present in the implementation. All desktop OpenGL implementations must support | |
941 | online shader compilations, and therefore the value of <code class="constant">GL_SHADER_COMPILER</code> | |
942 | will always be <code class="constant">GL_TRUE</code>. | |
943 | </p></dd><dt><span class="term"><code class="constant">GL_SHADER_STORAGE_BUFFER_BINDING</code></span></dt><dd><p> | |
944 | </p><p> | |
945 | When used with non-indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegerv</code>), | |
946 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
947 | currently bound to the target <code class="constant">GL_SHADER_STORAGE_BUFFER</code>. If no buffer object | |
948 | is bound to this target, 0 is returned. | |
949 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegeri_v</code>), | |
950 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
951 | bound to the indexed shader storage buffer binding points. The initial value is 0 for all targets. | |
952 | 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 | |
953 | <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
954 | </p></dd><dt><span class="term"><code class="constant">GL_SHADER_STORAGE_BUFFER_OFFSET_ALIGNMENT</code></span></dt><dd><p> | |
955 | </p><p> | |
956 | <em class="parameter"><code>params</code></em> returns a single value, the minimum required alignment | |
957 | for shader storage buffer sizes and offset. The initial value is 1. | |
958 | See <a href="glShaderStorateBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glShaderStorateBlockBinding</span></span></a>. | |
959 | </p></dd><dt><span class="term"><code class="constant">GL_SHADER_STORAGE_BUFFER_START</code></span></dt><dd><p> | |
960 | </p><p> | |
961 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>), | |
962 | <em class="parameter"><code>params</code></em> returns a single value, the start offset of the binding range for each | |
963 | indexed shader storage buffer binding. The initial value is 0 for all bindings. | |
964 | See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
965 | </p></dd><dt><span class="term"><code class="constant">GL_SHADER_STORAGE_BUFFER_SIZE</code></span></dt><dd><p> | |
966 | </p><p> | |
967 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>), | |
968 | <em class="parameter"><code>params</code></em> returns a single value, the size of the binding range for each | |
969 | indexed shader storage buffer binding. The initial value is 0 for all bindings. | |
970 | See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
971 | </p></dd><dt><span class="term"><code class="constant">GL_SMOOTH_LINE_WIDTH_RANGE</code></span></dt><dd><p> | |
972 | </p><p> | |
973 | <em class="parameter"><code>params</code></em> returns a pair of values indicating the range of | |
974 | widths supported for smooth (antialiased) lines. See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>. | |
975 | </p></dd><dt><span class="term"><code class="constant">GL_SMOOTH_LINE_WIDTH_GRANULARITY</code></span></dt><dd><p> | |
976 | </p><p> | |
977 | <em class="parameter"><code>params</code></em> returns a single value indicating the level of | |
978 | quantization applied to smooth line width parameters. | |
979 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_FAIL</code></span></dt><dd><p> | |
980 | </p><p> | |
981 | <em class="parameter"><code>params</code></em> returns one value, | |
982 | a symbolic constant indicating what action is taken for back-facing polygons when the stencil | |
983 | test fails. The initial value is <code class="constant">GL_KEEP</code>. | |
984 | See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>. | |
985 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_FUNC</code></span></dt><dd><p> | |
986 | </p><p> | |
987 | <em class="parameter"><code>params</code></em> returns one value, | |
988 | a symbolic constant indicating what function is used for back-facing polygons to compare the | |
989 | stencil reference value with the stencil buffer value. The initial value | |
990 | is <code class="constant">GL_ALWAYS</code>. | |
991 | See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>. | |
992 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_PASS_DEPTH_FAIL</code></span></dt><dd><p> | |
993 | </p><p> | |
994 | <em class="parameter"><code>params</code></em> returns one value, | |
995 | a symbolic constant indicating what action is taken for back-facing polygons when the stencil | |
996 | test passes, | |
997 | but the depth test fails. The initial value is <code class="constant">GL_KEEP</code>. | |
998 | See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>. | |
999 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_PASS_DEPTH_PASS</code></span></dt><dd><p> | |
1000 | </p><p> | |
1001 | <em class="parameter"><code>params</code></em> returns one value, | |
1002 | a symbolic constant indicating what action is taken for back-facing polygons when the stencil | |
1003 | test passes and the depth test passes. The initial value is <code class="constant">GL_KEEP</code>. | |
1004 | See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>. | |
1005 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_REF</code></span></dt><dd><p> | |
1006 | </p><p> | |
1007 | <em class="parameter"><code>params</code></em> returns one value, | |
1008 | the reference value that is compared with the contents of the stencil | |
1009 | buffer for back-facing polygons. The initial value is 0. | |
1010 | See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>. | |
1011 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_VALUE_MASK</code></span></dt><dd><p> | |
1012 | </p><p> | |
1013 | <em class="parameter"><code>params</code></em> returns one value, | |
1014 | the mask that is used for back-facing polygons to mask both the stencil reference value and the | |
1015 | stencil buffer value before they are compared. The initial value is all 1's. | |
1016 | See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>. | |
1017 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_BACK_WRITEMASK</code></span></dt><dd><p> | |
1018 | </p><p> | |
1019 | <em class="parameter"><code>params</code></em> returns one value, | |
1020 | the mask that controls writing of the stencil bitplanes for back-facing polygons. The initial value | |
1021 | is all 1's. | |
1022 | See <a href="glStencilMaskSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilMaskSeparate</span></span></a>. | |
1023 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_CLEAR_VALUE</code></span></dt><dd><p> | |
1024 | </p><p> | |
1025 | <em class="parameter"><code>params</code></em> returns one value, | |
1026 | the index to which the stencil bitplanes are cleared. The initial value is | |
1027 | 0. | |
1028 | See <a href="glClearStencil.xml"><span class="citerefentry"><span class="refentrytitle">glClearStencil</span></span></a>. | |
1029 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_FAIL</code></span></dt><dd><p> | |
1030 | </p><p> | |
1031 | <em class="parameter"><code>params</code></em> returns one value, | |
1032 | a symbolic constant indicating what action is taken when the stencil | |
1033 | test fails. The initial value is <code class="constant">GL_KEEP</code>. | |
1034 | See <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>. | |
1035 | This stencil state only affects non-polygons | |
1036 | and front-facing polygons. Back-facing polygons use separate stencil state. | |
1037 | See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>. | |
1038 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_FUNC</code></span></dt><dd><p> | |
1039 | </p><p> | |
1040 | <em class="parameter"><code>params</code></em> returns one value, | |
1041 | a symbolic constant indicating what function is used to compare the | |
1042 | stencil reference value with the stencil buffer value. The initial value | |
1043 | is <code class="constant">GL_ALWAYS</code>. | |
1044 | See <a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>. | |
1045 | This stencil state only affects non-polygons | |
1046 | and front-facing polygons. Back-facing polygons use separate stencil state. | |
1047 | See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>. | |
1048 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_PASS_DEPTH_FAIL</code></span></dt><dd><p> | |
1049 | </p><p> | |
1050 | <em class="parameter"><code>params</code></em> returns one value, | |
1051 | a symbolic constant indicating what action is taken when the stencil | |
1052 | test passes, | |
1053 | but the depth test fails. The initial value is <code class="constant">GL_KEEP</code>. | |
1054 | See <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>. | |
1055 | This stencil state only affects non-polygons | |
1056 | and front-facing polygons. Back-facing polygons use separate stencil state. | |
1057 | See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>. | |
1058 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_PASS_DEPTH_PASS</code></span></dt><dd><p> | |
1059 | </p><p> | |
1060 | <em class="parameter"><code>params</code></em> returns one value, | |
1061 | a symbolic constant indicating what action is taken when the stencil | |
1062 | test passes and the depth test passes. The initial value is <code class="constant">GL_KEEP</code>. | |
1063 | See <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>. | |
1064 | This stencil state only affects non-polygons | |
1065 | and front-facing polygons. Back-facing polygons use separate stencil state. | |
1066 | See <a href="glStencilOpSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOpSeparate</span></span></a>. | |
1067 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_REF</code></span></dt><dd><p> | |
1068 | </p><p> | |
1069 | <em class="parameter"><code>params</code></em> returns one value, | |
1070 | the reference value that is compared with the contents of the stencil | |
1071 | buffer. The initial value is 0. | |
1072 | See <a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>. | |
1073 | This stencil state only affects non-polygons | |
1074 | and front-facing polygons. Back-facing polygons use separate stencil state. | |
1075 | See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>. | |
1076 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_TEST</code></span></dt><dd><p> | |
1077 | </p><p> | |
1078 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether stencil testing | |
1079 | of fragments is enabled. The initial value is <code class="constant">GL_FALSE</code>. | |
1080 | 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>. | |
1081 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_VALUE_MASK</code></span></dt><dd><p> | |
1082 | </p><p> | |
1083 | <em class="parameter"><code>params</code></em> returns one value, | |
1084 | the mask that is used to mask both the stencil reference value and the | |
1085 | stencil buffer value before they are compared. The initial value is all 1's. | |
1086 | See <a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>. | |
1087 | This stencil state only affects non-polygons | |
1088 | and front-facing polygons. Back-facing polygons use separate stencil state. | |
1089 | See <a href="glStencilFuncSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFuncSeparate</span></span></a>. | |
1090 | </p></dd><dt><span class="term"><code class="constant">GL_STENCIL_WRITEMASK</code></span></dt><dd><p> | |
1091 | </p><p> | |
1092 | <em class="parameter"><code>params</code></em> returns one value, | |
1093 | the mask that controls writing of the stencil bitplanes. The initial value | |
1094 | is all 1's. | |
1095 | See <a href="glStencilMask.xml"><span class="citerefentry"><span class="refentrytitle">glStencilMask</span></span></a>. | |
1096 | This stencil state only affects non-polygons | |
1097 | and front-facing polygons. Back-facing polygons use separate stencil state. | |
1098 | See <a href="glStencilMaskSeparate.xml"><span class="citerefentry"><span class="refentrytitle">glStencilMaskSeparate</span></span></a>. | |
1099 | </p></dd><dt><span class="term"><code class="constant">GL_STEREO</code></span></dt><dd><p> | |
1100 | </p><p> | |
1101 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether stereo buffers | |
1102 | (left and right) are supported. | |
1103 | </p></dd><dt><span class="term"><code class="constant">GL_SUBPIXEL_BITS</code></span></dt><dd><p> | |
1104 | </p><p> | |
1105 | <em class="parameter"><code>params</code></em> returns one value, | |
1106 | an estimate of the number of bits of subpixel resolution that are used to | |
1107 | position rasterized geometry in window coordinates. The value must be at least 4. | |
1108 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_1D</code></span></dt><dd><p> | |
1109 | </p><p> | |
1110 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1111 | currently bound to the target <code class="constant">GL_TEXTURE_1D</code>. The initial value is 0. | |
1112 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1113 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_1D_ARRAY</code></span></dt><dd><p> | |
1114 | </p><p> | |
1115 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1116 | currently bound to the target <code class="constant">GL_TEXTURE_1D_ARRAY</code>. The initial value is 0. | |
1117 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1118 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D</code></span></dt><dd><p> | |
1119 | </p><p> | |
1120 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1121 | currently bound to the target <code class="constant">GL_TEXTURE_2D</code>. The initial value is 0. | |
1122 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1123 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D_ARRAY</code></span></dt><dd><p> | |
1124 | </p><p> | |
1125 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1126 | currently bound to the target <code class="constant">GL_TEXTURE_2D_ARRAY</code>. The initial value is 0. | |
1127 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1128 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D_MULTISAMPLE</code></span></dt><dd><p> | |
1129 | </p><p> | |
1130 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1131 | currently bound to the target <code class="constant">GL_TEXTURE_2D_MULTISAMPLE</code>. The initial value is 0. | |
1132 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1133 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY</code></span></dt><dd><p> | |
1134 | </p><p> | |
1135 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1136 | currently bound to the target <code class="constant">GL_TEXTURE_2D_MULTISAMPLE_ARRAY</code>. The initial value is 0. | |
1137 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1138 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_3D</code></span></dt><dd><p> | |
1139 | </p><p> | |
1140 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1141 | currently bound to the target <code class="constant">GL_TEXTURE_3D</code>. The initial value is 0. | |
1142 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1143 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_BUFFER</code></span></dt><dd><p> | |
1144 | </p><p> | |
1145 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1146 | currently bound to the target <code class="constant">GL_TEXTURE_BUFFER</code>. The initial value is 0. | |
1147 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1148 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_CUBE_MAP</code></span></dt><dd><p> | |
1149 | </p><p> | |
1150 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1151 | currently bound to the target <code class="constant">GL_TEXTURE_CUBE_MAP</code>. The initial value is 0. | |
1152 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1153 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_RECTANGLE</code></span></dt><dd><p> | |
1154 | </p><p> | |
1155 | <em class="parameter"><code>params</code></em> returns a single value, the name of the texture | |
1156 | currently bound to the target <code class="constant">GL_TEXTURE_RECTANGLE</code>. The initial value is 0. | |
1157 | See <a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>. | |
1158 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_COMPRESSION_HINT</code></span></dt><dd><p> | |
1159 | </p><p> | |
1160 | <em class="parameter"><code>params</code></em> returns a single value indicating the mode of the texture | |
1161 | compression hint. The initial value is <code class="constant">GL_DONT_CARE</code>. | |
c7b31271 | 1162 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BINDING_BUFFER</code></span></dt><dd><p> |
7faf1d71 AW |
1163 | </p><p> |
1164 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
1165 | currently bound to the <code class="constant">GL_TEXTURE_BUFFER</code> buffer binding point. The initial value is 0. | |
1166 | See <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>. | |
1167 | </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_BUFFER_OFFSET_ALIGNMENT</code></span></dt><dd><p> | |
1168 | </p><p> | |
1169 | <em class="parameter"><code>params</code></em> returns a single value, the minimum required alignment | |
1170 | for texture buffer sizes and offset. The initial value is 1. | |
1171 | See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>. | |
1172 | </p></dd><dt><span class="term"><code class="constant">GL_TIMESTAMP</code></span></dt><dd><p> | |
1173 | </p><p> | |
1174 | <em class="parameter"><code>params</code></em> returns a single value, the 64-bit value of the current | |
1175 | GL time. | |
1176 | See <a href="glQueryCounter.xml"><span class="citerefentry"><span class="refentrytitle">glQueryCounter</span></span></a>. | |
1177 | </p></dd><dt><span class="term"><code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_BINDING</code></span></dt><dd><p> | |
1178 | </p><p> | |
1179 | When used with non-indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegerv</code>), | |
1180 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
1181 | currently bound to the target <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER</code>. If no buffer object | |
1182 | is bound to this target, 0 is returned. | |
1183 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegeri_v</code>), | |
1184 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
1185 | bound to the indexed transform feedback attribute stream. The initial value is 0 for all targets. | |
1186 | 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 | |
1187 | <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
1188 | </p></dd><dt><span class="term"><code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_START</code></span></dt><dd><p> | |
1189 | </p><p> | |
1190 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>), | |
1191 | <em class="parameter"><code>params</code></em> returns a single value, the start offset of the binding range for each | |
1192 | transform feedback attribute stream. The initial value is 0 for all streams. | |
1193 | See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
1194 | </p></dd><dt><span class="term"><code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_SIZE</code></span></dt><dd><p> | |
1195 | </p><p> | |
1196 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>), | |
1197 | <em class="parameter"><code>params</code></em> returns a single value, the size of the binding range for each | |
1198 | transform feedback attribute stream. The initial value is 0 for all streams. | |
1199 | See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
1200 | </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_BINDING</code></span></dt><dd><p> | |
1201 | </p><p> | |
1202 | When used with non-indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegerv</code>), | |
1203 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
1204 | currently bound to the target <code class="constant">GL_UNIFORM_BUFFER</code>. If no buffer object | |
1205 | is bound to this target, 0 is returned. | |
1206 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegeri_v</code>), | |
1207 | <em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object | |
1208 | bound to the indexed uniform buffer binding point. The initial value is 0 for all targets. | |
1209 | 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 | |
1210 | <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
1211 | </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT</code></span></dt><dd><p> | |
1212 | </p><p> | |
1213 | <em class="parameter"><code>params</code></em> returns a single value, the minimum required alignment | |
1214 | for uniform buffer sizes and offset. The initial value is 1. | |
1215 | See <a href="glUniformBlockBinding.xml"><span class="citerefentry"><span class="refentrytitle">glUniformBlockBinding</span></span></a>. | |
1216 | </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_SIZE</code></span></dt><dd><p> | |
1217 | </p><p> | |
1218 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>), | |
1219 | <em class="parameter"><code>params</code></em> returns a single value, the size of the binding range for each | |
1220 | indexed uniform buffer binding. The initial value is 0 for all bindings. | |
1221 | See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
1222 | </p></dd><dt><span class="term"><code class="constant">GL_UNIFORM_BUFFER_START</code></span></dt><dd><p> | |
1223 | </p><p> | |
1224 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetInteger64i_v</code>), | |
1225 | <em class="parameter"><code>params</code></em> returns a single value, the start offset of the binding range for each | |
1226 | indexed uniform buffer binding. The initial value is 0 for all bindings. | |
1227 | See <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. | |
1228 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_ALIGNMENT</code></span></dt><dd><p> | |
1229 | </p><p> | |
1230 | <em class="parameter"><code>params</code></em> returns one value, | |
1231 | the byte alignment used for reading pixel data from memory. The initial | |
1232 | value is 4. | |
1233 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
1234 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_IMAGE_HEIGHT</code></span></dt><dd><p> | |
1235 | </p><p> | |
1236 | <em class="parameter"><code>params</code></em> returns one value, | |
1237 | the image height used for reading pixel data from memory. The initial | |
1238 | is 0. | |
1239 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
1240 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_LSB_FIRST</code></span></dt><dd><p> | |
1241 | </p><p> | |
1242 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether single-bit | |
1243 | pixels being read from memory are read first from the least significant | |
1244 | bit of each unsigned byte. The initial value is <code class="constant">GL_FALSE</code>. | |
1245 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
1246 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_ROW_LENGTH</code></span></dt><dd><p> | |
1247 | </p><p> | |
1248 | <em class="parameter"><code>params</code></em> returns one value, | |
1249 | the row length used for reading pixel data from memory. The initial value | |
1250 | is 0. | |
1251 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
1252 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SKIP_IMAGES</code></span></dt><dd><p> | |
1253 | </p><p> | |
1254 | <em class="parameter"><code>params</code></em> returns one value, | |
1255 | the number of pixel images skipped before the first pixel is read | |
1256 | from memory. The initial value is 0. | |
1257 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
1258 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SKIP_PIXELS</code></span></dt><dd><p> | |
1259 | </p><p> | |
1260 | <em class="parameter"><code>params</code></em> returns one value, | |
1261 | the number of pixel locations skipped before the first pixel is read | |
1262 | from memory. The initial value is 0. | |
1263 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
1264 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SKIP_ROWS</code></span></dt><dd><p> | |
1265 | </p><p> | |
1266 | <em class="parameter"><code>params</code></em> returns one value, | |
1267 | the number of rows of pixel locations skipped before the first pixel is read | |
1268 | from memory. The initial value is 0. | |
1269 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
1270 | </p></dd><dt><span class="term"><code class="constant">GL_UNPACK_SWAP_BYTES</code></span></dt><dd><p> | |
1271 | </p><p> | |
1272 | <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether the bytes of | |
1273 | two-byte and four-byte pixel indices and components are swapped after being | |
1274 | read from memory. The initial value is <code class="constant">GL_FALSE</code>. | |
1275 | See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>. | |
7faf1d71 AW |
1276 | </p></dd><dt><span class="term"><code class="constant">GL_VERTEX_BINDING_DIVISOR</code></span></dt><dd><p> |
1277 | </p><p> | |
1278 | Accepted by the indexed forms. <em class="parameter"><code>params</code></em> returns a single integer value representing the instance step | |
1279 | divisor of the first element in the bound buffer's data store for vertex attribute bound to <em class="parameter"><code>index</code></em>. | |
1280 | </p></dd><dt><span class="term"><code class="constant">GL_VERTEX_BINDING_OFFSET</code></span></dt><dd><p> | |
1281 | </p><p> | |
1282 | Accepted by the indexed forms. <em class="parameter"><code>params</code></em> returns a single integer value representing the byte offset | |
1283 | of the first element in the bound buffer's data store for vertex attribute bound to <em class="parameter"><code>index</code></em>. | |
1284 | </p></dd><dt><span class="term"><code class="constant">GL_VERTEX_BINDING_STRIDE</code></span></dt><dd><p> | |
1285 | </p><p> | |
1286 | Accepted by the indexed forms. <em class="parameter"><code>params</code></em> returns a single integer value representing the byte offset | |
1287 | between the start of each element in the bound buffer's data store for vertex attribute bound to <em class="parameter"><code>index</code></em>. | |
1288 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_ATTRIB_RELATIVE_OFFSET</code></span></dt><dd><p> | |
1289 | </p><p> | |
1290 | <em class="parameter"><code>params</code></em> returns a single integer value containing the maximum offset that may be added to a vertex binding | |
1291 | offset. | |
1292 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_VERTEX_ATTRIB_BINDINGS</code></span></dt><dd><p> | |
1293 | </p><p> | |
1294 | <em class="parameter"><code>params</code></em> returns a single integer value containing the maximum number of vertex buffers that may be bound. | |
1295 | </p></dd><dt><span class="term"><code class="constant">GL_VIEWPORT</code></span></dt><dd><p> | |
1296 | </p><p> | |
1297 | When used with non-indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegerv</code>), | |
1298 | <em class="parameter"><code>params</code></em> returns four values: | |
1299 | the | |
1300 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math> | |
1301 | and | |
1302 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math> | |
1303 | window coordinates of the viewport, followed by its width and height. | |
1304 | Initially the | |
1305 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math> | |
1306 | and | |
1307 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math> | |
1308 | window coordinates are both set to 0, | |
1309 | and the width and height are set to the width and height of the window into | |
1310 | which the GL will do its rendering. | |
1311 | See <a href="glViewport.xml"><span class="citerefentry"><span class="refentrytitle">glViewport</span></span></a>. | |
1312 | ||
1313 | When used with indexed variants of <code class="function">glGet</code> (such as <code class="function">glGetIntegeri_v</code>), | |
1314 | <em class="parameter"><code>params</code></em> returns four values: | |
1315 | the | |
1316 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math> | |
1317 | and | |
1318 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math> | |
1319 | window coordinates of the indexed viewport, followed by its width and height. | |
1320 | Initially the | |
1321 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">x</mml:mi></mml:math> | |
1322 | and | |
1323 | <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">y</mml:mi></mml:math> | |
1324 | window coordinates are both set to 0, | |
1325 | and the width and height are set to the width and height of the window into | |
1326 | which the GL will do its rendering. | |
1327 | See <a href="glViewportIndexedf.xml"><span class="citerefentry"><span class="refentrytitle">glViewportIndexedf</span></span></a>. | |
1328 | </p></dd><dt><span class="term"><code class="constant">GL_VIEWPORT_BOUNDS_RANGE</code></span></dt><dd><p> | |
1329 | </p><p> | |
1330 | <em class="parameter"><code>params</code></em> returns two values, the minimum and maximum viewport bounds range. | |
1331 | The minimum range should be at least [-32768, 32767]. | |
1332 | </p></dd><dt><span class="term"><code class="constant">GL_VIEWPORT_INDEX_PROVOKING_VERTEX</code></span></dt><dd><p> | |
1333 | </p><p> | |
1334 | <em class="parameter"><code>params</code></em> returns one value, | |
1335 | the implementation dependent specifc vertex of a primitive that is used to select the viewport index. | |
1336 | If the value returned is equivalent to <code class="constant">GL_PROVOKING_VERTEX</code>, then the vertex | |
1337 | selection follows the convention specified by | |
1338 | <a href="glProvokingVertex.xml"><span class="citerefentry"><span class="refentrytitle">glProvokingVertex</span></span></a>. | |
1339 | If the value returned is equivalent to <code class="constant">GL_FIRST_VERTEX_CONVENTION</code>, then the | |
1340 | selection is always taken from the first vertex in the primitive. | |
1341 | If the value returned is equivalent to <code class="constant">GL_LAST_VERTEX_CONVENTION</code>, then the | |
1342 | selection is always taken from the last vertex in the primitive. | |
1343 | If the value returned is equivalent to <code class="constant">GL_UNDEFINED_VERTEX</code>, then the | |
1344 | selection is not guaranteed to be taken from any specific vertex in the primitive. | |
1345 | </p></dd><dt><span class="term"><code class="constant">GL_VIEWPORT_SUBPIXEL_BITS</code></span></dt><dd><p> | |
1346 | </p><p> | |
1347 | <em class="parameter"><code>params</code></em> returns a single value, the number of bits of sub-pixel precision which the GL | |
1348 | uses to interpret the floating point viewport bounds. The minimum value is 0. | |
1349 | </p></dd><dt><span class="term"><code class="constant">GL_MAX_ELEMENT_INDEX</code></span></dt><dd><p> | |
1350 | </p><p> | |
1351 | <em class="parameter"><code>params</code></em> returns a single value, the maximum index that may be specified during the | |
1352 | transfer of generic vertex attributes to the GL. | |
1353 | </p></dd></dl></div><p> | |
1354 | Many of the boolean parameters can also be queried more easily using | |
1355 | <a href="glIsEnabled.xml"><span class="citerefentry"><span class="refentrytitle">glIsEnabled</span></span></a>. | |
1356 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p> | |
1357 | The following parameters return the associated value for the active texture unit: | |
1358 | <code class="constant">GL_TEXTURE_1D</code>, <code class="constant">GL_TEXTURE_BINDING_1D</code>, | |
1359 | <code class="constant">GL_TEXTURE_2D</code>, <code class="constant">GL_TEXTURE_BINDING_2D</code>, | |
1360 | <code class="constant">GL_TEXTURE_3D</code> and <code class="constant">GL_TEXTURE_BINDING_3D</code>. | |
1361 | </p><p> | |
1362 | <code class="constant">GL_MAX_VIEWPORTS</code>, <code class="constant">GL_VIEWPORT_SUBPIXEL_BITS</code>, | |
1363 | <code class="constant">GL_VIEWPORT_BOUNDS_RANGE</code>, <code class="constant">GL_LAYER_PROVOKING_VERTEX</code>, | |
1364 | and <code class="constant">GL_VIEWPORT_INDEX_PROVOKING_VERTEX</code> | |
1365 | are available only if the GL version is 4.1 or greater. | |
1366 | </p><p> | |
1367 | <code class="constant">GL_MAX_VERTEX_ATOMIC_COUNTERS</code>, | |
1368 | <code class="constant">GL_MAX_TESS_CONTROL_ATOMIC_COUNTERS</code>, | |
1369 | <code class="constant">GL_MAX_TESS_EVALUATION_ATOMIC_COUNTERS</code>, | |
1370 | <code class="constant">GL_MAX_GEOMETRY_ATOMIC_COUNTERS</code>, | |
1371 | <code class="constant">GL_MAX_FRAMGENT_ATOMIC_COUNTERS</code>, and | |
1372 | <code class="constant">GL_MIN_MAP_BUFFER_ALIGNMENT</code> are accepted by <em class="parameter"><code>pname</code></em> | |
1373 | only if the GL version is 4.2 or greater. | |
1374 | </p><p> | |
1375 | <code class="constant">GL_MAX_ELEMENT_INDEX</code> is accepted by <em class="parameter"><code>pname</code></em> only | |
1376 | if the GL version is 4.3 or greater. | |
1377 | </p><p> | |
1378 | <code class="constant">GL_MAX_COMPUTE_UNIFORM_BLOCKS</code>, <code class="constant">GL_MAX_COMPUTE_TEXTURE_IMAGE_UNITS</code>, | |
1379 | <code class="constant">GL_MAX_COMPUTE_UNIFORM_COMPONENTS</code>, <code class="constant">GL_MAX_COMPUTE_ATOMIC_COUNTERS</code>, | |
1380 | <code class="constant">GL_MAX_COMPUTE_ATOMIC_COUNTER_BUFFERS</code>, <code class="constant">GL_MAX_COMBINED_COMPUTE_UNIFORM_COMPONENTS</code>, | |
1381 | <code class="constant">GL_MAX_COMPUTE_WORK_GROUP_INVOCATIONS</code>, <code class="constant">GL_MAX_COMPUTE_WORK_GROUP_COUNT</code>, and | |
1382 | <code class="constant">GL_MAX_COMPUTE_WORK_GROUP_SIZE</code> and <code class="constant">GL_DISPATCH_INDIRECT_BUFFER_BINDING</code> are available only if the GL version | |
1383 | is 4.3 or greater. | |
1384 | </p><p> | |
1385 | <code class="constant">GL_MAX_DEBUG_GROUP_STACK_DEPTH</code>, <code class="constant">GL_DEBUG_GROUP_STACK_DEPTH</code> and <code class="constant">GL_MAX_LABEL_LENGTH</code> are accepted only if | |
1386 | the GL version is 4.3 or greater. | |
1387 | </p><p> | |
1388 | <code class="constant">GL_MAX_UNIFORM_LOCATIONS</code> is accepted only if the GL version is 4.3 or greater. | |
1389 | </p><p> | |
1390 | <code class="constant">GL_MAX_FRAMEBUFFER_WIDTH</code>, <code class="constant">GL_MAX_FRAMEBUFFER_HEIGHT</code>, <code class="constant">GL_MAX_FRAMEBUFFER_LAYERS</code>, | |
1391 | and <code class="constant">GL_MAX_FRAMEBUFFER_SAMPLES</code> are available only if the GL version is 4.3 or greater. | |
1392 | </p><p> | |
1393 | <code class="constant">GL_MAX_VERTEX_SHADER_STORAGE_BLOCKS</code>, <code class="constant">GL_MAX_TESS_CONTROL_SHADER_STORAGE_BLOCKS</code>, | |
1394 | <code class="constant">GL_MAX_TESS_EVALUATION_SHADER_STORAGE_BLOCKS</code>, <code class="constant">GL_MAX_GEOMETRY_SHADER_STORAGE_BLOCKS</code>, | |
1395 | <code class="constant">GL_MAX_FRAGMENT_SHADER_STORAGE_BLOCKS</code>, and <code class="constant">GL_MAX_COMPUTE_SHADER_STORAGE_BLOCKS</code> are available | |
1396 | only if the GL version is 4.3 or higher. | |
1397 | </p><p> | |
1398 | <code class="constant">GL_TEXTURE_BUFFER_OFFSET_ALIGNMENT</code> is available only if the GL version is 4.3 or greater. | |
1399 | </p><p> | |
1400 | <code class="constant">GL_VERTEX_BINDING_DIVISOR</code>, <code class="constant">GL_VERTEX_BINDING_OFFSET</code>, <code class="constant">GL_VERTEX_BINDING_STRIDE</code>, | |
1401 | <code class="constant">GL_MAX_VERTEX_ATTRIB_RELATIVE_OFFSET</code> and <code class="constant">GL_MAX_VERTEX_ATTRIB_BINDINGS</code> are available only if | |
1402 | the GL version is 4.3 or greater. | |
1403 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p> | |
1404 | <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>pname</code></em> is not an accepted value. | |
1405 | </p><p> | |
1406 | <code class="constant">GL_INVALID_VALUE</code> is generated on any of <code class="function">glGetBooleani_v</code>, | |
1407 | <code class="function">glGetIntegeri_v</code>, or <code class="function">glGetInteger64i_v</code> if | |
1408 | <em class="parameter"><code>index</code></em> is outside of the valid range for the indexed state <em class="parameter"><code>target</code></em>. | |
1409 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p> | |
1410 | <a href="glGetActiveUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetActiveUniform</span></span></a>, | |
1411 | <a href="glGetAttachedShaders.xml"><span class="citerefentry"><span class="refentrytitle">glGetAttachedShaders</span></span></a>, | |
1412 | <a href="glGetAttribLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetAttribLocation</span></span></a>, | |
1413 | <a href="glGetBufferParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetBufferParameter</span></span></a>, | |
1414 | <a href="glGetBufferPointerv.xml"><span class="citerefentry"><span class="refentrytitle">glGetBufferPointerv</span></span></a>, | |
1415 | <a href="glGetBufferSubData.xml"><span class="citerefentry"><span class="refentrytitle">glGetBufferSubData</span></span></a>, | |
1416 | <a href="glGetCompressedTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetCompressedTexImage</span></span></a>, | |
1417 | <a href="glGetError.xml"><span class="citerefentry"><span class="refentrytitle">glGetError</span></span></a>, | |
1418 | <a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>, | |
1419 | <a href="glGetProgramInfoLog.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgramInfoLog</span></span></a>, | |
1420 | <a href="glGetQueryiv.xml"><span class="citerefentry"><span class="refentrytitle">glGetQueryiv</span></span></a>, | |
1421 | <a href="glGetQueryObject.xml"><span class="citerefentry"><span class="refentrytitle">glGetQueryObject</span></span></a>, | |
1422 | <a href="glGetShader.xml"><span class="citerefentry"><span class="refentrytitle">glGetShader</span></span></a>, | |
1423 | <a href="glGetShaderInfoLog.xml"><span class="citerefentry"><span class="refentrytitle">glGetShaderInfoLog</span></span></a>, | |
1424 | <a href="glGetShaderSource.xml"><span class="citerefentry"><span class="refentrytitle">glGetShaderSource</span></span></a>, | |
1425 | <a href="glGetString.xml"><span class="citerefentry"><span class="refentrytitle">glGetString</span></span></a>, | |
1426 | <a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>, | |
1427 | <a href="glGetTexLevelParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexLevelParameter</span></span></a>, | |
1428 | <a href="glGetTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexParameter</span></span></a>, | |
1429 | <a href="glGetUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniform</span></span></a>, | |
1430 | <a href="glGetUniformLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformLocation</span></span></a>, | |
1431 | <a href="glGetVertexAttrib.xml"><span class="citerefentry"><span class="refentrytitle">glGetVertexAttrib</span></span></a>, | |
1432 | <a href="glGetVertexAttribPointerv.xml"><span class="citerefentry"><span class="refentrytitle">glGetVertexAttribPointerv</span></span></a>, | |
1433 | <a href="glIsEnabled.xml"><span class="citerefentry"><span class="refentrytitle">glIsEnabled</span></span></a> | |
1434 | </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p> | |
1435 | Copyright <span class="trademark"></span>© 1991-2006 Silicon Graphics, Inc. | |
1436 | Copyright <span class="trademark"></span>© 2010-2011 Khronos Group. | |
1437 | This document is licensed under the SGI Free Software B License. For details, see | |
1438 | <a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>. | |
1439 | </p></div></div></body></html> |