Name

PCOTM3 − Returns a 3D homogeneous transformation matrix. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function
 

Syntax

PCOTM3 (XFRMTI, X0, Y0, Z0, DX, DY, DZ, PHIX, PHIY, PHIZ, FX, FY, FZ,
ERRIND, XFRMTO)

Argument       Data Type        Access   Description
---------------------------------------------------------------------------
XFRMTI(4,4)    Array of reals   Read     Transformation matrix
X0, Y0, Z0     Real             Read     Fixed point
DX, DY, DZ     Real             Read     Shift vector
PHI            Real             Read     Rotation angle, in radians
FX, FY, FZ     Real             Read     Scale factor vector
ERRIND         Integer          Write    Error indicator
XFRMTO(4,4)    Array of reals   Write    Modified transformation matrix
---------------------------------------------------------------------------

Description

PCOTM3 returns a three-dimensional (4 x 4) homogeneous transformation matrix.  Digital PHIGS multiplies the input matrix (A) times the resultant transformation matrix (R) from the specified fixed point, shift, scale values, and rotations.  The result is A x R.  The order of the transformation is as follows:

1Scale (relative to the specified fixed point)

2Rotate (relative to the specified fixed point)

3Shift (move)

To store a matrix in a structure element, you must pass it to the PSLMT3 or PSGMT3 function. 

See Also

PBLTM3
PCOM3
PCOTM
PROX
PROY
PROZ
PSC3
PSGMT3
PSLMT3
PTR3