[ Previous | Next | Contents | Glossary | Home | Search ]
OpenGL 1.1 for AIX: Reference Manual

glGet Subroutine

Purpose

Returns the value or values of a selected parameter.

Library

OpenGL C bindings library: libGL.a

C Syntax

void glGetBooleanv(GLenum ParameterName,
       GLBoolean *ParameterValuess)
void glGetDoublev(GLenum ParameterName,
                   GLdouble *ParameterValues)               
void glGetFloatv(GLenum ParameterName,
                GLfloat *ParameterValues)
void glGetIntegerv(GLenum ParameterName,
                   GLint ParameterValues)

Parameters

ParameterName Specifies the parameter value to be returned. The symbolic constants listed in the Description section are accepted.
ParameterValues Returns the value or values of the specified parameter.

Description

The four commands, glGetBooleanv, glGetDoublev, glGetFloatv, and glGetIntegerv, return values for simple-state variables in GL. ParameterName is a symbolic constant indicating the state variable to be returned, and ParameterValues is a pointer to an array of the indicated type in which to place the returned data.

Type conversion is performed if ParameterValues 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 (zero). Otherwise, it is converted to GL_TRUE. If glGetIntegerv 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 either 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 ParameterName:

GL_ACCUM_ALPHA_BITS ParameterValues returns one value, the number of alpha bit planes in the accumulation buffer.
GL_ACCUM_BLUE_BITS ParameterValues returns one value, the number of blue bit planes in the accumulation buffer.
GL_ACCUM_CLEAR_VALUE ParameterValues returns four values: the red, green, blue, and alpha (RGBA) 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. (See glClearAccum.)
GL_ACCUM_GREEN_BITS ParameterValues returns one value, the number of green bit planes in the accumulation buffer.
GL_ACCUM_RED_BITS ParameterValues returns one value, the number of red bit planes in the accumulation buffer.
GL_ALPHA_BIAS ParameterValues returns one value, the alpha bias factor used during pixel transfers. (See glPixelTransfer.)
GL_ALPHA_BITS ParmeterValues returns one value, the number of alpha bit planes in each color buffer.
GL_ALPHA_SCALE ParameterValues returns one value, the alpha scale factor used during pixel transfers. (See glPixelTransfer.)
GL_ALPHA_TEST ParameterValues returns a single Boolean value indicating whether alpha testing of fragments is enabled. (See glAlphaFunc.)
GL_ALPHA_TEST_FUNC ParameterValues returns one value, the symbolic name of the alpha test function. (See glAlphaFunc.)
GL_ALPHA_TEST_REF ParameterValues returns one value, the reference value for the alpha test. (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.
GL_ARRAY_ELEMENT_LOCK_FIRST_EXT ParameterValues returns one value, the first element in the locked range. (See glLockArraysEXT.)
GL_ARRAY_ELEMENT_LOCK_COUNT_EXT ParameterValues returns one value, the count of elements in the locked range. (See glLockArraysEXT.)
GL_ATTRIB_STACK_DEPTH ParameterValues returns one value, the depth of the attribute stack. If the stack is empty, 0 is returned. (See glPushAttrib.)
GL_AUTO_NORMAL ParameterValues returns a single Boolean value indicating whether two-dimensional (2D) map evaluation automatically generates surface normals. (See glMap2.)
GL_AUX_BUFFERS ParameterValues returns one value, the number of auxiliary color buffers.
GL_BLEND ParameterValues returns a single Boolean value indicating whether blending is enabled. (See glBlendFunc.)
GL_BLEND_DST ParameterValues returns one value, the symbolic constant identifying the destination blend function. (See glBlendFunc.)
GL_BLEND_EQUATION_EXT ParameterValues returns one value, a symbolic constant indicating the blend equation. (See glBlendEquationEXT.)
GL_BLEND_SRC ParameterValues returns one value, the symbolic constant identifying the source blend function. (See glBlendFunc.)
GL_BLUE_BIAS ParameterValues returns one value, the blue bias factor used during pixel transfers. (See glPixelTransfer.)
GL_BLUE_BITS ParameterValues returns one value, the number of blue bit planes in each color buffer.
GL_CLIENT_ATTRIB_STACK_DEPTH ParameterValues returns one value indicating the depth of the attribute stack. The initial value is 0. (See glPushClientAttrib.)
GL_BLUE_SCALE ParameterValues returns one value, the blue scale factor used during pixel transfers. (See glPixelTransfer.)
GL_CLIP_PLANE ParameterValues returns a single Boolean value indicating whether the specified clipping plane is enabled. (See glClipPlane.)
GL_COLOR_ARRAY ParameterValues returns a single Boolean value indicating whether the color array is enabled. The initial value is GL_FALSE. (See glColorPointer.)
GL_COLOR_ARRAY_COUNT_EXT ParameterName returns one value, the number of colors in the color array, counting from the first, that are static. (See glColorPointerEXT.)
GL_COLOR_ARRAY_EXT ParameterValues returns a single boolean value, indicating whether the color array is enabled. (See glColorPointerEXT.)
GL_COLOR_ARRAY_SIZE ParameterValues returns one value, the number of components per color in the color array. The initial value is 4. (See glColorPointer.)
GL_COLOR_ARRAY_SIZE_EXT ParameterValues returns one value, the number of components per color in the color array. (See glColorPointerEXT.)
GL_COLOR_ARRAY_STRIDE ParameterValues returns one value, the byte offset between consecutive colors in the color array. The initial value is 0. (See glColorPointer.)
GL_COLOR_ARRAY_STRIDE_EXT ParameterName returns one value, the byte offset between consecutive colors in the color array. (See glColorPointerEXT.)
GL_COLOR_ARRAY_TYPE ParameterValues returns one value, the data type of each component in the color array. The initial value is GL_FLOAT. (See glColorPointer.)
GL_COLOR_ARRAY_TYPE_EXT ParameterValues returns one value, the data type of each component in the color array. (See glColorPointerEXT.)
GL_COLOR_CLEAR_VALUE ParameterValues returns four values: the RGBA 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. (See glClearColor.)
GL_COLOR_LOGIC_OP ParameterValues returns a single Boolean value indicating whether a fragment's color values are merged into the framebuffer using a logical operation. The initial value is GL_FALSE. (See glLogicOp.)
GL_COLOR_MATERIAL ParameterValues returns a single Boolean value indicating whether one or more material parameters are tracking the current color. (See glColorMaterial.)
GL_COLOR_MATERIAL_FACE ParameterValues returns one value, a symbolic constant indicating which materials have a parameter that is tracking the current color. (See glColorMaterial.)
GL_COLOR_MATERIAL_PARAMETER ParameterValues returns one value, a symbolic constant indicating which material parameters are tracking the current color. (See glColorMaterial.)
GL_COLOR_WRITEMASK ParameterValues returns four Boolean values: the RGBA write enables for the color buffers. (See glColorMask.)
GL_CULL_FACE ParameterValues returns a single Boolean value indicating whether polygon culling is enabled. (See glCullFace.)
GL_CULL_FACE_MODE ParameterValues returns one value, a symbolic constant indicating which polygon faces are to be culled. (See glCullFace.)
GL_CURRENT_COLOR ParameterValues returns four values: the RGBA 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.)
GL_CURRENT_INDEX ParameterValues returns one value, the current color index. (See glIndex.)
GL_CURRENT_NORMAL ParameterValues 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. (See glNormal.)
GL_CURRENT_RASTER_COLOR ParameterValues returns four values: the RGBA 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. (See glRasterPos.)
GL_CURRENT_RASTER_DISTANCE ParameterValues returns one value, the distance from the eye to the current raster position. The initial value is 0. (See glRasterPos.)
GL_CURRENT_RASTER_INDEX ParameterValues returns one value, the color index of the current raster position. (See glRasterPos.)
GL_CURRENT_RASTER_POSITION ParameterValues returns four values: the x, y, z, and w components of the current raster position. x, y, and z are in window coordinates, w is in clip coordinates. (See glRasterPos.)
GL_CURRENT_RASTER_TEXTURE_COORDS ParameterValues returns four values: the s, t, r, and q current raster texture coordinates. (See glRasterPos and glTexCoord.)
GL_CURRENT_RASTER_POSITION_VALID ParameterValues returns a single Boolean value indicating whether the current raster position is valid. (See glRasterPos.)
GL_CURRENT_TEXTURE_COORDS ParameterValues returns four values: the s, t, r, and q current texture coordinates. (See glTexCoord.)
GL_DEPTH_BIAS ParameterValues returns one value, the depth bias factor used during pixel transfers. (See glPixelTransfer.)
GL_DEPTH_BITS ParameterValues returns one value, the number of bit planes in the depth buffer.
GL_DEPTH_CLEAR_VALUE ParameterValues 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. (See glClearDepth.)
GL_DEPTH_FUNC ParameterValues returns one value, the symbolic constant that indicates the depth comparison function. (See glDepthFunc.)
GL_DEPTH_RANGE ParameterValues 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. (See glDepthRange.)
GL_DEPTH_SCALE ParameterValues returns one value, the depth scale factor used during pixel transfers. (See glPixelTransfer.)
GL_DEPTH_TEST ParameterValues returns a single Boolean value indicating whether depth testing of fragments is enabled. (See glDepthFunc and glDepthRange.)
GL_DEPTH_WRITEMASK ParameterValues returns a single Boolean value indicating if the depth buffer is enabled for writing. (See glDepthMask.)
GL_DITHER ParameterValues returns a single Boolean value indicating whether dithering of fragment colors and indices is enabled.
GL_DOUBLEBUFFER ParameterValues returns a single Boolean value indicating whether double buffering is supported.
GL_DRAW_BUFFER ParameterValues returns one value, a symbolic constant indicating which buffers are being drawn to. (See glDrawBuffer.)
GL_EDGE_FLAG ParameterValues returns a single Boolean value indicating whether the current edge flag is True or False. (See glEdgeFlag.)
GL_EDGE_FLAG_ARRAY ParameterValues returns a single Boolean value indicating whether the edge flag array is enabled. The initial value is GL_FALSE. (See glEdgeFlagPointer.)
GL_EDGE_FLAG_ARRAY_COUNT_EXT ParameterValues returns one value, the number of edge flags in the edge flag array, counting from the first, that are static. (See glEdgeFlagPointerEXT.)
GL_EDGE_FLAG_ARRAY_EXT ParameterValues returns a single boolean value, indicating whether the edge flag array is enabled. (See glEdgeFlagPointerEXT.)
GL_EDGE_FLAG_ARRAY_STRIDE ParameterValues returns one value, the byte offset between consecutive edge flags in the edge flag array. The initial value is 0. (See glEdgeFlagPointer.)
GL_EDGE_FLAG_ARRAY_STRIDE_EXT ParameterValues returns one value, the byte offset between consecutive edge flags in the edge flag array. (See glEdgeFlagPointerEXT.)
GL_FOG ParameterValues returns a single Boolean value indicating whether fogging is enabled. (See glFog.)
GL_FOG_COLOR ParameterValues returns four values: the RGBA 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. (See glFog.)
GL_FOG_DENSITY ParameterValues returns one value, the fog density parameter. (See glFog.)
GL_FOG_END ParameterValues returns one value, the end factor for the linear fog equation. (See glFog.)
GL_FOG_HINT ParameterValues returns one value, a symbolic constant indicating the mode of the fog hint. (See glHint.)
GL_FOG_INDEX ParameterValues returns one value, the fog color index. (See glFog.)
GL_FOG_MODE ParameterValues returns one value, a symbolic constant indicating which fog equation is selected. (See glFog.)
GL_FOG_START ParameterValues returns one value, the start factor for the linear fog equation. (See glFog.)
GL_FRONT_FACE ParameterValues returns one value, a symbolic constant indicating whether clockwise or counterclockwise polygon winding is treated as frontfacing. (See glFrontFace.)
GL_FUNC_ADD_EXT ParameterValues returns one value, specifying the blending equation defined in the GL Specification be used.
GL_FUNC_SUBTRACT_EXT
GL_GREEN_BIAS ParameterValues returns one value, the green bias factor used during pixel transfers.
GL_GREEN_BITS ParameterValues returns one value, the number of green bit planes in each color buffer.
GL_GREEN_SCALE ParameterValues returns one value, the green scale factor used during pixel transfers. (See glPixelTransfer.)
GL_INDEX_ARRAY ParameterValues returns a single Boolean value indicating whether the color index array is enabled. The initial value is GL_FALSE. (See glIndexPointer.)
GL_INDEX_ARRAY_COUNT_EXT ParameterValues returns one value, the number of color indexes in the color index array, counting from the first, that are static. (See glIndexPointerEXT.)
GL_INDEX_ARRAY_EXT ParameterValues returns a single boolean value, indicating whether the color index array is enabled. (See glIndexPointerEXT.)
GL_INDEX_ARRAY_STRIDE ParameterValues 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_STRIDE_EXT ParameterValues returns one value, the byte offset between consecutive color indexes in the color index array. (See glIndexPointerEXT.)
GL_INDEX_ARRAY_TYPE ParameterValues returns one value, the data type of indexes in the color index array. The initial value is GL_FLOAT. (See glIndexPointer.)
GL_INDEX_ARRAY_TYPE_EXT ParameterValues returns one value, the data type of indexes in the color index array. (See glIndexPointerEXT.)
GL_INDEX_BITS ParameterValues returns one value, the number of bit planes in each color index buffer.
GL_INDEX_CLEAR_VALUE ParameterValues returns one value, the color index used to clear the color index buffers. (See glClearIndex.)
GL_INDEX_MODE ParameterValues returns a single Boolean value indicating whether the GL is in color index mode (True) or RGBA mode (False).
GL_INDEX_OFFSET ParameterValues returns one value, the offset added to color and stencil indices during pixel transfers. (See glPixelTransfer.)
GL_INDEX_SHIFT ParameterValues returns one value, the amount that color and stencil indices are shifted during pixel transfers. (See glPixelTransfer.)
GL_INDEX_WRITEMASK ParameterValues returns one value, a mask indicating which bit planes of each color index buffer can be written. (See glIndexMask.)
GL_LIGHT# (where # is 1...n) ParameterValues returns a single Boolean value indicating whether the specified light is enabled. (See glLight and glLightModel.)
GL_LIGHTING ParameterValues returns a single Boolean value indicating whether lighting is enabled. (See glLightModel.)
GL_LIGHT_MODEL_AMBIENT ParameterValues returns four values: the RGBA 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. (See glLightModel.)
GL_LIGHT_MODEL_LOCAL_VIEWER ParameterValues returns a single Boolean value indicating whether specular reflection calculations treat the viewer as being local to the scene. (See glLightModel.)
GL_LIGHT_MODEL_TWO_SIDE ParameterValues returns a single Boolean value indicating whether separate materials are used to compute lighting for frontfacing and backfacing polygons. (See glLightModel.)
GL_LINE_SMOOTH ParameterValues returns a single Boolean value indicating whether antialiasing of lines is enabled. (See glLineWidth.)
GL_LINE_SMOOTH_HINT ParameterValues returns one value, a symbolic constant indicating the mode of the line antialiasing hint. (See glHint).
GL_LINE_STIPPLE ParameterValues returns a single Boolean value indicating whether stippling of lines is enabled. (See glLineStipple.)
GL_LINE_STIPPLE_PATTERN ParameterValues returns one value, the 16-bit line stipple pattern. (See glLineStipple.)
GL_LINE_STIPPLE_REPEAT ParameterValues returns one value, the line stipple repeat factor. (See glLineStipple.)
GL_LINE_WIDTH ParameterValues returns one value, the line width as specified with glLineWidth.
GL_LINE_WIDTH_GRANULARITY ParameterValues returns one value, the width difference between adjacent supported widths for antialiased lines. (See glLineWidth.)
GL_LINE_WIDTH_RANGE ParameterValues returns two values: the smallest and largest supported widths for antialiased lines. (See glLineWidth.)
GL_LIST_BASE ParameterValues returns one value, the base offset added to all names in arrays presented to glCallLists. (See glListBase.)
GL_LIST_INDEX ParameterValues returns one value, the name of the display list currently under construction. If no display list is currently under construction, 0 is returned. (See glNewList.)
GL_LIST_MODE ParameterValues returns one value, a symbolic constant indicating the construction mode of the display list currently being constructed. (See glNewList.)
GL_LOGIC_OP ParameterValues returns a single Boolean value indicating whether fragment indexes are merged into the frame buffer using a logical operation. (See glLogicOp.)
GL_LOGIC_OP_MODE ParameterValues returns one value, a symbolic constant indicating the selected logic operational mode. (See glLogicOp.)
GL_MAP1_COLOR_4 ParameterValues returns a single Boolean value indicating whether 1D evaluation generates colors. (See glMap1.)
GL_MAP1_GRID_DOMAIN ParameterValues returns two values: the endpoints of the one-dimensional (1D) map's grid domain. (See glMapGrid.)
GL_MAP1_GRID_SEGMENTS ParameterValues returns one value, the number of partitions in the 1D map's grid domain. (See glMapGrid.)
GL_MAP1_INDEX ParameterValues returns a single Boolean value indicating whether 1D evaluation generates color indices. (See glMap1.)
GL_MAP1_NORMAL ParameterValues returns a single Boolean value indicating whether 1D evaluation generates normals. (See glMap1.)
GL_MAP1_TEXTURE_COORD_1 ParameterValues returns a single Boolean value indicating whether 1D evaluation generates 1D texture coordinates. (See glMap1.)
GL_MAP1_TEXTURE_COORD_2 ParameterValues returns a single Boolean value indicating whether 1D evaluation generates 2D texture coordinates. (See glMap1.)
GL_MAP1_TEXTURE_COORD_3 ParameterValues returns a single Boolean value indicating whether 1D evaluation generates 3D texture coordinates. (See glMap1.)
GL_MAP1_TEXTURE_COORD_4 ParameterValues returns a single Boolean value indicating whether 1D evaluation generates 4D texture coordinates. (See glMap1.)
GL_MAP1_VERTEX_3 ParameterValues returns a single Boolean value indicating whether 1D evaluation generates 3D vertex coordinates. (See glMap1.)
GL_MAP1_VERTEX_4 ParameterValues returns a single Boolean value indicating whether 1D evaluation generates 4D vertex coordinates. (See glMap1.)
GL_MAP2_COLOR_4 ParameterValues returns a single Boolean value indicating whether 2D evaluation generates colors. (See glMap2.)
GL_MAP2_GRID_DOMAIN ParameterValues returns four values: the endpoints of the 2D map's i and j grid domains. (See glMapGrid.)
GL_MAP2_GRID_SEGMENTS ParameterValues returns two values: the number of partitions in the 2D map's i and j grid domains. (See glMapGrid.)
GL_MAP2_INDEX ParameterValues returns a single Boolean value indicating whether 2D evaluation generates color indices. (See glMap2.)
GL_MAP2_NORMAL ParameterValues returns a single Boolean value indicating whether 2D evaluation generates normals. (See glMap2.)
GL_MAP2_TEXTURE_COORD_1 ParameterValues returns a single Boolean value indicating whether 2D evaluation generates 1D texture coordinates. (See glMap2.)
GL_MAP2_TEXTURE_COORD_2 ParameterValues returns a single Boolean value indicating whether 2D evaluation generates 2D texture coordinates. (See glMap2.)
GL_MAP2_TEXTURE_COORD_3 ParameterValues returns a single Boolean value indicating whether 2D evaluation generates 3D texture coordinates. (See glMap2.)
GL_MAP2_TEXTURE_COORD_4 ParameterValues returns a single Boolean value indicating whether 2D evaluation generates 4D texture coordinates. (See glMap2.)
GL_MAP2_VERTEX_3 ParameterValues returns a single Boolean value indicating whether 2D evaluation generates 3D vertex coordinates. (See glMap2.)
GL_MAP2_VERTEX_4 ParameterValues returns a single Boolean value indicating whether 2D evaluation generates 4D vertex coordinates. (See glMap2.)
GL_MAP_COLOR ParameterValues returns a single Boolean value indicating if colors and color indices are to be replaced by table lookup during pixel transfers. (See glPixelTransfer.)
GL_MAP_STENCIL ParameterValues returns a single Boolean value indicating if stencil indices are to be replaced by table lookup during pixel transfers. (See glPixelTransfer.)
GL_MATRIX_MODE ParameterValues returns one value, a symbolic constant indicating which matrix stack is currently the target of all matrix operations. (See glMatrixMode.)
GL_MAX_3D_TEXTURE_SIZE_EXT ParameterValues returns one value, the maximum width, height, or depth of any 3D texture image (without borders). (See glTexImage3DEXT.)
GL_MAX_ATTRIB_STACK_DEPTH ParameterValues returns one value, the maximum supported depth of the attribute stack. (See glPushAttrib.)
GL_MAX_CLIENT_ATTRIB_STACK_DEPTH ParameterValues returns one value indicating the maximum supported depth of the client attribute stack. (See glPushClientAttrib.)
GL_MAX_CLIP_PLANES ParameterValues returns one value, the maximum number of application-defined clipping planes. (See glClipPlane.)
GL_MAX_EVAL_ORDER ParameterValues returns one value, the maximum equation order supported by 1D and 2D evaluators. (See glMap1 and glMap2.)
GL_MAX_LIGHTS ParameterValues returns one value, the maximum number of lights. (See glLight.)
GL_MAX_LIST_NESTING ParameterValues returns one value, the maximum recursion depth allowed during display list traversal. (See glCallList.)
GL_MAX_MODELVIEW_STACK_DEPTH ParameterValues returns one value, the maximum supported depth of the modelview matrix stack. (See glPushMatrix.)
GL_MAX_NAME_STACK_DEPTH ParameterValues returns one value, the maximum supported depth of the selection name stack. (See glPushName.)
GL_MAX_PIXEL_MAP_TABLE ParameterValues returns one value, the maximum supported size of a glPixelMap lookup table. (See glPixelMap.)
GL_MAX_PROJECTION_STACK_DEPTH ParameterValues returns one value, the maximum supported depth of the projection matrix stack. (See glPushMatrix.)
GL_MAX_TEXTURE_SIZE ParameterValues returns one value, the maximum width or height of any texture image (without borders). (See glTexImage1D and glTexImage2D.)
GL_MAX_TEXTURE_STACK_DEPTH ParameterValues returns one value, the maximum supported depth of the texture matrix stack. (See glPushMatrix.)
GL_MAX_VIEWPORT_DIMS ParameterValues returns two values: the maximum supported width and height of the viewport. (See glViewport.)
GL_MODELVIEW_MATRIX ParameterValues returns 16 values: the modelview matrix on the top of the modelview matrix stack. (See glPushMatrix.)
GL_MODELVIEW_STACK_DEPTH ParameterValues returns one value, the number of matrices on the modelview matrix stack. (See glPushMatrix.)
GL_NAME_STACK_DEPTH ParameterValues returns one value, the number of names on the selection name stack. (See glPushMatrix.)
GL_NORMAL_ARRAY ParameterValues returns a single Boolean value, indicating whether the normal array is enabled. The initial value is GL_FALSE. (See glNormalPointer.)
GL_NORMAL_ARRAY_COUNT_EXT ParameterValues returns one value, the number of normals in the normal array, counting from the first, that are static. (See glNormalPointerEXT.)
GL_NORMAL_ARRAY_EXT ParameterValues returns a single boolean value, indicating whether the normal array is enabled. (See glNormalPointerEXT.)
GL_NORMAL_ARRAY_STRIDE ParameterValues returns one value, the byte offset between consecutive normals in the normal array. The initial value is 0. (See glNormalPointer.)
GL_NORMAL_ARRAY_STRIDE_EXT ParameterValues returns one value, the byte offset between consecutive normals in the normal array. (See glNormalPointerEXT.)
GL_NORMAL_ARRAY_TYPE ParameterValues returns one value, the data type of each coordinate in the normal array. The initial value is GL_FLOAT. (See glNormalPointer.)
GL_NORMAL_ARRAY_TYPE_EXT ParameterValues returns one value, the data type of each coordinate in the normal array. (See glNormalPointerEXT.)
GL_NORMALIZE ParameterValues returns a single Boolean value indicating whether normals are automatically scaled to unit length after they have been transformed to eye coordinates. (See glNormal.)
GL_PACK_ALIGNMENT ParameterValues returns one value, the byte alignment used for writing pixel data to memory. (See glPixelStore.)
GL_PACK_IMAGE_HEIGHT_EXT ParameterValues returns one value, the number of image rows used for writing 3D pixel data to memory. (See glPixelStore.)
GL_PACK_LSB_FIRST ParameterValues 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. (See glPixelStore.)
GL_PACK_ROW_LENGTH ParameterValues returns one value, the row length used for writing pixel data to memory. (See glPixelStore.)
GL_PACK_SKIP_IMAGES_EXT ParameterValues returns one value, the number of 2D images skipped before the first pixel of a 3D image is written into memory. (See glPixelStore.)
GL_PACK_SKIP_PIXELS ParameterValues returns one value, the number of pixel locations skipped before the first pixel is written into memory. (See glPixelStore.)
GL_PACK_SKIP_ROWS ParameterValues returns one value, the number of rows of pixel locations skipped before the first pixel is written into memory. (See glPixelStore.)
GL_PACK_SWAP_BYTES ParameterValues returns a single Boolean value indicating whether the bytes of 2-byte and 4-byte pixel indices and components are swapped before being written to memory. (See glPixelStore.)
GL_PERSPECTIVE_CORRECTION_HINT ParameterValues returns one value, a symbolic constant indicating the mode of the perspective correction hint. (See glHint.)
GL_PIXEL_MAP_A_TO_A_SIZE ParameterValues returns one value, the size of the alpha-to-alpha pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_B_TO_B_SIZE ParameterValues returns one value, the size of the blue-to-blue pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_G_TO_G_SIZE ParameterValues returns one value, the size of the green-to-green pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_I_TO_A_SIZE ParameterValues returns one value, the size of the index-to-alpha pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_I_TO_B_SIZE ParameterValues returns one value, the size of the index-to-blue pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_I_TO_G_SIZE ParameterValues returns one value, the size of the index-to-green pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_I_TO_I_SIZE ParameterValues returns one value, the size of the index-to-index pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_I_TO_R_SIZE ParameterValues returns one value, the size of the index-to-red pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_R_TO_R_SIZE ParameterValues returns one value, the size of the red-to-red pixel translation table. (See glPixelMap.)
GL_PIXEL_MAP_S_TO_S_SIZE ParameterValues returns one value, the size of the stencil-to-stencil pixel translation table. (See glPixelMap.)
GL_POINT_SIZE ParameterValues returns one value, the point size as specified by glPointSize.
GL_POINT_SIZE_GRANULARITY ParameterValues returns one value, the size difference between adjacent supported sizes for antialiased points. (See glPointSize.)
GL_POINT_SIZE_RANGE ParameterValues returns two values: the smallest and largest supported sizes for antialiased points. (See glPointSize.)
GL_POINT_SMOOTH ParameterValues returns a single Boolean value indicating whether antialiasing of points is enabled. (See glPointSize.)
GL_POINT_SMOOTH_HINT ParameterValues returns one value, a symbolic constant indicating the mode of the point antialiasing hint. (See glHint.)
GL_POLYGON_MODE ParameterValues returns two values: symbolic constants indicating whether frontfacing and backfacing polygons are rasterized as points, lines, or filled polygons. (See glPolygonMode.)
GL_POLYGON_OFFSET_BIAS_EXT ParameterValues returns one value, the constant which is added to the z value of each fragment generated when a polygon is rasterized. (See glPolygonOffsetEXT.)
GL_POLYGON_OFFSET_EXT ParameterValues returns a single Boolean value indicating whether polygon offest is enabled. (See glPolygonOffsetEXT.)
GL_POLYGON_OFFSET_FACTOR ParameterValues returns one value, the scaling factor used to determine the variable offset which is added to the depth value of each fragment generated when a polygon is rasterized. The initial value is 0.0. (See glPolygonOffset.)
GL_POLYGON_OFFSET_FACTOR_EXT ParameterValues returns one value, the scaling factor used to determine the variable offset which is added to the z value of each fragment generated when a polygon is rasterized. (See glPolygonOffsetEXT.)
GL_POLYGON_OFFSET_FILL ParameterValues returns a single Boolean value indicating whether polygon offset is enabled for polygons in fill mode. The initial value is GL_FALSE. (See glPolygonOffset.)
GL_POLYGON_OFFSET_LINE ParameterValues returns a single Boolean value indicating whether polygon offset is enabled for polygons in line mode. The initial value is GL_FALSE. (See glPolygonOffset.)
GL_POLYGON_OFFSET_POINT ParameterValues returns a single Boolean value indicating whether polygon offset is enabled for polygons in point mode. The initial value is GL_FALSE. (See glPolygonOffset.)
GL_POLYGON_OFFSET_UNITS ParameterValues returns one value, this value is multiplied by an implementation-specific value and then added to the z value of each fragment generated when a polygon is rasterized. The initial value is 0.0. (See glPolygonOffset.)
GL_POLYGON_SMOOTH ParameterValues returns a single Boolean value indicating whether antialiasing of polygons is enabled. (See glPolygonMode.)
GL_POLYGON_SMOOTH_HINT ParameterValues returns one value, a symbolic constant indicating the mode of the polygon antialiasing hint. (See glHint.)
GL_POLYGON_STIPPLE ParameterValues returns a single Boolean value indicating whether stippling of polygons is enabled. (See glPolygonStipple.)
GL_PROJECTION_MATRIX ParameterValues returns 16 values: the projection matrix on the top of the projection matrix stack. (See glPushMatrix.)
GL_PROJECTION_STACK_DEPTH ParameterValues returns one value, the number of matrices on the projection matrix stack. (See glPushMatrix.)
GL_READ_BUFFER ParameterValues returns one value, a symbolic constant indicating which color buffer is selected for reading. (See glReadPixels and glAccum.)
GL_RED_BIAS ParameterValues returns one value, the red bias factor used during pixel transfers.
GL_RED_BITS ParameterValues returns one value, the number of red bit planes in each color buffer.
GL_RED_SCALE ParameterValues returns one value, the red scale factor used during pixel transfers. (See glPixelTransfer.)
GL_RENDER_MODE ParameterValues returns one value, a symbolic constant indicating whether the GL is in render, select, or feedback mode. (See glRenderMode.)
GL_RGBA_MODE ParameterValues returns a single Boolean value indicating whether the GL is in RGBA mode (True) or color index mode (False). (See glColor.)
GL_SCISSOR_BOX ParameterValues returns four values: the x and y window coordinates of the scissor box, followed by its width and height. (See glScissor.)
GL_SCISSOR_TEST ParameterValues returns a single Boolean value indicating whether scissoring is enabled. (See glScissor.)
GL_SHADE_MODEL ParameterValues returns one value, a symbolic constant indicating whether the shading mode is flat or smooth. (See glShadeModel.)
GL_STENCIL_BITS ParameterValues returns one value, the number of bit planes in the stencil buffer.
GL_STENCIL_CLEAR_VALUE ParameterValues returns one value, the index to which the stencil bit planes are cleared. (See glClearStencil.)
GL_STENCIL_FAIL ParameterValues returns one value, a symbolic constant indicating what action is taken when the stencil test fails. (See glStencilOp.)
GL_STENCIL_FUNC ParameterValues returns one value, a symbolic constant indicating what function is used to compare the stencil reference value with the stencil buffer value. (See glStencilFunc.)
GL_STENCIL_PASS_DEPTH_FAIL ParameterValues returns one value, a symbolic constant indicating what action is taken when the stencil test passes but the depth test fails. (See glStencilOp.)
GL_STENCIL_PASS_DEPTH_PASS ParameterValues returns one value, a symbolic constant indicating what action is taken when the stencil test passes and the depth test passes. (See glStencilOp.)
GL_STENCIL_REF ParameterValues returns one value, the reference value that is compared with the contents of the stencil buffer. (See glStencilFunc.)
GL_STENCIL_TEST ParameterValues returns a single Boolean value indicating whether stencil testing of fragments is enabled. (See glStencilFunc and glStencilOp.)
GL_STENCIL_VALUE_MASK ParameterValues returns one value, the mask that is used to mask both the stencil reference value and the stencil buffer value before they are compared. (See glStencilFunc.)
GL_STENCIL_WRITEMASK ParameterValues returns one value, the mask that controls writing of the stencil bit planes. (See glStencilMask.)
GL_STEREO ParameterValues returns a single Boolean value indicating whether stereo buffers (left and right) are supported.
GL_SUBPIXEL_BITS ParameterValues returns one value, an estimate of the number of bits of subpixel resolution that are used to position rasterized geometry in window coordinates.
GL_TEXTURE_1D ParameterValues returns a single Boolean value indicating whether 1D texture mapping is enabled. (See glTexImage1D.)
GL_TEXTURE_2D ParameterValues returns a single Boolean value indicating whether 2D texture mapping is enabled. (See glTexImage2D.)
GL_TEXTURE_1D_BINDING ParameterValues returns a single value, the name of the texture currently bound to the target GL_TEXTURE_1D. The initial value is 0. (See glBindTexture.)
GL_TEXTURE_1D_BINDING_EXT ParameterValues returns a single value, the name of the texture currently bound to the target GL_TEXTURE_1D. (See glBindTextureEXT.)
GL_TEXTURE_2D_BINDING ParameterValues returns a single value, the name of the texture currently bound to the target GL_TEXTURE_2D. The initial value is 0. (See glBindTexture.)
GL_TEXTURE_2D_BINDING_EXT ParameterValues returns a single value, the name of the texture currently bound to the target GL_TEXTURE_2D. (See glBindTextureEXT.)
GL_TEXTURE_3D_BINDING_EXT ParameterValues returns a single value, the name of the texture currently bound to the target GL_TEXTURE_3D_EXT. (See glBindTexture.)
GL_TEXTURE_3D_EXT ParameterValues returns a single Boolean value indicating whether 3D texture mapping is enabled. (See glTexImage3DEXT.)
GL_TEXTURE_COORD_ARRAY ParameterValues returns a single Boolean value indicating whether the texture coordinate array is enabled. The initial value is GL_FALSE. (See glTexCoordPointer.)
GL_TEXTURE_COORD_ARRAY_COUNT_EXT ParameterValues returns one value, the number of elements in the texture coordinate array, counting from the first, that are static. (See glTexCoordPointerEXT.)
GL_TEXTURE_COORD_ARRAY_EXT ParameterValues returns a single boolean value, indicating whether the texture coordinate array is enabled. (See glTexCoordPointerEXT.)
GL_TEXTURE_COORD_ARRAY_SIZE ParameterValues returns one value, the number of coordinates per element in the texture coordinate array. The initial value is 4. (See glTexCoordPointer.)
GL_TEXTURE_COORD_ARRAY_SIZE_EXT ParameterValues returns one value, the number of coordinates per element in the texture coordinate array. (See glTexCoordPointerEXT.)
GL_TEXTURE_COORD_ARRAY_STRIDE ParameterValues 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_STRIDE_EXT ParameterValues returns one value, the byte offset between consecutive elements in the texture coordinate array. (See glTexCoordPointerEXT.)
GL_TEXTURE_COORD_ARRAY_TYPE ParameterValues returns one value, the data type of the coordinates in the texture coordinate array. The initial value is GL_FLOAT. (See glTexCoordPointer.)
GL_TEXTURE_COORD_ARRAY_TYPE_EXT ParameterValues returns one value, the data type of the coordinates in the texture coordinate array. (See glTexCoordPointerEXT.)
GL_TEXTURE_ENV_COLOR ParameterValues returns four values: the RGBA values of the texture environment 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 glTexEnv.)
GL_TEXTURE_ENV_MODE ParameterValues returns one value, a symbolic constant indicating what texture environment function is currently selected. (See glTexEnv.)
GL_TEXTURE_GEN_S ParameterValues returns a single Boolean value indicating whether automatic generation of the S texture coordinate is enabled. (See glTexGen.)
GL_TEXTURE_GEN_T ParameterValues returns a single Boolean value indicating whether automatic generation of the T texture coordinate is enabled. (See glTexGen.)
GL_TEXTURE_GEN_R ParameterValues returns a single Boolean value indicating whether automatic generation of the R texture coordinate is enabled. (See glTexGen.)
GL_TEXTURE_GEN_Q ParameterValues returns a single Boolean value indicating whether automatic generation of the Q texture coordinate is enabled. (See glTexGen.)
GL_TEXTURE_MATRIX ParameterValues returns 16 values: the texture matrix on the top of the texture matrix stack. (See glPushMatrix.)
GL_TEXTURE_STACK_DEPTH ParameterValues returns one value, the maximum supported depth of the texture matrix stack. (See glPushMatrix.)
GL_UNPACK_ALIGNMENT ParameterValues returns one value, the byte alignment used for reading pixel data from memory. (See glPixelStore.)
GL_UNPACK_IMAGE_HEIGHT_EXT ParameterValues returns one value, the number of image rows used for reading 3D pixel data from memory. (See glPixelStore.)
GL_UNPACK_LSB_FIRST ParameterValues 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. (See glPixelStore.)
GL_UNPACK_ROW_LENGTH ParameterValues returns one value, the row length used for reading pixel data from memory. (See glPixelStore.)
GL_UNPACK_SKIP_IMAGES_EXT ParameterValues returns one value, the number of 2D images skipped before the first pixel of a 3D image is read from memory. (See glPixelStore.)
GL_UNPACK_SKIP_PIXELS ParameterValues returns one value, the number of pixel locations skipped before the first pixel is read from memory. (See glPixelStore.)
GL_UNPACK_SKIP_ROWS ParameterValues returns one value, the number of rows of pixel locations skipped before the first pixel is read from memory. (See glPixelStore.)
GL_UNPACK_SWAP_BYTES ParameterValues returns a single Boolean value indicating whether the bytes of 2-byte and 4-byte pixel indices and components are swapped after being read from memory. (See glPixelStore.)
GL_VERTEX_ARRAY ParameterValues returns a single Boolean value indicating whether the vertex array is enabled. The initial value is GL_FALSE. (See glVertexPointer.)
GL_VERTEX_ARRAY_COUNT_EXT ParameterValues returns one value, the number of vertexes in the vertex array, counting from the first, that are static. (See glVertexPointerEXT.)
GL_VERTEX_ARRAY_EXT ParameterValues returns a single boolean value, indicating whether the vertex array is enabled. (See glVertexPointerEXT.)
GL_VERTEX_ARRAY_SIZE ParameterValues returns one value, the number of coordinates per vertex in the vertex array. The initial value is 4. (See glVertexPointer.)
GL_VERTEX_ARRAY_SIZE_EXT ParameterValues returns one value, the number of coordinates per vertex in the vertex array. (See glVertexPointerEXT.)
GL_VERTEX_ARRAY_STRIDE ParameterValues returns one value, the byte offset between consecutive vertexes in the vertex array. The initial value is 0. (See glVertexPointer.)
GL_VERTEX_ARRAY_STRIDE_EXT ParameterValues returns one value, the byte offset between consecutive vertexes in the vertex array. (See glVertexPointerEXT.)
GL_VERTEX_ARRAY_TYPE ParameterValues returns one value, the data type of each coordinate in the vertex array. The initial value is GL_FLOAT. (See glVertexPointer.)
GL_VERTEX_ARRAY_TYPE_EXT ParameterValues returns one value, the data type of each coordinate in the vertex array. (See glVertexPointerEXT.)
GL_VIEWPORT ParameterValues returns four values: the x and y window coordinates of the viewport, followed by its width and height. (See glViewPort.)
GL_ZOOM_X ParameterValues returns one value, the x pixel zoom factor. (See glPixelZoom.)
GL_ZOOM_Y ParameterValues returns one value, the y pixel zoom factor. (See glPixelZoom.)

Many of the Boolean parameters can also be queried more easily using glIsEnabled.

Errors

GL_INVALID_ENUM ParameterName is not an accepted value.
GL_INVALID_OPERATION The glGet subroutine is called between a call to glBegin and the corresponding call to glEnd.

Files

/usr/include/GL/gl.h Contains C language constants, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The glGetClipPlane subroutine, glGetError subroutine, glGetLight subroutine, glGetMap subroutine, glGetMaterial subroutine, glGetPixelMap subroutine, glGetPointerv subroutine, glGetPointervEXT subroutine, glGetPolygonStipple subroutine, glGetString subroutine, glGetTexEnv subroutine, glGetTexGen subroutine, glGetTexImage subroutine, glGetTexLevelParameter subroutine, glGetTexParameter subroutine, glIsEnabled subroutine.

OpenGL Overview.


[ Previous | Next | Contents | Glossary | Home | Search ]