N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

guOrtho

Format
#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
What This Function Does
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 January 1998