drawfreehand
创建可定制的手绘ROI
描述
例子
创建不可选的手绘ROI
将图像读入工作区并显示它。
imshow (imread (“yellowlily.jpg”))
画一个徒手ROI。
H =手绘;
填充手绘ROI的表面,并禁用选择ROI的能力。单击和拖动鼠标时,ROI不会移动。
h.FaceAlpha = 1;h.FaceSelectable = false;
为写意ROI事件设置监听器
将图像读入工作区。
I = imread(“cameraman.tif”);
显示图像。
imshow(我);
在图像上画一个徒手ROI。
ROI =徒手画(“颜色”,“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之父
gca
(默认)|轴
对象|UIAxes
对象
ROI的父节点,指定为轴
对象或UIAxes
对象。有关在uiaxis中使用ROI的信息,包括重要的限制,请参见使用应用程序设计器创建的应用程序中的roi.
名称-值参数
指定可选参数对为Name1 = Value1,…,以=家
,在那里的名字
参数名称和价值
对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。
例子:h = drawfreehand(Color="y")
创建一个黄色徒手画的
对象。
在R2021a之前,使用逗号分隔每个名称和值,并将其括起来的名字
在报价。
例子:h = drawfreehand("Color","y")
创建一个黄色徒手画的
对象。
关闭
- - - - - -接近写意ROI
真正的
或1
(默认)|假
或0
关闭指定为的徒手ROI数字的或逻辑的1
(真正的
)或0
(假
).当真正的
,drawfreehand
函数通过将绘制的最后一个路点连接到绘制的第一个路点来关闭ROI。
颜色
- - - - - -ROI的颜色
[0 0.4470 0.7410]
(默认)|RGB值|颜色名称|短颜色名
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的选项
真正的
或1
(默认)|假
或0
上下文菜单提供了删除ROI的选项,指定为数字的或逻辑的1
(真正的
)或0
(假
).当值为真正的
,您可以使用上下文菜单交互地删除ROI。当值为假
时,删除感兴趣区域的上下文菜单选项被禁用。
方法,可以在上下文菜单之外删除ROI删除
函数。
DrawingArea
- - - - - -可以交互地放置ROI的轴的面积
“汽车”
(默认)|“无限”
|[x, y, w h]
可以交互地将ROI放置在其中的轴的区域,指定为本表中的值之一。
价值 | 描述 |
---|---|
“汽车” |
绘图区域是当前轴的限制(默认)。 |
“无限” |
绘制区域没有边界,可以绘制或拖动roi以超出轴的限制。 |
[x, y, w h] |
绘图区域限制为从(开始的矩形区域)x,y),并延伸至widthw和高度h. |
FaceAlpha
- - - - - -ROI面透明度
0.2
(默认)|在[0,1]范围内的数字
ROI表面的透明度,指定为范围[0,1]中的数字。当值为1
时,ROI面完全不透明。当值为0
时,ROI面完全透明。
FaceSelectable
- - - - - -ROI面可以捕捉点击
真正的
或1
(默认)|假
或0
ROI面可以捕获点击,指定为数字的或逻辑的1
(真正的
)或0
(假
).当真正的
时,ROI面捕获鼠标点击。当假
时,ROI面不捕获鼠标单击。
HandleVisibility
- - - - - -ROI处理的可见性孩子们
父属性
“上”
(默认)|“关闭”
|“回调”
中的ROI句柄的可见性孩子们
属性,指定为本表中的值之一。
价值 | 描述 |
---|---|
“上” |
对象句柄总是可见的(默认)。 |
“关闭” |
对象句柄始终是隐藏的。 |
“回调” |
对象句柄在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。 |
InteractionsAllowed
- - - - - -ROI的交互性
“所有”
(默认)|“没有”
|“重塑”
|“翻译”
ROI的交互性,指定为本表中的值之一。
价值 | 描述 |
---|---|
“所有” |
ROI是完全可交互的(默认)。 |
“没有” |
ROI是不可交互的,并且没有可见的拖拽点。 |
“翻译” |
ROI可以在绘图区域内平移(移动),但不能重新塑形。 |
“重塑” |
ROI可以被重塑,但不能被转换。 |
标签
- - - - - -ROI标签
”
(默认)|特征向量|字符串标量
ROI标签,指定为字符向量或字符串标量。默认情况下,ROI没有标签(”
).
LabelAlpha
- - - - - -文本背景透明度
1
(默认)|在[0,1]范围内的数字
文本背景的透明度,指定为范围[0,1]中的数字。当设置为1
时,文本背景完全不透明。当设置为0
时,文本背景完全透明。
LabelTextColor
- - - - - -标签文本颜色
“黑”
(默认)|RGB值|颜色名称|短颜色名
标记文本颜色,指定为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]
LabelVisible
- - - - - -标签的可见性
“上”
(默认)|“关闭”
|“徘徊”
标签可见性,指定为这些值之一。
价值 | 描述 |
---|---|
“上” |
当ROI可见时,标签也可见。 |
“徘徊” |
只有当鼠标悬停在ROI上时,标签才可见。 |
“关闭” |
标签不可见。 |
线宽
- - - - - -ROI边界宽度
正数
ROI边界的宽度,指定为以点为单位的正数。默认值是每屏幕像素点数的三倍,这样边界就有三个像素宽。
MarkerSize
- - - - - -标志尺寸
正数
标记大小,以正数表示。默认值是每屏幕像素点数的8倍,例如标记的大小为8个像素。
Multiclick
- - - - - -在互动放置期间控制徒手绘图风格
假
或0
(默认)|真正的
或1
在交互放置期间控制徒手绘图样式,指定为数字的或逻辑的0
(假
)或1
(真正的
).当值为假
,一个简单的点击和拖动手势完成徒手ROI。当值为真正的
,多个点击和拖动手势可以与直边相结合,形成更复杂的写意ROI形状。
父
- - - - - -投资回报父母
轴
对象|UIAxes
对象
的ROI父元素,指定为轴
或UIAxes
对象。有关在uiaxis中使用ROI的信息,包括重要的限制,请参见使用应用程序设计器创建的应用程序中的roi.
位置
- - - - - -ROI位置
n-by-2数值矩阵
ROI的位置,指定为n-by-2数值矩阵,其中n是定义ROI的顶点或点的数量。每一行表示[xy顶点或点的坐标。
选择
- - - - - -ROI选择状态
假
或0
(默认)|真正的
或1
ROI的选择状态,指定为数字的或逻辑的0
(假
)或1
(真正的
).
SelectedColor
- - - - - -选择ROI时的颜色
“没有”
(默认)|RGB值|颜色名称|短颜色名
选择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边缘进行平滑处理
1
(默认)|负的数量
交互放置后应用于ROI边缘的平滑,指定为非负数。的drawfreehand
函数过滤x而且y使用默认标准偏差为1的高斯平滑核的ROI坐标。高斯滤波器的大小为2 *装天花板(2 *平滑)+ 1
.只有在完成绘图后才能看到平滑效果。
StripeColor
- - - - - -ROI条纹颜色
“没有”
(默认)|RGB值|颜色名称|短颜色名
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相关联,指定为字符向量或字符串标量。属性在对象层次结构中使用标记值查找ROI对象findobj
函数。
用户数据
- - - - - -与ROI相关联的数据
任意MATLAB数据
与ROI关联的数据,指定为任何MATLAB数据。例如,您可以指定标量、向量、矩阵、单元格数组、字符串、字符数组、表或结构。的drawfreehand
对象不使用此数据。
可见
- - - - - -ROI的可见性
“上”
(默认)|“关闭”
|开/关逻辑值
ROI可见性,指定为“上”
或“关闭”
,或作为数字或逻辑1
(真正的
)或0
(假
).值为“上”
等于真,和“关闭”
等于false。该值存储为类型的on/off逻辑值OnOffSwitchState
.
价值 | 描述 |
---|---|
“上” |
显示ROI。 |
“关闭” |
隐藏ROI而不删除它。您仍然可以访问一个看不见的ROI的属性。 |
路点
- - - - - -定位点就是路点
n-by-1逻辑向量
位置点是路径点,指定为n-by-1逻辑向量n是定义ROI的点的数量。的长度路点
的行数必须匹配位置
名称-值参数。元素路点
用值真正的
确定要点位置
矩阵是路径点。
路径点在ROI边缘上显示为圆形。通过用鼠标单击和拖动路径点,可以使用路径点来重塑ROI。移动路径点将修改所单击的路径点与相邻路径点之间的手绘区域。
提示
ROI支持以下交万博1manbetx互性,包括键盘快捷键。
行为 键盘快捷键 取消绘制ROI。 新闻Esc.该函数返回一个有效值为空的ROI对象 位置
财产。完成ROI的绘制(关闭)。 双击,将在指针位置添加一个点,并绘制一条将该点与所绘制的第一个点连接起来的线,从而关闭ROI。
右键单击,将绘制一条连接最后一个点和所绘制的第一个点的线。
将指针放在第一个点上,然后单击。
新闻输入,它绘制一条连接最后一个点和所绘制的第一个点的直线。
调整ROI的大小。 将指针定位在路径点上,然后单击并拖动。在此模式下,没有辅助功能(边对齐)。
添加一个路径点。 将指针定位在ROI的边缘,右键单击,选择添加路径.还可以将指针定位在ROI的边缘上,然后双击。
移除一个路径点。 将指针定位在路径点上,右键单击并选择删除路标.
移动ROI。 将指针置于ROI上方。指针变为芙蓉形状。单击并拖动以移动ROI。 删除ROI。 将指针定位在ROI上(而不是顶点上),右键单击并选择删除徒手画的从上下文菜单。控件,还可以以编程方式删除ROI 删除
函数。的
drawfreehand
函数创建徒手画的
对象。创建对象后,可以使用这些对象功能修改ROI的形状、位置、外观和行为。能力 万博1manbetx 对象属性 ROI对象具有指定其形状、位置、外观和行为的属性。创建ROI对象后,使用点表示法更改属性。
例如,要更改的颜色
roi
至黄,定其颜色
属性:roi。颜色=“黄色”
对象的功能 ROI对象具有操作ROI的对象函数。例如,如果希望在创建ROI后暂停MATLAB命令行,请使用 等待
函数。事件通知 当某些事件发生时,例如单击ROI或移动ROI时,ROI对象可以通知代码。要接收事件通知,请设置听众.当ROI通过侦听器通知应用程序时,它返回特定于事件的数据。例如,用
ROIMoved
事件时,ROI对象返回其先前位置和当前位置。可以指定在事件发生时执行的回调函数。属性使用事件侦听器的示例
徒手画的
对象,看到为写意ROI事件设置监听器.
版本历史
在R2018b中引入R2020a:UIContextMenu
不建议使用名称-值参数
不建议从R2020a开始
从R2020a开始,使用UIContextMenu
不建议使用name-value参数将上下文菜单分配给ROI对象。使用快捷菜单
改为名称-值参数。数值相同。
目前还没有计划取消对万博1manbetxUIContextMenu
名称-值参数。
MATLAB命令
你点击了一个对应于这个MATLAB命令的链接:
在MATLAB命令窗口中输入该命令来运行该命令。Web浏览器不支持MATLAB命令。万博1manbetx
您也可以从以下列表中选择一个网站:
如何获得最佳的网站性能
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。