Name

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

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

Syntax

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

Data Structures

typedef Pfloat Pmatrix3[4][4];

Description

protate_x creates a three-dimensional (4 x 4) homogeneous transformation matrix that performs the specified rotation about the x-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 pset_local_tran3, pset_global_tran3, and pcompose_matrix3 functions.  To store a matrix in a structure element, you must pass it to the pset_local_tran3 or pset_global_tran3 function. 

See Also

pbuild_tran_matrix3
pcompose_matrix3
pcompose_tran_matrix3
protate
protate_y
protate_z
pscale3
pset_global_tran3
pset_local_tran3
ptran_point3
ptranslate3