glPushAttrib or glPopAttrib Subroutine

OpenGL 1.2 for AIX: Reference Manual

glPushAttrib or glPopAttrib Subroutine

Purpose

Pushes and pops the attribute stack.

Library

OpenGL C bindings library: libGL.a

C Syntax

void glPushAttrib(GLbitfield mask)

void glPopAttrib(void)

Parameters

mask

Specifies a mask that indicates which attributes to save. Values for Mask are provided in the preceding list.

Description

The glPushAttrib subroutine 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. The Mask parameter is typically constructed by ORing several of these constants together. The GL_ALL_ATTRIB_BITS special mask can be used to save all stackable states.

The symbolic mask constants and their associated GL states are in the following list.

Mask	Attributes 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
	GL_COLOR_LOGIC_OP enable bit
	GL_DITHER enable bit
	GL_DRAW_BUFFER setting
	GL_LOGIC_OP enable bit
	Logic op function
	Color mode and index mode clear values
	Color mode and index mode write masks
	GL_BLEND_EQUATION_EXT setting

GL_CURRENT_BIT	Current red, green, blue, alpha (RGBA) color
	Current color index
	Current normal vector
	Current texture coordinates
	Current raster position
	GL_CURRENT_RASTER_POSITION_VALID flag
	RGBA color associated with current raster position
	Color index associated with current raster position
	Texture coordinates associated with current raster position
	GL_EDGE_FLAG flag
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 flag
	GL_AUTO_NORMAL flag
	GL_BLEND flag
	Enable bits for the user-definable clipping planes
	GL_COLOR_LOGIC_OP flag
	GL_COLOR_MATERIAL
	GL_CULL_FACE flag
	GL_DEPTH_TEST flag
	GL_DITHER flag
	GL_FOG flag
	GL_LIGHTi, where 0 < i<GL_MAX_LIGHTS
	GL_LIGHTING flag
	GL_LINE_SMOOTH flag
	GL_LINE_STIPPLE flag
	GL_LOGIC_OP flag
	GL_MAP1_x, where x is a map type
	GL_MAP2_x, where x is a map type
	GL_NORMALIZE flag
	GL_POINT_SMOOTH flag
	GL_POLYGON_OFFSET_EXT flag
	GL_POLYGON_OFFSET_FILL flag
	GL_POLYGON_OFFSET_LINE flag
	GL_POLYGON_OFFSET_POINT flag
	GL_POLYGON_SMOOTH flag
	GL_POLYGON_STIPPLE flag
	GL_SCISSOR_TEST flag
	GL_STENCIL_TEST flag
	GL_TEXTURE_1D flag
	GL_TEXTURE_2D flag
	GL_TEXTURE_3D_EXT flag
	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
	1-dimensional (1D) grid endpoints and divisions
	2-dimensional (2D) grid endpoints and divisions
	GL_AUTO_NORMAL enable bit
GL_FOG_BIT	GL_FOG enable flag
	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_SUBPIXEL_HINT_IBM 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 flag
	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 flags
	GL_ZOOM_X and GL_ZOOM_Y factors
	GL_READ_BUFFER setting
GL_POINT_BIT	GL_POINT_SMOOTH flag
	Point size
GL_POLYGON_BIT	GL_CULL_FACE enable bit
	GL_CULL_FACE_MODE value
	GL_FRONT_FACE indicator
	GL_POLYGON_OFFSET_BIAS_EXT setting
	GL_POLYGON_OFFSET_EXT flag
	GL_POLYGON_OFFSET_FACTOR setting
	GL_POLYGON_OFFSET_FACTOR_EXT setting
	GL_POLYGON_OFFSET_FILL flag
	GL_POLYGON_OFFSET_LINE flag
	GL_POLYGON_OFFSET_POINT flag
	GL_POLYGON_OFFSET_UNITS setting
	GL_POLYGON_MODE setting
	GL_POLYGON_SMOOTH flag
	GL_POLYGON_STIPPLE enable bit
GL_POLYGON_STIPPLE_BIT	Polygon stipple image
GL_SCISSOR_BIT	GL_SCISSOR_TEST flag
	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
	Enables for 1D, 2D, and 3D_EXT testures
GL_TRANSFORM_BIT	Coefficients of the six clipping planes
	Enable bits for the user-definable clipping planes
	GL_MATRIX_MODE value
	GL_NORMALIZE flag
GL_VIEWPORT_BIT	Depth range (near and far)
	Viewport origin and extent

The glPopAttrib subroutine restores the values of the state variables saved with the last glPushAttrib subroutine. 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 flag is set, and no other change is made to GL state.

Initially, the attribute stack is empty.

Notes

Not all values for the GL state can be saved on the attribute stack. For example, pixel pack and unpack state, render mode state, and select and feedback state cannot be saved.

The depth of the attribute stack is dependent on the implementation, but it must be at least 16.

Errors

GL_STACK_OVERFLOW	The glPushAttrib subroutine is called while the attribute stack is full.
GL_STACK_UNDERFLOW	The glPopAttrib subroutine is called while the attribute stack is empty.
GL_INVALID_OPERATION	The glPushAttrib subroutine is called between a call to glBegin and the corresponding call to glEnd.

Associated Gets

glGet with argument GL_ATTRIB_STACK_DEPTH

glGet with argument GL_MAX_ATTRIB_STACK_DEPTH.

Files

/usr/include/GL/gl.h

Contains C language constants, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

OpenGL Overview.