# G3_Perspective

## C Specification

      #include <nitro/gx/g3_util.h>

      void G3_Perspective(
          fx32        fovySin,
          fx32        fovyCos,
          fx32        aspect,
          fx32        n,
          fx32        f,
          MtxFx44*    mtx );

## Description

This function sets the Matrix mode to the Projection mode and sets the Perspective Projection matrix as the current matrix. When `mtx` is not `NULL`, the Perspective Projection Matrix will also be set in `*``mtx`. This function uses the Divider.

The following is the set matrix:

## Arguments

`fovySin` | Sine value of the field-of-view angle (view angle) in y-direction/2
`fovyCos` | Cosine value of the field-of-view angle (view angle) in y-direction/2
`aspect` | Ratio of width of view field to height of view field (Horizontal to Vertical ratio: View Field Width/View Field Height)
`n` | Distance from eyepoint to the `near` clip plane
`f` | Distance from eyepoint to the `far` clip plane
`mtx` | Pointer to the 4x4 matrix

## Return Values

None

## See Also

`G3_PerspectiveW`, `G3_Frustum`, `G3_Ortho`

## Revision History

01/19/2004 Initial Version