Brief Index      Full Index      Events Index      I.M. Reference

Dolly_Camera


Functions

void Dolly_Camera (double right, double up, double in)

Function Documentation

void Dolly_Camera ( double  right,
double  up,
double  in 
)

One of a set of routines to manipulate one's point of view. "Dolly" moves the "camera" left and right, up and down, or in and out.

Parameters:
right - Distance to move the camera to the right. (Negative numbers move the camera to the left.)
up - Distance to raise the camera. (Negative numbers lower the camera.)
in - Distance to move the camera into the scene. (Negative numbers back the camera away.)

DETAILS

Once the point of view of your scene has been determined (with Set_Camera_Position() , Set_Camera_Target() , Set_Camera_By_Volume() , etc.) there are a number of ways to make adjustments. Dolly_Camera() ("dolly" is a motion picture industry term) trundles the camera to the right. The scene on the screen appears to move left---up, or in. The distances to be moved can be negative. The camera's target gets moved a matching distance, and the field-of-view remains unchanged.

Both Zoom_Camera() and Dolly_Camera() can be used to make what's in front of the camera appear larger. If you want to "focus in" on something without changing the "place you're standing", use Zoom_Camera() rather than Dolly_Camera() . If you want to "walk around" the thing you're looking at, and keep looking at it, use Orbit_Camera() . And if you want to look in a different direction, but not change where your feet are, use Pan_Camera() .

NOTE

If there is no Camera set up already in the segment, Dolly_Camera() will create a default camera (-1 to +1, etc.) and then dolly it. The owning segment's camera is ignored, so it's advisable to always do your camera work in the same segment.

NOTES

RESTRICTIONS

See also:
Set_Camera or Set_Camera_By_Volume, Set_Camera_Field, Set_Camera_Position, Set_Camera_Projection, Set_Camera_Target, Set_Camera_Up_Vector, Zoom_Camera, Orbit_Camera, Pan_Camera, Roll_Camera, Set_Window, Translate_Object, Rotate_Object.

Brief Index      Full Index      Events Index      I.M. Reference