# 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:4*pi; dx = sin(t)./40; dy = cos(t)./40; for i = 1:length(t); camdolly(dx(i),dy(i),0) drawnow end```