NAME

DoPopMatrix − Create an organizational object that pops a matrix

SYNOPSIS

C:

DtObject DoPopMatrix()

FORTRAN:

INTEGER∗4 DOPPMX()

DESCRIPTION

DoPopMatrix creates an organizational object that pops the current transformation matrix stack.  This object restores a local environment of geometric transformations saved with DoPushMatrix <DOPUMX>.  See DoPushMatrix for details on using these functions. 

ERRORS

DoPopMatrix will generate a warning if it is invoked in a group without a corresponding DoPushMatrix <DOPUMX>. 

This warning is generated during traversal of the database, not during creation of the object.  The warning will not occur when the initial code that creates the object is executed; rather the warning will occur when a display update or other traversal occurs. 

[WARNING - cannot pop matrix]

SEE ALSO

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

September 02, 1992