Name

PROY − Creates a 3D homogeneous transformation matrix that executes a rotation about the y-axis. 

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

Syntax

PROY (ROTANG, ERRIND, XFRMT)

Argument        Data Type       Access    Description
---------------------------------------------------------------------------
ROTANG          Real            Read      Rotation angle in radians; a
                                          positive number yields a
                                          counterclockwise rotation (when
                                          looking along the positive
                                          y-axis, towards the origin).
ERRIND          Integer         Write     Error indicator.
XFRMT(4,4)      Array of reals  Write     Transformation matrix.
---------------------------------------------------------------------------

Description

PROY creates a three-dimensional (4 x 4) homogeneous transformation matrix that performs the specified rotation about the y-axis.  If a rotation direction is counterclockwise, the rotation value is positive. 

The returned matrix can be passed to functions that require transformation matrices as input, such as the PSLMT3, PSGMT3, and PCOM3 functions.  To store a matrix in a structure element, you must pass it to the PSLMT3 or PSGMT3 function. 

See Also

PBLTM3
PCOM3
PCOTM3
PRO
PROX
PROZ
PSC3
PSGMT3
PSLMT3
PTP3
PTR3