Introduction

Getting Started

Programming Guides

API Reference

Additional Resources

Dolly_Camera

Functions

void DDolly_Camera (double x_dir, double up, double in)
 Similar to Dolly_Camera(), but operates on double-precision cameras. More...
 
void Dolly_Camera (double x_dir, 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. More...
 

Detailed Description

Function Documentation

void DDolly_Camera ( double  x_dir,
double  up,
double  in 
)

Similar to Dolly_Camera(), but operates on double-precision cameras.

Parameters
x_dir- Distance to move the camera in the x-direction.
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.)
void Dolly_Camera ( double  x_dir,
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
x_dir- Distance to move the camera in the x-direction.
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 in the direction you specify. The scene on the screen appears to move in the opposite direction. 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.