MTXRotAxisRad

Syntax

#include <revolution/mtx.h>

void C_MTXRotAxisRad ( Mtx m, VecPtr axis, f32 rad );
void PSMTXRotAxisRad ( Mtx m, VecPtr axis, f32 rad );

#define MTXRotAxisRad  C_MTXRotAxisRad // for debug build
#define MTXRotAxisRad  PSMTXRotAxisRad // for nondebug build

Arguments

m   New rotation matrix. m may be an Mtx or an MtxPtr.
axis Pointer to a Vec containing the components of the rotation axis.  axis may also be a Point3dPtr. The (x,y,z) members of axis correspond to the (x,y,z) components of the rotation axis. For example, (1,0,0) indicates a rotation about the X axis. axis does not have to be a unit vector.
rad Rotation angle in radians. Counter-clockwise rotations are positive.

Return Values

None.

Description

Sets the matrix to be rotated around the axis having the (x,y,z) component specified by axis. Counter-clockwise rotations are positive.

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

See Also

Mtx, MtxPtr, Vec, VecPtr, MTXQuat, MTXRotRad, MTXRotTrig

Revision History

2006/03/01 Initial version.


CONFIDENTIAL