主要内容

drawcuboid

创建可定制的立方体ROI

描述

drawcuboid函数创建长方体指定感兴趣的立方体区域(ROI)的形状和位置的对象。您可以通过使用鼠标在图像上绘制ROI,或者通过使用名称-值参数以编程方式创建ROI。您还可以指定ROI的初始外观和行为。

在点云的三维区域上绘制的蓝色长方体ROI。

创建ROI后,可以使用对象属性、对象函数和事件通知自定义ROI的形状、位置、外观和行为。有关使用这些功能的详细信息,请参见提示

例子

roi= drawcuboid创建一个长方体对象,并允许在当前轴上交互式地绘制感兴趣的立方体区域(ROI)。

要绘制ROI,调用drawcuboid函数。该函数绘制了一个以体积为中心的立方ROI。将指针移到图像上。光标变成一个芙蓉形状。移动图像上的任何地方的ROI。要完成ROI,单击鼠标按钮。有关使用ROI的详细信息,包括键盘快捷键和上下文菜单选项,请参见提示

roi= drawcuboid (斧头创建一个长方体对象,并允许在指定的轴上交互式地绘制感兴趣的立方体区域(ROI)斧头

roi= drawcuboid (年代创建一个长方体对象上的感兴趣的立方体区域(ROI)的交互式绘图散射对象。年代.控件定义的最近点在交互放置过程中,长方体被扣住散射对象。

roi= drawcuboid (___名称,值使用一个或多个名称-值对修改ROI的外观。

例子

全部折叠

创建3-D散点图,并交互定义数据上的长方体ROI。

定义三维散射数据的向量。

[x,y,z] =球面(16);X = [X(:)*。5 x(:) *。75 x (:));Y = [Y(:)*。5 y(:) *。75 y (:));Z = [Z(:)*。5 z(:) *。75 z (:));

指定每个标记的大小和颜色。

S = repmat([1.75 .5]*10,数字(x),1);C = repmat([1 2 3],数字(x),1);

创建一个三维散点图。使用视图来改变图中坐标轴的角度。

图hScatter = scatter3 (X (:), Y(,)、Z (:), S (:), C (:),“填充”);视图(-60、60);

开始在轴上放置一个长方体ROI。ROI在散点图中定义的最近点上。在交互放置过程中,使用滚轮调整长方体的大小。

drawcuboid (hScatter);

为三维分散数据定义向量。

[x,y,z] =球面(16);X = [X(:)*。5 x(:) *。75 x (:));Y = [Y(:)*。5 y(:) *。75 y (:));Z = [Z(:)*。5 z(:) *。75 z (:));

指定每个标记的大小和颜色。

S = repmat([1.75 .5]*10,数字(x),1);C = repmat([1 2 3],数字(x),1);

创建一个3-D散点图,并使用视图来改变图中轴的角度。

图hScatter = scatter3 (X (:), Y(,)、Z (:), S (:), C (:),“填充”);视图(-60、60);

开始在轴上放置一个长方体,从散点图中扣到最近的点。在交互放置过程中,使用滚轮调整长方体的大小。

roi = drawcuboid(hScatter,“颜色”“r”);

为ROI移动事件设置侦听器。当您移动它时,ROI将发送这些事件的通知并执行您指定的回调函数。

addlistener (roi,“MovingROI”, @allevents);addlistener (roi,“ROIMoved”, @allevents);

allevents回调函数显示感兴趣区先前位置和当前位置。

函数allevents(src,evt) evname = evt. eventname;开关(evname)情况下“MovingROI”} disp ([“投资回报率上升:”mat2str (evt.PreviousPosition)]);disp ([“ROI移动当前位置:”mat2str (evt.CurrentPosition)]);情况下“ROIMoved”} disp ([“ROI改变了之前的位置:”mat2str (evt.PreviousPosition)]);disp ([“ROI改变了当前位置:”mat2str (evt.CurrentPosition)]);结束结束

输入参数

全部折叠

ROI的父节点,指定为对象或UIAxes对象。有关在uiaxis中使用ROI的信息,包括重要的限制,请参见使用应用程序设计器创建的应用程序中的roi

散点图,指定为a散射对象。的父类散射对象成为ROI的父对象。有关更多信息,请参见散射

名称-值参数

的可选逗号分隔对名称,值参数。的名字参数名称和价值对应的值。的名字必须出现在引号内。您可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:“颜色”、“y”创建一个黄色长方体对象

ROI颜色,指定为RGB三元组、颜色名称或短颜色名称。

您可以使用RGB三元组指定任何颜色。RGB三元组是一个3元素的行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在[0,1]范围内。

您可以通过字符串标量或字符向量的名称指定一些常见颜色。该表列出了已命名的颜色选项和等效的RGB三元组。

颜色名称 短名称 RGB值 外观
“红色” “r” [10 0 0]

纯红色矩形

“绿色” ‘g’ [0 10 0]

一个纯绿色的矩形

“蓝” “b” [0 0 1]

一个纯蓝色的长方形

“青色” “c” [0 1 1]

纯青色矩形

“红色” “米” [10 0 1]

一个纯洋红色的长方形

“黄色” “y” [11 10 0]

纯黄色矩形

“黑” “k” [0 0 0]

一个黑色的矩形

“白色” ' w ' [1 1 1]

一个白色的矩形

这里是RGB三组的默认颜色,MATLAB®在许多类型的图中使用。

RGB值 外观
[0 0.4470 0.7410]

一个中蓝色的矩形

[0.8500 0.3250 0.0980]

红橙色矩形

[0.9290 0.6940 0.1250]

深黄色的长方形

[0.4940 0.1840 0.5560]

深紫色矩形

[0.4660 0.6740 0.1880]

一个浅绿色的长方形

[0.3010 0.7450 0.9330]

浅蓝色的长方形

[0.6350 0.0780 0.1840]

暗红色的长方形

例子:“颜色”,“r”

例子:“颜色”,“绿色”

例子:'Color',[0 0.4470 0.7410]

右键单击指定为的ROI时显示的上下文菜单快捷菜单对象。控件可以创建自定义上下文菜单uicontextmenu函数,然后配置上下文菜单属性。

上下文菜单提供了删除ROI的选项,指定为真正的.当值为真正的,您可以使用上下文菜单交互地删除ROI。当值为时,删除感兴趣区域的上下文菜单选项被禁用。

方法,可以在上下文菜单之外删除ROI删除函数。

可以交互地将ROI放置在其中的轴的区域,指定为本表中的值之一。

价值 描述
“汽车”

绘图区域是当前轴限制的超集和围绕ROI的边界框。

“无限” 绘制区域没有边界,可以绘制或拖动roi以超出轴的限制。
[x, y, z, w, h, d] 绘图区域仅限于从(xyz),与宽度w、身高h,和深度d

ROI边缘的透明度,指定为范围[0,1]中的数字。当设置为1时,ROI边缘完全不透明。当设置为0时,ROI边缘完全透明。

ROI面的透明度,指定为范围[0,1]中的数字。当值为1时,ROI面完全不透明。当值为0时,ROI面是完全透明的。

鼠标指针正下方的ROI面透明度,指定为范围[0,1]或“没有”表示没有变化的面透明度。当设置为1,鼠标指针下方的面部是完全不透明的。当设置为0,面部完全透明。

鼠标指针正下方的ROI表面的颜色,指定为RGB三元组、颜色名称、短颜色名称或“没有”.如果您指定了值“没有”,则悬停时面色不变。(悬停表示鼠标停留在ROI的立方体表面上。)当你没有悬停在一个ROI面上时,值颜色决定脸的颜色。

您可以使用RGB三元组指定任何颜色。RGB三元组是一个3元素的行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在[0,1]范围内。

您可以通过字符串标量或字符向量的名称指定一些常见颜色。该表列出了已命名的颜色选项和等效的RGB三元组。

颜色名称 短名称 RGB值 外观
“红色” “r” [10 0 0]

纯红色矩形

“绿色” ‘g’ [0 10 0]

一个纯绿色的矩形

“蓝” “b” [0 0 1]

一个纯蓝色的长方形

“青色” “c” [0 1 1]

纯青色矩形

“红色” “米” [10 0 1]

一个纯洋红色的长方形

“黄色” “y” [11 10 0]

纯黄色矩形

“黑” “k” [0 0 0]

一个黑色的矩形

“白色” ' w ' [1 1 1]

一个白色的矩形

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三元组。

RGB值 外观
[0 0.4470 0.7410]

一个中蓝色的矩形

[0.8500 0.3250 0.0980]

红橙色矩形

[0.9290 0.6940 0.1250]

深黄色的长方形

[0.4940 0.1840 0.5560]

深紫色矩形

[0.4660 0.6740 0.1880]

一个浅绿色的长方形

[0.3010 0.7450 0.9330]

浅蓝色的长方形

[0.6350 0.0780 0.1840]

暗红色的长方形

例子:‘FaceColorOnHover’,‘r’

例子:“FaceColorOnHover”、“绿色”

例子:'FaceColorOnHover',[0.8500 0.3250 0.0980]

中的ROI句柄的可见性孩子们属性,指定为本表中的值之一。

价值 描述
“上” 对象句柄总是可见的(默认)。
“关闭” 对象句柄始终是隐藏的。
“回调” 对象句柄在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。

ROI的交互性,指定为本表中的值之一。

价值 描述
“所有” ROI是完全可交互的。
“没有” ROI是不可交互的,并且没有可见的拖拽点。
“翻译” ROI可以在绘图区域内平移(移动)。

ROI标签,指定为字符向量或字符串标量。默认情况下,ROI没有标签().

文本背景的透明度,指定为范围[0,1]中的数字。当设置为1时,文本背景完全不透明。当设置为0时,文本背景完全透明。

标记文本颜色,指定为RGB三元组、颜色名称或短颜色名称。

您可以使用RGB三元组指定任何颜色。RGB三元组是一个3元素的行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在[0,1]范围内。

您可以通过字符串标量或字符向量的名称指定一些常见颜色。该表列出了已命名的颜色选项和等效的RGB三元组。

颜色名称 短名称 RGB值 外观
“红色” “r” [10 0 0]

纯红色矩形

“绿色” ‘g’ [0 10 0]

一个纯绿色的矩形

“蓝” “b” [0 0 1]

一个纯蓝色的长方形

“青色” “c” [0 1 1]

纯青色矩形

“红色” “米” [10 0 1]

一个纯洋红色的长方形

“黄色” “y” [11 10 0]

纯黄色矩形

“黑” “k” [0 0 0]

一个黑色的矩形

“白色” ' w ' [1 1 1]

一个白色的矩形

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三元组。

RGB值 外观
[0 0.4470 0.7410]

一个中蓝色的矩形

[0.8500 0.3250 0.0980]

红橙色矩形

[0.9290 0.6940 0.1250]

深黄色的长方形

[0.4940 0.1840 0.5560]

深紫色矩形

[0.4660 0.6740 0.1880]

一个浅绿色的长方形

[0.3010 0.7450 0.9330]

浅蓝色的长方形

[0.6350 0.0780 0.1840]

暗红色的长方形

例子:‘LabelTextColor’,‘r’

例子:“LabelTextColor”、“绿色”

例子:'LabelTextColor',[0 0.4470 0.7410]

标签可见性,指定为这些值之一。

价值 描述
“上” 当ROI可见时,标签也可见。
“徘徊” 只有当鼠标悬停在ROI上时,标签才可见。
“关闭” 标签不可见。

ROI边界的宽度,指定为以点为单位的正数。

的ROI父元素,指定为UIAxes对象。有关在uiaxis中使用ROI的信息,包括重要的限制,请参见使用应用程序设计器创建的应用程序中的roi

长方体的位置,指定为形式为[的1 × 6数值向量。xminyminzmin宽度高度深度].

长方体旋转的能力,指定为本表中的值之一。

价值 描述
“所有” ROI完全可旋转。
“x” ROI只能绕x
“y” ROI只能绕y轴。
“z” ROI只能绕z轴。
“没有” ROI是不可旋转的。

感兴趣区旋转角度,指定为形式为[的1 × 3数值矢量[x_angley_anglez_angle].旋转角度是用角来测量的x-,y- - - - - -,z分别设在。围绕ROI质心进行旋转,顺序如下:zyx

的价值RotationAngle不影响值在位置位置表示任何旋转前的长方体。

滚轮调整ROI大小的能力,指定为本表中的值之一。

价值 描述
“allresize” 滚轮影响所有ROI维度。
“xresize” 滚轮只会撞击x维度。
“yresize” 滚轮只会撞击y维度。
“zresize” 滚轮只会撞击z维度。
“没有” 滚轮没有效果。

ROI的选择状态,指定为逻辑值真正的

选择ROI时的颜色,指定为RGB三元组、颜色名称、短颜色名称或“没有”.如果你指定“没有”的值颜色定义所有状态的ROI颜色,无论是否选中。

您可以使用RGB三元组指定任何颜色。RGB三元组是一个3元素的行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在[0,1]范围内。

您可以通过字符串标量或字符向量的名称指定一些常见颜色。该表列出了已命名的颜色选项和等效的RGB三元组。

颜色名称 短名称 RGB值 外观
“红色” “r” [10 0 0]

纯红色矩形

“绿色” ‘g’ [0 10 0]

一个纯绿色的矩形

“蓝” “b” [0 0 1]

一个纯蓝色的长方形

“青色” “c” [0 1 1]

纯青色矩形

“红色” “米” [10 0 1]

一个纯洋红色的长方形

“黄色” “y” [11 10 0]

纯黄色矩形

“黑” “k” [0 0 0]

一个黑色的矩形

“白色” ' w ' [1 1 1]

一个白色的矩形

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三元组。

RGB值 外观
[0 0.4470 0.7410]

一个中蓝色的矩形

[0.8500 0.3250 0.0980]

红橙色矩形

[0.9290 0.6940 0.1250]

深黄色的长方形

[0.4940 0.1840 0.5560]

深紫色矩形

[0.4660 0.6740 0.1880]

一个浅绿色的长方形

[0.3010 0.7450 0.9330]

浅蓝色的长方形

[0.6350 0.0780 0.1840]

暗红色的长方形

例子:‘SelectedColor’,‘r’

例子:“SelectedColor”、“绿色”

例子:'SelectedColor',[0 0.4470 0.7410]

ROI条纹的颜色,指定为RGB三元组、颜色名称、短颜色名称或“没有”.如果你指定“没有”时,则ROI边缘为指定的纯色颜色.否则,ROI的边缘是条纹状的,颜色在指定的颜色之间交替颜色而且StripeColor

您可以使用RGB三元组指定任何颜色。RGB三元组是一个3元素的行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在[0,1]范围内。

您可以通过字符串标量或字符向量的名称指定一些常见颜色。该表列出了已命名的颜色选项和等效的RGB三元组。

颜色名称 短名称 RGB值 外观
“红色” “r” [10 0 0]

纯红色矩形

“绿色” ‘g’ [0 10 0]

一个纯绿色的矩形

“蓝” “b” [0 0 1]

一个纯蓝色的长方形

“青色” “c” [0 1 1]

纯青色矩形

“红色” “米” [10 0 1]

一个纯洋红色的长方形

“黄色” “y” [11 10 0]

纯黄色矩形

“黑” “k” [0 0 0]

一个黑色的矩形

“白色” ' w ' [1 1 1]

一个白色的矩形

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三元组。

RGB值 外观
[0 0.4470 0.7410]

一个中蓝色的矩形

[0.8500 0.3250 0.0980]

红橙色矩形

[0.9290 0.6940 0.1250]

深黄色的长方形

[0.4940 0.1840 0.5560]

深紫色矩形

[0.4660 0.6740 0.1880]

一个浅绿色的长方形

[0.3010 0.7450 0.9330]

浅蓝色的长方形

[0.6350 0.0780 0.1840]

暗红色的长方形

例子:‘StripeColor’,‘r’

例子:“StripeColor”、“绿色”

例子:'StripeColor',[0 0.4470 0.7410]

标记与ROI相关联,指定为字符向量或字符串标量。属性在对象层次结构中使用标记值查找ROI对象findobj函数。

与ROI关联的数据,指定为任何MATLAB数据。例如,您可以指定标量、向量、矩阵、单元格数组、字符串、字符数组、表或结构。的drawcuboid对象不使用此数据。

ROI可见性,指定为“上”“关闭”,或作为数字或逻辑1(真正的)或0(假)。值为“上”等于真,和“关闭”等于false。该值存储为类型的on/off逻辑值OnOffSwitchState

价值 描述
“上” 显示ROI。
“关闭” 隐藏ROI而不删除它。您仍然可以访问一个看不见的ROI的属性。

输出参数

全部折叠

立方ROI,返回为a长方体对象。

提示

  • ROI支持以下交金宝app互性,包括键盘快捷键。

    行为 键盘快捷键
    在绘图时微调ROI大小。 在绘图时,使用滚轮对ROI的大小进行微小更改。
    停止绘制ROI。 新闻Esc.该函数返回一个有效值为空的ROI对象位置字段。
    调整ROI的大小。

    将指针定位在长方体的一个可见面上,然后单击并拖动该表面。你可能需要旋转长方体来选择一个曲面。

    如果你按转变时,拖动鼠标可移动ROI,但不会改变任何尺寸。

    移动ROI。

    将指针定位在ROI的任何可见表面上,并在按下时单击并拖动转变

    将指针定位在ROI的任何可见表面上,右键单击并选择锁的维度.单击并拖动以移动ROI。

    删除ROI。 将指针放置在ROI上并右键单击以查看其上下文菜单。选择删除长方体菜单上的。方法还可以删除ROI删除对象的功能。
  • drawcuboid函数创建长方体对象。创建对象后,可以使用这些对象功能修改ROI的形状、位置、外观和行为。

    能力 金宝app
    对象属性

    ROI对象具有指定其形状、位置、外观和行为的属性。创建ROI对象后,使用点表示法更改属性。

    例如,要更改的颜色roi至黄,定其颜色属性:

    roi。颜色=“黄色”

    对象的功能 ROI对象具有操作ROI的对象函数。例如,如果希望在创建ROI后暂停MATLAB命令行,请使用等待函数。
    事件通知

    当某些事件发生时,例如单击ROI或移动ROI时,ROI对象可以通知代码。要接收事件通知,请设置听众.当ROI通过侦听器通知应用程序时,它返回特定于事件的数据。例如,用ROIMoved事件时,ROI对象返回其先前位置和当前位置。可以指定在事件发生时执行的回调函数。

    属性使用事件侦听器的示例长方体对象,看到为长方体ROI事件设置监听器

兼容性的考虑

全部展开

不建议从R2020a开始

在R2019a中引入