camdolly - Move camera position and target

Syntax

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

See Also

axes | Axes CameraPosition property | Axes CameraTarget property | Axes CameraUpVector property | Axes CameraViewAngle property | Axes Projection property | campos | camproj | camtarget | camup | camva

How To

• Defining Scenes with Camera Graphics

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS