Learn more about MATLAB

camdolly - Move camera position and target

Syntax

camdolly(dx,dy,dz) camdolly(dx,dy,dz,'targetmode') camdolly(dx,dy,dz,'targetmode','coordsys') camdolly(axes_handle,...)

Description

camdolly(dx,dy,dz) moves the camera position and the camera target by the specified amounts dx, dy, and dz.

camdolly(dx,dy,dz,'targetmode') uses the targetmode argument to determine how the camera moves:

movetarget (default) — Move both the camera and the target.
fixtarget — Move only the camera.

camdolly(dx,dy,dz,'targetmode','coordsys') uses the coordsys argument to determine how MATLAB interprets dx, dy, and dz:

camera (default) — Move in the coordinate system of the camera. dx moves left/right, dy moves down/up, and dz moves along the viewing axis. MATLAB normalizes the units to the scene.
For example, setting dx to 1 moves the camera to the right, which pushes the scene to the left edge of the box formed by the axes position rectangle. A negative value moves the scene in the other direction. Setting dz to 0.5 moves the camera to a position halfway between the camera position and the camera target.
pixels — Interpret dx and dy as pixel offsets and ignore dz.
data — Interpret dx, dy, and dz as offsets in axes data coordinates.

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

camdolly sets the axes CameraPosition and CameraTarget properties, which in turn sets the CameraPositionMode and CameraTargetMode properties to manual.

Examples

Move the camera along the x- and y-axes in a series of steps:

surf(peaks)
axis vis3d
t = 0:pi/20:2*pi;
dx = sin(t)./40;
dy = cos(t)./40;
for i = 1:length(t);
    camdolly(dx(i),dy(i),0)
    drawnow
end

How To

Defining Scenes with Camera Graphics

callSoapService

cameratoolbar

Recommended Products

Get MATLAB trial software

Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.

Get the Interactive Kit