MTXRotTrig

C Specification

#include <revolution.mtx.h>
void C_MTXRotTrig ( Mtx m, u8 axis, f32 sinA, f32 cosA );
void PSMTXRotTrig ( Mtx m, u8 axis, f32 sinA, f32 cosA );

#define MTXRotTrig  C_MTXRotTrig // for debug build
#define MTXRotTrig  PSMTXRotTrig // for nondebug build

Arguments

m New rotation matrix.  m may be either an Mtx or an MtxPtr.
axis one of the major (X, Y, Z ) axes. For convenience, axis is specified as a character, one of the 'X', 'x', 'Y', 'y', 'Z', 'z', as appropriate (must include the single quotation marks).
sinA Sine of rotation angle.
cosA Cosine of rotation angle.

Return Values

None.

Description

Creates a rotation matrix about one of the major (X, Y, Z ) axes.   Counter-clockwise rotations are positive. Rotation values are specified as sines or cosines.

During a debug build, MTXRotTrig is interpreted as C_MTXRotTrig, which is a normal C language version. During a nondebug build for a Broadway processor, the paired-singles equivalent of this function, PSMTXRotTrig, will be automatically substituted. You can also call each of C_MTXRotTrig/PSMTXRotTrig explicitly.

See Also

Mtx, MtxPtr, MTXQuat, MTXRotAxisRad, MTXRotAxisDeg, MTXRotRad, MTXRotDeg

Revision History

2006/03/01 Initial version.


CONFIDENTIAL