1GLGET(3G)                                                            GLGET(3G)
2
3
4

NAME

6       glGetBooleanv,  glGetDoublev,  glGetFloatv,  glGetIntegerv - return the
7       value or values of a selected parameter
8
9

C SPECIFICATION

11       void glGetBooleanv( GLenum pname,
12                           GLboolean *params )
13
14

C SPECIFICATION

16       void glGetDoublev( GLenum pname,
17                          GLdouble *params )
18
19

C SPECIFICATION

21       void glGetFloatv( GLenum pname,
22                         GLfloat *params )
23
24

C SPECIFICATION

26       void glGetIntegerv( GLenum pname,
27                           GLint *params )
28
29

PARAMETERS

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

DESCRIPTION

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

NOTES

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

ERRORS

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

SEE ALSO

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)
Impressum