主要内容

drawpolygon

创建可定制的多边形ROI

描述

drawpolygon函数创建一个多边形对象,该对象指定多边形感兴趣区域(ROI)的形状和位置。您可以使用鼠标在图像上绘制ROI,以交互方式创建ROI,或者使用名称-值参数以编程方式创建ROI。您还可以指定ROI的初始外观和行为。

蓝色多边形感兴趣区域(ROI),在图像中物体上绘制10个顶点。

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

例子

ROI.= drawpolygon.创建一个多边形对象并使电流轴上的多边形ROI的交互式绘制。

要绘制感兴趣区域,请将指针放置在图像上。光标变成一朵花的形状。单击可绘制多边形的顶点,拖动可绘制顶点之间的直线。双击鼠标按钮,完成ROI。有关使用ROI的更多信息,包括键盘快捷键和上下文菜单选项,请参见提示

ROI.= drawpolygon (斧头在指定的坐标轴上创建ROI斧头

ROI.= drawpolygon (___名称,值使用一个或多个名称值参数修改ROI的外观和行为。

例子

全部折叠

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

imshow (imread (“strawberries.jpg”))

在图像上绘制多边形投资回报率。使用'Facealpha'名称 - 值对,以使ROI透明的面部。

h = drawpolygon ('Facealpha',0);

通过设置来更改多边形轮廓的颜色“颜色”ROI的财产。

h.Color =“黄色”

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

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

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

使用图像绘制多边形ROI,使用位置参数指定顶点的位置。

My_vertices = [500 500; 400 600; 400 700; 500 800; 600 800; 700 700;700 600];h = drawpolygon (“位置”, my_vertices);

图中包含一个轴对象。轴对象包含2个类型图像的对象,images.roi.polygon。

将图像读入工作区。

我= imread (“cameraman.tif”);

显示图像。

imshow(我);

在图像上绘制多边形投资回报率。

roi = drawpolygon(“颜色”“r”);

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

AddListener(ROI,“MovingROI”, @allevents);AddListener(ROI,“ROIMoved”, @allevents);

allevents回调函数显示ROI的上一个位置和当前位置。

功能allevents(src,evt) evname = ev . eventname;转变(evname)情况下“MovingROI”} disp ([ROI移动了之前的位置mat2str (evt.PreviousPosition)]);disp ([“ROI移动当前位置:”mat2str (evt.CurrentPosition)]);情况下“ROIMoved”} disp (['ROI移动了以前的位置:'mat2str (evt.PreviousPosition)]);disp (['ROI移动当前位置:'mat2str (evt.CurrentPosition)]);结束结束

输入参数

全部折叠

ROI之父,指定为对象或A.UIAxes对象。有关在ui轴中使用ROI(包括重要限制)的信息,请参见在使用App Designer创建的应用中使用ROIS

名称-值参数

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

例子:“颜色”、“y”产生一个黄色的彩色多边形对象

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

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

您可以通过名称指定一些常见颜色作为字符串标量或字符向量。这个表列出了命名的颜色选项和等效的RGB三联体。

颜色名称 短名称 RGB值 外貌
“红色” “r” [1 0 0]

一个矩形纯红色

“绿色” ‘g’ (0 1 0)

纯绿色的长方形

“蓝” 'B' (0 0 1)

纯蓝色的长方形

'青色' “c” (0 1 1)

纯青色的长方形

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

一个矩形彩色纯洋红色

