DoPushAtts(3D)

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)