camtarget (MATLAB Function Reference)

Set or query the location of the camera target

camtarget
camtarget([camera_target])
camtarget('mode')
camtarget('auto')
camtarget('manual')
camtarget(axes_handle,...)

Description

The camera target is the location in the axes that the camera points to. The camera remains oriented towards this point regardless of its position.

camtarget

with no arguments returns the location of the camera target in the current axes.

camtarget([camera_target])

sets the camera target in the current axes to the specified value. Specify the target as a three-element vector containing the x-, y-, and z-coordinates of the desired location in the data units of the axes.

camtarget('mode')

returns the value of the camera target mode, which can be either auto (the default) or manual.

camtarget('auto')

sets the camera target mode to auto.

camtarget('manual')

sets the camera target mode to manual.

camtarget(axes_handle,...)

performs the set or query on the axes identified by the first argument, axes_handle. When you do not specify an axes handle, camtarget operates on the current axes.

Remarks

camtarget sets or queries values of the Axes object Cameratarget and CameraTargetMode properties.

When the camera target mode is auto, MATLAB positions the camera target at the center of the axes plot box.

Examples

This example moves the camera position and the camera target along the x-axis in a series of steps:

surf(peaks); 
axis vis3d
xp = linspace(-150,40,50);
xt = linspace(25,50,50);
for i=1:50
     campos([xp(i),25,5]);
     camtarget([xt(i),30,0])
     drawnow
end