NAME

ROTATE Z − calculate a 3D transformation matrix to perform a specified rotation about the z axis

SYNOPSIS

C Syntax

void
protate_z ( angle, error_ind, m)
Pfloatangle;rotation angle
Pint∗error_ind;OUT error indicator
Pmatrix3m;OUT transformation matrix

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use ROTATE Z to generate a 3D homogeneous (4 × 4) transformation matrix that performs a 3D rotation about the z axis. 

The returned matrix can be passed as an argument to SET LOCAL TRANSFORMATION 3 or SET GLOBAL TRANSFORMATION 3 to modify the modelling transformation that is applied to output primitives during traversal. 

C Input Parameter

angleThe angle of the rotation in radians.  Positive angles indicate counterclockwise rotation, and negative angles indicate clockwise rotation. 

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

mThe 4 × 4 homogeneous transformation matrix that performs the specified rotation.  Pmatrix3 is defined in phigs.h as follows:

typedef  Pfloat  Pmatrix3[4][4];

Execution

ROTATE Z returns the 3D homogeneous (4 × 4) transformation matrix that performs the rotation specified by angle about the z axis.  The rotation is specified in radians and is relative to the origin of the current modelling coordinate system. 

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

SEE ALSO

ROTATE (3P)
SET LOCAL TRANSFORMATION 3 (3P)
BUILD TRANSFORMATION MATRIX 3 (3P)
COMPOSE MATRIX 3 (3P)
TRANSFORM POINT 3 (3P)

September 02, 1992