1GLGET(3G) GLGET(3G)
2
3
4
6 glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv - return the
7 value or values of a selected parameter
8
9
11 void glGetBooleanv( GLenum pname,
12 GLboolean *params )
13
14
16 void glGetDoublev( GLenum pname,
17 GLdouble *params )
18
19
21 void glGetFloatv( GLenum pname,
22 GLfloat *params )
23
24
26 void glGetIntegerv( GLenum pname,
27 GLint *params )
28
29
31 pname Specifies the parameter value to be returned. The symbolic
32 constants in the list below are accepted.
33
34 params Returns the value or values of the specified parameter.
35
37 These four commands return values for simple state variables in GL.
38 pname is a symbolic constant indicating the state variable to be
39 returned, and params is a pointer to an array of the indicated type in
40 which to place the returned data.
41
42 Type conversion is performed if params has a different type than the
43 state variable value being requested. If glGetBooleanv is called, a
44 floating-point (or integer) value is converted to GL_FALSE if and only
45 if it is 0.0 (or 0). Otherwise, it is converted to GL_TRUE. If
46 glGetIntegerv is called, boolean values are returned as GL_TRUE or
47 GL_FALSE, and most floating-point values are rounded to the nearest
48 integer value. Floating-point colors and normals, however, are returned
49 with a linear mapping that maps 1.0 to the most positive representable
50 integer value, and -1.0 to the most negative representable integer
51 value. If glGetFloatv or glGetDoublev is called, boolean values are
52 returned as GL_TRUE or GL_FALSE, and integer values are converted to
53 floating-point values.
54
55 The following symbolic constants are accepted by pname:
56
57 GL_ACCUM_ALPHA_BITS params returns one value, the number of alpha
58 bitplanes in the accumulation buffer.
59
60 GL_ACCUM_BLUE_BITS params returns one value, the number of blue
61 bitplanes in the accumulation buffer.
62
63 GL_ACCUM_CLEAR_VALUE params returns four values: the red, green,
64 blue, and alpha values used to clear the accu‐
65 mulation buffer. Integer values, if
66 requested, are linearly mapped from the inter‐
67 nal floating-point representation such that
68 1.0 returns the most positive representable
69 integer value, and -1.0 returns the most nega‐
70 tive representable integer value. The initial
71 value is (0, 0, 0, 0). See glClearAccum.
72
73 GL_ACCUM_GREEN_BITS params returns one value, the number of green
74 bitplanes in the accumulation buffer.
75
76 GL_ACCUM_RED_BITS params returns one value, the number of red
77 bitplanes in the accumulation buffer.
78
79 GL_ACTIVE_TEXTURE_ARB params returns a single value indicating the
80 active multitexture unit. The initial value
81 is GL_TEXTURE0_ARB. See glActiveTextureARB.
82
83 GL_ALIASED_POINT_SIZE_RANGE
84 params returns two values, the smallest and
85 largest supported sizes for aliased points.
86
87 GL_ALIASED_LINE_WIDTH_RANGE
88 params returns two values, the smallest and
89 largest supported widths for aliased lines.
90
91 GL_ALPHA_BIAS params returns one value, the alpha bias fac‐
92 tor used during pixel transfers. The initial
93 value is 0. See glPixelTransfer.
94
95 GL_ALPHA_BITS params returns one value, the number of alpha
96 bitplanes in each color buffer.
97
98 GL_ALPHA_SCALE params returns one value, the alpha scale fac‐
99 tor used during pixel transfers. The initial
100 value is 1. See glPixelTransfer.
101
102 GL_ALPHA_TEST params returns a single boolean value indicat‐
103 ing whether alpha testing of fragments is
104 enabled. The initial value is GL_FALSE. See
105 glAlphaFunc.
106
107 GL_ALPHA_TEST_FUNC params returns one value, the symbolic name of
108 the alpha test function. The initial value is
109 GL_ALWAYS. See glAlphaFunc.
110
111 GL_ALPHA_TEST_REF params returns one value, the reference value
112 for the alpha test. The initial value is 0.
113 See glAlphaFunc. An integer value, if
114 requested, is linearly mapped from the inter‐
115 nal floating-point representation such that
116 1.0 returns the most positive representable
117 integer value, and -1.0 returns the most nega‐
118 tive representable integer value.
119
120 GL_ATTRIB_STACK_DEPTH params returns one value, the depth of the
121 attribute stack. If the stack is empty, 0 is
122 returned. The initial value is 0. See
123 glPushAttrib.
124
125 GL_AUTO_NORMAL params returns a single boolean value indicat‐
126 ing whether 2D map evaluation automatically
127 generates surface normals. The initial value
128 is GL_FALSE. See glMap2.
129
130 GL_AUX_BUFFERS params returns one value, the number of auxil‐
131 iary color buffers. The initial value is 0.
132
133 GL_BLEND params returns a single boolean value indicat‐
134 ing whether blending is enabled. The initial
135 value is GL_FALSE. See glBlendFunc.
136
137 GL_BLEND_COLOR params returns four values, the red, green,
138 blue, and alpha values which are the compo‐
139 nents of the blend color. See glBlendColor.
140
141 GL_BLEND_DST params returns one value, the symbolic con‐
142 stant identifying the destination blend func‐
143 tion. The initial value is GL_ZERO. See
144 glBlendFunc.
145
146 GL_BLEND_EQUATION params returns one value, a symbolic constant
147 indicating whether the blend equation is
148 GL_FUNC_ADD, GL_MIN or GL_MAX. See
149 glBlendEquation.
150
151 GL_BLEND_SRC params returns one value, the symbolic con‐
152 stant identifying the source blend function.
153 The initial value is GL_ONE. See glBlendFunc.
154
155 GL_BLUE_BIAS params returns one value, the blue bias factor
156 used during pixel transfers. The initial value
157 is 0. See glPixelTransfer.
158
159 GL_BLUE_BITS params returns one value, the number of blue
160 bitplanes in each color buffer.
161
162 GL_BLUE_SCALE params returns one value, the blue scale fac‐
163 tor used during pixel transfers. The initial
164 value is 1. See glPixelTransfer.
165
166 GL_CLIENT_ACTIVE_TEXTURE_ARB
167 params returns a single integer value indicat‐
168 ing the current client active multitexture
169 unit. The initial value is GL_TEXTURE0_ARB.
170 See glClientActiveTextureARB.
171
172 GL_CLIENT_ATTRIB_STACK_DEPTH
173 params returns one value indicating the depth
174 of the attribute stack. The initial value is
175 0. See glPushClientAttrib.
176
177 GL_CLIP_PLANEi params returns a single boolean value indicat‐
178 ing whether the specified clipping plane is
179 enabled. The initial value is GL_FALSE. See
180 glClipPlane.
181
182 GL_COLOR_ARRAY params returns a single boolean value indicat‐
183 ing whether the color array is enabled. The
184 initial value is GL_FALSE. See
185 glColorPointer.
186
187 GL_COLOR_ARRAY_SIZE params returns one value, the number of compo‐
188 nents per color in the color array. The ini‐
189 tial value is 4. See glColorPointer.
190
191 GL_COLOR_ARRAY_STRIDE params returns one value, the byte offset
192 between consecutive colors in the color array.
193 The initial value is 0. See glColorPointer.
194
195 GL_COLOR_ARRAY_TYPE params returns one value, the data type of
196 each component in the color array. The initial
197 value is GL_FLOAT. See glColorPointer.
198
199 GL_COLOR_CLEAR_VALUE params returns four values: the red, green,
200 blue, and alpha values used to clear the color
201 buffers. Integer values, if requested, are
202 linearly mapped from the internal floating-
203 point representation such that 1.0 returns the
204 most positive representable integer value, and
205 -1.0 returns the most negative representable
206 integer value. The initial value is (0, 0, 0,
207 0). See glClearColor.
208
209 GL_COLOR_LOGIC_OP params returns a single boolean value indicat‐
210 ing whether a fragment's RGBA color values are
211 merged into the framebuffer using a logical
212 operation. The initial value is GL_FALSE. See
213 glLogicOp.
214
215 GL_COLOR_MATERIAL params returns a single boolean value indicat‐
216 ing whether one or more material parameters
217 are tracking the current color. The initial
218 value is GL_FALSE. See glColorMaterial.
219
220 GL_COLOR_MATERIAL_FACE params returns one value, a symbolic constant
221 indicating which materials have a parameter
222 that is tracking the current color. The ini‐
223 tial value is GL_FRONT_AND_BACK. See
224 glColorMaterial.
225
226 GL_COLOR_MATERIAL_PARAMETER
227 params returns one value, a symbolic constant
228 indicating which material parameters are
229 tracking the current color. The initial value
230 is GL_AMBIENT_AND_DIFFUSE. See
231 glColorMaterial.
232
233 GL_COLOR_MATRIX params returns sixteen values: the color
234 matrix on the top of the color matrix stack.
235 Initially this matrix is the identity matrix.
236 See glPushMatrix.
237
238 GL_COLOR_MATRIX_STACK_DEPTH
239 params returns one value, the maximum sup‐
240 ported depth of the projection matrix stack.
241 The value must be at least 2. See
242 glPushMatrix.
243
244 GL_COLOR_TABLE params returns a single boolean value indicat‐
245 ing whether the color table lookup is enabled.
246 See glColorTable.
247
248 GL_COLOR_WRITEMASK params returns four boolean values: the red,
249 green, blue, and alpha write enables for the
250 color buffers. The initial value is (GL_TRUE,
251 GL_TRUE, GL_TRUE, GL_TRUE). See glColorMask.
252
253 GL_CONVOLUTION_1D params returns a single boolean value indicat‐
254 ing whether 1D convolution is enabled. The
255 initial value is GL_FALSE. See
256 glConvolutionFilter1D.
257
258 GL_CONVOLUTION_2D params returns a single boolean value indicat‐
259 ing whether 2D convolution is enabled. The
260 initial value is GL_FALSE. See
261 glConvolutionFilter2D.
262
263 GL_CULL_FACE params returns a single boolean value indicat‐
264 ing whether polygon culling is enabled. The
265 initial value is GL_FALSE. See glCullFace.
266
267 GL_CULL_FACE_MODE params returns one value, a symbolic constant
268 indicating which polygon faces are to be
269 culled. The initial value is GL_BACK. See
270 glCullFace.
271
272 GL_CURRENT_COLOR params returns four values: the red, green,
273 blue, and alpha values of the current color.
274 Integer values, if requested, are linearly
275 mapped from the internal floating-point repre‐
276 sentation such that 1.0 returns the most posi‐
277 tive representable integer value, and -1.0
278 returns the most negative representable inte‐
279 ger value. See glColor. The initial value is
280 (1, 1, 1, 1).
281
282 GL_CURRENT_INDEX params returns one value, the current color
283 index. The initial value is 1. See glIndex.
284
285 GL_CURRENT_NORMAL params returns three values: the x, y, and z
286 values of the current normal. Integer values,
287 if requested, are linearly mapped from the
288 internal floating-point representation such
289 that 1.0 returns the most positive repre‐
290 sentable integer value, and -1.0 returns the
291 most negative representable integer value.
292 The initial value is (0, 0, 1). See glNormal.
293
294 GL_CURRENT_RASTER_COLOR params returns four values: the red, green,
295 blue, and alpha values of the current raster
296 position. Integer values, if requested, are
297 linearly mapped from the internal floating-
298 point representation such that 1.0 returns the
299 most positive representable integer value, and
300 -1.0 returns the most negative representable
301 integer value. The initial value is (1, 1, 1,
302 1). See glRasterPos.
303
304 GL_CURRENT_RASTER_DISTANCE
305 params returns one value, the distance from
306 the eye to the current raster position. The
307 initial value is 0. See glRasterPos.
308
309 GL_CURRENT_RASTER_INDEX params returns one value, the color index of
310 the current raster position. The initial value
311 is 1. See glRasterPos.
312
313 GL_CURRENT_RASTER_POSITION
314 params returns four values: the x, y, z, and w
315 components of the current raster position. x,
316 y, and z are in window coordinates, and w is
317 in clip coordinates. The initial value is (0,
318 0, 0, 1). See glRasterPos.
319
320 GL_CURRENT_RASTER_POSITION_VALID
321 params returns a single boolean value indicat‐
322 ing whether the current raster position is
323 valid. The initial value is GL_TRUE. See
324 glRasterPos.
325
326 GL_CURRENT_RASTER_TEXTURE_COORDS
327 params returns four values: the s, t, r, and q
328 current raster texture coordinates. The ini‐
329 tial value is (0, 0, 0, 1). See glRasterPos
330 and glTexCoord.
331
332 GL_CURRENT_TEXTURE_COORDS
333 params returns four values: the s, t, r, and q
334 current texture coordinates. The initial value
335 is (0, 0, 0, 1). See glTexCoord.
336
337 GL_DEPTH_BIAS params returns one value, the depth bias fac‐
338 tor used during pixel transfers. The initial
339 value is 0. See glPixelTransfer.
340
341 GL_DEPTH_BITS params returns one value, the number of bit‐
342 planes in the depth buffer.
343
344 GL_DEPTH_CLEAR_VALUE params returns one value, the value that is
345 used to clear the depth buffer. Integer val‐
346 ues, if requested, are linearly mapped from
347 the internal floating-point representation
348 such that 1.0 returns the most positive repre‐
349 sentable integer value, and -1.0 returns the
350 most negative representable integer value. The
351 initial value is 1. See glClearDepth.
352
353 GL_DEPTH_FUNC params returns one value, the symbolic con‐
354 stant that indicates the depth comparison
355 function. The initial value is GL_LESS. See
356 glDepthFunc.
357
358 GL_DEPTH_RANGE params returns two values: the near and far
359 mapping limits for the depth buffer. Integer
360 values, if requested, are linearly mapped from
361 the internal floating-point representation
362 such that 1.0 returns the most positive repre‐
363 sentable integer value, and -1.0 returns the
364 most negative representable integer value. The
365 initial value is (0, 1). See glDepthRange.
366
367 GL_DEPTH_SCALE params returns one value, the depth scale fac‐
368 tor used during pixel transfers. The initial
369 value is 1. See glPixelTransfer.
370
371 GL_DEPTH_TEST params returns a single boolean value indicat‐
372 ing whether depth testing of fragments is
373 enabled. The initial value is GL_FALSE. See
374 glDepthFunc and glDepthRange.
375
376 GL_DEPTH_WRITEMASK params returns a single boolean value indicat‐
377 ing if the depth buffer is enabled for writ‐
378 ing. The initial value is GL_TRUE. See
379 glDepthMask.
380
381 GL_DITHER params returns a single boolean value indicat‐
382 ing whether dithering of fragment colors and
383 indices is enabled. The initial value is
384 GL_TRUE.
385
386 GL_DOUBLEBUFFER params returns a single boolean value indicat‐
387 ing whether double buffering is supported.
388
389 GL_DRAW_BUFFER params returns one value, a symbolic constant
390 indicating which buffers are being drawn to.
391 See glDrawBuffer. The initial value is GL_BACK
392 if there are back buffers, otherwise it is
393 GL_FRONT.
394
395 GL_EDGE_FLAG params returns a single boolean value indicat‐
396 ing whether the current edge flag is GL_TRUE
397 or GL_FALSE. The initial value is GL_TRUE.
398 See glEdgeFlag.
399
400 GL_EDGE_FLAG_ARRAY params returns a single boolean value indicat‐
401 ing whether the edge flag array is enabled.
402 The initial value is GL_FALSE. See
403 glEdgeFlagPointer.
404
405 GL_EDGE_FLAG_ARRAY_STRIDE
406 params returns one value, the byte offset
407 between consecutive edge flags in the edge
408 flag array. The initial value is 0. See
409 glEdgeFlagPointer.
410
411 GL_FEEDBACK_BUFFER_SIZE params returns one value, the size of the
412 feedback buffer. See glFeedbackBuffer.
413
414 GL_FEEDBACK_BUFFER_TYPE params returns one value, the type of the
415 feedback buffer. See glFeedbackBuffer.
416
417 GL_FOG params returns a single boolean value indicat‐
418 ing whether fogging is enabled. The initial
419 value is GL_FALSE. See glFog.
420
421 GL_FOG_COLOR params returns four values: the red, green,
422 blue, and alpha components of the fog color.
423 Integer values, if requested, are linearly
424 mapped from the internal floating-point repre‐
425 sentation such that 1.0 returns the most posi‐
426 tive representable integer value, and -1.0
427 returns the most negative representable inte‐
428 ger value. The initial value is (0, 0, 0, 0).
429 See glFog.
430
431 GL_FOG_DENSITY params returns one value, the fog density
432 parameter. The initial value is 1. See glFog.
433
434 GL_FOG_END params returns one value, the end factor for
435 the linear fog equation. The initial value is
436 1. See glFog.
437
438 GL_FOG_HINT params returns one value, a symbolic constant
439 indicating the mode of the fog hint. The ini‐
440 tial value is GL_DONT_CARE. See glHint.
441
442 GL_FOG_INDEX params returns one value, the fog color index.
443 The initial value is 0. See glFog.
444
445 GL_FOG_MODE params returns one value, a symbolic constant
446 indicating which fog equation is selected. The
447 initial value is GL_EXP. See glFog.
448
449 GL_FOG_START params returns one value, the start factor for
450 the linear fog equation. The initial value is
451 0. See glFog.
452
453 GL_FRONT_FACE params returns one value, a symbolic constant
454 indicating whether clockwise or counterclock‐
455 wise polygon winding is treated as front-fac‐
456 ing. The initial value is GL_CCW. See
457 glFrontFace.
458
459 GL_GREEN_BIAS params returns one value, the green bias fac‐
460 tor used during pixel transfers. The initial
461 value is 0.
462
463 GL_GREEN_BITS params returns one value, the number of green
464 bitplanes in each color buffer.
465
466 GL_GREEN_SCALE params returns one value, the green scale fac‐
467 tor used during pixel transfers. The initial
468 value is 1. See glPixelTransfer.
469
470 GL_HISTOGRAM params returns a single boolean value indicat‐
471 ing whether histogram is enabled. The initial
472 value is GL_FALSE. See glHistogram.
473
474 GL_INDEX_ARRAY params returns a single boolean value indicat‐
475 ing whether the color index array is enabled.
476 The initial value is GL_FALSE. See
477 glIndexPointer.
478
479 GL_INDEX_ARRAY_STRIDE params returns one value, the byte offset
480 between consecutive color indexes in the color
481 index array. The initial value is 0. See
482 glIndexPointer.
483
484 GL_INDEX_ARRAY_TYPE params returns one value, the data type of
485 indexes in the color index array. The initial
486 value is GL_FLOAT. See glIndexPointer.
487
488 GL_INDEX_BITS params returns one value, the number of bit‐
489 planes in each color index buffer.
490
491 GL_INDEX_CLEAR_VALUE params returns one value, the color index used
492 to clear the color index buffers. The initial
493 value is 0. See glClearIndex.
494
495 GL_INDEX_LOGIC_OP params returns a single boolean value indicat‐
496 ing whether a fragment's index values are
497 merged into the framebuffer using a logical
498 operation. The initial value is GL_FALSE. See
499 glLogicOp.
500
501 GL_INDEX_MODE params returns a single boolean value indicat‐
502 ing whether the GL is in color index mode (‐
503 GL_TRUE) or RGBA mode (GL_FALSE).
504
505 GL_INDEX_OFFSET params returns one value, the offset added to
506 color and stencil indices during pixel trans‐
507 fers. The initial value is 0. See
508 glPixelTransfer.
509
510 GL_INDEX_SHIFT params returns one value, the amount that
511 color and stencil indices are shifted during
512 pixel transfers. The initial value is 0. See
513 glPixelTransfer.
514
515 GL_INDEX_WRITEMASK params returns one value, a mask indicating
516 which bitplanes of each color index buffer can
517 be written. The initial value is all 1's. See
518 glIndexMask.
519
520 GL_LIGHTi params returns a single boolean value indicat‐
521 ing whether the specified light is enabled.
522 The initial value is GL_FALSE. See glLight
523 and glLightModel.
524
525 GL_LIGHTING params returns a single boolean value indicat‐
526 ing whether lighting is enabled. The initial
527 value is GL_FALSE. See glLightModel.
528
529 GL_LIGHT_MODEL_AMBIENT params returns four values: the red, green,
530 blue, and alpha components of the ambient
531 intensity of the entire scene. Integer val‐
532 ues, if requested, are linearly mapped from
533 the internal floating-point representation
534 such that 1.0 returns the most positive repre‐
535 sentable integer value, and -1.0 returns the
536 most negative representable integer value. The
537 initial value is (0.2, 0.2, 0.2, 1.0). See
538 glLightModel.
539
540 GL_LIGHT_MODEL_COLOR_CONTROL
541 params returns single enumerated value indi‐
542 cating whether specular reflection calcula‐
543 tions are separated from normal lighting com‐
544 putations. The initial value is
545 GL_SINGLE_COLOR.
546
547 GL_LIGHT_MODEL_LOCAL_VIEWER
548 params returns a single boolean value indicat‐
549 ing whether specular reflection calculations
550 treat the viewer as being local to the scene.
551 The initial value is GL_FALSE. See
552 glLightModel.
553
554 GL_LIGHT_MODEL_TWO_SIDE params returns a single boolean value indicat‐
555 ing whether separate materials are used to
556 compute lighting for front- and back-facing
557 polygons. The initial value is GL_FALSE. See
558 glLightModel.
559
560 GL_LINE_SMOOTH params returns a single boolean value indicat‐
561 ing whether antialiasing of lines is enabled.
562 The initial value is GL_FALSE. See
563 glLineWidth.
564
565 GL_LINE_SMOOTH_HINT params returns one value, a symbolic constant
566 indicating the mode of the line antialiasing
567 hint. The initial value is GL_DONT_CARE. See
568 glHint.
569
570 GL_LINE_STIPPLE params returns a single boolean value indicat‐
571 ing whether stippling of lines is enabled. The
572 initial value is GL_FALSE. See glLineStipple.
573
574 GL_LINE_STIPPLE_PATTERN params returns one value, the 16-bit line
575 stipple pattern. The initial value is all 1's.
576 See glLineStipple.
577
578 GL_LINE_STIPPLE_REPEAT params returns one value, the line stipple
579 repeat factor. The initial value is 1. See
580 glLineStipple.
581
582 GL_LINE_WIDTH params returns one value, the line width as
583 specified with glLineWidth. The initial value
584 is 1.
585
586 GL_LINE_WIDTH_GRANULARITY
587 params returns one value, the width difference
588 between adjacent supported widths for
589 antialiased lines. See glLineWidth.
590
591 GL_LINE_WIDTH_RANGE params returns two values: the smallest and
592 largest supported widths for antialiased
593 lines. See glLineWidth.
594
595 GL_LIST_BASE params returns one value, the base offset
596 added to all names in arrays presented to
597 glCallLists. The initial value is 0. See
598 glListBase.
599
600 GL_LIST_INDEX params returns one value, the name of the dis‐
601 play list currently under construction. 0 is
602 returned if no display list is currently under
603 construction. The initial value is 0. See
604 glNewList.
605
606 GL_LIST_MODE params returns one value, a symbolic constant
607 indicating the construction mode of the dis‐
608 play list currently under construction. The
609 initial value is 0. See glNewList.
610
611 GL_LOGIC_OP_MODE params returns one value, a symbolic constant
612 indicating the selected logic operation mode.
613 The initial value is GL_COPY. See glLogicOp.
614
615 GL_MAP1_COLOR_4 params returns a single boolean value indicat‐
616 ing whether 1D evaluation generates colors.
617 The initial value is GL_FALSE. See glMap1.
618
619 GL_MAP1_GRID_DOMAIN params returns two values: the endpoints of
620 the 1D map's grid domain. The initial value is
621 (0, 1). See glMapGrid.
622
623 GL_MAP1_GRID_SEGMENTS params returns one value, the number of parti‐
624 tions in the 1D map's grid domain. The initial
625 value is 1. See glMapGrid.
626
627 GL_MAP1_INDEX params returns a single boolean value indicat‐
628 ing whether 1D evaluation generates color
629 indices. The initial value is GL_FALSE. See
630 glMap1.
631
632 GL_MAP1_NORMAL params returns a single boolean value indicat‐
633 ing whether 1D evaluation generates normals.
634 The initial value is GL_FALSE. See glMap1.
635
636 GL_MAP1_TEXTURE_COORD_1 params returns a single boolean value indicat‐
637 ing whether 1D evaluation generates 1D texture
638 coordinates. The initial value is GL_FALSE.
639 See glMap1.
640
641 GL_MAP1_TEXTURE_COORD_2 params returns a single boolean value indicat‐
642 ing whether 1D evaluation generates 2D texture
643 coordinates. The initial value is GL_FALSE.
644 See glMap1.
645
646 GL_MAP1_TEXTURE_COORD_3 params returns a single boolean value indicat‐
647 ing whether 1D evaluation generates 3D texture
648 coordinates. The initial value is GL_FALSE.
649 See glMap1.
650
651 GL_MAP1_TEXTURE_COORD_4 params returns a single boolean value indicat‐
652 ing whether 1D evaluation generates 4D texture
653 coordinates. The initial value is GL_FALSE.
654 See glMap1.
655
656 GL_MAP1_VERTEX_3 params returns a single boolean value indicat‐
657 ing whether 1D evaluation generates 3D vertex
658 coordinates. The initial value is GL_FALSE.
659 See glMap1.
660
661 GL_MAP1_VERTEX_4 params returns a single boolean value indicat‐
662 ing whether 1D evaluation generates 4D vertex
663 coordinates. The initial value is GL_FALSE.
664 See glMap1.
665
666 GL_MAP2_COLOR_4 params returns a single boolean value indicat‐
667 ing whether 2D evaluation generates colors.
668 The initial value is GL_FALSE. See glMap2.
669
670 GL_MAP2_GRID_DOMAIN params returns four values: the endpoints of
671 the 2D map's i and j grid domains. The initial
672 value is (0,1; 0,1). See glMapGrid.
673
674 GL_MAP2_GRID_SEGMENTS params returns two values: the number of par‐
675 titions in the 2D map's i and j grid domains.
676 The initial value is (1,1). See glMapGrid.
677
678 GL_MAP2_INDEX params returns a single boolean value indicat‐
679 ing whether 2D evaluation generates color
680 indices. The initial value is GL_FALSE. See
681 glMap2.
682
683 GL_MAP2_NORMAL params returns a single boolean value indicat‐
684 ing whether 2D evaluation generates normals.
685 The initial value is GL_FALSE. See glMap2.
686
687 GL_MAP2_TEXTURE_COORD_1 params returns a single boolean value indicat‐
688 ing whether 2D evaluation generates 1D texture
689 coordinates. The initial value is GL_FALSE.
690 See glMap2.
691
692 GL_MAP2_TEXTURE_COORD_2 params returns a single boolean value indicat‐
693 ing whether 2D evaluation generates 2D texture
694 coordinates. The initial value is GL_FALSE.
695 See glMap2.
696
697 GL_MAP2_TEXTURE_COORD_3 params returns a single boolean value indicat‐
698 ing whether 2D evaluation generates 3D texture
699 coordinates. The initial value is GL_FALSE.
700 See glMap2.
701
702 GL_MAP2_TEXTURE_COORD_4 params returns a single boolean value indicat‐
703 ing whether 2D evaluation generates 4D texture
704 coordinates. The initial value is GL_FALSE.
705 See glMap2.
706
707 GL_MAP2_VERTEX_3 params returns a single boolean value indicat‐
708 ing whether 2D evaluation generates 3D vertex
709 coordinates. The initial value is GL_FALSE.
710 See glMap2.
711
712 GL_MAP2_VERTEX_4 params returns a single boolean value indicat‐
713 ing whether 2D evaluation generates 4D vertex
714 coordinates. The initial value is GL_FALSE.
715 See glMap2.
716
717 GL_MAP_COLOR params returns a single boolean value indicat‐
718 ing if colors and color indices are to be
719 replaced by table lookup during pixel trans‐
720 fers. The initial value is GL_FALSE. See
721 glPixelTransfer.
722
723 GL_MAP_STENCIL params returns a single boolean value indicat‐
724 ing if stencil indices are to be replaced by
725 table lookup during pixel transfers. The ini‐
726 tial value is GL_FALSE. See glPixelTransfer.
727
728 GL_MATRIX_MODE params returns one value, a symbolic constant
729 indicating which matrix stack is currently the
730 target of all matrix operations. The initial
731 value is GL_MODELVIEW. See glMatrixMode.
732
733 GL_MAX_3D_TEXTURE_SIZE params returns one value, a rough estimate of
734 the largest 3D texture that the GL can handle.
735 If the GL version is 1.2 or greater, use
736 GL_PROXY_TEXTURE_3D to determine if a texture
737 is too large. See glTexImage3D.
738
739 GL_MAX_CLIENT_ATTRIB_STACK_DEPTH
740 params returns one value indicating the maxi‐
741 mum supported depth of the client attribute
742 stack. See glPushClientAttrib.
743
744 GL_MAX_ATTRIB_STACK_DEPTH
745 params returns one value, the maximum sup‐
746 ported depth of the attribute stack. The value
747 must be at least 16. See glPushAttrib.
748
749 GL_MAX_CLIP_PLANES params returns one value, the maximum number
750 of application-defined clipping planes. The
751 value must be at least 6. See glClipPlane.
752
753 GL_MAX_COLOR_MATRIX_STACK_DEPTH
754 params returns one value, the maximum sup‐
755 ported depth of the color matrix stack. The
756 value must be at least 2. See glPushMatrix.
757
758 GL_MAX_ELEMENTS_INDICES params returns one value, the recommended max‐
759 imum number of vertex array indices. See
760 glDrawRangeElements.
761
762 GL_MAX_ELEMENTS_VERTICES params returns one value, the recommended max‐
763 imum number of vertex array vertices. See
764 glDrawRangeElements.
765
766 GL_MAX_EVAL_ORDER params returns one value, the maximum equation
767 order supported by 1D and 2D evaluators. The
768 value must be at least 8. See glMap1 and
769 glMap2.
770
771 GL_MAX_LIGHTS params returns one value, the maximum number
772 of lights. The value must be at least 8. See
773 glLight.
774
775 GL_MAX_LIST_NESTING params returns one value, the maximum recur‐
776 sion depth allowed during display-list traver‐
777 sal. The value must be at least 64. See
778 glCallList.
779
780 GL_MAX_MODELVIEW_STACK_DEPTH
781 params returns one value, the maximum sup‐
782 ported depth of the modelview matrix stack.
783 The value must be at least 32. See
784 glPushMatrix.
785
786 GL_MAX_NAME_STACK_DEPTH params returns one value, the maximum sup‐
787 ported depth of the selection name stack. The
788 value must be at least 64. See glPushName.
789
790 GL_MAX_PIXEL_MAP_TABLE params returns one value, the maximum sup‐
791 ported size of a glPixelMap lookup table. The
792 value must be at least 32. See glPixelMap.
793
794 GL_MAX_PROJECTION_STACK_DEPTH
795 params returns one value, the maximum sup‐
796 ported depth of the projection matrix stack.
797 The value must be at least 2. See
798 glPushMatrix.
799
800 GL_MAX_TEXTURE_SIZE params returns one value. The value gives a
801 rough estimate of the largest texture that the
802 GL can handle. If the GL version is 1.1 or
803 greater, use GL_PROXY_TEXTURE_1D or
804 GL_PROXY_TEXTURE_2D to determine if a texture
805 is too large. See glTexImage1D and
806 glTexImage2D.
807
808 GL_MAX_TEXTURE_STACK_DEPTH
809 params returns one value, the maximum sup‐
810 ported depth of the texture matrix stack. The
811 value must be at least 2. See glPushMatrix.
812
813 GL_MAX_TEXTURE_UNITS_ARB params returns a single value indicating the
814 number of texture units supported. The value
815 must be at least 1. See glActiveTextureARB.
816
817 GL_MAX_VIEWPORT_DIMS params returns two values: the maximum sup‐
818 ported width and height of the viewport.
819 These must be at least as large as the visible
820 dimensions of the display being rendered to.
821 See glViewport.
822
823 GL_MINMAX params returns a single boolean value indicat‐
824 ing whether pixel minmax values are computed.
825 The initial value is GL_FALSE. See glMinmax.
826
827 GL_MODELVIEW_MATRIX params returns sixteen values: the modelview
828 matrix on the top of the modelview matrix
829 stack. Initially this matrix is the identity
830 matrix. See glPushMatrix.
831
832 GL_MODELVIEW_STACK_DEPTH params returns one value, the number of matri‐
833 ces on the modelview matrix stack. The ini‐
834 tial value is 1. See glPushMatrix.
835
836 GL_NAME_STACK_DEPTH params returns one value, the number of names
837 on the selection name stack. The initial value
838 is 0. See glPushName.
839
840 GL_NORMAL_ARRAY params returns a single boolean value, indi‐
841 cating whether the normal array is enabled.
842 The initial value is GL_FALSE. See
843 glNormalPointer.
844
845 GL_NORMAL_ARRAY_STRIDE params returns one value, the byte offset
846 between consecutive normals in the normal
847 array. The initial value is 0. See
848 glNormalPointer.
849
850 GL_NORMAL_ARRAY_TYPE params returns one value, the data type of
851 each coordinate in the normal array. The ini‐
852 tial value is GL_FLOAT. See glNormalPointer.
853
854 GL_NORMALIZE params returns a single boolean value indicat‐
855 ing whether normals are automatically scaled
856 to unit length after they have been trans‐
857 formed to eye coordinates. The initial value
858 is GL_FALSE. See glNormal.
859
860 GL_PACK_ALIGNMENT params returns one value, the byte alignment
861 used for writing pixel data to memory. The
862 initial value is 4. See glPixelStore.
863
864 GL_PACK_IMAGE_HEIGHT params returns one value, the image height
865 used for writing pixel data to memory. The
866 initial value is 0. See glPixelStore.
867
868 GL_PACK_LSB_FIRST params returns a single boolean value indicat‐
869 ing whether single-bit pixels being written to
870 memory are written first to the least signifi‐
871 cant bit of each unsigned byte. The initial
872 value is GL_FALSE. See glPixelStore.
873
874 GL_PACK_ROW_LENGTH params returns one value, the row length used
875 for writing pixel data to memory. The initial
876 value is 0. See glPixelStore.
877
878 GL_PACK_SKIP_IMAGES params returns one value, the number of pixel
879 images skipped before the first pixel is writ‐
880 ten into memory. The initial value is 0. See
881 glPixelStore.
882
883 GL_PACK_SKIP_PIXELS params returns one value, the number of pixel
884 locations skipped before the first pixel is
885 written into memory. The initial value is 0.
886 See glPixelStore.
887
888 GL_PACK_SKIP_ROWS params returns one value, the number of rows
889 of pixel locations skipped before the first
890 pixel is written into memory. The initial
891 value is 0. See glPixelStore.
892
893 GL_PACK_SWAP_BYTES params returns a single boolean value indicat‐
894 ing whether the bytes of two-byte and four-
895 byte pixel indices and components are swapped
896 before being written to memory. The initial
897 value is GL_FALSE. See glPixelStore.
898
899 GL_PERSPECTIVE_CORRECTION_HINT
900 params returns one value, a symbolic constant
901 indicating the mode of the perspective correc‐
902 tion hint. The initial value is GL_DONT_CARE.
903 See glHint.
904
905 GL_PIXEL_MAP_A_TO_A_SIZE params returns one value, the size of the
906 alpha-to-alpha pixel translation table. The
907 initial value is 1. See glPixelMap.
908
909 GL_PIXEL_MAP_B_TO_B_SIZE params returns one value, the size of the
910 blue-to-blue pixel translation table. The
911 initial value is 1. See glPixelMap.
912
913 GL_PIXEL_MAP_G_TO_G_SIZE params returns one value, the size of the
914 green-to-green pixel translation table. The
915 initial value is 1. See glPixelMap.
916
917 GL_PIXEL_MAP_I_TO_A_SIZE params returns one value, the size of the
918 index-to-alpha pixel translation table. The
919 initial value is 1. See glPixelMap.
920
921 GL_PIXEL_MAP_I_TO_B_SIZE params returns one value, the size of the
922 index-to-blue pixel translation table. The
923 initial value is 1. See glPixelMap.
924
925 GL_PIXEL_MAP_I_TO_G_SIZE params returns one value, the size of the
926 index-to-green pixel translation table. The
927 initial value is 1. See glPixelMap.
928
929 GL_PIXEL_MAP_I_TO_I_SIZE params returns one value, the size of the
930 index-to-index pixel translation table. The
931 initial value is 1. See glPixelMap.
932
933 GL_PIXEL_MAP_I_TO_R_SIZE params returns one value, the size of the
934 index-to-red pixel translation table. The
935 initial value is 1. See glPixelMap.
936
937 GL_PIXEL_MAP_R_TO_R_SIZE params returns one value, the size of the red-
938 to-red pixel translation table. The initial
939 value is 1. See glPixelMap.
940
941 GL_PIXEL_MAP_S_TO_S_SIZE params returns one value, the size of the
942 stencil-to-stencil pixel translation table.
943 The initial value is 1. See glPixelMap.
944
945 GL_POINT_SIZE params returns one value, the point size as
946 specified by glPointSize. The initial value is
947 1.
948
949 GL_POINT_SIZE_GRANULARITY
950 params returns one value, the size difference
951 between adjacent supported sizes for
952 antialiased points. See glPointSize.
953
954 GL_POINT_SIZE_RANGE params returns two values: the smallest and
955 largest supported sizes for antialiased
956 points. The smallest size must be at most 1,
957 and the largest size must be at least 1. See
958 glPointSize.
959
960 GL_POINT_SMOOTH params returns a single boolean value indicat‐
961 ing whether antialiasing of points is enabled.
962 The initial value is GL_FALSE. See
963 glPointSize.
964
965 GL_POINT_SMOOTH_HINT params returns one value, a symbolic constant
966 indicating the mode of the point antialiasing
967 hint. The initial value is GL_DONT_CARE. See
968 glHint.
969
970 GL_POLYGON_MODE params returns two values: symbolic constants
971 indicating whether front-facing and back-fac‐
972 ing polygons are rasterized as points, lines,
973 or filled polygons. The initial value is
974 GL_FILL. See glPolygonMode.
975
976 GL_POLYGON_OFFSET_FACTOR params returns one value, the scaling factor
977 used to determine the variable offset that is
978 added to the depth value of each fragment gen‐
979 erated when a polygon is rasterized. The ini‐
980 tial value is 0. See glPolygonOffset.
981
982 GL_POLYGON_OFFSET_UNITS params returns one value. This value is mul‐
983 tiplied by an implementation-specific value
984 and then added to the depth value of each
985 fragment generated when a polygon is raster‐
986 ized. The initial value is 0. See
987 glPolygonOffset.
988
989 GL_POLYGON_OFFSET_FILL params returns a single boolean value indicat‐
990 ing whether polygon offset is enabled for
991 polygons in fill mode. The initial value is
992 GL_FALSE. See glPolygonOffset.
993
994 GL_POLYGON_OFFSET_LINE params returns a single boolean value indicat‐
995 ing whether polygon offset is enabled for
996 polygons in line mode. The initial value is
997 GL_FALSE. See glPolygonOffset.
998
999 GL_POLYGON_OFFSET_POINT params returns a single boolean value indicat‐
1000 ing whether polygon offset is enabled for
1001 polygons in point mode. The initial value is
1002 GL_FALSE. See glPolygonOffset.
1003
1004 GL_POLYGON_SMOOTH params returns a single boolean value indicat‐
1005 ing whether antialiasing of polygons is
1006 enabled. The initial value is GL_FALSE. See
1007 glPolygonMode.
1008
1009 GL_POLYGON_SMOOTH_HINT params returns one value, a symbolic constant
1010 indicating the mode of the polygon antialias‐
1011 ing hint. The initial value is GL_DONT_CARE.
1012 See glHint.
1013
1014 GL_POLYGON_STIPPLE params returns a single boolean value indicat‐
1015 ing whether polygon stippling is enabled. The
1016 initial value is GL_FALSE. See
1017 glPolygonStipple.
1018
1019 GL_POST_COLOR_MATRIX_COLOR_TABLE
1020 params returns a single boolean value indicat‐
1021 ing whether post color matrix transformation
1022 lookup is enabled. The initial value is
1023 GL_FALSE. See glColorTable.
1024
1025 GL_POST_COLOR_MATRIX_RED_BIAS
1026 params returns one value, the red bias factor
1027 applied to RGBA fragments after color matrix
1028 transformations. The initial value is 0. See
1029 glPixelTransfer.
1030
1031 GL_POST_COLOR_MATRIX_GREEN_BIAS
1032 params returns one value, the green bias fac‐
1033 tor applied to RGBA fragments after color
1034 matrix transformations. The initial value is
1035 0. See glPixelTransfer
1036
1037 GL_POST_COLOR_MATRIX_BLUE_BIAS
1038 params returns one value, the blue bias factor
1039 applied to RGBA fragments after color matrix
1040 transformations. The initial value is 0. See
1041 glPixelTransfer.
1042
1043 GL_POST_COLOR_MATRIX_ALPHA_BIAS
1044 params returns one value, the alpha bias fac‐
1045 tor applied to RGBA fragments after color
1046 matrix transformations. The initial value is
1047 0. See glPixelTransfer.
1048
1049 GL_POST_COLOR_MATRIX_RED_SCALE
1050 params returns one value, the red scale factor
1051 applied to RGBA fragments after color matrix
1052 transformations. The initial value is 1. See
1053 glPixelTransfer.
1054
1055 GL_POST_COLOR_MATRIX_GREEN_SCALE
1056 params returns one value, the green scale fac‐
1057 tor applied to RGBA fragments after color
1058 matrix transformations. The initial value is
1059 1. See glPixelTransfer.
1060
1061 GL_POST_COLOR_MATRIX_BLUE_SCALE
1062 params returns one value, the blue scale fac‐
1063 tor applied to RGBA fragments after color
1064 matrix transformations. The initial value is
1065 1. See glPixelTransfer.
1066
1067 GL_POST_COLOR_MATRIX_ALPHA_SCALE
1068 params returns one value, the alpha scale fac‐
1069 tor applied to RGBA fragments after color
1070 matrix transformations. The initial value is
1071 1. See glPixelTransfer.
1072
1073 GL_POST_CONVOLUTION_COLOR_TABLE
1074 params returns a single boolean value indicat‐
1075 ing whether post convolution lookup is
1076 enabled. The initial value is GL_FALSE. See
1077 glColorTable.
1078
1079 GL_POST_CONVOLUTION_RED_BIAS
1080 params returns one value, the red bias factor
1081 applied to RGBA fragments after convolution.
1082 The initial value is 0. See glPixelTransfer.
1083
1084 GL_POST_CONVOLUTION_GREEN_BIAS
1085 params returns one value, the green bias fac‐
1086 tor applied to RGBA fragments after convolu‐
1087 tion. The initial value is 0. See
1088 glPixelTransfer.
1089
1090 GL_POST_CONVOLUTION_BLUE_BIAS
1091 params returns one value, the blue bias factor
1092 applied to RGBA fragments after convolution.
1093 The initial value is 0. See glPixelTransfer.
1094
1095 GL_POST_CONVOLUTION_ALPHA_BIAS
1096 params returns one value, the alpha bias fac‐
1097 tor applied to RGBA fragments after convolu‐
1098 tion. The initial value is 0. See
1099 glPixelTransfer.
1100
1101 GL_POST_CONVOLUTION_RED_SCALE
1102 params returns one value, the red scale factor
1103 applied to RGBA fragments after convolution.
1104 The initial value is 1. See glPixelTransfer.
1105
1106 GL_POST_CONVOLUTION_GREEN_SCALE
1107 params returns one value, the green scale fac‐
1108 tor applied to RGBA fragments after convolu‐
1109 tion. The initial value is 1. See
1110 glPixelTransfer.
1111
1112 GL_POST_CONVOLUTION_BLUE_SCALE
1113 params returns one value, the blue scale fac‐
1114 tor applied to RGBA fragments after convolu‐
1115 tion. The initial value is 1. See
1116 glPixelTransfer.
1117
1118 GL_POST_CONVOLUTION_ALPHA_SCALE
1119 params returns one value, the alpha scale fac‐
1120 tor applied to RGBA fragments after convolu‐
1121 tion. The initial value is 1. See
1122 glPixelTransfer.
1123
1124 GL_PROJECTION_MATRIX params returns sixteen values: the projection
1125 matrix on the top of the projection matrix
1126 stack. Initially this matrix is the identity
1127 matrix. See glPushMatrix.
1128
1129 GL_PROJECTION_STACK_DEPTH
1130 params returns one value, the number of matri‐
1131 ces on the projection matrix stack. The ini‐
1132 tial value is 1. See glPushMatrix.
1133
1134 GL_READ_BUFFER params returns one value, a symbolic constant
1135 indicating which color buffer is selected for
1136 reading. The initial value is GL_BACK if there
1137 is a back buffer, otherwise it is GL_FRONT.
1138 See glReadPixels and glAccum.
1139
1140 GL_RED_BIAS params returns one value, the red bias factor
1141 used during pixel transfers. The initial value
1142 is 0.
1143
1144 GL_RED_BITS params returns one value, the number of red
1145 bitplanes in each color buffer.
1146
1147 GL_RED_SCALE params returns one value, the red scale factor
1148 used during pixel transfers. The initial value
1149 is 1. See glPixelTransfer.
1150
1151 GL_RENDER_MODE params returns one value, a symbolic constant
1152 indicating whether the GL is in render,
1153 select, or feedback mode. The initial value is
1154 GL_RENDER. See glRenderMode.
1155
1156 GL_RESCALE_NORMAL params returns single boolean value indicating
1157 whether normal rescaling is enabled. See
1158 glEnable.
1159
1160 GL_RGBA_MODE params returns a single boolean value indicat‐
1161 ing whether the GL is in RGBA mode (true) or
1162 color index mode (false). See glColor.
1163
1164 GL_SCISSOR_BOX params returns four values: the x and y window
1165 coordinates of the scissor box, followed by
1166 its width and height. Initially the x and y
1167 window coordinates are both 0 and the width
1168 and height are set to the size of the window.
1169 See glScissor.
1170
1171 GL_SCISSOR_TEST params returns a single boolean value indicat‐
1172 ing whether scissoring is enabled. The initial
1173 value is GL_FALSE. See glScissor.
1174
1175 GL_SELECTION_BUFFER_SIZE params return one value, the size of the
1176 selection buffer. See glSelectBuffer.
1177
1178 GL_SEPARABLE_2D params returns a single boolean value indicat‐
1179 ing whether 2D separable convolution is
1180 enabled. The initial value is GL_FALSE. See
1181 glSeparableFilter2D.
1182
1183 GL_SHADE_MODEL params returns one value, a symbolic constant
1184 indicating whether the shading mode is flat or
1185 smooth. The initial value is GL_SMOOTH. See
1186 glShadeModel.
1187
1188 GL_SMOOTH_LINE_WIDTH_RANGE
1189 params returns two values, the smallest and
1190 largest supported widths for antialiased
1191 lines. See glLineWidth.
1192
1193 GL_SMOOTH_LINE_WIDTH_GRANULARITY
1194 params returns one value, the granularity of
1195 widths for antialiased lines. See
1196 glLineWidth.
1197
1198 GL_SMOOTH_POINT_SIZE_RANGE
1199 params returns two values, the smallest and
1200 largest supported widths for antialiased
1201 points. See glPointSize.
1202
1203 GL_SMOOTH_POINT_SIZE_GRANULARITY
1204 params returns one value, the granularity of
1205 sizes for antialiased points. See
1206 glPointSize.
1207
1208 GL_STENCIL_BITS params returns one value, the number of bit‐
1209 planes in the stencil buffer.
1210
1211 GL_STENCIL_CLEAR_VALUE params returns one value, the index to which
1212 the stencil bitplanes are cleared. The initial
1213 value is 0. See glClearStencil.
1214
1215 GL_STENCIL_FAIL params returns one value, a symbolic constant
1216 indicating what action is taken when the sten‐
1217 cil test fails. The initial value is GL_KEEP.
1218 See glStencilOp.
1219
1220 GL_STENCIL_FUNC params returns one value, a symbolic constant
1221 indicating what function is used to compare
1222 the stencil reference value with the stencil
1223 buffer value. The initial value is GL_ALWAYS.
1224 See glStencilFunc.
1225
1226 GL_STENCIL_PASS_DEPTH_FAIL
1227 params returns one value, a symbolic constant
1228 indicating what action is taken when the sten‐
1229 cil test passes, but the depth test fails. The
1230 initial value is GL_KEEP. See glStencilOp.
1231
1232 GL_STENCIL_PASS_DEPTH_PASS
1233 params returns one value, a symbolic constant
1234 indicating what action is taken when the sten‐
1235 cil test passes and the depth test passes. The
1236 initial value is GL_KEEP. See glStencilOp.
1237
1238 GL_STENCIL_REF params returns one value, the reference value
1239 that is compared with the contents of the
1240 stencil buffer. The initial value is 0. See
1241 glStencilFunc.
1242
1243 GL_STENCIL_TEST params returns a single boolean value indicat‐
1244 ing whether stencil testing of fragments is
1245 enabled. The initial value is GL_FALSE. See
1246 glStencilFunc and glStencilOp.
1247
1248 GL_STENCIL_VALUE_MASK params returns one value, the mask that is
1249 used to mask both the stencil reference value
1250 and the stencil buffer value before they are
1251 compared. The initial value is all 1's. See
1252 glStencilFunc.
1253
1254 GL_STENCIL_WRITEMASK params returns one value, the mask that con‐
1255 trols writing of the stencil bitplanes. The
1256 initial value is all 1's. See glStencilMask.
1257
1258 GL_STEREO params returns a single boolean value indicat‐
1259 ing whether stereo buffers (left and right)
1260 are supported.
1261
1262 GL_SUBPIXEL_BITS params returns one value, an estimate of the
1263 number of bits of subpixel resolution that are
1264 used to position rasterized geometry in window
1265 coordinates. The initial value
1266 is 4.
1267
1268 GL_TEXTURE_1D params returns a single boolean value indicat‐
1269 ing whether 1D texture mapping is enabled. The
1270 initial value is GL_FALSE. See glTexImage1D.
1271
1272 GL_TEXTURE_BINDING_1D params returns a single value, the name of the
1273 texture currently bound to the target
1274 GL_TEXTURE_1D. The initial value is 0. See
1275 glBindTexture.
1276
1277 GL_TEXTURE_2D params returns a single boolean value indicat‐
1278 ing whether 2D texture mapping is enabled. The
1279 initial value is GL_FALSE. See glTexImage2D.
1280
1281 GL_TEXTURE_BINDING_2D params returns a single value, the name of the
1282 texture currently bound to the target
1283 GL_TEXTURE_2D. The initial value is 0. See
1284 glBindTexture.
1285
1286 GL_TEXTURE_3D params returns a single boolean value indicat‐
1287 ing whether 3D texture mapping is enabled. The
1288 initial value is GL_FALSE. See glTexImage3D.
1289
1290 GL_TEXTURE_BINDING_3D params returns a single value, the name of the
1291 texture currently bound to the target
1292 GL_TEXTURE_3D. The initial value is 0. See
1293 glBindTexture.
1294
1295 GL_TEXTURE_COORD_ARRAY params returns a single boolean value indicat‐
1296 ing whether the texture coordinate array is
1297 enabled. The initial value is GL_FALSE. See
1298 glTexCoordPointer.
1299
1300 GL_TEXTURE_COORD_ARRAY_SIZE
1301 params returns one value, the number of coor‐
1302 dinates per element in the texture coordinate
1303 array. The initial value is 4. See
1304 glTexCoordPointer.
1305
1306 GL_TEXTURE_COORD_ARRAY_STRIDE
1307 params returns one value, the byte offset
1308 between consecutive elements in the texture
1309 coordinate array. The initial value is 0. See
1310 glTexCoordPointer.
1311
1312 GL_TEXTURE_COORD_ARRAY_TYPE
1313 params returns one value, the data type of the
1314 coordinates in the texture coordinate array.
1315 The initial value is GL_FLOAT. See
1316 glTexCoordPointer.
1317
1318 GL_TEXTURE_GEN_Q params returns a single boolean value indicat‐
1319 ing whether automatic generation of the q tex‐
1320 ture coordinate is enabled. The initial value
1321 is GL_FALSE. See glTexGen.
1322
1323 GL_TEXTURE_GEN_R params returns a single boolean value indicat‐
1324 ing whether automatic generation of the r tex‐
1325 ture coordinate is enabled. The initial value
1326 is GL_FALSE. See glTexGen.
1327
1328 GL_TEXTURE_GEN_S params returns a single boolean value indicat‐
1329 ing whether automatic generation of the S tex‐
1330 ture coordinate is enabled. The initial value
1331 is GL_FALSE. See glTexGen.
1332
1333 GL_TEXTURE_GEN_T params returns a single boolean value indicat‐
1334 ing whether automatic generation of the T tex‐
1335 ture coordinate is enabled. The initial value
1336 is GL_FALSE. See glTexGen.
1337
1338 GL_TEXTURE_MATRIX params returns sixteen values: the texture
1339 matrix on the top of the texture matrix stack.
1340 Initially this matrix is the identity matrix.
1341 See glPushMatrix.
1342
1343 GL_TEXTURE_STACK_DEPTH params returns one value, the number of matri‐
1344 ces on the texture matrix stack. The initial
1345 value is 1. See glPushMatrix.
1346
1347 GL_UNPACK_ALIGNMENT params returns one value, the byte alignment
1348 used for reading pixel data from memory. The
1349 initial value is 4. See glPixelStore.
1350
1351 GL_UNPACK_IMAGE_HEIGHT params returns one value, the image height
1352 used for reading pixel data from memory. The
1353 initial is 0. See glPixelStore.
1354
1355 GL_UNPACK_LSB_FIRST params returns a single boolean value indicat‐
1356 ing whether single-bit pixels being read from
1357 memory are read first from the least signifi‐
1358 cant bit of each unsigned byte. The initial
1359 value is GL_FALSE. See glPixelStore.
1360
1361 GL_UNPACK_ROW_LENGTH params returns one value, the row length used
1362 for reading pixel data from memory. The ini‐
1363 tial value is 0. See glPixelStore.
1364
1365 GL_UNPACK_SKIP_IMAGES params returns one value, the number of pixel
1366 images skipped before the first pixel is read
1367 from memory. The initial value is 0. See
1368 glPixelStore.
1369
1370 GL_UNPACK_SKIP_PIXELS params returns one value, the number of pixel
1371 locations skipped before the first pixel is
1372 read from memory. The initial value is 0. See
1373 glPixelStore.
1374
1375 GL_UNPACK_SKIP_ROWS params returns one value, the number of rows
1376 of pixel locations skipped before the first
1377 pixel is read from memory. The initial value
1378 is 0. See glPixelStore.
1379
1380 GL_UNPACK_SWAP_BYTES params returns a single boolean value indicat‐
1381 ing whether the bytes of two-byte and four-
1382 byte pixel indices and components are swapped
1383 after being read from memory. The initial
1384 value is GL_FALSE. See glPixelStore.
1385
1386 GL_VERTEX_ARRAY params returns a single boolean value indicat‐
1387 ing whether the vertex array is enabled. The
1388 initial value is GL_FALSE. See
1389 glVertexPointer.
1390
1391 GL_VERTEX_ARRAY_SIZE params returns one value, the number of coor‐
1392 dinates per vertex in the vertex array. The
1393 initial value is 4. See glVertexPointer.
1394
1395 GL_VERTEX_ARRAY_STRIDE params returns one value, the byte offset
1396 between consecutive vertices in the vertex
1397 array. The initial value is 0. See
1398 glVertexPointer.
1399
1400 GL_VERTEX_ARRAY_TYPE params returns one value, the data type of
1401 each coordinate in the vertex array. The ini‐
1402 tial value is GL_FLOAT. See glVertexPointer.
1403
1404 GL_VIEWPORT params returns four values: the x and y window
1405 coordinates of the viewport, followed by its
1406 width and height. Initially the x and y win‐
1407 dow coordinates are both set to 0, and the
1408 width and height are set to the width and
1409 height of the window into which the GL will do
1410 its rendering. See glViewport.
1411
1412 GL_ZOOM_X params returns one value, the x pixel zoom
1413 factor. The initial value is 1. See
1414 glPixelZoom.
1415
1416 GL_ZOOM_Y params returns one value, the y pixel zoom
1417 factor. The initial value is 1. See
1418 glPixelZoom.
1419
1420 Many of the boolean parameters can also be queried more easily using
1421 glIsEnabled.
1422
1424 GL_COLOR_LOGIC_OP, GL_COLOR_ARRAY, GL_COLOR_ARRAY_SIZE,
1425 GL_COLOR_ARRAY_STRIDE, GL_COLOR_ARRAY_TYPE, GL_EDGE_FLAG_ARRAY,
1426 GL_EDGE_FLAG_ARRAY_STRIDE, GL_INDEX_ARRAY, GL_INDEX_ARRAY_STRIDE,
1427 GL_INDEX_ARRAY_TYPE, GL_INDEX_LOGIC_OP, GL_NORMAL_ARRAY,
1428 GL_NORMAL_ARRAY_STRIDE, GL_NORMAL_ARRAY_TYPE, GL_POLYGON_OFFSET_UNITS,
1429 GL_POLYGON_OFFSET_FACTOR, GL_POLYGON_OFFSET_FILL,
1430 GL_POLYGON_OFFSET_LINE, GL_POLYGON_OFFSET_POINT,
1431 GL_TEXTURE_COORD_ARRAY, GL_TEXTURE_COORD_ARRAY_SIZE,
1432 GL_TEXTURE_COORD_ARRAY_STRIDE, GL_TEXTURE_COORD_ARRAY_TYPE,
1433 GL_VERTEX_ARRAY, GL_VERTEX_ARRAY_SIZE, GL_VERTEX_ARRAY_STRIDE, and
1434 GL_VERTEX_ARRAY_TYPE are available only if the GL version is 1.1 or
1435 greater.
1436
1437 GL_ALIASED_POINT_SIZE_RANGE, GL_ALIASED_POINT_SIZE_GRANULARITY,
1438 GL_FEEDBACK_BUFFER_SIZE, GL_FEEDBACK_BUFFER_TYPE,
1439 GL_LIGHT_MODEL_AMBIENT, GL_LIGHT_MODEL_COLOR_CONTROL,
1440 GL_MAX_3D_TEXTURE_SIZE, GL_MAX_ELEMENTS_INDICES,
1441 GL_MAX_ELEMENTS_VERTICES, GL_PACK_IMAGE_HEIGHT, GL_PACK_SKIP_IMAGES,
1442 GL_RESCALE_NORMAL, GL_SELECTION_BUFFER_SIZE,
1443 GL_SMOOTH_LINE_WIDTH_GRANULARITY, GL_SMOOTH_LINE_WIDTH_RANGE,
1444 GL_SMOOTH_POINT_SIZE_GRANULARITY, GL_SMOOTH_POINT_SIZE_RANGE,
1445 GL_TEXTURE_3D, GL_TEXTURE_BINDING_3D, GL_UNPACK_IMAGE_HEIGHT, and
1446 GL_UNPACK_SKIP_IMAGES are available only if the GL version is 1.2 or
1447 greater.
1448
1449 GL_LINE_WIDTH_GRANULARITY was deprecated in GL version 1.2. Its func‐
1450 tionality was replaced by GL_SMOOTH_LINE_WIDTH_GRANULARITY.
1451
1452 GL_LINE_WIDTH_RANGE was deprecated in GL version 1.2. Its functional‐
1453 ity was replaced by GL_SMOOTH_LINE_WIDTH_RANGE.
1454
1455 GL_POINT_SIZE_GRANULARITY was deprecated in GL version 1.2. Its func‐
1456 tionality was replaced by GL_SMOOTH_POINT_SIZE_GRANULARITY.
1457
1458 GL_POINT_SIZE_RANGE was deprecated in GL version 1.2. Its functional‐
1459 ity was replaced by GL_SMOOTH_POINT_SIZE_RANGE.
1460
1461 GL_BLEND_COLOR, GL_BLEND_EQUATION, GL_COLOR_MATRIX,
1462 GL_COLOR_MATRIX_STACK_DEPTH, GL_COLOR_TABLE, GL_CONVOLUTION_1D,
1463 GL_CONVOLUTION_2D, GL_HISTOGRAM, GL_MAX_COLOR_MATRIX_STACK_DEPTH,
1464 GL_MINMAX, GL_POST_COLOR_MATRIX_COLOR_TABLE,
1465 GL_POST_COLOR_MATRIX_RED_BIAS, GL_POST_COLOR_MATRIX_GREEN_BIAS,
1466 GL_POST_COLOR_MATRIX_BLUE_BIAS, GL_POST_COLOR_MATRIX_ALPHA_BIAS,
1467 GL_POST_COLOR_MATRIX_RED_SCALE, GL_POST_COLOR_MATRIX_GREEN_SCALE,
1468 GL_POST_COLOR_MATRIX_BLUE_SCALE, GL_POST_COLOR_MATRIX_ALPHA_SCALE,
1469 GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_CONVOLUTION_RED_BIAS,
1470 GL_POST_CONVOLUTION_GREEN_BIAS, GL_POST_CONVOLUTION_BLUE_BIAS,
1471 GL_POST_CONVOLUTION_ALPHA_BIAS, GL_POST_CONVOLUTION_RED_SCALE,
1472 GL_POST_CONVOLUTION_GREEN_SCALE, GL_POST_CONVOLUTION_BLUE_SCALE,
1473 GL_POST_CONVOLUTION_ALPHA_SCALE, and GL_SEPARABLE_2D are available only
1474 if GL_ARB_imaging is returned from glGet when called with the argument
1475 GL_EXTENSIONS.
1476
1477 GL_ACTIVE_TEXTURE_ARB, GL_CLIENT_ACTIVE_TEXTURE_ARB, and
1478 GL_MAX_TEXTURE_UNITS_ARB are available only if GL_ARB_multitexture is
1479 returned from glGet when called with the argument GL_EXTENSIONS.
1480
1481 When the GL_ARB_multitexture extension is supported, the following
1482 parameters return the associated value for the active texture unit:
1483 GL_CURRENT_RASTER_TEXTURE_COORDS, GL_TEXTURE_1D, GL_TEXTURE_BINDING_1D,
1484 GL_TEXTURE_2D, GL_TEXTURE_BINDING_2D, GL_TEXTURE_3D,
1485 GL_TEXTURE_BINDING_3D, GL_TEXTURE_GEN_S, GL_TEXTURE_GEN_T,
1486 GL_TEXTURE_GEN_R, GL_TEXTURE_GEN_Q, GL_TEXTURE_MATRIX, and
1487 GL_TEXTURE_STACK_DEPTH. Likewise, the following parameters return the
1488 associated value for the active client texture unit:
1489 GL_TEXTURE_COORD_ARRAY, GL_TEXTURE_COORD_ARRAY_SIZE,
1490 GL_TEXTURE_COORD_ARRAY_STRIDE, GL_TEXTURE_COORD_ARRAY_TYPE.
1491
1493 GL_INVALID_ENUM is generated if pname is not an accepted value.
1494
1495 GL_INVALID_OPERATION is generated if glGet is executed between the exe‐
1496 cution of glBegin and the corresponding execution of glEnd.
1497
1499 glGetClipPlane(3G), glGetColorTable(3G), glGetColorTableParameter(3G),
1500 glGetConvolutionFilter(3G), glGetConvolutionParameter(3G),
1501 glGetError(3G), glGetHistogram(3G), glGetHistogramParameter(3G),
1502 glGetLight(3G), glGetMap(3G), glGetMaterial(3G), glGetMinmax(3G),
1503 glGetMinmaxParameter(3G), glGetPixelMap(3G), glGetPointerv(3G),
1504 glGetPolygonStipple(3G), glGetSeparableFilter(3G), glGetString(3G),
1505 glGetTexEnv(3G), glGetTexGen(3G), glGetTexImage(3G),
1506 glGetTexLevelParameter(3G), glGetTexParameter(3G), glIsEnabled(3G)
1507
1508
1509
1510 GLGET(3G)