Name

PSGMT − Resets the global modeling transformation by specifying a 3 x 3 transformation matrix. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

Syntax

PSGMT (XFRMT)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
XFRMT(3,3)     Array of       Read       Transformation matrix
               reals
---------------------------------------------------------------------------

Description

PSGMT resets the global modeling transformation by specifying a 3 x 3 transformation matrix.  Depending on the current edit mode, this function either inserts the new structure element (that contains the value of the transformation matrix) into the open structure directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new set global transformation element. 

Initially, the value of the global transformation for the topmost structure of a posted network is that of the identity matrix.  The transformation matrix of the set global transformation structure element replaces the existing global transformation when the element is traversed. 

The element has the following effects during structure traversal:

•The current global modeling transformation entry in the PHIGS traversal state list is combined with the specified 3 x 3 transformation matrix, after expanding the 3 x 3 matrix into a 4 x 4 matrix (see the hardcopy or Bookreader version of the documentation for details). 

•Changes to the global transformation affect structures in which the changes are encountered; parent structures are not affected. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

PSGMT3
PSLMT
PSLMT3