Name

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

void pset_global_tran (
  Pmatrix    xform   /∗ (I) Transformation matrix ∗/
)

Data Structures

typedef Pfloat Pmatrix[3][3];

Description

pset_global_tran 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

pset_global_tran3
pset_local_tran
pset_local_tran3