cameratoolbar

Control camera toolbar programmatically

Syntax

cameratoolbar

cameratoolbar(state)

cameratoolbar(reset)

cameratoolbar("SetMode",mode)

cameratoolbar("SetCoordSys",coordsys)

cameratoolbar(fig,___)

tb = cameratoolbar(___)

tf = cameratoolbar("GetVisible")

m = cameratoolbar("GetMode")

p = cameratoolbar("GetCoordSys")

___ = cameratoolbar(fig,___)

Description

Display Camera Toolbar

cameratoolbar displays a camera toolbar in the current figure that enables interactive manipulation of the camera axes and light. If no figure is available, then MATLAB^® calls the figure function to create one. Interacting with the camera toolbar disables the default set of interactions built into axes in the figure.

Showing the camera toolbar automatically changes the aspect ratio of the axes in the figure to avoid distortion as you move the camera around the scene. Hiding the toolbar does not revert the impacted Axes properties.

Set Camera Toolbar Parameters

cameratoolbar(state) sets the visibility of the camera toolbar.

cameratoolbar(reset) resets the current camera, scene light, or target to the state before interactions began.

cameratoolbar("SetMode",mode) sets the camera motion control mode.

cameratoolbar("SetCoordSys",coordsys) sets the principal axis of camera motion.

cameratoolbar(fig,___) sets parameters for the camera toolbar in the specified figure. Specify the figure before any of the input argument combinations in the previous syntaxes.

tb = cameratoolbar(___) returns the Toolbar object.

Get Camera Toolbar Parameters

tf = cameratoolbar("GetVisible") returns the visibility of the camera toolbar in the current figure (1 if visible, 0 if not visible).

m = cameratoolbar("GetMode") returns the current camera motion control mode.

p = cameratoolbar("GetCoordSys") returns the current principal axis of camera motion.

___ = cameratoolbar(fig,___) gets parameters for the camera toolbar in the specified figure.

Examples

Display Camera Toolbar on Figure

Create a surface plot in a figure. To display the camera toolbar, set the figure's ToolBar property to "figure" and call the cameratoolbar function.

fig = figure;
surf(peaks)
fig.ToolBar = "figure";
cameratoolbar(fig)

Set the camera toolbar mode to "zoom" by using "SetMode".

cameratoolbar(SetMode="zoom")

Input Arguments

state — Toolbar visibility state

"show" | "hide" | "toggle" | "close"

Toolbar visibility state, specified as one of these values:

• "show" — Show the camera toolbar.

• "hide" — Hide the camera toolbar.

• "toggle" — Toggle the camera toolbar visibility between the "show" and "hide" states.

• "close" — Remove the camera toolbar from the figure.

reset — Reset option

"ResetCameraAndSceneLight" | "ResetCamera" | "ResetSceneLight" | "ResetTarget" | "NoReset"

Reset option to the default state, specified as one of these values:

• "ResetCameraAndSceneLight" — Reset the current camera and scene light.

• "ResetCamera" — Reset the current camera.

• "ResetSceneLight" — Reset the current scene light.

• "ResetTarget" — Reset the current target.

• "NoReset" — Do not set the state of any camera controls. This option is valid only for figures created with the figure function.

Alternatively, you can reset the camera and scene light using the toolbar, by clicking the corresponding button.

mode — Camera motion control mode

"orbit" | "orbitscenelight" | "pan" | "dollyhv" | "dollyfb" | "zoom" | "roll" | "nomode"

Camera motion control mode, specified as one of these values:

• "orbit" — Orbit camera.

• "orbitscenelight" — Orbit scene light.

• "pan" — Pan or tilt camera.

• "dollyhv" — Move camera horizontally or vertically.

• "dollyfb" — Move camera forward or back.

• "zoom" — Zoom camera.

• "roll" — Roll camera.

• "nomode" — No camera mode.

For more information about the various modes, see Control View Using Camera Tools.

Alternatively, you can set the camera mode using the toolbar, by clicking the corresponding button.

coordsys — Principal axis of camera motion

"x" | "y" | "z" | "none"

Principal axis of camera motion, specified as one of these values:

• "x" — Principal axis x

• "y" — Principal axis y

• "z" — Principal axis z

• "none" — No principal axis

For more information about the principal axes, see Control View Using Camera Tools.

Alternatively, you can set the principal axis using the toolbar, by clicking the corresponding button.

fig — Target figure

Figure object

Target figure, specified as a Figure object.

Output Arguments

tf — Camera toolbar visibility

1 | 0

Camera toolbar visibility, returned as 1 or 0 of data type logical. If the camera toolbar is visible, tf is logical 1 (true). Otherwise, tf is logical 0 (false).

m — Camera motion control mode

character vector

Camera motion control mode, returned as a character vector. See the mode input argument for the list of possible values.

p — Principal axis of camera motion

character vector

Principal axis of camera motion, returned as a character vector. See the coordsys input argument for the list of possible values.

tb — Camera toolbar

Toolbar object

Camera toolbar, returned as a Toolbar object.

Version History

Introduced before R2006a

R2022b: Visual toolbar support for figures created with the uifigure function

Syntaxes that make the visual toolbar interface visible are now supported by figures created with the uifigure function. Previously, figures created with the uifigure function supported only syntaxes that did not directly make the toolbar visible. Now, the visual camera toolbar interface and all syntaxes are supported by figures and UI figures.

R2022a: Syntax support for figures created with the uifigure function

Syntaxes that do not directly make the visual camera toolbar interface visible are now supported by figures created with the uifigure function. Previously, only figures created with the figure function supported controlling the camera toolbar programmatically.