Dolly_Camera

Functions
void	Dolly_Camera (double right, double up, double in)
void	QDolly_Camera (const char *segment, 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.

void QDolly_Camera	(	const char *	segment,
		double	right,
		double	up,
		double	in
	)

Similar to Dolly_Camera(), but operates on a given segment rather than the currently open one.

Parameters:

	segment	- Name of the segment(s) to be changed. "?Picture" is typi cally used.
	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

No additional details. See Dolly_Camera()