矩形

感兴趣矩形区

全部展开页面

描述

当矩形对象是一个矩形的兴趣区域（ROI）。

要绘制感兴趣区域，将光标放置在坐标轴上，单击并拖动以创建形状。要完成ROI，请松开鼠标按钮。有关使用此ROI(包括键盘快捷键)的更多信息，请参见提示．

创建

描述

创建一个矩形对象,使用images.roi.rectangle.创建功能。创建对象后，调用画对象函数开始绘制ROI。为了方便，您还可以使用drawrectangle功能创建一个矩形ROI。当drawrectangle函数创建ROI对象并自动调用画对象的功能。

示例

roi= images.roi.Rectangle创建一个实例images.roi.rectangle.具有默认属性的类。

roi= images.roi.rectangle（斧头）在指定的轴上创建ROI斧头．

roi= images.roi.rectangle（___那名称，价值）套属性使用名称-值对。例如,images.roi.Rectangle('颜色',' y ')设置的颜色矩形反对黄色。可以指定多个名称-值对。将每个属性名用单引号括起来。

输入参数

全部展开

`斧头`-ROI的母公司
`gca`(默认)|`轴`目的|`UIAxes`目的

ROI之父，指定为轴对象或一个UIAxes对象。有关在ui轴中使用ROI(包括重要限制)的信息，请参见在应用设计师创建的应用中使用roi．

属性

全部展开

`AspectRatio`-矩形纵横比
`1`(默认)|积极的数字标量

矩形的宽高比，指定为正值标量。当您绘制或调整矩形大小时，此属性的值会自动更改。当images.roi.rectangle.对象计算此值高度/宽度

`颜色`-ROI的颜色
蓝色(默认)|`ColorSpec.`

ROI颜色，指定为MATLAB^®ColorSpec(颜色规范)．

例子:'绿色'

例子:‘g’

例子:(0 1 0)

`快捷菜单`-上下文菜单
`快捷菜单`目的

上下文菜单，指定为a快捷菜单对象。当您右键单击ROI时，使用此属性显示自定义上下文菜单。控件可以创建自定义上下文菜单UIContextMenu.功能，然后配置上下文菜单属性。

`删除`-ROI可以通过上下文菜单交互式删除
`真正的`(默认)|`假`

可以通过上下文菜单交互式地删除ROI，指定为真正的或假．当值是真正的（默认），您可以通过上下文菜单删除ROI。要禁用此上下文菜单项，请将此属性设置为假．当值设置为假，您仍然可以通过调用删除功能将句柄指定为ROI作为输入。

`DrawingArea`-坐标轴区域，您可以交互放置ROI
`'汽车'`(默认)|`“无限”`|`[x, y, w h]`

您可以交互放置ROI的坐标轴区域，指定为该表中的值之一。

