GLGET(3gl)GLGET(3gl)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 GL_FALSE if and only
if it is 0.0 (or 0). Otherwise, it is converted to GL_TRUE. If glGet‐
Integerv is called, boolean values are returned as GL_TRUE or GL_FALSE,
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
GL_TRUE or GL_FALSE, and integer values are converted to floating-point
values.
The following symbolic constants are accepted by pname:
GL_ACCUM_ALPHA_BITS params returns one value, the number of alpha
bitplanes in the accumulation buffer.
GL_ACCUM_BLUE_BITS params returns one value, the number of blue
bitplanes in the accumulation buffer.
GL_ACCUM_CLEAR_VALUE params returns four values: the red, green,
blue, and alpha values used to clear the accu‐
mulation buffer. Integer values, if
requested, are linearly mapped from the inter‐
nal floating-point representation such that
1.0 returns the most positive representable
integer value, and -1.0 returns the most nega‐
tive representable integer value. The initial
value is (0, 0, 0, 0). See glClearAccum.
GL_ACCUM_GREEN_BITS params returns one value, the number of green
bitplanes in the accumulation buffer.
GL_ACCUM_RED_BITS params returns one value, the number of red
bitplanes in the accumulation buffer.
GL_ACTIVE_TEXTURE_ARB params returns a single value indicating the
active multitexture unit. The initial value
is GL_TEXTURE0_ARB. See
glActiveTextureARB.
GL_ALPHA_BIAS params returns one value, the alpha bias fac‐
tor used during pixel transfers. The initial
value is 0. See
glPixelTransfer.
GL_ALPHA_BITS params returns one value, the number of alpha
bitplanes in each color buffer.
GL_ALPHA_SCALE params returns one value, the alpha scale fac‐
tor used during pixel transfers. The initial
value is 1. See
glPixelTransfer.
GL_ALPHA_TEST params returns a single boolean value indicat‐
ing whether alpha testing of fragments is
enabled. The initial value is GL_FALSE. See
glAlphaFunc.
GL_ALPHA_TEST_FUNC params returns one value, the symbolic name of
the alpha test function. The initial value is
GL_ALWAYS. See
glAlphaFunc.
GL_ALPHA_TEST_REF 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 inter‐
nal floating-point representation such that
1.0 returns the most positive representable
integer value, and -1.0 returns the most nega‐
tive representable integer value.
GL_ATTRIB_STACK_DEPTH 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.
GL_AUTO_NORMAL params returns a single boolean value indicat‐
ing whether 2D map evaluation automatically
generates surface normals. The initial value
is GL_FALSE. See glMap2.
GL_AUX_BUFFERS params returns one value, the number of auxil‐
iary color buffers. The initial value is 0.
GL_BLEND params returns a single boolean value indicat‐
ing whether blending is enabled. The initial
value is GL_FALSE. See
glBlendFunc.
GL_BLEND_DST params returns one value, the symbolic con‐
stant identifying the destination blend func‐
tion. The initial value is GL_ZERO. See
glBlendFunc.
GL_BLEND_SRC params returns one value, the symbolic con‐
stant identifying the source blend function.
The initial value is GL_ONE. See glBlendFunc.
GL_BLUE_BIAS params returns one value, the blue bias factor
used during pixel transfers. The initial value
is 0. See
glPixelTransfer.
GL_BLUE_BITS params returns one value, the number of blue
bitplanes in each color buffer.
GL_BLUE_SCALE params returns one value, the blue scale fac‐
tor used during pixel transfers. The initial
value is 1. See
glPixelTransfer.
GL_CLIENT_ACTIVE_TEXTURE_ARB
params returns a single integer value indicat‐
ing the current client active multitexture
unit. The initial value is GL_TEXTURE0_ARB.
See
glClientActiveTextureARB.
GL_CLIENT_ATTRIB_STACK_DEPTH
params returns one value indicating the depth
of the attribute stack. The initial value is
0. See
glPushClientAttrib.
GL_CLIP_PLANEi params returns a single boolean value indicat‐
ing whether the specified clipping plane is
enabled. The initial value is GL_FALSE. See
glClipPlane.
GL_COLOR_ARRAY params returns a single boolean value indicat‐
ing whether the color array is enabled. The
initial value is GL_FALSE. See glColor‐
Pointer.
GL_COLOR_ARRAY_SIZE params returns one value, the number of compo‐
nents per color in the color array. The ini‐
tial value is 4. See
glColorPointer.
GL_COLOR_ARRAY_STRIDE params returns one value, the byte offset
between consecutive colors in the color array.
The initial value is 0. See glColorPointer.
GL_COLOR_ARRAY_TYPE params returns one value, the data type of
each component in the color array. The initial
value is GL_FLOAT. See glColorPointer.
GL_COLOR_CLEAR_VALUE 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.
GL_COLOR_LOGIC_OP params returns a single boolean value indicat‐
ing whether a fragment's RGBA color values are
merged into the framebuffer using a logical
operation. The initial value is GL_FALSE. See
glLogicOp.
GL_COLOR_MATERIAL params returns a single boolean value indicat‐
ing whether one or more material parameters
are tracking the current color. The initial
value is GL_FALSE. See glColorMaterial.
GL_COLOR_MATERIAL_FACE params returns one value, a symbolic constant
indicating which materials have a parameter
that is tracking the current color. The ini‐
tial value is GL_FRONT_AND_BACK. See glColor‐
Material.
GL_COLOR_MATERIAL_PARAMETER
params returns one value, a symbolic constant
indicating which material parameters are
tracking the current color. The initial value
is GL_AMBIENT_AND_DIFFUSE. See
glColorMaterial.
GL_COLOR_WRITEMASK params returns four boolean values: the red,
green, blue, and alpha write enables for the
color buffers. The initial value is (GL_TRUE,
GL_TRUE, GL_TRUE, GL_TRUE). See glColorMask.
GL_CONVOLUTION_1D_EXT params returns a single boolean value indicat‐
ing whether 1D convolution is enabled. The
initial value is GL_FALSE. See glConvolution‐
Filter1DEXT.
GL_CONVOLUTION_2D_EXT params returns a single boolean value indicat‐
ing whether 2D convolution is enabled. The
initial value is GL_FALSE. See glConvolution‐
Filter2DEXT.
GL_CULL_FACE params returns a single boolean value indicat‐
ing whether polygon culling is enabled. The
initial value is GL_FALSE. See glCullFace.
GL_CULL_FACE_MODE params returns one value, a symbolic constant
indicating which polygon faces are to be
culled. The initial value is GL_BACK. See
glCullFace.
GL_CURRENT_COLOR 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 repre‐
sentation such that 1.0 returns the most posi‐
tive representable integer value, and -1.0
returns the most negative representable inte‐
ger value. See glColor. The initial value is
(1, 1, 1, 1).
GL_CURRENT_INDEX params returns one value, the current color
index. The initial value is 1. See glIndex.
GL_CURRENT_NORMAL 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 repre‐
sentable integer value, and -1.0 returns the
most negative representable integer value.
The initial value is (0, 0, 1). See glNormal.
GL_CURRENT_RASTER_COLOR 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.
GL_CURRENT_RASTER_DISTANCE
params returns one value, the distance from
the eye to the current raster position. The
initial value is 0. See glRasterPos.
GL_CURRENT_RASTER_INDEX params returns one value, the color index of
the current raster position. The initial value
is 1. See glRasterPos.
GL_CURRENT_RASTER_POSITION
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.
GL_CURRENT_RASTER_POSITION_VALID
params returns a single boolean value indicat‐
ing whether the current raster position is
valid. The initial value is GL_TRUE. See
glRasterPos.
GL_CURRENT_RASTER_TEXTURE_COORDS
params returns four values: the s, t, r, and q
current raster texture coordinates. The ini‐
tial value is (0, 0, 0, 1). See glRasterPos
and glTexCoord.
GL_CURRENT_SECONDARY_COLOR
params returns four values: the red, green,
blue, and alpha values of the current sec‐
ondary color. See glColor. The initial value
is (0, 0, 0, 1).
GL_CURRENT_TEXTURE_COORDS
params returns four values: the s, t, r, and q
current texture coordinates. The initial value
is (0, 0, 0, 1). See glTexCoord.
GL_DEPTH_BIAS params returns one value, the depth bias fac‐
tor used during pixel transfers. The initial
value is 0. See
glPixelTransfer.
GL_DEPTH_BITS params returns one value, the number of bit‐
planes in the depth buffer.
GL_DEPTH_CLEAR_VALUE params returns one value, the value that is
used to clear the depth buffer. Integer val‐
ues, if requested, are linearly mapped from
the internal floating-point representation
such that 1.0 returns the most positive repre‐
sentable integer value, and -1.0 returns the
most negative representable integer value. The
initial value is 1. See glClearDepth.
GL_DEPTH_FUNC params returns one value, the symbolic con‐
stant that indicates the depth comparison
function. The initial value is GL_LESS. See
glDepthFunc.
GL_DEPTH_RANGE 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 repre‐
sentable integer value, and -1.0 returns the
most negative representable integer value. The
initial value is
(0, 1). See glDepthRange.
GL_DEPTH_SCALE params returns one value, the depth scale fac‐
tor used during pixel transfers. The initial
value is 1. See
glPixelTransfer.
GL_DEPTH_TEST params returns a single boolean value indicat‐
ing whether depth testing of fragments is
enabled. The initial value is GL_FALSE. See
glDepthFunc and glDepthRange.
GL_DEPTH_WRITEMASK params returns a single boolean value indicat‐
ing if the depth buffer is enabled for writ‐
ing. The initial value is GL_TRUE. See
glDepthMask.
GL_DETAIL_2D_BINDING_SGIS
params returns the bound detail texture.
GL_DITHER params returns a single boolean value indicat‐
ing whether dithering of fragment colors and
indices is enabled. The initial value is
GL_TRUE.
GL_DOUBLEBUFFER params returns a single boolean value indicat‐
ing whether double buffering is supported.
GL_DRAW_BUFFER params returns one value, a symbolic constant
indicating which buffers are being drawn to.
See glDrawBuffer. The initial value is GL_BACK
if there are back buffers, otherwise it is
GL_FRONT.
GL_EDGE_FLAG params returns a single boolean value indicat‐
ing whether the current edge flag is GL_TRUE
or GL_FALSE. The initial value is GL_TRUE.
See glEdgeFlag.
GL_EDGE_FLAG_ARRAY params returns a single boolean value indicat‐
ing whether the edge flag array is enabled.
The initial value is GL_FALSE. See glEdge‐
FlagPointer.
GL_EDGE_FLAG_ARRAY_STRIDE
params returns one value, the byte offset
between consecutive edge flags in the edge
flag array. The initial value is 0. See
glEdgeFlagPointer.
GL_FOG params returns a single boolean value indicat‐
ing whether fogging is enabled. The initial
value is GL_FALSE. See glFog.
GL_FOG_COLOR 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 repre‐
sentation such that 1.0 returns the most posi‐
tive representable integer value, and -1.0
returns the most negative representable inte‐
ger value. The initial value is (0, 0, 0, 0).
See glFog.
GL_FOG_DENSITY params returns one value, the fog density
parameter. The initial value is 1. See glFog.
GL_FOG_END params returns one value, the end factor for
the linear fog equation. The initial value is
1. See glFog.
GL_FOG_HINT params returns one value, a symbolic constant
indicating the mode of the fog hint. The ini‐
tial value is GL_DONT_CARE. See glHint.
GL_FOG_INDEX params returns one value, the fog color index.
The initial value is 0. See glFog.
GL_FOG_MODE params returns one value, a symbolic constant
indicating which fog equation is selected. The
initial value is GL_EXP. See glFog.
GL_FOG_START params returns one value, the start factor for
the linear fog equation. The initial value is
0. See glFog.
GL_GENERATE_MIPMAP_HINT params returns one value, a symbolic constant
indicating the desired mipmap filtering hint.
The initial value is GL_DONT_CARE. See glTex‐
Parameter.
GL_FRAMENT_PROGRAM_ARB params returns a single boolean value indicat‐
ing whether the fragment program is enabled
(GL_TRUE) or disabled (GL_FALSE).
GL_FRONT_FACE params returns one value, a symbolic constant
indicating whether clockwise or counterclock‐
wise polygon winding is treated as front-fac‐
ing. The initial value is GL_CCW. See
glFrontFace.
GL_GLOBAL_ALPHA_FACTOR_SUN
params returns one value, the global alpha
factor as specified with glGlobalAlphaFactor‐
SUN. The initial value is 1.0. See glGlobal‐
AlphaFactorSUN.
GL_GRADIENT_CLEAR_COLOR_BOTTOM_EXT
params returns 4 values, indicating the clear
color at the bottom of the clear region. The
initial value is 0,0,0,0. See glClearParame‐
terEXT.
GL_GRADIENT_CLEAR_COLOR_TOP_EXT
params returns 4 values, indicating the clear
color at the top of the clear region. The
initial value is 0,0,0,0. See glClearParame‐
terEXT.
GL_GRADIENT_CLEAR_HEIGHT_EXT
params returns 1 values, indicating the height
of the clear region. The initial value is
height of the window. See glClearParame‐
terEXT.
GL_GRADIENT_CLEAR_MODE_EXT
params returns one value, a symbolic constant
indicating the gradient clear color mode. The
initial value is GL_GRADIENT_CLEAR_SOLID_EXT.
See glClearColorModeEXT.
GL_GRADIENT_CLEAR_WIDTH_EXT
params returns 1 values, indicating the width
of the clear region. The initial value is
width of the window. See glClearParameterEXT.
GL_GRADIENT_CLEAR_X_EXT params returns 1 values, indicating the x
coordinate of the lower left of the clear
region. The initial value is lower left of
the window. See glClearParameterEXT.
GL_GRADIENT_CLEAR_Y_EXT params returns 1 values, indicating the y
coordinate of the lower left of the clear
region. The initial value is lower left of
the window. See glClearParameterEXT.
GL_GREEN_BIAS params returns one value, the green bias fac‐
tor used during pixel transfers. The initial
value is 0.
GL_GREEN_BITS params returns one value, the number of green
bitplanes in each color buffer.
GL_GREEN_SCALE params returns one value, the green scale fac‐
tor used during pixel transfers. The initial
value is 1. See
glPixelTransfer.
GL_HISTOGRAM_EXT params returns a single boolean value indicat‐
ing whether histogram is enabled. The initial
value is GL_FALSE. See glHistogramEXT.
GL_INDEX_ARRAY params returns a single boolean value indicat‐
ing whether the color index array is enabled.
The initial value is GL_FALSE. See glIndex‐
Pointer.
GL_INDEX_ARRAY_STRIDE params returns one value, the byte offset
between consecutive color indexes in the color
index array. The initial value is 0. See
glIndexPointer.
GL_INDEX_ARRAY_TYPE params returns one value, the data type of
indexes in the color index array. The initial
value is GL_FLOAT. See
glIndexPointer.
GL_INDEX_BITS params returns one value, the number of bit‐
planes in each color index buffer.
GL_INDEX_CLEAR_VALUE params returns one value, the color index used
to clear the color index buffers. The initial
value is 0. See
glClearIndex.
GL_INDEX_LOGIC_OP params returns a single boolean value indicat‐
ing whether a fragment's index values are
merged into the framebuffer using a logical
operation. The initial value is GL_FALSE. See
glLogicOp.
GL_INDEX_MODE params returns a single boolean value indicat‐
ing whether the GL is in color index mode
(GL_TRUE) or RGBA mode (GL_FALSE).
GL_INDEX_OFFSET params returns one value, the offset added to
color and stencil indices during pixel trans‐
fers. The initial value is 0. See glPixel‐
Transfer.
GL_INDEX_SHIFT params returns one value, the amount that
color and stencil indices are shifted during
pixel transfers. The initial value is 0. See
glPixelTransfer.
GL_INDEX_WRITEMASK 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.
GL_LIGHTi params returns a single boolean value indicat‐
ing whether the specified light is enabled.
The initial value is GL_FALSE. See glLight
and glLightModel.
GL_LIGHTING params returns a single boolean value indicat‐
ing whether lighting is enabled. The initial
value is GL_FALSE. See glLightModel.
GL_LIGHT_MODEL_AMBIENT params returns four values: the red, green,
blue, and alpha components of the ambient
intensity of the entire scene. Integer val‐
ues, if requested, are linearly mapped from
the internal floating-point representation
such that 1.0 returns the most positive repre‐
sentable 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.
GL_LIGHT_MODEL_LOCAL_VIEWER
params returns a single boolean value indicat‐
ing whether specular reflection calculations
treat the viewer as being local to the scene.
The initial value is GL_FALSE. See glLight‐
Model.
GL_LIGHT_MODEL_TWO_SIDE params returns a single boolean value indicat‐
ing whether separate materials are used to
compute lighting for front- and back-facing
polygons. The initial value is GL_FALSE. See
glLightModel.
GL_LINE_SMOOTH params returns a single boolean value indicat‐
ing whether antialiasing of lines is enabled.
The initial value is GL_FALSE. See
glLineWidth.
GL_LINE_SMOOTH_HINT params returns one value, a symbolic constant
indicating the mode of the line antialiasing
hint. The initial value is GL_DONT_CARE. See
glHint.
GL_LINE_STIPPLE params returns a single boolean value indicat‐
ing whether stippling of lines is enabled. The
initial value is GL_FALSE. See glLineStipple.
GL_LINE_STIPPLE_PATTERN params returns one value, the 16-bit line
stipple pattern. The initial value is all 1's.
See glLineStipple.
GL_LINE_STIPPLE_REPEAT params returns one value, the line stipple
repeat factor. The initial value is 1. See
glLineStipple.
GL_LINE_WIDTH params returns one value, the line width as
specified with glLineWidth. The initial value
is 1.
GL_LINE_WIDTH_GRANULARITY
params returns one value, the width difference
between adjacent supported widths for
antialiased lines. See glLineWidth.
GL_LINE_WIDTH_RANGE params returns two values: the smallest and
largest supported widths for antialiased
lines. See glLineWidth.
GL_LIST_BASE params returns one value, the base offset
added to all names in arrays presented to
glCallLists. The initial value is 0. See
glListBase.
GL_LIST_INDEX params returns one value, the name of the dis‐
play list currently under construction. 0 is
returned if no display list is currently under
construction. The initial value is 0. See
glNewList.
GL_LIST_MODE params returns one value, a symbolic constant
indicating the construction mode of the dis‐
play list currently under construction. The
initial value is 0. See glNewList.
GL_LOGIC_OP_MODE params returns one value, a symbolic constant
indicating the selected logic operation mode.
The initial value is GL_COPY. See glLogicOp.
GL_MAP1_COLOR_4 params returns a single boolean value indicat‐
ing whether 1D evaluation generates colors.
The initial value is GL_FALSE. See glMap1.
GL_MAP1_GRID_DOMAIN params returns two values: the endpoints of
the 1D map's grid domain. The initial value is
(0, 1). See
glMapGrid.
GL_MAP1_GRID_SEGMENTS params returns one value, the number of parti‐
tions in the 1D map's grid domain. The initial
value is 1. See
glMapGrid.
GL_MAP1_INDEX params returns a single boolean value indicat‐
ing whether 1D evaluation generates color
indices. The initial value is GL_FALSE. See
glMap1.
GL_MAP1_NORMAL params returns a single boolean value indicat‐
ing whether 1D evaluation generates normals.
The initial value is GL_FALSE. See glMap1.
GL_MAP1_TEXTURE_COORD_1 params returns a single boolean value indicat‐
ing whether 1D evaluation generates 1D texture
coordinates. The initial value is GL_FALSE.
See glMap1.
GL_MAP1_TEXTURE_COORD_2 params returns a single boolean value indicat‐
ing whether 1D evaluation generates 2D texture
coordinates. The initial value is GL_FALSE.
See glMap1.
GL_MAP1_TEXTURE_COORD_3 params returns a single boolean value indicat‐
ing whether 1D evaluation generates 3D texture
coordinates. The initial value is GL_FALSE.
See glMap1.
GL_MAP1_TEXTURE_COORD_4 params returns a single boolean value indicat‐
ing whether 1D evaluation generates 4D texture
coordinates. The initial value is GL_FALSE.
See glMap1.
GL_MAP1_VERTEX_3 params returns a single boolean value indicat‐
ing whether 1D evaluation generates 3D vertex
coordinates. The initial value is GL_FALSE.
See glMap1.
GL_MAP1_VERTEX_4 params returns a single boolean value indicat‐
ing whether 1D evaluation generates 4D vertex
coordinates. The initial value is GL_FALSE.
See glMap1.
GL_MAP2_COLOR_4 params returns a single boolean value indicat‐
ing whether 2D evaluation generates colors.
The initial value is GL_FALSE. See glMap2.
GL_MAP2_GRID_DOMAIN 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.
GL_MAP2_GRID_SEGMENTS params returns two values: the number of par‐
titions in the 2D map's i and j grid domains.
The initial value is (1,1). See glMapGrid.
GL_MAP2_INDEX params returns a single boolean value indicat‐
ing whether 2D evaluation generates color
indices. The initial value is GL_FALSE. See
glMap2.
GL_MAP2_NORMAL params returns a single boolean value indicat‐
ing whether 2D evaluation generates normals.
The initial value is GL_FALSE. See glMap2.
GL_MAP2_TEXTURE_COORD_1 params returns a single boolean value indicat‐
ing whether 2D evaluation generates 1D texture
coordinates. The initial value is GL_FALSE.
See glMap2.
GL_MAP2_TEXTURE_COORD_2 params returns a single boolean value indicat‐
ing whether 2D evaluation generates 2D texture
coordinates. The initial value is GL_FALSE.
See glMap2.
GL_MAP2_TEXTURE_COORD_3 params returns a single boolean value indicat‐
ing whether 2D evaluation generates 3D texture
coordinates. The initial value is GL_FALSE.
See glMap2.
GL_MAP2_TEXTURE_COORD_4 params returns a single boolean value indicat‐
ing whether 2D evaluation generates 4D texture
coordinates. The initial value is GL_FALSE.
See glMap2.
GL_MAP2_VERTEX_3 params returns a single boolean value indicat‐
ing whether 2D evaluation generates 3D vertex
coordinates. The initial value is GL_FALSE.
See glMap2.
GL_MAP2_VERTEX_4 params returns a single boolean value indicat‐
ing whether 2D evaluation generates 4D vertex
coordinates. The initial value is GL_FALSE.
See glMap2.
GL_MAP_COLOR params returns a single boolean value indicat‐
ing if colors and color indices are to be
replaced by table lookup during pixel trans‐
fers. The initial value is GL_FALSE. See
glPixelTransfer.
GL_MAP_STENCIL params returns a single boolean value indicat‐
ing if stencil indices are to be replaced by
table lookup during pixel transfers. The ini‐
tial value is GL_FALSE. See
glPixelTransfer.
GL_MATRIX_MODE params returns one value, a symbolic constant
indicating which matrix stack is currently the
target of all matrix operations. The initial
value is GL_MODELVIEW. See glMatrixMode.
GL_MAX_CLIENT_ATTRIB_STACK_DEPTH
params returns one value indicating the maxi‐
mum supported depth of the client attribute
stack. See
glPushClientAttrib.
GL_MAX_ATTRIB_STACK_DEPTH
params returns one value, the maximum sup‐
ported depth of the attribute stack. The value
must be at least 16. See
glPushAttrib.
GL_MAX_CLIP_PLANES params returns one value, the maximum number
of application-defined clipping planes. The
value must be at least 6. See glClipPlane.
GL_MAX_EVAL_ORDER 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.
GL_MAX_LIGHTS params returns one value, the maximum number
of lights. The value must be at least 8. See
glLight.
GL_MAX_LIST_NESTING params returns one value, the maximum recur‐
sion depth allowed during display-list traver‐
sal. The value must be at least 64. See
glCallList.
GL_MAX_MODELVIEW_STACK_DEPTH
params returns one value, the maximum sup‐
ported depth of the modelview matrix stack.
The value must be at least 32. See glPushMa‐
trix.
GL_MAX_NAME_STACK_DEPTH params returns one value, the maximum sup‐
ported depth of the selection name stack. The
value must be at least 64. See glPushName.
GL_MAX_PIXEL_MAP_TABLE params returns one value, the maximum sup‐
ported size of a glPixelMap lookup table. The
value must be at least 32. See glPixelMap.
GL_MAX_PROJECTION_STACK_DEPTH
params returns one value, the maximum sup‐
ported depth of the projection matrix stack.
The value must be at least 2. See glPushMa‐
trix.
GL_MAX_TEXTURE_SIZE 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 GL_PROXY_TEXTURE_1D or
GL_PROXY_TEXTURE_2D to determine if a texture
is too large. See glTexImage1D and glTexIm‐
age2D.
GL_MAX_CUBE_MAP_TEXTURE_SIZE
params returns one value. The value gives a
estimate of the largest texture size for each
face of the cubemap that the GL can handle.
See glTexImage2D.
GL_MAX_TEXTURE_STACK_DEPTH
params returns one value, the maximum sup‐
ported depth of the texture matrix stack. The
value must be at least 2. See glPushMatrix.
GL_MAX_VIEWPORT_DIMS params returns two values: the maximum sup‐
ported 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.
GL_MODELVIEW_MATRIX params returns sixteen values: the modelview
matrix on the top of the modelview matrix
stack. Initially this matrix is the identity
matrix. See glPushMatrix.
GL_MINMAX_EXT params returns a single boolean value indicat‐
ing whether minmax is enabled. The initial
value is GL_FALSE. See glMinmaxEXT.
GL_MODELVIEW_STACK_DEPTH params returns one value, the number of matri‐
ces on the modelview matrix stack. The ini‐
tial value is 1. See
glPushMatrix.
GL_NAME_STACK_DEPTH params returns one value, the number of names
on the selection name stack. The initial value
is 0. See
glPushName.
GL_NORMAL_ARRAY params returns a single boolean value, indi‐
cating whether the normal array is enabled.
The initial value is GL_FALSE. See glNormal‐
Pointer.
GL_NORMAL_ARRAY_STRIDE params returns one value, the byte offset
between consecutive normals in the normal
array. The initial value is 0. See glNormal‐
Pointer.
GL_NORMAL_ARRAY_TYPE params returns one value, the data type of
each coordinate in the normal array. The ini‐
tial value is GL_FLOAT. See glNormalPointer.
GL_NORMALIZE params returns a single boolean value indicat‐
ing whether normals are automatically scaled
to unit length after they have been trans‐
formed to eye coordinates. The initial value
is GL_FALSE. See glNormal.
GL_PACK_ALIGNMENT params returns one value, the byte alignment
used for writing pixel data to memory. The
initial value is 4. See glPixelStore.
GL_PACK_LSB_FIRST params returns a single boolean value indicat‐
ing whether single-bit pixels being written to
memory are written first to the least signifi‐
cant bit of each unsigned byte. The initial
value is GL_FALSE. See glPixelStore.
GL_PACK_ROW_LENGTH params returns one value, the row length used
for writing pixel data to memory. The initial
value is 0. See
glPixelStore.
GL_PACK_SKIP_PIXELS params returns one value, the number of pixel
locations skipped before the first pixel is
written into memory. The initial value is 0.
See glPixelStore.
GL_PACK_SKIP_ROWS 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.
GL_PACK_SWAP_BYTES params returns a single boolean value indicat‐
ing whether the bytes of two-byte and four-
byte pixel indices and components are swapped
before being written to memory. The initial
value is GL_FALSE. See glPixelStore.
GL_PERSPECTIVE_CORRECTION_HINT
params returns one value, a symbolic constant
indicating the mode of the perspective correc‐
tion hint. The initial value is GL_DONT_CARE.
See glHint.
GL_PIXEL_MAP_A_TO_A_SIZE params returns one value, the size of the
alpha-to-alpha pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_B_TO_B_SIZE params returns one value, the size of the
blue-to-blue pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_G_TO_G_SIZE params returns one value, the size of the
green-to-green pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_I_TO_A_SIZE params returns one value, the size of the
index-to-alpha pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_I_TO_B_SIZE params returns one value, the size of the
index-to-blue pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_I_TO_G_SIZE params returns one value, the size of the
index-to-green pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_I_TO_I_SIZE params returns one value, the size of the
index-to-index pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_I_TO_R_SIZE params returns one value, the size of the
index-to-red pixel translation table. The
initial value is 1. See
glPixelMap.
GL_PIXEL_MAP_R_TO_R_SIZE params returns one value, the size of the red-
to-red pixel translation table. The initial
value is 1. See glPixelMap.
GL_PIXEL_MAP_S_TO_S_SIZE params returns one value, the size of the
stencil-to-stencil pixel translation table.
The initial value is 1. See
glPixelMap.
GL_POINT_SIZE params returns one value, the point size as
specified by glPointSize. The initial value is
1.
GL_POINT_SIZE_GRANULARITY
params returns one value, the size difference
between adjacent supported sizes for
antialiased points. See glPointSize.
GL_POINT_SIZE_RANGE 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.
GL_POINT_SMOOTH params returns a single boolean value indicat‐
ing whether antialiasing of points is enabled.
The initial value is GL_FALSE. See glPoint‐
Size.
GL_POINT_SMOOTH_HINT params returns one value, a symbolic constant
indicating the mode of the point antialiasing
hint. The initial value is GL_DONT_CARE. See
glHint.
GL_POLYGON_MODE params returns two values: symbolic constants
indicating whether front-facing and back-fac‐
ing polygons are rasterized as points, lines,
or filled polygons. The initial value is
GL_FILL. See glPolygonMode.
GL_POLYGON_OFFSET_FACTOR params returns one value, the scaling factor
used to determine the variable offset that is
added to the depth value of each fragment gen‐
erated when a polygon is rasterized. The ini‐
tial value is 0. See glPolygonOffset.
GL_POLYGON_OFFSET_UNITS params returns one value. This value is mul‐
tiplied by an implementation-specific value
and then added to the depth value of each
fragment generated when a polygon is raster‐
ized. The initial value is 0. See glPoly‐
gonOffset.
GL_POLYGON_OFFSET_FILL params returns a single boolean value indicat‐
ing whether polygon offset is enabled for
polygons in fill mode. The initial value is
GL_FALSE. See glPolygonOffset.
GL_POLYGON_OFFSET_LINE params returns a single boolean value indicat‐
ing whether polygon offset is enabled for
polygons in line mode. The initial value is
GL_FALSE. See glPolygonOffset.
GL_POLYGON_OFFSET_POINT params returns a single boolean value indicat‐
ing whether polygon offset is enabled for
polygons in point mode. The initial value is
GL_FALSE. See glPolygonOffset.
GL_POLYGON_OFFSET_BIAS_EXT
params returns one value. This value is a
constant value added to the depth value of
each fragment generated when a polygon is ras‐
terized. The initial value is 0. See glPoly‐
gonOffsetEXT.
GL_POLYGON_OFFSET_FACTOR_EXT
params returns one value, the scaling factor
used to determine the variable offset that is
added to the depth value of each fragment gen‐
erated when a polygon is rasterized. The ini‐
tial value is 0. See glPolygonOffsetEXT.
GL_POLYGON_OFFSET_EXT params returns a single boolean value indicat‐
ing whether polygon offset is enabled for
polygons in fill mode. The initial value is
GL_FALSE. See glPolygonOffsetEXT.
GL_POLYGON_SMOOTH params returns a single boolean value indicat‐
ing whether antialiasing of polygons is
enabled. The initial value is GL_FALSE. See
glPolygonMode.
GL_POLYGON_SMOOTH_HINT params returns one value, a symbolic constant
indicating the mode of the polygon antialias‐
ing hint. The initial value is GL_DONT_CARE.
See glHint.
GL_POLYGON_STIPPLE params returns a single boolean value indicat‐
ing whether polygon stippling is enabled. The
initial value is GL_FALSE. See glPolygonStip‐
ple.
GL_POST_CONVOLUTION_ALPHA_BIAS_EXT
params returns one value, the post convolution
alpha bias factor used during pixel transfers.
The initial value is 0. See
glPixelTransfer.
GL_POST_CONVOLUTION_BLUE_BIAS_EXT
params returns one value, the post convolution
blue bias factor used during pixel transfers.
The initial value is 0. See
glPixelTransfer.
GL_POST_CONVOLUTION_GREEN_BIAS_EXT
params returns one value, the post convolution
green bias factor used during pixel transfers.
The initial value is 0. See
glPixelTransfer.
GL_POST_CONVOLUTION_RED_BIAS_EXT
params returns one value, the post convolution
red bias factor used during pixel transfers.
The initial value is 0. See
glPixelTransfer.
GL_POST_CONVOLUTION_ALPHA_SCALE_EXT
params returns one value, the post convolution
alpha scale factor used during pixel trans‐
fers. The initial value is 1. See
glPixelTransfer.
GL_POST_CONVOLUTION_BLUE_SCALE_EXT
params returns one value, the post convolution
blue scale factor used during pixel transfers.
The initial value is 1. See
glPixelTransfer.
GL_POST_CONVOLUTION_GREEN_SCALE_EXT
params returns one value, the post convolution
green scale factor used during pixel trans‐
fers. The initial value is 1. See
glPixelTransfer.
GL_POST_CONVOLUTION_RED_SCALE_EXT
params returns one value, the post convolution
red scale factor used during pixel transfers.
The initial value is 1. See
glPixelTransfer.
GL_PROJECTION_MATRIX params returns sixteen values: the projection
matrix on the top of the projection matrix
stack. Initially this matrix is the identity
matrix. See glPushMatrix.
GL_PROJECTION_STACK_DEPTH
params returns one value, the number of matri‐
ces on the projection matrix stack. The ini‐
tial value is 1. See
glPushMatrix.
GL_READ_BUFFER params returns one value, a symbolic constant
indicating which color buffer is selected for
reading. The initial value is GL_BACK if there
is a back buffer, otherwise it is GL_FRONT.
See glReadPixels and glAccum.
GL_RED_BIAS params returns one value, the red bias factor
used during pixel transfers. The initial value
is 0.
GL_RED_BITS params returns one value, the number of red
bitplanes in each color buffer.
GL_RED_SCALE params returns one value, the red scale factor
used during pixel transfers. The initial value
is 1. See glPixelTransfer.
GL_RENDER_MODE params returns one value, a symbolic constant
indicating whether the GL is in render,
select, or feedback mode. The initial value is
GL_RENDER. See glRenderMode.
GL_RGBA_MODE params returns a single boolean value indicat‐
ing whether the GL is in RGBA mode (true) or
color index mode (false). See glColor.
GL_SCISSOR_BOX 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.
GL_SCISSOR_TEST params returns a single boolean value indicat‐
ing whether scissoring is enabled. The initial
value is GL_FALSE. See glScissor.
GL_SECONDARY_COLOR_ARRAY_SIZE
params returns one value, the number of compo‐
nents per color in the secondary color array.
The initial value is 4. See
glSecondaryColorPointer.
GL_SECONDARY_COLOR_ARRAY_STRIDE
params returns one value, the byte offset
between consecutive colors in the secondary
color array. The initial value is 0. See
glSecondaryColorPointer.
GL_SECONDARY_COLOR_ARRAY_TYPE
params returns one value, the data type of
each component in the secondary color array.
The initial value is GL_FLOAT. See glSec‐
ondaryColorPointer.
GL_SEPARABLE_2D_EXT params returns a single boolean value indicat‐
ing whether separable convolution is enabled.
The initial value is GL_FALSE. See glSepara‐
bleFilter2DEXT.
GL_SHADE_MODEL params returns one value, a symbolic constant
indicating whether the shading mode is flat or
smooth. The initial value is GL_SMOOTH. See
glShadeModel.
GL_STENCIL_BITS params returns one value, the number of bit‐
planes in the stencil buffer.
GL_STENCIL_CLEAR_VALUE params returns one value, the index to which
the stencil bitplanes are cleared. The initial
value is 0. See
glClearStencil.
GL_STENCIL_FAIL params returns one value, a symbolic constant
indicating what action is taken when the sten‐
cil test fails. The initial value is GL_KEEP.
See glStencilOp.
GL_STENCIL_FUNC 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 GL_ALWAYS.
See glStencilFunc.
GL_STENCIL_PASS_DEPTH_FAIL
params returns one value, a symbolic constant
indicating what action is taken when the sten‐
cil test passes, but the depth test fails. The
initial value is GL_KEEP. See
glStencilOp.
GL_STENCIL_PASS_DEPTH_PASS
params returns one value, a symbolic constant
indicating what action is taken when the sten‐
cil test passes and the depth test passes. The
initial value is GL_KEEP. See
glStencilOp.
GL_STENCIL_REF params returns one value, the reference value
that is compared with the contents of the
stencil buffer. The initial value is 0. See
glStencilFunc.
GL_STENCIL_TEST params returns a single boolean value indicat‐
ing whether stencil testing of fragments is
enabled. The initial value is GL_FALSE. See
glStencilFunc and glStencilOp.
GL_STENCIL_VALUE_MASK 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.
GL_STENCIL_WRITEMASK params returns one value, the mask that con‐
trols writing of the stencil bitplanes. The
initial value is all 1's. See glStencilMask.
GL_STEREO params returns a single boolean value indicat‐
ing whether stereo buffers (left and right)
are supported.
GL_SUBPIXEL_BITS 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.
GL_TEXTURE_1D params returns a single boolean value indicat‐
ing whether 1D texture mapping is enabled. The
initial value is GL_FALSE. See glTexImage1D.
GL_TEXTURE_1D_BINDING params returns a single value, the name of the
texture currently bound to the target GL_TEX‐
TURE_1D. The initial value is 0. See glBind‐
Texture.
GL_TEXTURE_2D params returns a single boolean value indicat‐
ing whether 2D texture mapping is enabled. The
initial value is GL_FALSE. See glTexImage2D.
GL_TEXTURE_2D_BINDING params returns a single value, the name of the
texture currently bound to the target GL_TEX‐
TURE_2D. The initial value is 0. See glBind‐
Texture.
GL_TEXTURE_CAPACITY_SIZE_SUN
params returns a single value, the texture
memory capacity in the current configuration
(in terms of bytes). For those devices that
do not support hardware texture memory, the
returned value is 0.
GL_TEXTURE_CUBE_MAP params returns a single boolean value indicat‐
ing whether cube-map texturing is enabled. The
initial value is GL_FALSE. See glTexImage2D.
GL_TEXTURE_BINDING_CUBE_MAP
params returns a single value, the name of the
texture currently bound to the target GL_TEX‐
TURE_CUBE_MAP. The initial value is 0. See
glBindTexture.
GL_TEXTURE_COORD_ARRAY params returns a single boolean value indicat‐
ing whether the texture coordinate array is
enabled. The initial value is GL_FALSE. See
glTexCoordPointer.
GL_TEXTURE_COORD_ARRAY_SIZE
params returns one value, the number of coor‐
dinates per element in the texture coordinate
array. The initial value is 4. See glTexCo‐
ordPointer.
GL_TEXTURE_COORD_ARRAY_STRIDE
params returns one value, the byte offset
between consecutive elements in the texture
coordinate array. The initial value is 0. See
glTexCoordPointer.
GL_TEXTURE_COORD_ARRAY_TYPE
params returns one value, the data type of the
coordinates in the texture coordinate array.
The initial value is GL_FLOAT. See glTexCo‐
ordPointer.
GL_TEXTURE_GEN_Q params returns a single boolean value indicat‐
ing whether automatic generation of the q tex‐
ture coordinate is enabled. The initial value
is GL_FALSE. See glTexGen.
GL_TEXTURE_GEN_R params returns a single boolean value indicat‐
ing whether automatic generation of the r tex‐
ture coordinate is enabled. The initial value
is GL_FALSE. See glTexGen.
GL_TEXTURE_GEN_S params returns a single boolean value indicat‐
ing whether automatic generation of the S tex‐
ture coordinate is enabled. The initial value
is GL_FALSE. See glTexGen.
GL_TEXTURE_GEN_T params returns a single boolean value indicat‐
ing whether automatic generation of the T tex‐
ture coordinate is enabled. The initial value
is GL_FALSE. See glTexGen.
GL_TEXTURE_MATRIX params returns sixteen values: the texture
matrix on the top of the texture matrix stack.
Initially this matrix is the identity matrix.
See glPushMatrix.
GL_TEXTURE_STACK_DEPTH params returns one value, the number of matri‐
ces on the texture matrix stack. The initial
value is 1. See
glPushMatrix.
GL_TEXTURE_TARGET_NUM_PIPES_SUN
params returns one value, the number of hard‐
ware pipelines currently storing the textures.
See
glSetTextureTargetiSUN.
GL_TEXTURE_TARGET_PIPE_MASK_SUN
params returns one value, a bitmask, indicat‐
ing which of the available pipelines are stor‐
ing the textures. See
glSetTextureTargetiSUN.
GL_TEXTURE_TARGET_MAX_PIPES_SUN
params returns one value, the maximum number
of hardware pipelines available.
GL_TEXTURE_TARGET_MODE_SUN
params returns one value, the current texture
target mode. See
glSetTextureTargetModeSUN.
GL_TRANSPOSE_COLOR_MATRIX_ARB
params returns sixteen values: the transpose
of the color matrix on the top of the color
matrix stack. Initially this matrix is the
identity matrix. See
glPushMatrix.
GL_TRANSPOSE_MODELVIEW_MATRIX_ARB
params returns sixteen values: the transpose
of the modelview matrix on the top of the mod‐
elview matrix stack. Initially this matrix is
the identity matrix. See
glPushMatrix.
GL_TRANSPOSE_PROJECTION_MATRIX_ARB
params returns sixteen values: the transpose
of the projection matrix on the top of the
projection matrix stack. Initially this
matrix is the identity matrix. See
glPushMatrix.
GL_TRANSPOSE_TEXTURE_MATRIX_ARB
params returns sixteen values: the transpose
of the texture matrix on the top of the tex‐
ture matrix stack. Initially this matrix is
the identity matrix. See
glPushMatrix.
GL_UNPACK_ALIGNMENT params returns one value, the byte alignment
used for reading pixel data from memory. The
initial value is 4. See glPixelStore.
GL_UNPACK_LSB_FIRST params returns a single boolean value indicat‐
ing whether single-bit pixels being read from
memory are read first from the least signifi‐
cant bit of each unsigned byte. The initial
value is GL_FALSE. See glPixelStore.
GL_UNPACK_ROW_LENGTH params returns one value, the row length used
for reading pixel data from memory. The ini‐
tial value is 0. See
glPixelStore.
GL_UNPACK_SKIP_PIXELS 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.
GL_UNPACK_SKIP_ROWS 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.
GL_UNPACK_CONSTANT_DATA_SUNX
params returns a single boolean value indicat‐
ing whether the data being read from memory
should be treated as constant data. Data is
"constant data" if it will remain unchanged
and so the library internally need not make a
copy of the data passed in. The initial value
is GL_FALSE. See glPixelStore.
GL_UNPACK_SWAP_BYTES params returns a single boolean value indicat‐
ing whether the bytes of two-byte and four-
byte pixel indices and components are swapped
after being read from memory. The initial
value is GL_FALSE. See glPixelStore.
GL_VERTEX_ARRAY params returns a single boolean value indicat‐
ing whether the vertex array is enabled. The
initial value is GL_FALSE. See glVertex‐
Pointer.
GL_VERTEX_ARRAY_SIZE params returns one value, the number of coor‐
dinates per vertex in the vertex array. The
initial value is 4. See
glVertexPointer.
GL_VERTEX_ARRAY_STRIDE params returns one value, the byte offset
between consecutive vertexes in the vertex
array. The initial value is 0. See glVertex‐
Pointer.
GL_VERTEX_ARRAY_TYPE params returns one value, the data type of
each coordinate in the vertex array. The ini‐
tial value is GL_FLOAT. See glVertexPointer.
GL_VERTEX_PROGRAM_ARB params returns a single boolean value indicat‐
ing whether the vertex program is enabled
(GL_TRUE) or disabled (GL_FALSE).
GL_VIEWPORT params returns four values: the x and y window
coordinates of the viewport, followed by its
width and height. Initially the x and y win‐
dow 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.
GL_ZOOM_X params returns one value, the x pixel zoom
factor. The initial value is 1. See glPixel‐
Zoom.
GL_ZOOM_Y params returns one value, the y pixel zoom
factor. The initial value is 1. See glPixel‐
Zoom.
GL_NUM_COMPRESSED_TEXTURE_FORMATS
params returns the number of specific com‐
pressed internal formats supported by the ren‐
derer.
GL_COMPRESSED_TEXTURE_FORMATS
params returns the set of specific compressed
internal formats supported by the renderer.
GL_POST_TEXTURE_FILTER_SCALE_RANGE_SGIX
params returns two floating-point values. The
first one is the minimum scale value and the
second is the maximum scale value. The imple‐
mentation supports atleast this range of scale
factors.
GL_POST_TEXTURE_FILTER_BIAS_RANGE_SGIX
params returns two floating-point values. The
first one is the minimum bias value and the
second is the maximum bias value. The imple‐
mentation supports atleast this range of bias
values.
GL_MAX_TEXTURE_MAX_ANISOTROPY_EXT
params returns one floating-point value. It is
the limit of maximum degree of anisotropy
allowed by the underlying GL implementation.
The minimum value for GL_MAX_TEXTURE_MAX_AN‐
ISOTROPY_EXT is 2.0.
GL_MULTISAMPLE_ARB params returns a single boolean value indi‐
cating whether multisampling is enabled. The
initial value is GL_FALSE.
GL_SAMPLE_ALPHA_TO_COVERAGE_ARB
params returns a single boolean value indi‐
cating whether to generate the tempory cover‐
age value based on fragment alpha value. The
initial value is GL_FALSE.
GL_SAMPLE_ALPHA_TO_ONE_ARB
params returns a single boolean value indi‐
cating whether to replace fragment alpha by
the maximum representable alpga value. The
initial value is GL_FALSE.
GL_SAMPLE_COVERAGE_ARB params returns a single boolean value indi‐
cating whether to generate the tempory cover‐
age value based on GL_SAMPLE_COVER‐
AGE_VALUE_ARB and GL_SAMPLE_COVER‐
AGE_INVERT_ARB. The initial value is
GL_FALSE.
GL_SAMPLE_BUFFERS_ARB params returns one value, number of sample
buffers. If the returned value is 0, then the
context is not capable of doing multisampling.
GL_SAMPLES_ARB params returns one value, number of samples
per pixel.
GL_SAMPLE_COVERAGE_VALUE_ARB
params returns one value which is used to gen‐
erate the tempoary coverage value when GL_SAM‐
PLE_COVERAGE_ARB is enabled. The default value
is 1.
GL_SAMPLE_COVERAGE_INVERT_ARB
params returns a single boolean value indi‐
cating whether to invert the temporary cover‐
age before it is ANDed with the fragment cov‐
erage. The initial value is GL_FALSE.
GL_VERTEX_PROGRAM_POINT_SIZE_ARB
params returns a single boolean value indi‐
cating whether the point size is taken from
the vertex shader's point size result when a
vertex shader is active.
GL_VERTEX_PROGRAM_TWO_SIDE_ARB
params returns a single boolean value indi‐
cating whether the color is selected between
the front and back colors when a vertex shader
is active.
GL_COLOR_SUM_ARB params returns a single boolean value indi‐
cating whether color sum is enabled for vertex
shaders.
GL_PROGRAM_ERROR_POSITION_ARB
params returns a single value indicating
error position of the current program. If a
program fails to load, the program error posi‐
tion is set to the ubyte offset into the spec‐
ified program string indicating where the
first program error was detected. If the pro‐
gram fails to load because of a semantic
restriction that is not detected until the
program is fully scanned, the error position
is set to the value of program length. If a
program loads successfully, the error position
is set to -1.
GL_CURRENT_MATRIX_ARB params returns 16 values representing the
current matrix.
GL_TRANSPOSE_CURRENT_MATRIX_ARB
params returns 16 values representing the
transpose of the current matrix.
GL_CURRENT_MATRIX_STACK_DEPTH_ARB
params returns a single value indicating the
stack depth of the current program matrix.
GL_MAX_PROGRAM_MATRICES_ARB
params returns a single value indicating
maixmum number of program matrices which are
supported.
GL_MAX_PROGRAM_MATRIX_STACK_DEPTH_ARB
params returns a single value indicating the
maximum supported depth for program matrices
stacks.
GL_MAX_TEXTURE_COORDS_ARB
params returns a single value indicating the
maximum number of texture coordinate sets sup‐
ported.
GL_MAX_TEXTURE_IMAGE_UNITS_AR
params returns a single value indicating max‐
imum number of separate texture units which
can be accessed by a fragment shader.
GL_MAX_VERTEX_UNIFORM_COMPONENTS_ARB
params returns a single value indicating The
maximum number of values that can be held in
uniform variable storage for a vertex shader.
GL_MAX_VARYING_FLOATS_ARB
params returns a single value indicating the
maximum number of individual floating point
values that can be interpolated in a vertex
program.
GL_MAX_VERTEX_ATTRIBS_ARB
params returns a single value indicating the
maximum number of vertex attributes supported.
GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS_ARB
params returns a single value indicating max‐
imum number of separate texture units which
can be accessed by a vertex shader.
GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS_ARB
params returns a single value indicating max‐
imum number of separate texture units which
can be accessed by the vertex and fragment
shaders combined.
GL_MAX_TEXTURE_COORDS_ARB
params returns a single value indicating the
maximum number of texture coordinates sets
that are supported.
GL_MAX_FRAGMENT_UNIFORM_COMPONENTS_ARB
params returns a single value indicating the
maximum number of individual floating point
values, or individual integer values, or indi‐
vidual Boolean values that can be held in uni‐
form variable storage for a fragment shader
GL_VERTEX_PROGRAM_POINT_SIZE_ARB
params returns a single boolean value indi‐
cating how point size is computed. GL_TRUE
indicates that the point size is computed from
a vertex program point size result which is
written to the builtin gl_PointSize. GL_FALSE
indicates that the point size will be taken
from the point size state as specified by
glPointSize If no vertex program is active
this value is ignored.
GL_VERTEX_PROGRAM_TWO_SIDE_ARB
params returns a single boolean value indi‐
cating whether the front or back color is
used. GL_TRUE indicates that either the front
or back color will be use. GL_FALSE indicates
that the front color will always be used. If
no vertex program is active this value is
ignored.
Many of the boolean parameters can also be queried more easily
using
glIsEnabled.
NOTES
GL_COLOR_LOGIC_OP, GL_COLOR_ARRAY, GL_COLOR_ARRAY_SIZE,
GL_COLOR_ARRAY_STRIDE, GL_COLOR_ARRAY_TYPE, GL_EDGE_FLAG_ARRAY,
GL_EDGE_FLAG_ARRAY_STRIDE, GL_INDEX_ARRAY, GL_INDEX_ARRAY_STRIDE,
GL_INDEX_ARRAY_TYPE, GL_INDEX_LOGIC_OP, GL_NORMAL_ARRAY, GL_NOR‐
MAL_ARRAY_STRIDE, GL_NORMAL_ARRAY_TYPE, GL_POLYGON_OFFSET_UNITS,
GL_POLYGON_OFFSET_FACTOR, GL_POLYGON_OFFSET_FILL, GL_POLYGON_OFF‐
SET_LINE, GL_POLYGON_OFFSET_POINT, GL_POLYGON_OFFSET_BIAS_EXT, GL_POLY‐
GON_OFFSET_FACTOR_EXT, GL_POLYGON_OFFSET_EXT, GL_SECONDARY_COLOR_ARRAY,
GL_SECONDARY_COLOR_ARRAY_SIZE, GL_SECONDARY_COLOR_ARRAY_STRIDE, GL_TEX‐
TURE_COORD_ARRAY, GL_TEXTURE_COORD_ARRAY_SIZE, GL_TEX‐
TURE_COORD_ARRAY_STRIDE, GL_TEXTURE_COORD_ARRAY_TYPE, GL_VERTEX_ARRAY,
GL_VERTEX_ARRAY_SIZE, GL_VERTEX_ARRAY_STRIDE, and GL_VERTEX_ARRAY_TYPE
are available only if the GL version is 1.1 or greater.
GL_ACTIVE_TEXTURE_ARB, GL_CLIENT_ACTIVE_TEXTURE_ARB, and GL_MAX_TEX‐
TURE_UNITS_ARB are available only if GL_ARB_multitexture is returned
from glGetString when called with the argument GL_EXTENSIONS.
When the GL_ARB_multitexture extension is supported, the following
parameters return the associated value for the active texture unit:
GL_CURRENT_RASTER_TEXTURE_COORDS, GL_TEXTURE_1D, GL_TEXTURE_BINDING_1D,
GL_TEXTURE_2D, GL_TEXTURE_BINDING_2D, GL_TEXTURE_3D, GL_TEXTURE_BIND‐
ING_3D, GL_TEXTURE_CUBE_MAP, GL_TEXTURE_BINDING_CUBE_MAP, GL_TEX‐
TURE_GEN_S, GL_TEXTURE_GEN_T, GL_TEXTURE_GEN_R, GL_TEXTURE_GEN_Q,
GL_TEXTURE_MATRIX, and GL_TEXTURE_STACK_DEPTH. Likewise the following
parameters return the associated value for the active client texture
unit: GL_TEXTURE_COORD_ARRAY, GL_TEXTURE_COORD_ARRAY_SIZE, GL_TEX‐
TURE_COORD_ARRAY_STRIDE, GL_TEXTURE_COORD_ARRAY_TYPE.
GL_MULTISAMPLE_ARB, GL_SAMPLE_ALPHA_TO_COVERAGE_ARB, GL_SAM‐
PLE_ALPHA_TO_ONE_ARB, GL_SAMPLE_COVERAGE_ARB, GL_SAMPLE_BUFFERS_ARB,
GL_SAMPLES_ARB, GL_SAMPLE_COVERAGE_VALUE_ARB, and GL_SAMPLE_COVER‐
AGE_INVERT_ARB are available only if GL_ARB_multisample is returned
from glGetString when called with the argument GL_EXTENSIONS.
ERRORS
GL_INVALID_ENUM is generated if pname is not an accepted value.
GL_INVALID_OPERATION is generated if glGet is executed between the exe‐
cution of glBegin and the corresponding execution of glEnd.
SEE ALSO
glGetClipPlane, glGetError, glGetLight, glGetMap, glGetMaterial,
glGetPixelMap, glGetPointerv, glGetPolygonStipple, glGetString, glGet‐
TexEnv, glGetTexGen, glGetTexImage, glGetTexLevelParameter, glGetTexPa‐
rameter, glIsEnabled
13 May 99 GLGET(3gl)