MTXFrustum

C Specification

#include <revolution/mtx.h>
void MTXFrustum (
    Mtx44 m,
    f32   t,
    f32   b,
    f32   l,
    f32   r,
    f32   n,
    f32   f );

Arguments

m New 4x4 parallel projection matrix. m may be either a Mtx44 or a Mtx44Ptr..
t Top edge of view volume at the near clipping plane.
b Bottom edge of view volume at the near clipping plane.
l Left edge of view volume at the near clipping plane.
r Right edge of view volume at the near clipping plane.
n Positive distance to near clipping plane.
f Positive distance to far clipping plane.

Return Values

None.

Description

Sets a 4×4 perspective projection matrix from viewing volume dimensions. This matrix is used by the GX API to convert points to screen space.

For typical perspective projections, the axis of projection is the -z axis, so t = positive, b = -t, r = positive, l = -r. n and f must both be positive values representing the distance to the near and far clipping planes, respectively.

Note: m must possess a negative "Z" value in order to make converted points visible after projection in view space.

See Also

Mtx44, Mtx44Ptr, MTXOrtho, MtxPerspective 

Revision History

03/01/2006 Initial version.