rotate Subroutine

GL3.2 for AIX: Graphics Library (GL) Technical Reference

rotate Subroutine

Purpose

Rotates graphical primitives (fixed-point version).

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void rotate(Angle angle, Char8 axis)

FORTRAN Syntax

SUBROUTINE ROTATE(angle, axis) 
INTEGER*4 angle
CHARACTER*1 axis

Description

The rotate subroutine specifies an angle (angle) and an axis of rotation (axis). The fixed- point angle is given in tenths of a degree according to the right-hand rule.

The rotate subroutine is a modeling routine; it changes the current transformation matrix. All objects drawn after the rotate subroutine executes are rotated. Use the pushmatrix and popmatrix subroutines to preserve and restore unrotated modeling coordinates.

Parameters

angle	Specifies the angle of rotation of an object.
axis	Specifies the relative axis of rotation. There are six values defined for this parameter (the character may be upper- or lowercase):
	x, X indicates the x-axis.
	y, Y indicates the y-axis.
	z, Z indicates the z-axis.

Example

The example C language program backface.c uses the rotate modeling subroutine to alter the current transformation matrix when modelling the sides of a cube using a square.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

/usr/include/gl/gl.h	Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h	Contains FORTRAN constant and variable type definitions for GL.

Related Information

Popping the transformation matrix stack with the popmatrix subroutine.

Pushing down the transformation matrix stack with the pushmatrix subroutine.

Rotating a graphical primitive (floating-point version) with the rot subroutine.

Scaling and mirroring objects with the scale subroutine.

Translating a graphical primitive with the translate subroutine.

AIX Graphics Library Overview and Working with Coordinate Systems.