价值	描述
`'汽车'`	绘图区域是当前轴的限制(默认)。
`“无限”`	绘图区域没有边界，可以绘制或拖动roi超出轴的限制。
`[x, y, w h]`	绘图区域限于一个矩形区域，起始位置为(X.那y），并延伸到宽度W.和高度H.．

`Facealpha.`-ROI面透明度
`０．２`(默认)|数字标量

ROI面透明度，指定为范围内的数字标量值[0 1]．当值是1在美国，投资回报率是完全不透明的。当值是0.， ROI面是完全透明的。

`可调整`-ROI面可以捕获点击量
`真正的`(默认)|`假`

ROI面可以捕捉点击，指定为真正的或假．什么时候真正的(默认)，ROI面捕获鼠标点击。什么时候假，ROI面部不会捕获鼠标点击。

`FixedAspectRatio`-相互作用期间宽高比保持不变
`假`(默认)|`真正的`

纵横比在互动期间保持恒定，指定为真正的或假．当值是真正的当您绘制或调整矩形大小时，ROI维护宽高比。当值是假(默认值)，您可以在绘制或调整矩形大小时更改长宽比。您可以使用默认上下文菜单更改此属性的状态。

`HandleVisibility`-ROI处理的可视性`孩子们`父母的财产
`'开'`(默认)|`“关闭”`|`'回调'`

ROI手柄的可见性孩子们父的属性，指定为此表中的值之一。

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

`InteractionsAllowed`-交互性的ROI
`'全部'`(默认)|`'没有'`|`'翻译'`

ROI的交互性，指定为该表中的值之一。

价值	描述
`'全部'`	ROI是完全可交互的(默认)。
`'没有'`	ROI不互动，没有可见拖动点。
`'翻译'`	ROI可以在绘图区域内翻译(移动)，但不能重塑。

`标签`-ROI标签
`''`(默认)|特征向量|字符串

ROI标签，指定为字符向量或字符串。默认情况下，ROI没有标签(''）。

`LabelAlpha.`-文本背景的透明度
`1`(默认)|数字标量

文本背景的透明度，指定为范围内的标量值[0 1]．设置到1，文本背景完全不透明。设置到0.，文本背景完全透明。

`LabeltextColor.`-标签文本颜色
`“黑”`(默认)|ColorSpec.

标签文本颜色，指定为MATLABColorSpec(颜色规范)．强度必须在[0,1]范围内。

`LabelVisible`-ROI标签的可视性
`'开'`(默认)|`“关闭”`|`“徘徊”`|`“里面”`

ROI标签的可见性，指定为其中一个值：

价值	描述
`'开'`	当ROI可见时，标签是可见的`标签`财产是非空的（默认）。
`“徘徊”`	只有当鼠标悬停在ROI上时，标签才可见。
`“里面”`	标签只有在ROI中有足够的空间显示时才可见。
`“关闭”`	标签不可见。

`线宽`-ROI边缘的宽度
是每个屏幕像素点数的三倍(默认)|积极的数字标量

ROI边缘的宽度，指定为点中的正数值标量。默认值是每个屏幕像素点数的三倍。

`MarkerSize`-标志尺寸
每个屏幕像素的点数的8倍(默认)|积极的数字标量

标记大小，指定为点的正值标量值。

`父`-ROI父母
`轴`目的|`UIAxes`目的

ROI母，指定为轴或UIAxes对象。有关在ui轴中使用ROI(包括重要限制)的信息，请参见在应用设计师创建的应用中使用roi．

`姿势`-ROI的位置
1-by-4数值数组

ROI的位置，指定为表单的1 × 4数字数组[xmin, ymin，宽，高]．xmin和ymin指定矩形左上角的位置。宽度和高度在两个维度中指定矩形的范围。

`旋转`-旋转矩形的能力
`假`(默认)|`真正的`

旋转矩形的能力，指定为真正的或假．当值是假(默认)，矩形不能旋转。当值是真正的，您可以通过单击角落的标记附近来旋转矩形。

`RotationAngle`-矩形中心周围的角
`0.`(默认)|数字标量

围绕矩形中心的角度，指定为数字标量。角度是以顺时针方向的度数来测量的。当您绘制或移动ROI时，此属性的值将自动更改。

的价值RotationAngle不影响姿势．当姿势属性表示旋转前ROI的初始位置。要确定旋转ROI的位置，请使用顶点财产。

`选择`-ROI的选择状态
`假`(默认)|`真正的`

ROI的选择状态，指定为逻辑值真正的或假．您还可以交互式地设置此属性。例如，单击ROI选择ROI并将此属性设置为真正的．同样,按下Ctrl键和单击ROI取消选择ROI并将此属性的值设置为假．

`SelectedColor`-选择时ROI的颜色
`'没有'`(默认)|`ColorSpec.`

选择感兴趣区域的颜色时，用MATLAB指定ColorSpec(颜色规范)．强度必须在这个范围内[0, 1]．如果“SelectedColor”被设置为'没有'，那么值颜色定义所有状态的ROI的颜色，选择或不选择。

例子:'绿色'

例子:‘g’

例子:(0 1 0)

`条纹镜头`-ROI条纹颜色
`'没有'`(默认)|`ColorSpec.`价值

ROI条纹的颜色，用MATLAB指定ColorSpec(颜色规范)价值。默认情况下，ROI的边缘是纯色的。如果您指定条纹镜头，ROI边缘条纹。条带内由指定的值的组合组成“颜色”和这个值。

例子:'绿色'

例子:‘g’

例子:(0 1 0)

`标签`-标记与ROI相关联
`''`(默认)|特征向量|字符串标量

标记与ROI相关联，指定为字符向量或字符串。使用标记值在对象的层次结构中查找ROI对象findobj功能。

`用户数据`-与ROI相关联的数据
任何MATLAB数据

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

`顶点`-矩形边缘的点的位置
N.2数组

ROI边缘的点的位置，指定为一个N.-by-2阵列。

此属性是只读的。

`可见`-ROI的可见性
`'开'`(默认)|`“关闭”`|开/关逻辑值

ROI可见性，指定为'开'或“关闭”，或数字或逻辑1(真正的)或0.(假)。的值'开'相当于真实，而且“关闭”等于false。因此，可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState．

价值	描述
`'开'`	显示ROI(默认值)。
`“关闭”`	隐藏ROI而不删除它。您仍然可以访问不可见ROI的属性。

对象功能

`addlistener`	创建绑定到事件源的事件监听器
`beginDrawingFromPoint`	从指定的点开始绘制ROI
`bringToFront`	将ROI带到轴堆叠顺序的前面
`createMask`	从ROI中创建二元掩模图像
`画`	开始交互式地绘制ROI
`inROI`	查询点是否位于ROI内
`等待`	块MATLAB指令行直到ROI操作完成

例子

全部折叠

以非交互方式创建矩形ROI

打开生活的脚本

将图像读入工作区并显示它。

我= imread (“baby.jpg”）;图imshow(我)

图中包含一个坐标轴。轴包含一个image类型的对象。

在图像上创建一个矩形ROI，使用姿势参数指定其位置和大小。该示例还指定矩形的边缘是条纹线。对于以编程方式创建的ROI，如果希望在特定轴中绘制的ROI，则必须将该轴指定为输入参数。否则，一个实例images.roi.rectangle.类已创建但未显示。在本例中，指定当前坐标轴(gca)以在该坐标轴上绘制ROI。

h = images.roi.rectangle（gca，“位置”，[500,500,1000,1000]，“StripeColor”那'r'）;

图中包含一个坐标轴。轴包含2个类型图像的对象，images.roi.rectangle。

设置矩形ROI事件的侦听器

打开生活的脚本

将图像读入工作区。

我= imread (“cameraman.tif”）;

显示图像。

imshow(我);

在图像上绘制一个矩形感兴趣区域。因为这个例子指定了ROI的长度和位置，所以您不必调用画方法以启用交互式绘图。

roi = images.roi.rectangle（gca，“位置”，[80,45,80,100]）;

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

addlistener (roi,'搬家', @allevents);addlistener (roi,“ROIMoved”, @allevents);

当借助者回调函数在命令行上显示先前位置和投资回报率的当前位置。

函数避免（SRC，EVT）EVName = EVT.Eventname;开关(evname)情况下{'搬家'disp（[“ROI改变了之前的位置”mat2str (evt.PreviousPosition)]);disp ([“ROI移动当前位置:”mat2str（EVT.CurrentPosition）]）;情况下{“ROIMoved”disp（['ROI移动了以前的位置：'mat2str (evt.PreviousPosition)]);disp ([“投资回报率改变了当前的头寸”mat2str（EVT.CurrentPosition）]）;结束结束

事件名称	触发	事件数据	事件属性
`deletingroi.`	ROI即将被交互删除。	`事件。EventData`	`NotifyAccess`：`私人的` `LengeAccess.`：`民众`
`DrawingStarted`	ROI将以交互方式绘制。	`事件。EventData`	`NotifyAccess`：`私人的` `LengeAccess.`：`民众`
`绘制了`	ROI是交互式绘制的。	`事件。EventData`	`NotifyAccess`：`私人的` `LengeAccess.`：`民众`
`搬运`	ROI的形状或位置正在被交互地改变。	`images.roi.rectanglemovingeventdata.`	`NotifyAccess`：`私人的` `LengeAccess.`：`民众`
`ROIMoved`	ROI形状或位置已被交互地改变。	`images.roi.rectanglemovingeventdata.`	`NotifyAccess`：`私人的` `LengeAccess.`：`民众`
`ROIClicked`	ROI已被单击。	`images.roi.ROIClickedEventData`	`NotifyAccess`：`私人的` `LengeAccess.`：`民众`

提示

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

行为	键盘快捷键
取消绘制ROI。	pressEsc．函数返回一个有效的ROI对象，其值为空`姿势`字段。
调整(重塑)ROI。	将光标放在顶点上，然后单击并拖动。矩形在每个角落和每侧的中点都有顶点。要保留调整大小的宽高比，请按下班关键。要锁定长宽比，请使用修复长宽比在右键单击上下文菜单中。
移动ROI。	将光标定位在ROI上。光标改变了浮动形状。单击并拖动ROI。
删除ROI。	将指针放置在矩形上，右键单击并选择删除矩形从上下文菜单。控件也可以通过编程方式删除ROI`删除`对象方法。

有关在使用App Designer创建的应用程序中使用ROI的信息，请参阅在应用设计师创建的应用中使用roi．

兼容性的考虑

全部展开

`UIContextMenu.`属性不推荐使用

不建议在R2020a开始

从R2020a开始，使用UIContextMenu.不建议将上下文菜单分配给图形对象或UI组件的属性。使用快捷菜单财产。属性值是相同的。

目前还没有取消支持的计划金宝appUIContextMenu.财产。然而,UIContextMenu.属性将不再出现在通过调用得到在图形对象或UI组件上的功能。

也可以看看

AssistedFreehand|圆圈|十字|长方体|drawrectangle|椭圆形|手法|线|点|多边形|折线

话题

ROI创作概述

在R2018B中介绍

矩形

描述

创建

描述

输入参数

斧头-ROI的母公司gca(默认)|轴目的|UIAxes目的

属性

AspectRatio-矩形纵横比1(默认)|积极的数字标量

颜色-ROI的颜色蓝色(默认)|ColorSpec.

快捷菜单-上下文菜单快捷菜单目的

删除-ROI可以通过上下文菜单交互式删除真正的(默认)|假

DrawingArea-坐标轴区域，您可以交互放置ROI'汽车'(默认)|“无限”|[x, y, w h]

Facealpha.-ROI面透明度０．２(默认)|数字标量

可调整-ROI面可以捕获点击量真正的(默认)|假

FixedAspectRatio-相互作用期间宽高比保持不变假(默认)|真正的

HandleVisibility-ROI处理的可视性孩子们父母的财产'开'(默认)|“关闭”|'回调'

InteractionsAllowed-交互性的ROI'全部'(默认)|'没有'|'翻译'

标签-ROI标签''(默认)|特征向量|字符串

LabelAlpha.-文本背景的透明度1(默认)|数字标量

LabeltextColor.-标签文本颜色“黑”(默认)|ColorSpec.

LabelVisible-ROI标签的可视性'开'(默认)|“关闭”|“徘徊”|“里面”

线宽-ROI边缘的宽度是每个屏幕像素点数的三倍(默认)|积极的数字标量

MarkerSize-标志尺寸每个屏幕像素的点数的8倍(默认)|积极的数字标量

父-ROI父母轴目的|UIAxes目的

姿势-ROI的位置1-by-4数值数组

旋转-旋转矩形的能力假(默认)|真正的

RotationAngle-矩形中心周围的角0.(默认)|数字标量

选择-ROI的选择状态假(默认)|真正的

SelectedColor-选择时ROI的颜色'没有'(默认)|ColorSpec.

条纹镜头-ROI条纹颜色'没有'(默认)|ColorSpec.价值

标签-标记与ROI相关联''(默认)|特征向量|字符串标量

用户数据-与ROI相关联的数据任何MATLAB数据

顶点-矩形边缘的点的位置N.2数组

可见-ROI的可见性'开'(默认)|“关闭”|开/关逻辑值

对象功能

例子

以非交互方式创建矩形ROI

设置矩形ROI事件的侦听器

更多关于

事件

提示

兼容性的考虑

UIContextMenu.属性不推荐使用

也可以看看

话题

图像处理工具箱文档

金宝app

介绍基于MATLAB的深度学习

`斧头`-ROI的母公司
`gca`(默认)|`轴`目的|`UIAxes`目的

`AspectRatio`-矩形纵横比
`1`(默认)|积极的数字标量

`颜色`-ROI的颜色
蓝色(默认)|`ColorSpec.`

`快捷菜单`-上下文菜单
`快捷菜单`目的

`删除`-ROI可以通过上下文菜单交互式删除
`真正的`(默认)|`假`

`DrawingArea`-坐标轴区域，您可以交互放置ROI
`'汽车'`(默认)|`“无限”`|`[x, y, w h]`

`Facealpha.`-ROI面透明度
`０．２`(默认)|数字标量

`可调整`-ROI面可以捕获点击量
`真正的`(默认)|`假`

`FixedAspectRatio`-相互作用期间宽高比保持不变
`假`(默认)|`真正的`

`HandleVisibility`-ROI处理的可视性`孩子们`父母的财产
`'开'`(默认)|`“关闭”`|`'回调'`

`InteractionsAllowed`-交互性的ROI
`'全部'`(默认)|`'没有'`|`'翻译'`

`标签`-ROI标签
`''`(默认)|特征向量|字符串

`LabelAlpha.`-文本背景的透明度
`1`(默认)|数字标量

`LabeltextColor.`-标签文本颜色
`“黑”`(默认)|ColorSpec.

`LabelVisible`-ROI标签的可视性
`'开'`(默认)|`“关闭”`|`“徘徊”`|`“里面”`

`线宽`-ROI边缘的宽度
是每个屏幕像素点数的三倍(默认)|积极的数字标量

`MarkerSize`-标志尺寸
每个屏幕像素的点数的8倍(默认)|积极的数字标量

`父`-ROI父母
`轴`目的|`UIAxes`目的

`姿势`-ROI的位置
1-by-4数值数组

`旋转`-旋转矩形的能力
`假`(默认)|`真正的`

`RotationAngle`-矩形中心周围的角
`0.`(默认)|数字标量

`选择`-ROI的选择状态
`假`(默认)|`真正的`

`SelectedColor`-选择时ROI的颜色
`'没有'`(默认)|`ColorSpec.`

`条纹镜头`-ROI条纹颜色
`'没有'`(默认)|`ColorSpec.`价值

`标签`-标记与ROI相关联
`''`(默认)|特征向量|字符串标量

`用户数据`-与ROI相关联的数据
任何MATLAB数据

`顶点`-矩形边缘的点的位置
N.2数组

`可见`-ROI的可见性
`'开'`(默认)|`“关闭”`|开/关逻辑值

`UIContextMenu.`属性不推荐使用