[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

ROTATE (PHOP,*,*,*)

Purpose

Use Rotate to calculate a two-dimensional transformation matrix to perform the specified 2D-axis rotation.

If the graPHIGS API can compute the transformation matrix, then the graPHIGS API sets the error indicator to zero and returns the transformation matrix. If the graPHIGS API cannot compute the transformation matrix, then the values of the matrix are unpredictable and the graPHIGS API sets the error indicator to the following error:

2
Function Requires State (PHOP,*,*,*)

Language Bindings

C

protate (angle, err_ind, result_tran)

Input Parameters

Pfloat angle
Rotational angle in radians (positive if counterclockwise).

Output Parameters

Pint *err_ind
Error indicator.

Pmatrix result_tran
Transformation matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).

FORTRAN

PRO (rotang, errind, xfrmt)

Input Parameters

real rotang
Rotational angle in radians (positive if counterclockwise).

Output Parameters

integer errind
Error indicator.

real xfrmt(3,3)
Transformation matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).

Errors

None

Related Subroutines

  • None

    • [ Previous | Next | Contents | Glossary | Home | Search ]