camorbit

Syntax

Description

camorbit(dtheta,dphi) rotates
the camera position around the camera target by the amounts specified
in dtheta and dphi (both in
degrees). dtheta is the horizontal rotation and dphi is
the vertical rotation.

camorbit(dtheta,dphi,'coordsys') rotates
the camera position around the camera target, using the coordsys argument
to determine the center of rotation. coordsys can
take on two values:

data (default) — Rotate
the camera around an axis defined by the camera target and the direction (default
is the positive z direction).

camera — Rotate the camera
about the point defined by the camera target.

camorbit(dtheta,dphi,'coordsys','direction')
defines the axis of rotation for the data coordinate system using the
direction argument in conjunction with the camera target. Specify
direction as a three-element vector containing the
x-, y-, and
z-components of the direction or one of the options,
x, y, or z, to indicate
[1 0 0], [0 1 0], or [0 0
1] respectively.

camorbit(axes_handle,...) operates
on the axes identified by the first argument, axes_handle.
When you do not specify an axes handle, camorbit operates
on the current axes.

The behavior of camorbit differs
from the rotate3d function
in that while the rotate3d tool modifies the View property
of the axes, the camorbit function fixes the aspect
ratio and modifies the CameraTarget, CameraPosition,
and CameraUpVector properties
of the axes. See Axes Properties for
more information on all axes properties.

Examples

Rotate Camera Horizontally

Rotate the camera horizontally about a line defined by the camera target point and a direction that is parallel to the y-axis. Visualize this rotation as a cone formed with the camera target at the apex and the camera position forming the base.