MTXRotRad

C Specification

#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.  m may be an Mtx or an MtxPtr.
axis One of the major (X, Y, Z ) axes. For convenience, axisis passed in as a character, one of 'X', 'x', 'Y', 'y', 'Z', '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 (X, Y, Z ) axes. Counter-clockwise rotations are positive.

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

See Also

Mtx, MtxPtr, MTXQuat, MTXRotAxisRad, MTXRotTrig

Revision History

03/01/2006 Initial version.