NAME

DoCamera − Create a camera studio object

SYNOPSIS

C:

DtObject DoCamera()

Fortran:

INTEGER∗4 DOCM()

DESCRIPTION

DoCamera creates a camera object.  A camera is a studio object.  It obtains properties only through attribute inheritance and then only during execution of definition objects. 

Cameras obtain their position and orientation through inheritance of the current transformation matrix attribute values.  The inverse of the transformation matrix attribute becomes the camera viewing transformation associated with the active camera.  DoLookAtFrom <DOLAF> is a common mechanism for setting the transformation matrix prior to creating a camera. 

The camera object itself is not visible; only its effects are.  One may have an arbitrary number of cameras per view, but only one camera may be active at a given time (see DvSetActiveCamera).  The active camera is the camera used to render the image in the view. 

DEFAULTS

The default camera model is a perspective camera with a field of view of 90 degrees, and the hither and yon planes at -.01 and -1.0, respectively.  The camera is positioned at the origin, pointing down the Z-axis in the negative direction.  Up is in the direction of the positive Y-axis. 

SEE ALSO

DoCameraMatrix(3D), DoLookAtFrom(3D), DoPerspective(3D), DoParallel(3D), DvInqActiveCamera(3D), DvSetActiveCamera(3D)

September 29, 2021