NAME

DoPerspective − Create a perspective studio attribute object for cameras

SYNOPSIS

C:

DtObject DoPerspective(fov, hither, yon)
DtReal fov, hither, yon;

FORTRAN:

INTEGER∗4 DOPER(FOV, HITHER, YON)
REAL∗8 FOV, HITHER, YON

DESCRIPTION

DoPerspective creates a perspective studio attribute object for cameras.  The parameter fov specifies the frustum of vision angle (field of view).  By default, the frustum of vision is measured in degrees.  You can change the unit of measure to radians by setting DsSetAngleUnits <DSSAU> to DcAngleRadians <DCAR>.  The parameters hither and yon specify the location of the front and the back clipping planes in camera coordinates.  Note that both of these planes must be ahead of the camera.  Because the camera’s location in its own relative coordinate system is always at (0.0, 0.0, 0.0) looking down the negative Z-axis, both hither and yon must be negative. 

ERRORS

DoPerspective will fail if hither is less than or equal to yon. 

[WARNING - value out of range]

DoPerspective will fail if hither is greater than or equal to 0.0. 

[WARNING - value out of range]

SEE ALSO

DoCamera(3D), DoCameraMatrix(3D), DoParallel(3D), DoProjection(3D), DsInqAngleUnits(3D), DsSetAngleUnits(3D)

September 02, 1992