MATLAB Function Reference |

Move the camera position and target

**Syntax**

camdolly(dx,dy,dz) camdolly(dx,dy,dz,'

') camdolly(dx,dy,dz,'*targetmode*

','*targetmode*

') camdolly(axes_handle,...)*coordsys*

**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,'`

The

')
*targetmode*

argument can take on two values that determine how MATLAB moves the camera:*targetmode*

`camdolly(dx,dy,dz,'`

The

','*targetmode*

')
*coordsys*

argument can take on three values that determine how MATLAB interprets *coordsys*`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 |

© 1994-2005 The MathWorks, Inc.