Name

PSGMT3 − Resets the global modeling transformation by specifying a 4 x 4 transformation matrix. 

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

Syntax

PSGMT3 (XFRMT)

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

Description

PSGMT3 resets the global modeling transformation by specifying a 4 x 4 transformation matrix.  Depending on the current edit mode, this function either inserts the new set global transformation 3 element (that contains the value of the transformation matrix) 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 3 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 3 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 set to the specified value of the transformation matrix.  Digital PHIGS uses this value when creating subsequent output primitives. 

•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

PSGMT
PSLMT
PSLMT3