Low-Level Camera Properties :: Defining the View (3-D Visualization)

3-D Visualization

Low-Level Camera Properties

Camera graphics is based on a group of axes properties that control the position and orientation of the camera. In general, the camera commands make it unnecessary to access these properties directly.

Property
Description

CameraPosition
Specifies the location of the viewpoint in axes units.

CameraPositionMode
In automatic mode, MATLAB determines the position based on the scene. In manual mode, you specify the viewpoint location.

CameraTarget
Specifies the location in the axes pointed to by the camera. Together with the CameraPosition, it defines the viewing axis.

CameraTargetMode
In automatic mode, MATLAB specifies the CameraTarget as the center of the axes plot box. In manual mode, you specify the location.

CameraUpVector
The rotation of the camera around the viewing axis is defined by a vector indicating the direction taken as up.

CameraUpVectorMode
In automatic mode, MATLAB orients the up vector along the positive y-axis for 2-D views and along the positive z-axis for 3-D views. In manual mode, you specify the direction.

CameraViewAngle
Specifies the field of view of the "lens." If you specify a value for CameraViewAngle, MATLAB overrides stretch-to-fill behavior (see Understanding Axes Aspect Ratio).

CameraViewAngleMode
In automatic mode, MATLAB adjusts the view angle to the smallest angle that captures the entire scene. In manual mode, you specify the angle.
Setting CameraViewAngleMode to manual overrides stretch-to-fill behavior.

Projection
Selects either an orthographic or perspective projection.

Property	Description
`CameraPosition`	Specifies the location of the viewpoint in axes units.
`CameraPositionMode`	In `automatic` mode, MATLAB determines the position based on the scene. In `manual` mode, you specify the viewpoint location.
`CameraTarget`	Specifies the location in the axes pointed to by the camera. Together with the `CameraPosition`, it defines the viewing axis.
`CameraTargetMode`	In `automatic` mode, MATLAB specifies the `CameraTarget` as the center of the axes plot box. In `manual` mode, you specify the location.
`CameraUpVector`	The rotation of the camera around the viewing axis is defined by a vector indicating the direction taken as up.
`CameraUpVectorMode`	In `automatic` mode, MATLAB orients the up vector along the positive y-axis for 2-D views and along the positive z-axis for 3-D views. In `manual` mode, you specify the direction.
`CameraViewAngle`	Specifies the field of view of the "lens." If you specify a value for CameraViewAngle, MATLAB overrides stretch-to-fill behavior (see Understanding Axes Aspect Ratio).
`CameraViewAngleMode`	In `automatic` mode, MATLAB adjusts the view angle to the smallest angle that captures the entire scene. In `manual` mode, you specify the angle. Setting `CameraViewAngleMode` to `manual` overrides stretch-to-fill behavior.
`Projection`	Selects either an orthographic or perspective projection.

Example -- Moving the Camera Through a Scene Default Viewpoint Selection