guOrtho

Syntax

#include "gu.h"
void guOrtho(Mtx m,
   float l, float r,
   float b, float t,
   float n, float f,
   float scale)

Arguments

• m is the resulting 4x4 projection matrix

• l,r specify the left and right vertical clipping planes

• b,t specify the bottom and top horizontal clipping planes

• n,f specify the near and far clipping planes (z-planes in world space)

• scale is the scale for each element of the matrix. It can be used to improve precision in the RSP fixed point arithmetic

Explanation
It computes and returns an orthographic 4x4 fixed-point projection matrix for an orthographic parallel viewing volume. The near clipping plane is a rectangle with the lower-left corner at (l, b, -n) and the upper-right corner at (r, t, -n). The far clipping plane is a rectangle with corners at (l, b, -f) and (r, t, -f). Both near and far (n and f) can be positive or negative. For a detailed description of the fixed-point matrix format, see gSPMatrix.

Note
The near and far planes are specified slightly differently here than they are in the guPerspective function. Here they represent z-planes in world space; in guPerspective they are distances that are always positive.

Larger separations between the near and far planes decrease the z resolution for Z-Buffering.

See Also
guOrthoF
guFrustum
guPerspective
guLookAt
gSPMatrix
glOrtho(3G)

Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility. Copyright © 1998 Nintendo of America Inc. All rights reserved Nintendo and N64 are registered trademarks of Nintendo Last Updated April, 1999