Control camera toolbar programmatically
Display Camera Toolbar
cameratoolbar displays a camera toolbar in the current figure
that enables interactive manipulation of the axes camera 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
Set Camera Toolbar Parameters
cameratoolbar( sets the visibility of
the camera toolbar.
cameratoolbar( resets the current
camera, scene light, or target to the state before interactions began.
the principal axis of camera motion.
parameters for the camera toolbar in the specified figure. Specify the figure before any
of the input argument combinations in the previous syntaxes.
Get Camera Toolbar Parameters
visibility of the camera toolbar in the current figure (
tf = cameratoolbar("GetVisible")
1 if visible,
0 if not visible).
current camera motion control mode.
m = cameratoolbar("GetMode")
current principal axis of camera motion.
p = cameratoolbar("GetCoordSys")
Display Camera Toolbar in Figure
Create a figure and add a camera toolbar to the figure. Note that you can also display the camera toolbar by selecting Camera Toolbar from the View menu of the figure window. The camera toolbar appears below the default figure toolbar.
fig = figure; tb = cameratoolbar(fig);
Set the camera toolbar mode to zoom by using
state — Toolbar visibility state
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
"close"— Remove the camera toolbar from the figure.
reset — Reset option
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
Alternatively, you can reset the camera and scene light using the toolbar, by clicking the corresponding button.
mode — Camera motion control mode
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 Camera Toolbar.
Alternatively, you can set the camera mode using the toolbar, by clicking the corresponding button.
coordsys — Principal axis of camera motion
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 Camera Toolbar.
Alternatively, you can set the principal axis using the toolbar, by clicking the corresponding button.
fig — Target figure
Target figure, specified as a
tf — Camera toolbar visibility
Camera toolbar visibility, returned as
of data type
logical. If the camera toolbar is visible,
tf is logical
tf is logical
m — Camera motion control mode
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
Principal axis of camera motion, returned as a character vector. See the
coordsys input argument for the list of possible values.
tb — Camera toolbar
Camera toolbar, returned as a
Version HistoryIntroduced before R2006a
R2022b: Visual toolbar support for figures created with the
Syntaxes that make the visual toolbar interface visible are now supported by figures
created with the
uifigure function. Previously, figures created with
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
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.