Name

protate − Creates a 2D homogeneous transformation matrix used to rotate the axes. 

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

Syntax

void protate (
  Pfloat     angle,       /∗ (I) Rotation angle, in radians; a positive
                                 number yields a counterclockwise
                                 rotation ∗/
  Pint      ∗error_ind,   /∗ (O) Error indicator ∗/
  Pmatrix    matrix       /∗ (O) Transformation matrix ∗/
)

Data Structures

typedef Pfloat Pmatrix[3][3];

Description

protate creates a two-dimensional (3 x 3) homogeneous transformation matrix used to perform the specified rotation of the axes.  If a rotation direction is counterclockwise (when viewed from positive z towards negative z), the rotation value is positive. 

The returned matrix can be passed to functions that require transformation matrices as input, such as the pset_local_tran, pset_global_tran, and pcompose_matrix functions.  To store a matrix in a structure element, you must pass it to one of the pset_global_tran or pset_local_tran functions. 

See Also

pbuild_tran_matrix3
pcompose_matrix
pcompose_tran_matrix
protate_x
protate_y
protate_z
pscale
pset_global_tran
pset_local_tran
ptran_point
ptranslate