“黄色” “y” (1 1 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”

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

例子:“颜色”,[0 0.4470 - 0.7410)

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

上下文菜单提供了一个删除ROI的选项,指定为真的或者.当值为真的,您可以使用上下文菜单交互地删除ROI。当值为时,删除ROI的上下文菜单选项被禁用。

在这两种情况下,您都可以在上下文菜单之外使用删除函数。

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

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

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

ROI面可以捕捉点击,指定为真的或者.当真的(默认),ROI面部捕获鼠标点击。当, ROI的面孔不捕捉鼠标点击。

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

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

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

价值 描述
“所有” ROI是完全可交互的(默认)。
“没有” ROI是不可交互的,没有可见的阻力点。
“翻译” ROI可以在绘图区域内翻译(移动),但不能重新竖起。
“重塑” ROI可以重新竖起但未翻译。

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

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

标签文本颜色,指定为RGB三联网,颜色名称或短颜色名称。

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

您可以通过名称指定一些常见颜色作为字符串标量或字符向量。这个表列出了命名的颜色选项和等效的RGB三联体。

颜色名称 短名称 RGB值 外貌
“红色” “r” [1 0 0]

一个矩形纯红色

“绿色” ‘g’ (0 1 0)

纯绿色的长方形

“蓝” 'B' (0 0 1)

纯蓝色的长方形

'青色' “c” (0 1 1)

纯青色的长方形

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

一个矩形彩色纯洋红色

“黄色” “y” (1 1 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对象。有关在ui轴中使用ROI(包括重要限制)的信息,请参见在使用App Designer创建的应用中使用ROIS

ROI的位置,指定为一个n-by-2数字矩阵在其中n是定义ROI的顶点或点数。每行代表[xy顶点或点的坐标。

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

选择时,投资回报的颜色,指定为RGB三联网,颜色名称,短颜色名称或“没有”.如果您指定“没有”,然后是值颜色定义所有选中或未选中状态的ROI颜色。

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

您可以通过名称指定一些常见颜色作为字符串标量或字符向量。这个表列出了命名的颜色选项和等效的RGB三联体。

颜色名称 短名称 RGB值 外貌
“红色” “r” [1 0 0]

一个矩形纯红色

“绿色” ‘g’ (0 1 0)

纯绿色的长方形

“蓝” 'B' (0 0 1)

纯蓝色的长方形

'青色' “c” (0 1 1)

纯青色的长方形

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

一个矩形彩色纯洋红色

“黄色” “y” (1 1 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]

深红色的长方形

例子:'selectscolor','r'

例子:'selectscolor','绿色'

例子:“SelectedColor”,[0 0.4470 - 0.7410)

ROI条带的颜色,指定为RGB三联网,颜色名称,短颜色名称或“没有”.如果您指定“没有”,则ROI边缘为指定的纯色颜色.否则,ROI的边缘是条纹的,颜色在指定的颜色之间交替颜色StripeColor

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

您可以通过名称指定一些常见颜色作为字符串标量或字符向量。这个表列出了命名的颜色选项和等效的RGB三联体。

颜色名称 短名称 RGB值 外貌
“红色” “r” [1 0 0]

一个矩形纯红色

“绿色” ‘g’ (0 1 0)

纯绿色的长方形

“蓝” 'B' (0 0 1)

纯蓝色的长方形

'青色' “c” (0 1 1)

纯青色的长方形

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

一个矩形彩色纯洋红色

“黄色” “y” (1 1 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”、“绿色”

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

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

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

ROI可见性,指定为“上”或者“关闭”,或作为一个数字或逻辑1(真正的)或0(假)。的值“上”等于true,那么“关闭”相当于假。该值存储为类型的开/关逻辑值OnOffSwitchState

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

输出参数

全部折叠

多边形投资回报率,作为一个返回多边形对象。

提示

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

    行为 键盘快捷键
    使所绘制的线以15度角闭合。 举行转变关键的同时。
    完成ROI的绘制(关闭)。

    双击,在指针位置添加一个新顶点,并向第一个顶点绘制一条线以关闭多边形。

    新闻输入,它在指针位置添加一个新顶点,并向第一个顶点绘制一条线以关闭多边形。

    右键单击,它不添加新顶点,而是从上一个顶点关闭多边形。

    在第一个顶点上的位置指针,然后单击。

    取消绘制ROI。 新闻Esc键.函数返回一个有效的ROI对象,其值为空位置财产。
    向ROI添加新顶点。

    将指针放置在ROI的边缘上,双击。

    将指针放置在感兴趣区域的边缘,单击鼠标右键,选择添加顶点从上下文菜单。

    删除最近添加的顶点,但继续绘制。 新闻退格.函数重画从前一个顶点到指针当前位置的直线。你只能回到你画的第一个顶点。
    调整ROI的大小(重塑)

    在顶点上的位置指针,然后单击并拖动。

    向ROI中添加一个新顶点,然后单击并拖动。

    删除一个顶点。ROI重画连接两个相邻顶点的直线。

    移动投资回报率。 将指针放在ROI上(不是顶点上)。指针更改为浮动形状。单击并拖动以移动ROI。
    删除ROI。 将指针放在ROI上的任何位置并右键单击。选择删除多边形从上下文菜单。您也可以使用删除函数。
  • drawpolygon函数创建一个多边形对象。在创建对象之后,您可以使用这些对象功能修改ROI的形状、位置、外观和行为。

    能力 金宝app
    对象属性

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

    例如,要改变颜色ROI.为黄色,设置它颜色财产:

    roi。颜色=“黄色”

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

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

    的事件监听器使用示例多边形对象,参见为多边形ROI事件设置监听器

兼容性考虑因素

全部展开

不建议在R2020a开始

介绍了R2018b