Name

pset_local_tran3 − 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

void pset_local_tran3 (
  Pmatrix3          xform,           /∗ (I) Transformation matrix ∗/
  Pcompose_type     compose_type     /∗ (I) Composition type ∗/
)

Data Structures

typedef  Pfloat  Pmatrix3[4][4];
typedef enum {
    PTYPE_PRECONCAT,   /∗ matrix preconcatenate
                          (local <- local ∗ matrix) ∗/
    PTYPE_POSTCONCAT,  /∗ matrix postconcatenate
                          (local <- matrix ∗ local) ∗/
    PTYPE_REPLACE      /∗ matrix replace
                          (local <- matrix) ∗/
} Pcompose_type;

Description

pset_local_tran3 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 pset_local_tran3 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: PTYPE_PRECONCAT, PTYPE_POSTCONCAT, or PTYPE_REPLACE. 

•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

pbuild_tran_matrix3
pset_global_tran3
pset_local_tran
pset_view_rep3
ptran_point3