 |
Index for
Section 3G |
|
 |
Alphabetical
listing for G |
|
 |
Bottom of
page |
|
glPopAttrib(3G)
NAME
glPushAttrib, glPopAttrib - push and pop the server attribute stack
SYNOPSIS
void glPushAttrib(
GLbitfield mask );
void glPopAttrib(
void );
PARAMETERS
mask
Specifies a mask that indicates which attributes to save. Values for
mask are listed below.
DESCRIPTION
glPushAttrib() takes one argument, a mask that indicates which groups of
state variables to save on the attribute stack. Symbolic constants are used
to set bits in the mask. mask is typically constructed by ORing several of
these constants together. The special mask GL_ALL_ATTRIB_BITS can be used
to save all stackable states.
The symbolic mask constants and their associated GL state are as follows
(the second column lists which attributes are saved):
GL_ACCUM_BUFFER_BIT Accumulation buffer clear value
GL_COLOR_BUFFER_BIT GL_ALPHA_TEST enable bit
Alpha test function and reference value
GL_BLEND enable bit
Blending source and destination
functions
Constant blend color
Blending equation
GL_DITHER enable bit
GL_DRAW_BUFFER setting
GL_COLOR_LOGIC_OP enable bit
GL_INDEX_LOGIC_OP enable bit
Logic op function
Color mode and index mode clear values
Color mode and index mode writemasks
GL_CURRENT_BIT Current RGBA color
Current color index
Current normal vector
Current texture coordinates
Current raster position
GL_CURRENT_RASTER_POSITION_VALID option
RGBA color associated with current
raster position
Color index associated with current
raster position
Texture coordinates associated with
current raster position
GL_EDGE_FLAG option
GL_DEPTH_BUFFER_BIT GL_DEPTH_TEST enable bit
Depth buffer test function
Depth buffer clear value
GL_DEPTH_WRITEMASK enable bit
GL_ENABLE_BIT GL_ALPHA_TEST option
GL_AUTO_NORMAL option
GL_BLEND option
Enable bits for the user-definable
clipping planes
GL_COLOR_MATERIAL
GL_CULL_FACE option
GL_DEPTH_TEST option
GL_DITHER option
GL_FOG option
GL_LIGHTi where 0 <= i<GL_MAX_LIGHTS
GL_LIGHTING option
GL_LINE_SMOOTH option
GL_LINE_STIPPLE option
GL_COLOR_LOGIC_OP option
GL_INDEX_LOGIC_OP option
GL_MAP1_x where x is a map type
GL_MAP2_x where x is a map type
GL_NORMALIZE option
GL_POINT_SMOOTH option
GL_POLYGON_OFFSET_LINE option
GL_POLYGON_OFFSET_FILL option
GL_POLYGON_OFFSET_POINT option
GL_POLYGON_SMOOTH option
GL_POLYGON_STIPPLE option
GL_SCISSOR_TEST option
GL_STENCIL_TEST option
GL_TEXTURE_1D option
GL_TEXTURE_2D option
GL_TEXTURE_3D option
Flags GL_TEXTURE_GEN_x where x is S, T,
R, or Q
GL_EVAL_BIT
GL_MAP1_x enable bits, where x is a map
type
GL_MAP2_x enable bits, where x is a map
type
1D grid endpoints and divisions
2D grid endpoints and divisions
GL_AUTO_NORMAL enable bit
GL_FOG_BIT GL_FOG enable bit
Fog color
Fog density
Linear fog start
Linear fog end
Fog index
GL_FOG_MODE value
GL_HINT_BIT
GL_PERSPECTIVE_CORRECTION_HINT setting
GL_POINT_SMOOTH_HINT setting
GL_LINE_SMOOTH_HINT setting
GL_POLYGON_SMOOTH_HINT setting
GL_FOG_HINT setting
GL_LIGHTING_BIT GL_COLOR_MATERIAL enable bit
GL_COLOR_MATERIAL_FACE value
Color material parameters that are
tracking the current color
Ambient scene color
GL_LIGHT_MODEL_LOCAL_VIEWER value
GL_LIGHT_MODEL_TWO_SIDE setting
GL_LIGHTING enable bit
Enable bit for each light
Ambient, diffuse, and specular
intensity for each light
Direction, position, exponent, and
cutoff angle for each light
Constant, linear, and quadratic
attenuation factors for each light
Ambient, diffuse, specular, and
emissive color for each material
Ambient, diffuse, and specular color
indices for each material
Specular exponent for each material
GL_SHADE_MODEL setting
GL_LINE_BIT GL_LINE_SMOOTH option
GL_LINE_STIPPLE enable bit
Line stipple pattern and repeat counter
Line width
GL_LIST_BIT GL_LIST_BASE setting
GL_PIXEL_MODE_BIT
GL_RED_BIAS and GL_RED_SCALE settings
GL_GREEN_BIAS and GL_GREEN_SCALE values
GL_BLUE_BIAS and GL_BLUE_SCALE
GL_ALPHA_BIAS and GL_ALPHA_SCALE
GL_DEPTH_BIAS and GL_DEPTH_SCALE
GL_INDEX_OFFSET and GL_INDEX_SHIFT
values
GL_MAP_COLOR and GL_MAP_STENCIL options
GL_ZOOM_X and GL_ZOOM_Y factors
GL_READ_BUFFER setting
GL_POINT_BIT GL_POINT_SMOOTH option
Point size
GL_POLYGON_BIT GL_CULL_FACE enable bit
GL_CULL_FACE_MODE value
GL_FRONT_FACE indicator
GL_POLYGON_MODE setting
GL_POLYGON_SMOOTH option
GL_POLYGON_STIPPLE enable bit
GL_POLYGON_OFFSET_FILL option
GL_POLYGON_OFFSET_LINE option
GL_POLYGON_OFFSET_POINT option
GL_POLYGON_OFFSET_FACTOR
GL_POLYGON_OFFSET_UNITS
GL_POLYGON_STIPPLE_BIT Polygon stipple image
GL_SCISSOR_BIT GL_SCISSOR_TEST option
Scissor box
GL_STENCIL_BUFFER_BIT GL_STENCIL_TEST enable bit
Stencil function and reference value
Stencil value mask
Stencil fail, pass, and depth buffer
pass actions
Stencil buffer clear value
Stencil buffer writemask
GL_TEXTURE_BIT
Enable bits for the four texture
coordinates
Border color for each texture image
Minification function for each texture
image
Magnification function for each texture
image
Texture coordinates and wrap mode for
each texture image
Color and mode for each texture
environment
Enable bits GL_TEXTURE_GEN_x, x is S,
T, R, and Q
GL_TEXTURE_GEN_MODE setting for S, T,
R, and Q
glTexGen() plane equations for S, T, R,
and Q
Current texture bindings (for example,
GL_TEXTURE_BINDING_2D)
GL_TRANSFORM_BIT Coefficients of the six clipping planes
Enable bits for the user-definable
clipping planes
GL_MATRIX_MODE value
GL_NORMALIZE option
GL_RESCALE_NORMAL option
GL_VIEWPORT_BIT Depth range (near and far)
Viewport origin and extent
glPopAttrib() restores the values of the state variables saved with the
last glPushAttrib() command. Those not saved are left unchanged.
It is an error to push attributes onto a full stack, or to pop attributes
off an empty stack. In either case, the error option is set and no other
change is made to GL state.
Initially, the attribute stack is empty.
NOTES
Not all values for GL state can be saved on the attribute stack. For
example, render mode state, and select and feedback state cannot be saved.
Client state must be saved with glPushClientAttrib().
The depth of the attribute stack depends on the implementation, but it must
be at least 16.
When the GL_ARB_multitexture extension is supported, pushing and popping
texture state apples to all supported texture units.
ERRORS
GL_STACK_OVERFLOW is generated if glPushAttrib() is called while the
attribute stack is full.
GL_STACK_UNDERFLOW is generated if glPopAttrib() is called while the
attribute stack is empty.
GL_INVALID_OPERATION is generated if glPushAttrib() or glPopAttrib() is
executed between the execution of glBegin() and the corresponding execution
of glEnd().
ASSOCIATED GETS
glGet() with argument GL_ATTRIB_STACK_DEPTH
glGet() with argument GL_MAX_ATTRIB_STACK_DEPTH
SEE ALSO
glGet(3), glGetClipPlane(3), glGetError(3), glGetLight(3), glGetMap(3),
glGetMaterial(3), glGetPixelMap(3), glGetPolygonStipple(3), glGetString(3),
glGetTexEnv(3), glGetTexGen(3), glGetTexImage(3),
glGetTexLevelParameter(3), glGetTexParameter(3), glIsEnabled(3)(),
glPushClientAttrib(3)
|
Index for
Section 3G |
|
|
Alphabetical
listing for G |
|
 |
Top of
page |
|