camdolly (MATLAB Functions)

Move the 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 moves the camera position and the camera target by the specified amounts.

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

camdolly(dx,dy,dz,'targetmode') The targetmode argument can take on two values that determine how MATLAB moves the camera:

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

camdolly(dx,dy,dz,'targetmode','coordsys') The coordsys argument can take on three values that determine how MATLAB interprets dx, dy, and dz:

Coordinate Systems

camera (default) -- Move in the camera's coordinate system. dx moves left/right, dy moves down/up, and dz moves along the viewing axis. The units are normalized 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. dz is ignored.
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.

Remarks

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

Examples

This example moves 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, campos, camproj, camtarget, camup, camva

The axes properties CameraPosition, CameraTarget, CameraUpVector, CameraViewAngle, Projection

Controlling the Camera Viewpoint for related functions

See Defining Scenes with Camera Graphics for more information on camera properties.

calendar cameratoolbar