cameratoolbar

以编程方式控制相机工具栏

全页折叠

    语法

    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,___)

    说明

    显示相机工具栏

    cameratoolbar 在当前图窗中显示相机工具栏，该工具栏支持相机坐标轴和灯光的交互式操作。如果没有可用的图窗，则 MATLAB® 调用 figure 函数来创建一个图窗。与相机工具栏交互会禁用图窗中坐标区内置的默认交互集。

    显示相机工具栏会自动更改图窗中坐标区的纵横比，以避免在场景中移动相机时发生失真。隐藏该工具栏不会还原受影响的 Axes 属性。

    设置相机工具栏参数

    cameratoolbar(state) 设置相机工具栏的可见性。

    cameratoolbar(reset) 将当前相机、场景灯光或目标重置为交互开始前的状态。

    cameratoolbar("SetMode",mode) 设置相机移动控制模式。

    示例

    cameratoolbar("SetCoordSys",coordsys) 设置相机移动的主轴。

    cameratoolbar(fig,___) 为指定图窗中的相机工具栏设置参数。在上述语法中，在任何输入参量组合之前指定图窗。

    示例

    tb = cameratoolbar(___) 返回 Toolbar 对象。

    获取相机工具栏参数

    tf = cameratoolbar("GetVisible") 返回当前图窗中相机工具栏的可见性（1 表示可见，0 表示不可见）。

    m = cameratoolbar("GetMode") 返回当前相机移动控制模式。

    p = cameratoolbar("GetCoordSys") 返回相机移动的当前主轴。

    ___ = cameratoolbar(fig,___) 获取指定图窗中相机工具栏的参数。

    示例

    全部折叠

    在图窗中创建一个曲面图。要显示相机工具栏，请将图窗的 ToolBar 属性设置为 "figure" 并调用 cameratoolbar 函数。

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

    Top portion of a figure window that displays a figure toolbar and a camera toolbar

    使用 "SetMode" 将相机工具栏模式设置为 "zoom"。

    cameratoolbar(SetMode="zoom")

    Top portion of a figure window that displays a figure toolbar and a camera toolbar. The camera toolbar has the Zoom Camera button depressed.

    输入参数

    全部折叠

    工具栏可见性状态，指定为下列值之一：

    • "show" - 显示相机工具栏。

    • "hide" - 隐藏相机工具栏。

    • "toggle" - 在 "show" 和 "hide" 状态之间切换相机工具栏的可见性。

    • "close" - 从图窗中删除相机工具栏。

    将选项重置为其默认状态，指定为以下值之一：

    • "ResetCameraAndSceneLight" - 重置当前相机和场景灯光。

    • "ResetCamera" - 重置当前相机。

    • "ResetSceneLight" - 重置当前场景灯光。

    • "ResetTarget" - 重置当前目标。

    • "NoReset" - 不设置任何相机控制的状态。此选项仅对使用 figure 函数创建的图窗有效。

    也可以通过点击对应的按钮，使用工具栏重置相机和场景灯光。

    相机移动控制模式，指定为以下值之一：

    • "orbit" - 环移相机。

    • "orbitscenelight" - 环移场景灯光。

    • "pan" - 平转或纵转相机。

    • "dollyhv" - 平移或纵移相机。

    • "dollyfb" - 前移或后移相机。

    • "zoom" - 缩放相机。

    • "roll" - 滚转相机。

    • "nomode" - 无相机模式。

    有关各种模式的详细信息，请参阅使用相机工具栏控制视图。

    您也可以通过点击对应的按钮，使用工具栏设置相机模式。

    相机移动的主轴，指定为以下值之一：

    • "x" - 主轴 x

    • "y" - 主轴 y

    • "z" - 主轴 z

    • "none" - 没有主轴

    有关主轴的详细信息，请参阅使用相机工具栏控制视图。

    您也可以通过点击对应的按钮，使用工具栏设置主轴。

    目标图窗，指定为 Figure 对象。

    输出参量

    全部折叠

    相机工具栏可见性，以数据类型为 logical 的 1 或 0 形式返回。如果相机工具栏可见，则 tf 为逻辑值 1 (true)。否则，tf 为逻辑值 0 (false)。

    相机移动控制模式，以字符向量形式返回。有关可能值的列表，请参阅 mode 输入参量。

    相机移动的主轴，以字符向量形式返回。有关可能值的列表，请参阅 coordsys 输入参量。

    相机工具栏，以 Toolbar 对象形式返回。

    版本历史记录

    在 R2006a 之前推出

    全部展开

    另请参阅

    函数

    主题