MTXRotAxisRad

C Specification

#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`. (x,y,z) members of `axis` correspond to (x,y,z) components of rotation axis (e.g., (`1,0,0`) specifies 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 perform the rotation about the axis with the (x,y,z) components 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 nondebug build for a Broadway processor, the paired-singles equivalent of this function, PSMTXRotAxisRad, will be automatically substituted. You can also call C_MTXRotAxisRad or PSMTXRotAxisRad explicitly.

Revision History