glGet(3G) OpenGL Reference glGet(3G)
NAME
glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv - return the
value or values of a selected parameter
C SPECIFICATION
void glGetBooleanv( GLenum pname,
GLboolean *params )
C SPECIFICATION
void glGetDoublev( GLenum pname,
GLdouble *params )
C SPECIFICATION
void glGetFloatv( GLenum pname,
GLfloat *params )
C SPECIFICATION
void glGetIntegerv( GLenum pname,
GLint *params )
PARAMETERS
pname Specifies the parameter value to be returned. The symbolic
constants in the list below are accepted.
params Returns the value or values of the specified parameter.
DESCRIPTION
These four commands return values for simple state variables in GL. pname
is a symbolic constant indicating the state variable to be returned, and
params is a pointer to an array of the indicated type in which to place
the returned data.
Type conversion is performed if params has a different type than the
state variable value being requested. If glGetBooleanv is called, a
floating-point (or integer) value is converted to GLFALSE if and only if
it is 0.0 (or 0). Otherwise, it is converted to GLTRUE. If
glGetIntegerv is called, boolean values are returned as GLTRUE or
GLFALSE, and most floating-point values are rounded to the nearest
integer value. Floating-point colors and normals, however, are returned
with a linear mapping that maps 1.0 to the most positive representable
integer value, and -1.0 to the most negative representable integer value.
If glGetFloatv or glGetDoublev is called, boolean values are returned as
GLTRUE or GLFALSE, and integer values are converted to floating-point
values.
Page 1
glGet(3G) OpenGL Reference glGet(3G)
The following symbolic constants are accepted by pname:
GLACCUMALPHABITS params returns one value, the number of alpha
bitplanes in the accumulation buffer.
GLACCUMBLUEBITS params returns one value, the number of blue
bitplanes in the accumulation buffer.
GLACCUMCLEARVALUE params returns four values: the red, green,
blue, and alpha values used to clear the
accumulation buffer. Integer values, if
requested, are linearly mapped from the internal
floating-point representation such that 1.0
returns the most positive representable integer
value, and -1.0 returns the most negative
representable integer value. The initial value
is (0, 0, 0, 0). See glClearAccum.
GLACCUMGREENBITS params returns one value, the number of green
bitplanes in the accumulation buffer.
GLACCUMREDBITS params returns one value, the number of red
bitplanes in the accumulation buffer.
GLALPHABIAS params returns one value, the alpha bias factor
used during pixel transfers. The initial value
is 0. See glPixelTransfer.
GLALPHABITS params returns one value, the number of alpha
bitplanes in each color buffer.
GLALPHASCALE params returns one value, the alpha scale factor
used during pixel transfers. The initial value
is 1. See glPixelTransfer.
GLALPHATEST params returns a single boolean value indicating
whether alpha testing of fragments is enabled.
The initial value is GLFALSE. See glAlphaFunc.
GLALPHATESTFUNC params returns one value, the symbolic name of
the alpha test function. The initial value is
GLALWAYS. See glAlphaFunc.
GLALPHATESTREF params returns one value, the reference value
for the alpha test. The initial value is 0. See
glAlphaFunc. An integer value, if requested, is
linearly mapped from the internal floating-point
representation such that 1.0 returns the most
positive representable integer value, and -1.0
returns the most negative representable integer
value.
Page 2
glGet(3G) OpenGL Reference glGet(3G)
GLATTRIBSTACKDEPTH params returns one value, the depth of the
attribute stack. If the stack is empty, 0 is
returned. The initial value is 0. See
glPushAttrib.
GLAUTONORMAL params returns a single boolean value indicating
whether 2D map evaluation automatically
generates surface normals. The initial value is
GLFALSE. See glMap2.
GLAUXBUFFERS params returns one value, the number of
auxiliary color buffers. The initial value is 0.
GLBLEND params returns a single boolean value indicating
whether blending is enabled. The initial value
is GLFALSE. See glBlendFunc.
GLBLENDCOLOREXT params returns four values, the red, green,
blue, and alpha values which are the components
of the blend color. See glBlendColorEXT.
GLBLENDDST params returns one value, the symbolic constant
identifying the destination blend function. The
initial value is GLZERO. See glBlendFunc.
GLBLENDEQUATIONEXT params returns one value, a symbolic constant
indicating whether the blend equation is
GLFUNCADDEXT, GLMINEXT or GLMAXEXT. See
glBlendEquationEXT.
GLBLENDSRC params returns one value, the symbolic constant
identifying the source blend function. The
initial value is GLONE. See glBlendFunc.
GLBLENDOPSGI params returns one value, the symbolic constant
identifying the blend operator. See
glBlendFunc.
GLBLUEBIAS params returns one value, the blue bias factor
used during pixel transfers. The initial value
is 0. See glPixelTransfer.
GLBLUEBITS params returns one value, the number of blue
bitplanes in each color buffer.
GLBLUESCALE params returns one value, the blue scale factor
used during pixel transfers. The initial value
is 1. See glPixelTransfer.
GLCALLIGRAPHICFRAGMENTSGIX
params returns a single boolean value indicating
whether fragment information is sent to the
Page 3
glGet(3G) OpenGL Reference glGet(3G)
calligraphic interface.
GLCLIENTATTRIBSTACKDEPTH
params returns one value indicating the depth of
the attribute stack. The initial value is 0.
See glPushClientAttrib.
GLCLIPPLANEi params returns a single boolean value indicating
whether the specified clipping plane is enabled.
The initial value is GLFALSE. See glClipPlane.
GLCOLORARRAY params returns a single boolean value indicating
whether the color array is enabled. The initial
value is GLFALSE. See glColorPointer.
GLCOLORARRAYSIZE params returns one value, the number of
components per color in the color array. The
initial value is 4. See glColorPointer.
GLCOLORARRAYSTRIDE params returns one value, the byte offset
between consecutive colors in the color array.
The initial value is 0. See glColorPointer.
GLCOLORARRAYTYPE params returns one value, the data type of each
component in the color array. The initial value
is GLFLOAT. See glColorPointer.
GLCOLORCLEARVALUE params returns four values: the red, green,
blue, and alpha values used to clear the color
buffers. Integer values, if requested, are
linearly mapped from the internal floating-point
representation such that 1.0 returns the most
positive representable integer value, and -1.0
returns the most negative representable integer
value. The initial value is (0, 0, 0, 0). See
glClearColor.
GLCOLORLOGICOP params returns a single boolean value indicating
whether a fragment's RGBA color values are
merged into the framebuffer using a logical
operation. The initial value is GLFALSE. See
glLogicOp.
GLCOLORMATERIAL params returns a single boolean value indicating
whether one or more material parameters are
tracking the current color. The initial value is
GLFALSE. See glColorMaterial.
GLCOLORMATERIALFACE params returns one value, a symbolic constant
indicating which materials have a parameter that
is tracking the current color. The initial value
is GLFRONTANDBACK. See glColorMaterial.
Page 4
glGet(3G) OpenGL Reference glGet(3G)
GLCOLORMATERIALPARAMETER
params returns one value, a symbolic constant
indicating which material parameters are
tracking the current color. The initial value is
GLAMBIENTANDDIFFUSE. See glColorMaterial.
GLCOLORMATRIXSGI params returns sixteen values: the color matrix
on the top of the color matrix stack. See
glPushMatrix, glPixelTransfer.
GLCOLORMATRIXSTACKDEPTHSGI
params returns one value, the maximum supported
depth of the color matrix stack. See
glPushMatrix, glPixelTransfer.
GLCOLORTABLESGI params returns a single boolean value indicating
whether colors are passed through a lookup table
before being used by convolution. See
glColorTableSGI.
GLCOLORWRITEMASK params returns four boolean values: the red,
green, blue, and alpha write enables for the
color buffers. The initial value is (GLTRUE,
GLTRUE, GLTRUE, GLTRUE). See glColorMask.
GLCONVOLUTION1DEXT params returns a single boolean value indicating
whether one-dimensional convolution will be
performed during pixel transfers. See
glConvolutionFilter1DEXT.
GLCONVOLUTION2DEXT params returns a single boolean value indicating
whether two-dimensional convolution will be
performed during pixel transfers. See
glConvolutionFilter2DEXT.
GLCULLFACE params returns a single boolean value indicating
whether polygon culling is enabled. The initial
value is GLFALSE. See glCullFace.
GLCULLFACEMODE params returns one value, a symbolic constant
indicating which polygon faces are to be culled.
The initial value is GLBACK. See glCullFace.
GLCURRENTCOLOR params returns four values: the red, green,
blue, and alpha values of the current color.
Integer values, if requested, are linearly
mapped from the internal floating-point
representation such that 1.0 returns the most
positive representable integer value, and -1.0
returns the most negative representable integer
value. See glColor. The initial value is (1, 1,
1, 1).
Page 5
glGet(3G) OpenGL Reference glGet(3G)
GLCURRENTINDEX params returns one value, the current color
index. The initial value is 1. See glIndex.
GLCURRENTNORMAL params returns three values: the x, y, and z
values of the current normal. Integer values,
if requested, are linearly mapped from the
internal floating-point representation such that
1.0 returns the most positive representable
integer value, and -1.0 returns the most
negative representable integer value. The
initial value is (0, 0, 1). See glNormal.
GLCURRENTRASTERCOLOR params returns four values: the red, green,
blue, and alpha values of the current raster
position. Integer values, if requested, are
linearly mapped from the internal floating-point
representation such that 1.0 returns the most
positive representable integer value, and -1.0
returns the most negative representable integer
value. The initial value is (1, 1, 1, 1). See
glRasterPos.
GLCURRENTRASTERDISTANCE
params returns one value, the distance from the
eye to the current raster position. The initial
value is 0. See glRasterPos.
GLCURRENTRASTERINDEX params returns one value, the color index of the
current raster position. The initial value is 1.
See glRasterPos.
GLCURRENTRASTERPOSITION
params returns four values: the x, y, z, and w
components of the current raster position. x,
y, and z are in window coordinates, and w is in
clip coordinates. The initial value is (0, 0, 0,
1). See glRasterPos.
GLCURRENTRASTERPOSITIONVALID
params returns a single boolean value indicating
whether the current raster position is valid.
The initial value is GLTRUE. See glRasterPos.
GLCURRENTRASTERTEXTURECOORDS
params returns four values: the s, t, r, and q
current raster texture coordinates. The initial
value is (0, 0, 0, 1). See glRasterPos and
glTexCoord.
GLCURRENTTEXTURECOORDS
params returns four values: the s, t, r, and q
current texture coordinates. The initial value
Page 6
glGet(3G) OpenGL Reference glGet(3G)
is (0, 0, 0, 1). See glTexCoord.
GLDEPTHBIAS params returns one value, the depth bias factor
used during pixel transfers. The initial value
is 0. See glPixelTransfer.
GLDEPTHBITS params returns one value, the number of
bitplanes in the depth buffer.
GLDEPTHCLEARVALUE params returns one value, the value that is used
to clear the depth buffer. Integer values, if
requested, are linearly mapped from the internal
floating-point representation such that 1.0
returns the most positive representable integer
value, and -1.0 returns the most negative
representable integer value. The initial value
is 1. See glClearDepth.
GLDEPTHFUNC params returns one value, the symbolic constant
that indicates the depth comparison function.
The initial value is GLLESS. See glDepthFunc.
GLDEPTHRANGE params returns two values: the near and far
mapping limits for the depth buffer. Integer
values, if requested, are linearly mapped from
the internal floating-point representation such
that 1.0 returns the most positive representable
integer value, and -1.0 returns the most
negative representable integer value. The
initial value is (0, 1). See glDepthRange.
GLDEPTHSCALE params returns one value, the depth scale factor
used during pixel transfers. The initial value
is 1. See glPixelTransfer.
GLDEPTHTEST params returns a single boolean value indicating
whether depth testing of fragments is enabled.
The initial value is GLFALSE. See glDepthFunc
and glDepthRange.
GLDEPTHWRITEMASK params returns a single boolean value indicating
if the depth buffer is enabled for writing. The
initial value is GLTRUE. See glDepthMask.
GLDETAILTEXTURE2DBINDINGSGIS
params returns a single value, the name of the
detail texture bound to
GLDETAILTEXTURE2DSGIS (or zero if there is
none). See glDetailTexFuncSGIS.
Page 7
glGet(3G) OpenGL Reference glGet(3G)
GLDISTANCEATTENUATIONSGIS
params returns three values, the coefficients of
the distance attentuation function for rendering
points. See glPointParameterSGIS.
GLDITHER params returns a single boolean value indicating
whether dithering of fragment colors and indices
is enabled. The initial value is GLTRUE.
GLDOUBLEBUFFER params returns a single boolean value indicating
whether double buffering is supported.
GLDRAWBUFFER params returns one value, a symbolic constant
indicating which buffers are being drawn to. See
glDrawBuffer. The initial value is GLBACK if
there are back buffers, otherwise it is
GLFRONT.
GLEDGEFLAG params returns a single boolean value indicating
whether the current edge flag is GLTRUE or
GLFALSE. The initial value is GLTRUE. See
glEdgeFlag.
GLEDGEFLAGARRAY params returns a single boolean value indicating
whether the edge flag array is enabled. The
initial value is GLFALSE. See
glEdgeFlagPointer.
GLEDGEFLAGARRAYSTRIDE
params returns one value, the byte offset
between consecutive edge flags in the edge flag
array. The initial value is 0. See
glEdgeFlagPointer.
GLFOG params returns a single boolean value indicating
whether fogging is enabled. The initial value is
GLFALSE. See glFog.
GLFOGCOLOR params returns four values: the red, green,
blue, and alpha components of the fog color.
Integer values, if requested, are linearly
mapped from the internal floating-point
representation such that 1.0 returns the most
positive representable integer value, and -1.0
returns the most negative representable integer
value. The initial value is (0, 0, 0, 0). See
glFog.
GLFOGDENSITY params returns one value, the fog density
parameter. The initial value is 1. See glFog.
Page 8
glGet(3G) OpenGL Reference glGet(3G)
GLFOGEND params returns one value, the end factor for the
linear fog equation. The initial value is 1. See
glFog.
GLFOGFUNCPOINTSSGIS params returns one value, the number of points
in the current custom fog blending function.
See glFog and glFogFuncSGIS.
GLFOGFUNCSGIS params returns an array of fog blending function
control points. Each control point consists of
two values, an eye-space distance and a blending
factor, in that order. The control points are
listed in order of increasing eye-space
distance. The number of control points may be
queried by glGet with argument
GLFOGFUNCPOINTSSGIS. See glFog and
glFogFuncSGIS.
GLFOGHINT params returns one value, a symbolic constant
indicating the mode of the fog hint. The initial
value is GLDONTCARE. See glHint.
GLFOGINDEX params returns one value, the fog color index.
The initial value is 0. See glFog.
GLFOGMODE params returns one value, a symbolic constant
indicating which fog equation is selected. The
initial value is GLEXP. See glFog.
GLFOGSTART params returns one value, the start factor for
the linear fog equation. The initial value is 0.
See glFog
GLFOGOFFSETSGIX params returns a single boolean value indicating
whether fog offset is enabled. See glFog.
GLFOGOFFSETVALUESGIX params returns four values, a reference point
(X,Y,Z) in eye coordinates, and a Z offset in
eye coordinates. See glFog.
GLFRONTFACE params returns one value, a symbolic constant
indicating whether clockwise or counterclockwise
polygon winding is treated as front-facing. The
initial value is GLCCW. See glFrontFace.
GLGREENBIAS params returns one value, the green bias factor
used during pixel transfers. The initial value
is 0.
GLGREENBITS params returns one value, the number of green
bitplanes in each color buffer.
Page 9
glGet(3G) OpenGL Reference glGet(3G)
GLGREENSCALE params returns one value, the green scale factor
used during pixel transfers. The initial value
is 1. See glPixelTransfer.
GLHISTOGRAMEXT params returns a single boolean value indicating
whether histogramming is enabled. See
glHistogramEXT.
GLINDEXARRAY params returns a single boolean value indicating
whether the color index array is enabled. The
initial value is GLFALSE. See glIndexPointer.
GLINDEXARRAYSTRIDE params returns one value, the byte offset
between consecutive color indexes in the color
index array. The initial value is 0. See
glIndexPointer.
GLINDEXARRAYTYPE params returns one value, the data type of
indexes in the color index array. The initial
value is GLFLOAT. See glIndexPointer.
GLINDEXBITS params returns one value, the number of
bitplanes in each color index buffer.
GLINDEXCLEARVALUE params returns one value, the color index used
to clear the color index buffers. The initial
value is 0. See glClearIndex.
GLINDEXLOGICOP params returns a single boolean value indicating
whether a fragment's index values are merged
into the framebuffer using a logical operation.
The initial value is GLFALSE. See glLogicOp.
GLINDEXMODE params returns a single boolean value indicating
whether the GL is in color index mode (GLTRUE)
or RGBA mode (GLFALSE).
GLINDEXOFFSET params returns one value, the offset added to
color and stencil indices during pixel
transfers. The initial value is 0. See
glPixelTransfer.
GLINDEXSHIFT params returns one value, the amount that color
and stencil indices are shifted during pixel
transfers. The initial value is 0. See
glPixelTransfer.
GLINDEXWRITEMASK params returns one value, a mask indicating
which bitplanes of each color index buffer can
be written. The initial value is all 1's. See
glIndexMask.
Page 10
glGet(3G) OpenGL Reference glGet(3G)
GLINSTRUMENTMEASUREMENTSSGIX
params returns one value, the number of
outstanding instrumentation requests made since
the instrumentation buffer was specified. See
glInstrumentsBufferSGIX.
GLINTERLACESGIX params returns a single boolean value indicating
whether glCopyPixels and glCopyTexSubImage2DEXT
skip every other line in the destination pixel
array. See glCopyPixels and
glCopyTexSubImage2DEXT.
GLLIGHTi params returns a single boolean value indicating
whether the specified light is enabled. The
initial value is GLFALSE. See glLight and
glLightModel.
GLLIGHTING params returns a single boolean value indicating
whether lighting is enabled. The initial value
is GLFALSE. See glLightModel.
GLLIGHTMODELAMBIENT params returns four values: the red, green,
blue, and alpha components of the ambient
intensity of the entire scene. Integer values,
if requested, are linearly mapped from the
internal floating-point representation such that
1.0 returns the most positive representable
integer value, and -1.0 returns the most
negative representable integer value. The
initial value is (0.2, 0.2, 0.2, 1.0). See
glLightModel.
GLLIGHTMODELLOCALVIEWER
params returns a single boolean value indicating
whether specular reflection calculations treat
the viewer as being local to the scene. The
initial value is GLFALSE. See glLightModel.
GLLIGHTMODELTWOSIDE params returns a single boolean value indicating
whether separate materials are used to compute
lighting for front- and back-facing polygons.
The initial value is GLFALSE. See glLightModel.
GLLINESMOOTH params returns a single boolean value indicating
whether antialiasing of lines is enabled. The
initial value is GLFALSE. See glLineWidth.
GLLINESMOOTHHINT params returns one value, a symbolic constant
indicating the mode of the line antialiasing
hint. The initial value is GLDONTCARE. See
glHint.
Page 11
glGet(3G) OpenGL Reference glGet(3G)
GLLINESTIPPLE params returns a single boolean value indicating
whether stippling of lines is enabled. The
initial value is GLFALSE. See glLineStipple.
GLLINESTIPPLEPATTERN params returns one value, the 16-bit line
stipple pattern. The initial value is all 1's.
See glLineStipple.
GLLINESTIPPLEREPEAT params returns one value, the line stipple
repeat factor. The initial value is 1. See
glLineStipple.
GLLINEWIDTH params returns one value, the line width as
specified with glLineWidth. The initial value is
1.
GLLINEWIDTHGRANULARITY
params returns one value, the width difference
between adjacent supported widths for
antialiased lines. See glLineWidth.
GLLINEWIDTHRANGE params returns two values: the smallest and
largest supported widths for antialiased lines.
See glLineWidth.
GLLISTBASE params returns one value, the base offset added
to all names in arrays presented to glCallLists.
The initial value is 0. See glListBase.
GLLISTINDEX params returns one value, the name of the
display list currently under construction. 0 is
returned if no display list is currently under
construction. The initial value is 0. See
glNewList.
GLLISTMODE params returns one value, a symbolic constant
indicating the construction mode of the display
list currently under construction. The initial
value is 0. See glNewList.
GLLOGICOPMODE params returns one value, a symbolic constant
indicating the selected logic operation mode.
The initial value is GLCOPY. See glLogicOp.
GLMAP1COLOR4 params returns a single boolean value indicating
whether 1D evaluation generates colors. The
initial value is GLFALSE. See glMap1.
GLMAP1GRIDDOMAIN params returns two values: the endpoints of the
1D map's grid domain. The initial value is (0,
1). See glMapGrid.
Page 12
glGet(3G) OpenGL Reference glGet(3G)
GLMAP1GRIDSEGMENTS params returns one value, the number of
partitions in the 1D map's grid domain. The
initial value is 1. See glMapGrid.
GLMAP1INDEX params returns a single boolean value indicating
whether 1D evaluation generates color indices.
The initial value is GLFALSE. See glMap1.
GLMAP1NORMAL params returns a single boolean value indicating
whether 1D evaluation generates normals. The
initial value is GLFALSE. See glMap1.
GLMAP1TEXTURECOORD1 params returns a single boolean value indicating
whether 1D evaluation generates 1D texture
coordinates. The initial value is GLFALSE. See
glMap1.
GLMAP1TEXTURECOORD2 params returns a single boolean value indicating
whether 1D evaluation generates 2D texture
coordinates. The initial value is GLFALSE. See
glMap1.
GLMAP1TEXTURECOORD3 params returns a single boolean value indicating
whether 1D evaluation generates 3D texture
coordinates. The initial value is GLFALSE. See
glMap1.
GLMAP1TEXTURECOORD4 params returns a single boolean value indicating
whether 1D evaluation generates 4D texture
coordinates. The initial value is GLFALSE. See
glMap1.
GLMAP1VERTEX3 params returns a single boolean value indicating
whether 1D evaluation generates 3D vertex
coordinates. The initial value is GLFALSE. See
glMap1.
GLMAP1VERTEX4 params returns a single boolean value indicating
whether 1D evaluation generates 4D vertex
coordinates. The initial value is GLFALSE. See
glMap1.
GLMAP2COLOR4 params returns a single boolean value indicating
whether 2D evaluation generates colors. The
initial value is GLFALSE. See glMap2.
GLMAP2GRIDDOMAIN params returns four values: the endpoints of
the 2D map's i and j grid domains. The initial
value is (0,1; 0,1). See glMapGrid.
Page 13
glGet(3G) OpenGL Reference glGet(3G)
GLMAP2GRIDSEGMENTS params returns two values: the number of
partitions in the 2D map's i and j grid domains.
The initial value is (1,1). See glMapGrid.
GLMAP2INDEX params returns a single boolean value indicating
whether 2D evaluation generates color indices.
The initial value is GLFALSE. See glMap2.
GLMAP2NORMAL params returns a single boolean value indicating
whether 2D evaluation generates normals. The
initial value is GLFALSE. See glMap2.
GLMAP2TEXTURECOORD1 params returns a single boolean value indicating
whether 2D evaluation generates 1D texture
coordinates. The initial value is GLFALSE. See
glMap2.
GLMAP2TEXTURECOORD2 params returns a single boolean value indicating
whether 2D evaluation generates 2D texture
coordinates. The initial value is GLFALSE. See
glMap2.
GLMAP2TEXTURECOORD3 params returns a single boolean value indicating
whether 2D evaluation generates 3D texture
coordinates. The initial value is GLFALSE. See
glMap2.
GLMAP2TEXTURECOORD4 params returns a single boolean value indicating
whether 2D evaluation generates 4D texture
coordinates. The initial value is GLFALSE. See
glMap2.
GLMAP2VERTEX3 params returns a single boolean value indicating
whether 2D evaluation generates 3D vertex
coordinates. The initial value is GLFALSE. See
glMap2.
GLMAP2VERTEX4 params returns a single boolean value indicating
whether 2D evaluation generates 4D vertex
coordinates. The initial value is GLFALSE. See
glMap2.
GLMAPCOLOR params returns a single boolean value indicating
if colors and color indices are to be replaced
by table lookup during pixel transfers. The
initial value is GLFALSE. See glPixelTransfer.
GLMAPSTENCIL params returns a single boolean value indicating
if stencil indices are to be replaced by table
lookup during pixel transfers. The initial value
is GLFALSE. See glPixelTransfer.
Page 14
glGet(3G) OpenGL Reference glGet(3G)
GLMATRIXMODE params returns one value, a symbolic constant
indicating which matrix stack is currently the
target of all matrix operations. The initial
value is GLMODELVIEW. See glMatrixMode.
GLMAX3DTEXTURESIZEEXT
params returns one value, the maximum width,
height, or depth of any 3D texture image
(without borders). See glTexImage3DEXT.
GLMAXCLIENTATTRIBSTACKDEPTH
params returns one value indicating the maximum
supported depth of the client attribute stack.
See glPushClientAttrib.
GLMAXATTRIBSTACKDEPTH
params returns one value, the maximum supported
depth of the attribute stack. The value must be
at least 16. See glPushAttrib.
GLMAXCLIPPLANES params returns one value, the maximum number of
application-defined clipping planes. The value
must be at least 6. See glClipPlane.
GLMAXCLIPMAPDEPTHSGIX
params returns one value, the maximum number of
levels permitted in a clipmap. See
glTexParameter.
GLMAXCLIPMAPVIRTUALDEPTHSGIX
params returns one value, the maximum number of
levels permitted in a virtual clipmap. See
glTexParameter.
GLMAXCOLORMATRIXSTACKDEPTHSGI
params returns one value, the maximum supported
depth of the color matrix stack. See
glPushMatrix, glPixelTransfer.
GLMAXEVALORDER params returns one value, the maximum equation
order supported by 1D and 2D evaluators. The
value must be at least 8. See glMap1 and
glMap2.
GLMAXFOGFUNCPOINTSSGIS
params returns one value, the maximum number of
control points supported in custom fog blending
functions. See glFog and glFogFuncSGIS.
GLMAXLIGHTS params returns one value, the maximum number of
lights. The value must be at least 8. See
glLight.
Page 15
glGet(3G) OpenGL Reference glGet(3G)
GLMAXLISTNESTING params returns one value, the maximum recursion
depth allowed during display-list traversal. The
value must be at least 64. See glCallList.
GLMAXMODELVIEWSTACKDEPTH
params returns one value, the maximum supported
depth of the modelview matrix stack. The value
must be at least 32. See glPushMatrix.
GLMAXNAMESTACKDEPTH params returns one value, the maximum supported
depth of the selection name stack. The value
must be at least 64. See glPushName.
GLMAXPIXELMAPTABLE params returns one value, the maximum supported
size of a glPixelMap lookup table. The value
must be at least 32. See glPixelMap.
GLMAXPROJECTIONSTACKDEPTH
params returns one value, the maximum supported
depth of the projection matrix stack. The value
must be at least 2. See glPushMatrix.
GLMAXTEXTURESIZE params returns one value. The value gives a
rough estimate of the largest texture that the
GL can handle. If the GL version is 1.1 or
greater, use GLPROXYTEXTURE1D or
GLPROXYTEXTURE2D to determine if a texture is
too large. See glTexImage1D and glTexImage2D.
GLMAXTEXTURESTACKDEPTH
params returns one value, the maximum supported
depth of the texture matrix stack. The value
must be at least 2. See glPushMatrix.
GLMAXVIEWPORTDIMS params returns two values: the maximum
supported width and height of the viewport.
These must be at least as large as the visible
dimensions of the display being rendered to.
See glViewport.
GLMINMAXEXT params returns a single boolean value indicating
whether the pixel transfer min/max computation
is enabled. See glMinmaxEXT.
GLMODELVIEWMATRIX params returns sixteen values: the modelview
matrix on the top of the modelview matrix stack.
Initially this matrix is the identity matrix.
See glPushMatrix.
GLMODELVIEWSTACKDEPTH params returns one value, the number of matrices
on the modelview matrix stack. The initial
value is 1. See glPushMatrix.
Page 16
glGet(3G) OpenGL Reference glGet(3G)
GLNAMESTACKDEPTH params returns one value, the number of names on
the selection name stack. The initial value is
0. See glPushName.
GLMULTISAMPLESGIS params returns a single boolean value indicating
whether multisampling is enabled. See
glSamplePatternSGIS.
GLNORMALARRAY params returns a single boolean value,
indicating whether the normal array is enabled.
The initial value is GLFALSE. See
glNormalPointer.
GLNORMALARRAYSTRIDE params returns one value, the byte offset
between consecutive normals in the normal array.
The initial value is 0. See glNormalPointer.
GLNORMALARRAYTYPE params returns one value, the data type of each
coordinate in the normal array. The initial
value is GLFLOAT. See glNormalPointer.
GLNORMALIZE params returns a single boolean value indicating
whether normals are automatically scaled to unit
length after they have been transformed to eye
coordinates. The initial value is GLFALSE. See
glNormal.
GLPACKALIGNMENT params returns one value, the byte alignment
used for writing pixel data to memory. The
initial value is 4. See glPixelStore.
GLPACKIMAGEHEIGHTEXT params returns one value, the image height used
for writing (3D) pixel data to memory. See
glPixelStore.
GLPACKLSBFIRST params returns a single boolean value indicating
whether single-bit pixels being written to
memory are written first to the least
significant bit of each unsigned byte. The
initial value is GLFALSE. See glPixelStore.
GLPACKROWLENGTH params returns one value, the row length used
for writing pixel data to memory. The initial
value is 0. See glPixelStore.
GLPACKSKIPIMAGESEXT params returns one value, the number of 2D
images skipped before the first pixel is written
into memory. See glPixelStore.
GLPACKSKIPPIXELS params returns one value, the number of pixel
locations skipped before the first pixel is
written into memory. The initial value is 0. See
Page 17
glGet(3G) OpenGL Reference glGet(3G)
glPixelStore.
GLPACKSKIPROWS params returns one value, the number of rows of
pixel locations skipped before the first pixel
is written into memory. The initial value is 0.
See glPixelStore.
GLPACKSWAPBYTES params returns a single boolean value indicating
whether the bytes of two-byte and four-byte
pixel indices and components are swapped before
being written to memory. The initial value is
GLFALSE. See glPixelStore.
GLPERSPECTIVECORRECTIONHINT
params returns one value, a symbolic constant
indicating the mode of the perspective
correction hint. The initial value is
GLDONTCARE. See glHint.
GLPIXELMAPATOASIZE params returns one value, the size of the
alpha-to-alpha pixel translation table. The
initial value is 1. See glPixelMap.
GLPIXELMAPBTOBSIZE params returns one value, the size of the blue-
to-blue pixel translation table. The initial
value is 1. See glPixelMap.
GLPIXELMAPGTOGSIZE params returns one value, the size of the
green-to-green pixel translation table. The
initial value is 1. See glPixelMap.
GLPIXELMAPITOASIZE params returns one value, the size of the
index-to-alpha pixel translation table. The
initial value is 1. See glPixelMap.
GLPIXELMAPITOBSIZE params returns one value, the size of the
index-to-blue pixel translation table. The
initial value is 1. See glPixelMap.
GLPIXELMAPITOGSIZE params returns one value, the size of the
index-to-green pixel translation table. The
initial value is 1. See glPixelMap.
GLPIXELMAPITOISIZE params returns one value, the size of the
index-to-index pixel translation table. The
initial value is 1. See glPixelMap.
GLPIXELMAPITORSIZE params returns one value, the size of the
index-to-red pixel translation table. The
initial value is 1. See glPixelMap.
Page 18
glGet(3G) OpenGL Reference glGet(3G)
GLPIXELMAPRTORSIZE params returns one value, the size of the red-
to-red pixel translation table. The initial
value is 1. See glPixelMap.
GLPIXELMAPSTOSSIZE params returns one value, the size of the
stencil-to-stencil pixel translation table. The
initial value is 1. See glPixelMap.
GLPOINTFADETHRESHOLDSIZESGIS
params returns one value, the size at which a
dynamically-sized point will begin to fade (in
order to further reduce its brightness). See
glPointParameterSGIS.
GLPOINTSIZE params returns one value, the point size as
specified by glPointSize. The initial value is
1.
GLPOINTSIZEMAXSGIS params returns one value, the maximum allowable
size for dynamically-sized points. See
glPointParameterSGIS.
GLPOINTSIZEMINSGIS params returns one value, the minimum allowable
size for dynamically-sized points. See
glPointParameterSGIS.
GLPOINTSIZEGRANULARITY
params returns one value, the size difference
between adjacent supported sizes for antialiased
points. See glPointSize.
GLPOINTSIZERANGE params returns two values: the smallest and
largest supported sizes for antialiased points.
The smallest size must be at most 1, and the
largest size must be at least 1. See
glPointSize.
GLPOINTSMOOTH params returns a single boolean value indicating
whether antialiasing of points is enabled. The
initial value is GLFALSE. See glPointSize.
GLPOINTSMOOTHHINT params returns one value, a symbolic constant
indicating the mode of the point antialiasing
hint. The initial value is GLDONTCARE. See
glHint.
GLPOLYGONMODE params returns two values: symbolic constants
indicating whether front-facing and back-facing
polygons are rasterized as points, lines, or
filled polygons. The initial value is GLFILL.
See glPolygonMode.
Page 19
glGet(3G) OpenGL Reference glGet(3G)
GLPOLYGONOFFSETBIASEXT
params returns one value, the constant which is
added to the z value of each fragment generated
when a polygon is rasterized. See
glPolygonOffsetEXT.
GLPOLYGONOFFSETEXT params returns a single boolean value indicating
whether polygon offset is enabled. See
glPolygonOffsetEXT.
GLPOLYGONOFFSETFACTOR params returns one value, the scaling factor
used to determine the variable offset that is
added to the depth value of each fragment
generated when a polygon is rasterized. The
initial value is 0. See glPolygonOffset.
GLPOLYGONOFFSETUNITS params returns one value. This value is
multiplied by an implementation-specific value
and then added to the depth value of each
fragment generated when a polygon is rasterized.
The initial value is 0. See glPolygonOffset.
GLPOLYGONOFFSETFILL params returns a single boolean value indicating
whether polygon offset is enabled for polygons
in fill mode. The initial value is GLFALSE.
See glPolygonOffset.
GLPOLYGONOFFSETLINE params returns a single boolean value indicating
whether polygon offset is enabled for polygons
in line mode. The initial value is GLFALSE.
See glPolygonOffset.
GLPOLYGONOFFSETPOINT params returns a single boolean value indicating
whether polygon offset is enabled for polygons
in point mode. The initial value is GLFALSE.
See glPolygonOffset.
GLPOLYGONOFFSETUNITS params returns one value. This value is
multiplied by an implementation-specific value
and then added to the depth value of each
fragment generated when a polygon is rasterized.
The initial value is 0. See glPolygonOffset.
GLPOLYGONSMOOTH params returns a single boolean value indicating
whether antialiasing of polygons is enabled. The
initial value is GLFALSE. See glPolygonMode.
GLPOLYGONSMOOTHHINT params returns one value, a symbolic constant
indicating the mode of the polygon antialiasing
hint. The initial value is GLDONTCARE. See
glHint.
Page 20
glGet(3G) OpenGL Reference glGet(3G)
GLPOLYGONSTIPPLE params returns a single boolean value indicating
whether polygon stippling is enabled. The
initial value is GLFALSE. See glPolygonStipple.
GLPOSTCOLORMATRIXALPHABIASSGI
params returns a single value, the bias term to
be added to alpha immediately after
multiplication by the top of the color matrix
stack. See glPixelTransfer.
GLPOSTCOLORMATRIXALPHASCALESGI
params returns a single value, the scale factor
to be applied to alpha immediately after
multiplication by the top of the color matrix
stack. See glPixelTransfer.
GLPOSTCOLORMATRIXBLUEBIASSGI
params returns a single value, the bias term to
be added to blue immediately after
multiplication by the top of the color matrix
stack. See glPixelTransfer.
GLPOSTCOLORMATRIXBLUESCALESGI
params returns a single value, the scale factor
to be applied to blue immediately after
multiplication by the top of the color matrix
stack. See glPixelTransfer.
GLPOSTCOLORMATRIXCOLORTABLESGI
params returns a single boolean value indicating
whether colors are passed through a lookup table
before being processed by the histogram
operation. See glColorTableSGI.
GLPOSTCOLORMATRIXGREENBIASSGI
params returns a single value, the bias term to
be added to green immediately after
multiplication by the top of the color matrix
stack. See glPixelTransfer.
GLPOSTCOLORMATRIXGREENSCALESGI
params returns a single value, the scale factor
to be applied to green immediately after
multiplication by the top of the color matrix
stack. See glPixelTransfer.
GLPOSTCOLORMATRIXREDBIASSGI
params returns a single value, the bias term to
be added to red immediately after multiplication
by the top of the color matrix stack. See
glPixelTransfer.
Page 21
glGet(3G) OpenGL Reference glGet(3G)
GLPOSTCOLORMATRIXREDSCALESGI
params returns a single value, the scale factor
to be applied to red immediately after
multiplication by the top of the color matrix
stack. See glPixelTransfer.
GLPOSTCONVOLUTIONALPHABIASEXT
params returns a single value, the bias term to
be added to alpha immediately after convolution.
See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
glSeparableFilter2DEXT.
GLPOSTCONVOLUTIONALPHASCALEEXT
params returns a single value, the scale factor
to be applied to alpha immediately after
convolution. See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
glSeparableFilter2DEXT.
GLPOSTCONVOLUTIONBLUEBIASEXT
params returns a single value, the bias term to
be added to blue immediately after convolution.
See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
glSeparableFilter2DEXT.
GLPOSTCONVOLUTIONBLUESCALEEXT
params returns a single value, the scale factor
to be applied to blue immediately after
convolution. See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
glSeparableFilter2DEXT.
GLPOSTCONVOLUTIONCOLORTABLESGI
params returns a single boolean value indicating
whether colors are passed through a lookup table
before being processed by the color matrix
operation. See glColorTableSGI.
GLPOSTCONVOLUTIONGREENBIASEXT
params returns a single value, the bias term to
be added to green immediately after convolution.
See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
glSeparableFilter2DEXT.
GLPOSTCONVOLUTIONGREENSCALEEXT
params returns a single value, the scale factor
to be applied to green immediately after
convolution. See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
Page 22
glGet(3G) OpenGL Reference glGet(3G)
glSeparableFilter2DEXT.
GLPOSTCONVOLUTIONREDBIASEXT
params returns a single value, the bias term to
be added to red immediately after convolution.
See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
glSeparableFilter2DEXT.
GLPOSTCONVOLUTIONREDSCALEEXT
params returns a single value, the scale factor
to be applied to red immediately after
convolution. See glConvolutionFilter1DEXT,
glConvolutionFilter2DEXT, and
glSeparableFilter2DEXT.
GLPOSTTEXTUREFILTERBIASRANGESGIX
params returns two values: the minimum and
maximum values for the texture bias factors.
See glTexParameterfv and glTexParameteriv.
GLPOSTTEXTUREFILTERSCALERANGESGIX
params returns two values: the minimum and
maximum values for the texture scale factors.
GLPROJECTIONMATRIX params returns sixteen values: the projection
matrix on the top of the projection matrix
stack. Initially this matrix is the identity
matrix. See glPushMatrix.
GLPROJECTIONSTACKDEPTH
params returns one value, the number of matrices
on the projection matrix stack. The initial
value is 1. See glPushMatrix.
GLREADBUFFER params returns one value, a symbolic constant
indicating which color buffer is selected for
reading. The initial value is GLBACK if there
is a back buffer, otherwise it is GLFRONT. See
glReadPixels and glAccum.
GLREDBIAS params returns one value, the red bias factor
used during pixel transfers. The initial value
is 0.
GLREDBITS params returns one value, the number of red
bitplanes in each color buffer.
GLREDSCALE params returns one value, the red scale factor
used during pixel transfers. The initial value
is 1. See glPixelTransfer.
Page 23
glGet(3G) OpenGL Reference glGet(3G)
GLREFERENCEPLANEEQUATIONSGIX
params returns four values, the coefficients of
the plane equation for the reference plane,
expressed in clip coordinates. See
glReferencePlaneSGIX.
GLREFERENCEPLANESGIX params returns a single boolean value indicating
whether depth values for pixel fragments are
computed from the reference plane (true) or from
the primitive being drawn (false). See
glReferencePlaneSGIX.
GLRENDERMODE params returns one value, a symbolic constant
indicating whether the GL is in render, select,
or feedback mode. The initial value is
GLRENDER. See glRenderMode.
GLRGBAMODE params returns a single boolean value indicating
whether the GL is in RGBA mode (true) or color
index mode (false). See glColor.
GLSAMPLEALPHATOMASKSGIS
params returns a single boolean value indicating
whether fragment alpha values will modify the
multisampling fragment mask. See
glSampleMaskSGIS.
GLSAMPLEALPHATOONESGIS
params returns a single boolean value indicating
whether fragment alpha will be set to the
maximum possible value after modifying the
multisampling fragment mask. See
glSampleMaskSGIS.
GLSAMPLEBUFFERSSGIS params returns one value, the number of
multisample buffers.
GLSAMPLEMASKINVERTSGIS
params returns a single boolean value indicating
whether the multisampling fragment modification
mask is to be inverted. See glSampleMaskSGIS.
GLSAMPLEMASKSGIS params returns a single boolean value indicating
whether the multisampling fragment mask will be
modified by a coverage mask. See
glSampleMaskSGIS.
GLSAMPLEMASKVALUESGIS
params returns one value, the coverage of the
multisampling fragment modification mask. See
glSampleMaskSGIS.
Page 24
glGet(3G) OpenGL Reference glGet(3G)
GLSAMPLEPATTERNSGIS params returns one value, a symbolic constant
indicating the multisampling pattern. See
glSamplePatternSGIS.
GLSAMPLESSGIS params returns one value, the number of samples
per pixel used for multisampling.
GLSCISSORBOX params returns four values: the x and y window
coordinates of the scissor box, followed by its
width and height. Initially the x and y window
coordinates are both 0 and the width and height
are set to the size of the window. See
glScissor.
GLSCISSORTEST params returns a single boolean value indicating
whether scissoring is enabled. The initial value
is GLFALSE. See glScissor.
GLSEPARABLE2DEXT params returns a single boolean value indicating
whether separable two-dimensional convolution
will be performed during pixel transfers. See
glSeparableFilter2DEXT.
GLSHADEMODEL params returns one value, a symbolic constant
indicating whether the shading mode is flat or
smooth. The initial value is GLSMOOTH. See
glShadeModel.
GLSPRITEAXISSGIX params returns three values that specify the
current sprite rotation axis. See
glSpriteParameterSGIX.
GLSPRITEMODESGIX params returns one value, a symbolic constant
indicating the current sprite mode. See
glSpriteParameterSGIX.
GLSPRITESGIX params returns a single boolean value indicating
whether the sprite transformation is enabled.
See glSpriteParameterSGIX.
GLSPRITETRANSLATIONSGIX
params returns three values that specify the
current sprite translation. See
glSpriteParameterSGIX.
GLSTENCILBITS params returns one value, the number of
bitplanes in the stencil buffer.
GLSTENCILCLEARVALUE params returns one value, the index to which the
stencil bitplanes are cleared. The initial value
is 0. See glClearStencil.
Page 25
glGet(3G) OpenGL Reference glGet(3G)
GLSTENCILFAIL params returns one value, a symbolic constant
indicating what action is taken when the stencil
test fails. The initial value is GLKEEP. See
glStencilOp.
GLSTENCILFUNC params returns one value, a symbolic constant
indicating what function is used to compare the
stencil reference value with the stencil buffer
value. The initial value is GLALWAYS. See
glStencilFunc.
GLSTENCILPASSDEPTHFAIL
params returns one value, a symbolic constant
indicating what action is taken when the stencil
test passes, but the depth test fails. The
initial value is GLKEEP. See glStencilOp.
GLSTENCILPASSDEPTHPASS
params returns one value, a symbolic constant
indicating what action is taken when the stencil
test passes and the depth test passes. The
initial value is GLKEEP. See glStencilOp.
GLSTENCILREF params returns one value, the reference value
that is compared with the contents of the
stencil buffer. The initial value is 0. See
glStencilFunc.
GLSTENCILTEST params returns a single boolean value indicating
whether stencil testing of fragments is enabled.
The initial value is GLFALSE. See
glStencilFunc and glStencilOp.
GLSTENCILVALUEMASK params returns one value, the mask that is used
to mask both the stencil reference value and the
stencil buffer value before they are compared.
The initial value is all 1's. See
glStencilFunc.
GLSTENCILWRITEMASK params returns one value, the mask that controls
writing of the stencil bitplanes. The initial
value is all 1's. See glStencilMask.
GLSTEREO params returns a single boolean value indicating
whether stereo buffers (left and right) are
supported.
GLSUBPIXELBITS params returns one value, an estimate of the
number of bits of subpixel resolution that are
used to position rasterized geometry in window
coordinates. The initial value is 4.
Page 26
glGet(3G) OpenGL Reference glGet(3G)
GLTEXTURE1D params returns a single boolean value indicating
whether 1D texture mapping is enabled. The
initial value is GLFALSE. See glTexImage1D.
GLTEXTURE1DBINDING params returns a single value, the name of the
texture currently bound to the target
GLTEXTURE1D. The initial value is 0. See
glBindTexture.
GLTEXTURE2D params returns a single boolean value indicating
whether 2D texture mapping is enabled. The
initial value is GLFALSE. See glTexImage2D.
GLTEXTURE2DBINDING params returns a single value, the name of the
texture currently bound to the target
GLTEXTURE2D. The initial value is 0. See
glBindTexture.
GLTEXTURE2DBINDINGEXT
params returns a single value, the name of the
texture currently bound to the target
GLTEXTURE2D. See glBindTextureEXT.
GLTEXTURE3DEXT params returns a single boolean value indicating
whether 3D texture mapping is enabled. See
glTexImage3DEXT.
GLTEXTURE3DBINDINGEXT
params returns a single value, the name of the
texture currently bound to the target
GLTEXTURE3DEXT. See glBindTextureEXT.
GLTEXTURECOLORTABLESGI
params returns a single boolean value indicating
whether texture colors are passed through a
lookup table before being used to generate pixel
fragments. See glColorTableSGI.
GLTEXTURECOORDARRAY params returns a single boolean value indicating
whether the texture coordinate array is enabled.
The initial value is GLFALSE. See
glTexCoordPointer.
GLTEXTURECOORDARRAYSIZE
params returns one value, the number of
coordinates per element in the texture
coordinate array. The initial value is 4. See
glTexCoordPointer.
GLTEXTURECOORDARRAYSTRIDE
params returns one value, the byte offset
between consecutive elements in the texture
Page 27
glGet(3G) OpenGL Reference glGet(3G)
coordinate array. The initial value is 0. See
glTexCoordPointer.
GLTEXTURECOORDARRAYTYPE
params returns one value, the data type of the
coordinates in the texture coordinate array. The
initial value is GLFLOAT. See
glTexCoordPointer.
GLTEXTUREGENQ params returns a single boolean value indicating
whether automatic generation of the q texture
coordinate is enabled. The initial value is
GLFALSE. See glTexGen.
GLTEXTUREGENR params returns a single boolean value indicating
whether automatic generation of the r texture
coordinate is enabled. The initial value is
GLFALSE. See glTexGen.
GLTEXTUREGENS params returns a single boolean value indicating
whether automatic generation of the S texture
coordinate is enabled. The initial value is
GLFALSE. See glTexGen.
GLTEXTUREGENT params returns a single boolean value indicating
whether automatic generation of the T texture
coordinate is enabled. The initial value is
GLFALSE. See glTexGen.
GLTEXTUREMATRIX params returns sixteen values: the texture
matrix on the top of the texture matrix stack.
Initially this matrix is the identity matrix.
See glPushMatrix.
GLTEXTURESTACKDEPTH params returns one value, the number of matrices
on the texture matrix stack. The initial value
is 1. See glPushMatrix.
GLUNPACKALIGNMENT params returns one value, the byte alignment
used for reading pixel data from memory. The
initial value is 4. See glPixelStore.
GLUNPACKIMAGEHEIGHTEXT
params returns one value, the image height used
for reading (3D) pixel data from memory. See
glPixelStore.
GLUNPACKLSBFIRST params returns a single boolean value indicating
whether single-bit pixels being read from memory
are read first from the least significant bit of
each unsigned byte. The initial value is
GLFALSE. See glPixelStore.
Page 28
glGet(3G) OpenGL Reference glGet(3G)
GLUNPACKROWLENGTH params returns one value, the row length used
for reading pixel data from memory. The initial
value is 0. See glPixelStore.
GLUNPACKSKIPIMAGES params returns one value, the number of images
skipped before the first (3D) pixel is read from
memory. See glPixelStore.
GLUNPACKSKIPPIXELS params returns one value, the number of pixel
locations skipped before the first pixel is read
from memory. The initial value is 0. See
glPixelStore.
GLUNPACKSKIPROWS params returns one value, the number of rows of
pixel locations skipped before the first pixel
is read from memory. The initial value is 0. See
glPixelStore.
GLUNPACKSWAPBYTES params returns a single boolean value indicating
whether the bytes of two-byte and four-byte
pixel indices and components are swapped after
being read from memory. The initial value is
GLFALSE. See glPixelStore.
GLVERTEXARRAY params returns a single boolean value indicating
whether the vertex array is enabled. The initial
value is GLFALSE. See glVertexPointer.
GLVERTEXARRAYSIZE params returns one value, the number of
coordinates per vertex in the vertex array. The
initial value is 4. See glVertexPointer.
GLVERTEXARRAYSTRIDE params returns one value, the byte offset
between consecutive vertexes in the vertex
array. The initial value is 0. See
glVertexPointer.
GLVERTEXARRAYTYPE params returns one value, the data type of each
coordinate in the vertex array. The initial
value is GLFLOAT. See glVertexPointer.
GLVIEWPORT params returns four values: the x and y window
coordinates of the viewport, followed by its
width and height. Initially the x and y window
coordinates are both set to 0, and the width and
height are set to the width and height of the
window into which the GL will do its rendering.
See glViewport.
GLZOOMX params returns one value, the x pixel zoom
factor. The initial value is 1. See glPixelZoom.
Page 29
glGet(3G) OpenGL Reference glGet(3G)
GLZOOMY params returns one value, the y pixel zoom
factor. The initial value is 1. See
glPixelZoom.
Many of the boolean parameters can also be queried more easily using
glIsEnabled.
NOTES
GLCOLORARRAY, GLCOLORARRAYSIZE, GLCOLORARRAYSTRIDE,
GLCOLORARRAYTYPE, GLCOLORLOGICOP, GLEDGEFLAGARRAY,
GLEDGEFLAGARRAYSTRIDE, GLINDEXARRAY, GLINDEXARRAYSTRIDE,
GLINDEXARRAYTYPE, GLINDEXLOGICOP, GLNORMALARRAY,
GLNORMALARRAYSTRIDE, GLNORMALARRAYTYPE, GLPOLYGONOFFSETFACTOR,
GLPOLYGONOFFSETFILL, GLPOLYGONOFFSETLINE, GLPOLYGONOFFSETPOINT,
GLPOLYGONOFFSETUNITS, GLTEXTURECOORDARRAY,
GLTEXTURECOORDARRAYSIZE, GLTEXTURECOORDARRAYSTRIDE,
GLTEXTURECOORDARRAYTYPE, GLVERTEXARRAY, GLVERTEXARRAYSIZE,
GLVERTEXARRAYSTRIDE, and GLVERTEXARRAYTYPE are available only if
the GL version is 1.1 or greater.
ERRORS
GLINVALIDENUM is generated if pname is not an accepted value.
GLINVALIDOPERATION is generated if glGet is executed between the
execution of glBegin and the corresponding execution of glEnd.
MACHINE DEPENDENCIES
GLCOLORTABLESGI, GLPOSTCOLORMATRIXCOLORTABLESGI and
GLPOSTCONVOLUTIONCOLORTABLESGI are part of the SGIcolortable
extension which is not supported on RealityEngine, RealityEngine2, and
VTX systems.
RealityEngine, RealityEngine2, and VTX systems do not support
GLDETAILTEXTURE2DBINDINGSGIS.
The SGIXinterlace extension is supported only on InfiniteReality
systems, on RealityEngine, RealityEngine2, and VTX systems, and on O2
systems.
On InfiniteReality systems, if the post-texture filter scale and bias
values are set to values other than the defaults, they are limited to the
range [0.0, 1.0). (note: this range excludes 1.0.) The
SGIXtexturescalebias extension is not supported on RealityEngine,
RealityEngine2, and VTX systems or on High Impact and Maximum Impact
systems.
SEE ALSO
glGetClipPlane, glGetError, glGetLight, glGetMap, glGetMaterial,
glGetPixelMap, glGetPointerv, glGetPolygonStipple, glGetString,
glGetTexEnv, glGetTexGen, glGetTexImage, glGetTexLevelParameter,
Page 30
glGet(3G) OpenGL Reference glGet(3G)
glGetTexParameter, glIsEnabled
Page 31