Main Content

cameratoolbar

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

    说明

    显示相机工具栏

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

    设置相机工具栏参数

    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,___) 获取指定图窗中相机工具栏的参数。

    示例

    全部折叠

    创建一个图窗并将相机工具栏添加到该图窗中。请注意,您也可以通过从图窗窗口的视图菜单中选择相机工具栏来显示相机工具栏。相机工具栏出现在默认图窗工具栏下方。

    fig = figure;
    tb = cameratoolbar(fig);

    Top portion of a figure window that displays the default figure toolbar and the camera toolbar below it

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

    cameratoolbar("SetMode","zoom")

    Top portion of a figure window that displays the default figure toolbar and the camera toolbar below with 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 对象。

    输出参量

    全部折叠

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

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

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

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

    版本历史记录

    在 R2006a 之前推出

    全部展开

    另请参阅

    函数