NAME

DoPushAtts − Create an organizational object that pushes all attributes

SYNOPSIS

C:

DtObject DoPushAtts()

FORTRAN:

INTEGER∗4 DOPUA()

DESCRIPTION

DoPushAtts creates an organizational object that pushes all attributes.  This object saves the local environment of all attributes; the environment is restored with DoPopAtts <DOPPA>. 

DoPushAtts and DoPopAtts <DOPPA> act as a team to create a local environment of attributes that may be saved and restored.  DoPushAtts effectively pushes onto a local stack any attributes that could be modified by objects between its location in the regular group and a subsequent DoPopAtts object.  Execution of the DoPopAtts <DOPPA> object restores the values from the stack of all attributes values that were pushed.  DoPushAtts and DoPopAtts <DOPPA> objects may be nested; however, DoPushAtts and DoPopAtts <DOPPA> will not work across group boundaries. 

During execution, regular groups act as if they performed a DoPushAtts before their execution starts and a DoPopAtts <DOPPA> when they are exited.  Inline groups behave differently; see DoInLineGroup.  When a group is closed, all DoPushAtts still in effect are popped. 

SEE ALSO

DoGroup(3D), DoInLineGroup(3D), DoPopAtts(3D), DoPopMatrix(3D), DoPushMatrix(3D)

September 02, 1992