NAME

ROTATE − calculate a 2D transformation matrix to perform a specified 2D rotation

SYNOPSIS

C Syntax

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

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use ROTATE to generate a 2D homogeneous (3 × 3) transformation matrix that performs a 2D rotation. 

The returned matrix may be passed as an argument to SET LOCAL TRANSFORMATION or SET GLOBAL TRANSFORMATION 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 3 × 3 transformation matrix that performs the specified rotation.  Pmatrix is defined in phigs.h as follows:

typedef  Pfloat  Pmatrix[3][3];

Execution

ROTATE returns a 2D homogeneous (3 × 3) transformation matrix that performs the rotation specified by angle.  The rotation is specified in radians.  The rotation is relative to the origin of the current modelling coordinate system. 

ERRORS

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

SEE ALSO

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

September 02, 1992