glPushAttrib(3G)
glPushAttrib, glPopAttrib - push and pop the attribute stack
As shipped in IRIX 6.5. First release of IRIX 6.5.
NAME glPushAttrib, glPopAttrib - push and pop the attribute stack C SPECIFICATION void glPushAttrib( GLbitfield mask ) PARAMETERS mask Specifies a mask that indicates which attributes to save. Values for mask are listed in the table below. C SPECIFICATION void glPopAttrib( void ) 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 GL_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 enable bit RGBA color associated with current raster position Color index associated with current raster position Texture coordinates associated with current raster position GL_EDGE_FLAG enable bit 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 enable bit GL_AUTO_NORMAL enable bit GL_BLEND enable bit GL_CALLIGRAPHIC_FRAGMENT_SGIX enable bit GL_CLIP_PLANEi enable bits GL_COLOR_LOGIC_OP enable bit GL_COLOR_MATERIAL GL_CONVOLUTION_1D_EXT, GL_CONVOLUTION_2D_EXT, and GL_SEPARABLE_2D_EXT enable bits GL_COLOR_TABLE_SGI enable bit GL_CULL_FACE enable bit GL_DEPTH_TEST enable bit GL_DITHER enable bit GL_FOG enable bit GL_HISTOGRAM_EXT enable bit GL_INDEX_LOGIC_OP enable bit GL_INTERLACE_SGIX enable bit GL_LIGHTi where 0 <= i<GL_MAX_LIGHTS GL_LIGHTING enable bit GL_LINE_SMOOTH enable bit GL_LINE_STIPPLE enable bit GL_LOGIC_OP enable bit GL_MAP1_x where x is a map type GL_MAP2_x where x is a map type GL_MINMAX_EXT enable bit GL_MULTISAMPLE_SGIS enable bit GL_NORMALIZE enable bit GL_POINT_SMOOTH enable bit GL_POLYGON_OFFSET_EXT enable bit GL_POLYGON_OFFSET_FILL enable bit GL_POLYGON_OFFSET_LINE enable bit GL_POLYGON_OFFSET_POINT enable bit GL_POLYGON_SMOOTH enable bit GL_POLYGON_STIPPLE enable bit GL_POST_COLOR_MATRIX_COLOR_TABLE_SGI enable bit GL_POST_CONVOLUTION_COLOR_TABLE_SGI enable bit GL_REFERENCE_PLANE_SGIX enable bit GL_SAMPLE_ALPHA_TO_MASK_SGIS enable bit GL_SAMPLE_ALPHA_TO_ONE_SGIS enable bit GL_SAMPLE_MASK_SGIS enable bit GL_SCISSOR_TEST enable bit GL_SPRITE_SGIX enable bit GL_STENCIL_TEST enable bit GL_TEXTURE_1D enable bit GL_TEXTURE_2D enable bit GL_TEXTURE_COLOR_TABLE_SGI enable bit Enable bits 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-D grid endpoints and divisions 2-D 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 Control points for custom fog blending function Number of control points GL_FOG_OFFSET_SGIX enable bit Fog offset parameters 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 enable bit GL_LINE_STIPPLE enable bit Line stipple pattern and repeat counter Line width GL_LIST_BIT GL_LIST_BASE setting GL_MULTISAMPLE_BIT_EXT GL_MULTISAMPLE_SGIS enable bit GL_SAMPLE_ALPHA_TO_MASK_SGIS enable bit GL_SAMPLE_ALPHA_TO_ONE_SGIS enable bit GL_SAMPLE_MASK_SGIS enable bit GL_SAMPLE_MASK_VALUE_SGIS GL_SAMPLE_MASK_INVERT_SGIS GL_SAMPLE_PATTERN_SGIS GL_PIXEL_MODE_BIT GL_RED_BIAS and GL_RED_SCALE values GL_GREEN_BIAS and GL_GREEN_SCALE 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 GL_MAP_COLOR and GL_MAP_STENCIL enable bits GL_ZOOM_X and GL_ZOOM_Y factors GL_READ_BUFFER setting Post-color-matrix scale and bias values GL_COLOR_TABLE_SCALE_SGI and GL_COLOR_TABLE_BIAS_SGI for all color tables GL_CONVOLUTION_1D_EXT, GL_CONVOLUTION_2D_EXT, and GL_SEPARABLE_2D_EXT enable bits Convolution filter scale and bias values Post-convolution pixel scale and bias values Convolution border mode GL_HISTOGRAM_EXT enable bit GL_MINMAX_EXT enable bit GL_INTERLACE_SGIX enable bit GL_POINT_BIT GL_POINT_SMOOTH enable bit Point size GL_POINT_SIZE_MIN_SGIS and GL_POINT_SIZE_MAX_SGIS GL_POINT_FADE_THRESHOLD_SIZE_SGIS GL_DISTANCE_ATTENUATION_SGIS GL_POLYGON_BIT GL_CULL_FACE enable bit GL_CULL_FACE_MODE value GL_FRONT_FACE indicator GL_POLYGON_MODE setting GL_POLYGON_SMOOTH enable bit GL_POLYGON_STIPPLE enable bit GL_POLYGON_OFFSET_EXT enable bit GL_POLYGON_OFFSET_FACTOR_EXT GL_POLYGON_OFFSET_BIAS_EXT GL_POLYGON_OFFSET_FILL enable bit GL_POLYGON_OFFSET_LINE enable bit GL_POLYGON_OFFSET_POINT enable bit GL_POLYGON_OFFSET_FACTOR GL_POLYGON_OFFSET_UNITS GL_POLYGON_STIPPLE_BIT Polygon stipple image GL_SCISSOR_BIT GL_SCISSOR_TEST enable bit 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 target Minification function for each texture target Magnification function for each texture target Texture coordinates and wrap mode for each texture target Color, mode, and bias 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 Detail texture binding, level offset, mode, and scaling function control points Sharp texture scaling function control points GL_TEXTURE_COLOR_TABLE_SGI enable bit GL_TEXTURE_COLOR_TABLE_SCALE_SGI GL_TEXTURE_COLOR_TABLE_BIAS_SGI Current texture bindings (e.g. GL_TEXTURE_2D_BINDING_EXT) Minimum and maximum LOD clamping values Base and maximum mipmap levels Texture filter function weights Dual and quad texture group selection Post-texture filter scale and bias values Clipmap frame size, center, offset, lod offset, depth, and virtual depth Texture comparison operator Texture comparison enable Shadow ambient lighting coefficient GL_TRANSFORM_BIT Coefficients of the six clipping planes GL_CLIP_PLANEi enable bits GL_MATRIX_MODE value GL_NORMALIZE enable bit Coefficients of the reference plane GL_SPRITE_SGIX enable bit Current sprite mode, axis, and translation 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 flag 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, pixel pack and unpack state, render mode state, and select and feedback state cannot be saved. The depth of the attribute stack depends on the implementation, but it must be at least 16. GL_COLOR_LOGIC_OP, GL_INDEX_LOGIC_OP, GL_POLYGON_OFFSET_FILL, GL_POLYGON_OFFSET_LINE and GL_POLYGON_OFFSET_POINT are only available if the GL version is 1.1 or greater. 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. MACHINE DEPENDENCIES GL_COLOR_TABLE_SGI, GL_POST_COLOR_MATRIX_COLOR_TABLE_SGI and GL_POST_CONVOLUTION_COLOR_TABLE_SGI are part of the SGI_color_table extension which is not supported on RealityEngine, RealityEngine2, and VTX systems. On RealityEngine, RealityEngine2, and VTX and High Impact and Maximum Impact systems there is no support for pushing or popping attributes related to detail texturing. The SGIX_interlace extension is supported only on InfiniteReality systems, on RealityEngine, RealityEngine2, and VTX systems, and on O2 systems. RealityEngine, RealityEngine2, and VTX systems have no support for pushing or popping attributes related to sharpen texturing. On InfiniteReality systems, if the post-texture filter scale and bias values are set to values other than the defaults, they are limited to the range [0.0, 1.0). (note: this range excludes 1.0.) The SGIX_texture_scale_bias extension is not supported on RealityEngine, RealityEngine2, and VTX systems or on High Impact and Maximum Impact systems. The SGIS_texture_select extension is supported only on InfiniteReality systems, High Impact and Maximum Impact on Octane systems, and High Impact and Maximum Impact on Indigo2 systems with the TRAM option card. SEE ALSO glGet, glGetClipPlane, glGetError, glGetLight, glGetMap, glGetMaterial, glGetPixelMap, glGetPointerv, glGetPolygonStipple, glGetString, glGetTexEnv, glGetTexGen, glGetTexImage, glGetTexLevelParameter, glGetTexParameter, glIsEnabled