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

ROTATE Z (PHOP,*,*,*)

Purpose

Use Rotate Z to calculate a three-dimensional transformation matrix to rotate around the z-axis using a given angle of 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_z (angle, err_ind, result_tran)

Input Parameters

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

Output Parameters

Pint *err_ind
Error indicator.

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

FORTRAN

PROZ (rotang, errind, xfrmt)

Input Parameters

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

Output Parameters

integer errind
Error indicator.

real xfrmt(4,4)
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 ]