Name

PSLMT3 − Resets the local modeling transformation by specifying a 4 x 4 transformation matrix and a composition type. 

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

Syntax

PSLMT3 (XFRMT, CTYPE)

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

Constants

Defined Argument      Constant      Description
---------------------------------------------------------------------------
CTYPE                 PCPRE         Matrix preconcatenate
                                    (local <- local ∗ matrix)
                      PCPOST        Matrix postconcatenate
                                    (local <- matrix ∗ local)
                      PCREPL        Matrix replace
                                    (local <- matrix)
---------------------------------------------------------------------------

Description

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

The PSLMT3 function inserts a modeling transformation into the open structure.  It has the following effects during structure traversal:

•The current local modeling transformation entry in the PHIGS traversal state list is combined with the specified 4 x 4 transformation matrix.  The composition method used depends on the specified value of the enumerated type: PCPRE, PCPOST, or PCREPL. 

•The current local modeling transformation entry in the PHIGS traversal state list is set to the result of the matrix composition.  Digital PHIGS uses this value when creating subsequent output primitives. 

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

See Also

PBLTM3
PSGMT3
PSLMT
PSVWR3
PTP3