# G3_PerspectiveW

## C Specification

      #include <nitro/gx/g3_util.h>

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

## Description

This function sets the Matrix mode to the Projection mode and sets the Perspective Projection matrix to the current matrix. If mtx is not NULL, this function also sets a perspective projection matrix to *mtx. This function uses the Divider.

The diagram shows the matrix that is set.

X scaleW

## Arguments

`fovySin` | Sine of the angle of the vertical (y) field of view (view angle)/ 2
`fovyCos` | Cosine of the angle of the vertical (y) field of view (view angle)/ 2
`aspect` | The ratio of the width / height of the field of view (aspect ratio: w/h of the field of view)
`n` | Distance from the eyepoint to the near clipping plane
`f` | Distance from the eyepoint to the far clipping plane
`scaleW` | Fine adjustment parameter for the view volume
`mtx` | Pointer to a 4x4 matrix

## Return Values

None

## See Also

`G3_Perspectve`, `G3_FrustumW`, `G3_OrthoW`

## Revision History

04/27/2004 Initial Version