MTXRotRad

Syntax

#include <revolution/mtx.h>

void C_MTXRotRad ( Mtx m, u8 axis, f32 rad );
void PSMTXRotRad ( Mtx m, u8 axis, f32 rad );

#define MTXRotRad  C_MTXRotRad // for debug build
#define MTXRotRad  PSMTXRotRad // for nondebug build

Arguments

m New rotation matrix. The type of m is either Mtx or MtxPtr.
axis One of the major axes (X, Y, Z). For convenience, axis is passed in as a character, one of 'X', 'x', 'Y', 'y', 'Z' and 'z', as appropriate (must include the single quotation marks).
rad Rotation angle in radians. Counter-clockwise rotations are positive.

Return Values

None.

Description

Creates a rotation matrix about one of the major axes (X, Y, Z). Counter-clockwise rotations are positive.

During a debug build, the MTXRotRad function is parsed as C_MTXRotRad, which is a normal C language version. During a non-debug build for a Broadway processor, the paired-singles equivalent of this function, PSMTXRotRad, will be automatically substituted. You can also call C_MTXRotRad and PSMTXRotRad explicitly.

See Also

Mtx, MtxPtr, MTXQuat, MTXRotAxisRad, MTXRotTrig

Revision History

2006/03/01 Initial version.


CONFIDENTIAL