[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
OpenGL 1.2 for AIX: Reference Manual

gluPerspective Subroutine

Purpose

Sets up a perspective projection matrix.

Library

OpenGL C bindings library: libGL.a

C Syntax

void gluPerspective(GLdouble fovy, 
   GLdouble aspect, 
   GLdouble zNear, 
   GLdouble zFar)

Description

The gluPerspective subroutine specifies a viewing frustum into the world coordinate system. Generally, the aspect used with this subroutine should match that of its associated viewport. For example, an aspect ratio value of aspect=2.0 means the viewer's angle of view is twice as wide in x as it is in y. If the viewport is twice as wide as it is tall, it displays the image without distortion.

The matrix generated by the gluPerspective subroutine is multiplied by the current matrix just as if the glMultMatrix subroutine were called with the generated matrix. To load the perspective matrix onto the current matrix stack instead, precede the call to gluPerspective with a call to the glLoadIdentity subroutine.

Given f defined as follows:

f = cotangent(fovy/2)

The generated matrix is

                   (     f                                  )
                   |  ------   0       0            0       |
                   |  aspect                                |
                   |                                        |
                   |                                        |
                   |     0     f       0            0       |
                   |                                        |
                   |                                        |
                   |               zFar+zNear  2*zFar*zNear |
                   |     0     0   ----------  ------------ |
                   |               zNear-zFar   zNear-zFar  |
                   |                                        |
                   |                                        |
                   |     0     0      -1            0       |
                   (                                        )

Parameters

fovy Specifies the field of view angle (in degrees) in the y direction.
aspect Indicates the aspect ratio. This value determines the field of view in the x direction and is the ratio of x (width) to y (height).
zNear Specifies the distance from the viewer to the closest clipping plane. This value must be positive.
zFar Specifies the distance from the viewer to the farthest clipping plane. This value must be positive.

Notes

Depth buffer precision is affected by the values specified for zNear and zFar. The greater the ratio of zFar to zNear is, the less effective the depth buffer will be at distinguishing between surfaces that are near each other. If

r = zFar/zNear

roughly log2(r) bits of depth buffer precision are lost. Because r approaches infinity as zNear approaches 0, zNear must never be set to 0.

Files

/usr/include/GL/gl.h Contains C language constraints, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The glFrustum subroutine, glLoadIdentity subroutine, glMultMatrix subroutine, gluOrtho2D subroutine.

OpenGL Overview.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]