drawpolygon

Создайте настраиваемый многоугольный ROI

Описание

drawpolygon функция создает Polygon объект, который задает форму и положение многоугольной видимой области (ROI). Можно создать ROI в интерактивном режиме путем рисования ROI по изображению с помощью мыши, или программно при помощи аргументов name-value. Можно также задать начальный внешний вид и поведение ROI.

Blue Polygon ROI with 10 vertices drawn over an object in an image.

После того, как вы создадите ROI, можно использовать свойства объектов, объектные функции и уведомления о событии, чтобы настроить форму, положение, внешний вид и поведение ROI. Для получения дополнительной информации об использовании этих возможностей смотрите Советы.

пример

roi = drawpolygon создает Polygon возразите и включает интерактивный рисунок многоугольного ROI на текущей системе координат.

Чтобы чертить ROI, расположите указатель на изображение. Курсор превращается в форму fleur. Щелкните, чтобы чертить вершины многоугольника и перетащить, чтобы провести линии между вершинами. Чтобы закончить ROI, дважды кликните кнопку мыши. Для получения дополнительной информации об использовании ROI, включая горячие клавиши и опции контекстного меню, смотрите Советы.

roi = drawpolygon(ax) создает ROI на осях, заданных ax.

roi = drawpolygon(___,Name,Value) изменяет внешний вид и поведение ROI с помощью одних или нескольких аргументов name-value.

Примеры

свернуть все

Считайте изображение в рабочую область и отобразите ее.

imshow(imread('strawberries.jpg'))

Чертите многоугольный ROI на изображении. Используйте 'FaceAlpha' пара "имя-значение", чтобы сделать поверхность ROI прозрачной.

h = drawpolygon('FaceAlpha',0);

Измените цвет схемы многоугольника путем установки 'Color' свойство ROI.

h.Color = 'yellow';

Считайте изображение в рабочую область и отобразите его.

I = imread('baby.jpg');
figure
imshow(I)

Figure contains an axes object. The axes object contains an object of type image.

Чертите многоугольный ROI по изображению, с помощью Position параметр, чтобы задать местоположение вершин.

my_vertices = [500 500;400 600;400 700;500 800;600 800;700 700; 700 600];
h = drawpolygon('Position',my_vertices);

Figure contains an axes object. The axes object contains 2 objects of type image, images.roi.polygon.

Считайте изображение в рабочую область.

I = imread('cameraman.tif'); 

Отобразите изображение.

imshow(I);

Чертите многоугольный ROI на изображении.

roi = drawpolygon('Color','r');

Настройте прослушиватели для ROI движущиеся события. Когда вы перемещаете его, ROI отправляет уведомления об этих событиях и выполняет функцию обратного вызова, которую вы задаете.

addlistener(roi,'MovingROI',@allevents);
addlistener(roi,'ROIMoved',@allevents);

allevents функция обратного вызова отображает предыдущее положение и текущее положение ROI.

function allevents(src,evt)
    evname = evt.EventName;
    switch(evname)
        case{'MovingROI'}
            disp(['ROI moving previous position: ' mat2str(evt.PreviousPosition)]);
            disp(['ROI moving current position: ' mat2str(evt.CurrentPosition)]);
        case{'ROIMoved'}
            disp(['ROI moved previous position: ' mat2str(evt.PreviousPosition)]);
            disp(['ROI moved current position: ' mat2str(evt.CurrentPosition)]);
    end
end

Входные параметры

свернуть все

Родительский элемент ROI в виде Axes возразите или UIAxes объект. Для получения информации об использовании ROI в UIAxes, включая важные ограничения, смотрите Используя ROI в Приложениях, Созданных с App Designer.

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Color','y' создает желтый Polygon объект

Цвет ROI в виде триплета RGB, названия цвета или короткого названия цвета.

Можно задать любой цвет с помощью триплета RGB. Триплет RGB является вектором-строкой с 3 элементами, элементы которого задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0,1].

Можно задать некоторые простые цвета по наименованию как строковый скаляр или вектор символов. Эта таблица приводит опции именованного цвета и эквивалентные триплеты RGB.

Название цветаКраткое названиеТриплет RGBВнешний вид
'red''r'[1 0 0]

A rectangle colored pure red

'green''g'[0 1 0]

A rectangle colored pure green

'blue''b'[0 0 1]

A rectangle colored pure blue

'cyan' 'c'[0 1 1]

A rectangle colored pure cyan

'magenta''m'[1 0 1]

A rectangle colored pure magenta

'yellow''y'[1 1 0]

A rectangle colored pure yellow

'black''k'[0 0 0]

A rectangle colored black

'white''w'[1 1 1]

A rectangle colored white

Вот триплеты RGB для цветов по умолчанию что MATLAB® использование во многих типах графиков.

Триплет RGBВнешний вид
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Пример: 'Color','r'

Пример: 'Color','green'

Пример: 'Color',[0 0.4470 0.7410]

Контекстное меню, которое отображается, когда вы щелкаете правой кнопкой по ROI в виде ContextMenu объект. Можно создать пользовательское контекстное меню при помощи uicontextmenu функционируйте и затем конфигурирующий свойства контекстного меню.

Контекстное меню предоставляет возможность удалять ROI в виде true или false. Когда значением является true, можно удалить ROI в интерактивном режиме с помощью контекстного меню. Когда значением является false, опция контекстного меню, чтобы удалить ROI отключена.

В обоих случаях можно удалить ROI за пределами контекстного меню при помощи delete функция.

Область осей, в которые можно в интерактивном режиме поместить ROI в виде одного из значений в этой таблице.

ЗначениеОписание
'auto'Областью рисунка являются пределы текущей системы координат (значение по умолчанию).
'unlimited'Область рисунка не имеет никакого контура, и ROI могут чертиться или перетаскиваться, чтобы расширить вне пределов осей.
[x,y,w,h]Область рисунка ограничивается прямоугольной областью, начинающейся в (x, y), и расширяющей к ширине w и высота h.

Прозрачность ROI стоит в виде номера в области значений [0, 1]. Когда значением является 1, поверхность ROI абсолютно непрозрачна. Когда значением является 0, поверхность ROI абсолютно прозрачна.

Поверхность ROI может получить нажатия кнопки в виде true или false. Когда true (значение по умолчанию), поверхность ROI захватывает клики мыши. Когда false, поверхность ROI не захватывает клики мыши.

Видимость ROI обрабатывает в Children свойство родительского элемента в виде одного из значений в этой таблице.

ЗначениеОписание
'on'Указатель на объект всегда отображается (значение по умолчанию).
'off'Указатель на объект скрыт в любом случае.
'callback' Указатель на объект отображается из коллбэков или функций, вызванных коллбэками, но не из функций, вызванных из командной строки.

Интерактивность ROI в виде одного из значений в этой таблице.

ЗначениеОписание
'all'ROI является полностью межигровым (значение по умолчанию).
'none'ROI не является межигровым, и никакие не перетаскивают точки, отображаются.
'translate'ROI может быть переведен (перемещенный) в области рисунка, но не изменился.
'reshape'ROI может быть изменен, но не переведен.

Метка ROI в виде вектора символов или строкового скаляра. По умолчанию ROI не имеет никакой метки ('').

Прозрачность фона текста в виде номера в области значений [0, 1]. Когда установлено в 1, фон текста абсолютно непрозрачен. Когда установлено в 0, фон текста абсолютно прозрачен.

Цвет текста метки в виде триплета RGB, названия цвета или короткого названия цвета.

Можно задать любой цвет с помощью триплета RGB. Триплет RGB является вектором-строкой с 3 элементами, элементы которого задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0,1].

Можно задать некоторые простые цвета по наименованию как строковый скаляр или вектор символов. Эта таблица приводит опции именованного цвета и эквивалентные триплеты RGB.

Название цветаКраткое названиеТриплет RGBВнешний вид
'red''r'[1 0 0]

A rectangle colored pure red

'green''g'[0 1 0]

A rectangle colored pure green

'blue''b'[0 0 1]

A rectangle colored pure blue

'cyan' 'c'[0 1 1]

A rectangle colored pure cyan

'magenta''m'[1 0 1]

A rectangle colored pure magenta

'yellow''y'[1 1 0]

A rectangle colored pure yellow

'black''k'[0 0 0]

A rectangle colored black

'white''w'[1 1 1]

A rectangle colored white

Вот триплеты RGB для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Триплет RGBВнешний вид
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Пример: 'LabelTextColor','r'

Пример: 'LabelTextColor','green'

Пример: 'LabelTextColor',[0 0.4470 0.7410]

Пометьте видимость в виде одного из этих значений.

ЗначениеОписание
'on'Метка отображается, когда ROI отображается.
'hover'Метка отображается только, когда мышь наводит на ROI.
'off'Метка не отображается.

Ширина ROI граничит в виде положительного числа в точках. Значением по умолчанию является три раза число точек на экранный пиксель, такой, что граница три пикселя шириной.

Размер маркера в виде положительного числа в точках. Значением по умолчанию является восемь раз число точек на экранный пиксель, такой, что маркеры составляют восемь пикселей в размере.

Родительский элемент ROI в виде Axes или UIAxes объект. Для получения информации об использовании ROI в UIAxes, включая важные ограничения, смотрите Используя ROI в Приложениях, Созданных с App Designer.

Положение ROI в виде n-by-2 числовая матрица, где n является количеством вершин или точек, задающих ROI. Каждая строка представляет [x y] координаты вершины или точки.

Состояние выбора ROI в виде логического значения true или false.

Цвет ROI, когда выбрано в виде триплета RGB, названия цвета, короткого названия цвета или 'none'. Если вы задаете 'none', затем значение Color задает цвет ROI для всех состояний, выбранных или нет.

Можно задать любой цвет с помощью триплета RGB. Триплет RGB является вектором-строкой с 3 элементами, элементы которого задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0,1].

Можно задать некоторые простые цвета по наименованию как строковый скаляр или вектор символов. Эта таблица приводит опции именованного цвета и эквивалентные триплеты RGB.

Название цветаКраткое названиеТриплет RGBВнешний вид
'red''r'[1 0 0]

A rectangle colored pure red

'green''g'[0 1 0]

A rectangle colored pure green

'blue''b'[0 0 1]

A rectangle colored pure blue

'cyan' 'c'[0 1 1]

A rectangle colored pure cyan

'magenta''m'[1 0 1]

A rectangle colored pure magenta

'yellow''y'[1 1 0]

A rectangle colored pure yellow

'black''k'[0 0 0]

A rectangle colored black

'white''w'[1 1 1]

A rectangle colored white

Вот триплеты RGB для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Триплет RGBВнешний вид
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Пример: 'SelectedColor','r'

Пример: 'SelectedColor','green'

Пример: 'SelectedColor',[0 0.4470 0.7410]

Цвет ROI чередует в виде триплета RGB, названия цвета, короткого названия цвета или 'none'. Если вы задаете 'none', затем ребро ROI является сплошным цветом, заданным Color. В противном случае ребро ROI чередуется с цветами, чередующимися между цветами, заданными Color и StripeColor.

Можно задать любой цвет с помощью триплета RGB. Триплет RGB является вектором-строкой с 3 элементами, элементы которого задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0,1].

Можно задать некоторые простые цвета по наименованию как строковый скаляр или вектор символов. Эта таблица приводит опции именованного цвета и эквивалентные триплеты RGB.

Название цветаКраткое названиеТриплет RGBВнешний вид
'red''r'[1 0 0]

A rectangle colored pure red

'green''g'[0 1 0]

A rectangle colored pure green

'blue''b'[0 0 1]

A rectangle colored pure blue

'cyan' 'c'[0 1 1]

A rectangle colored pure cyan

'magenta''m'[1 0 1]

A rectangle colored pure magenta

'yellow''y'[1 1 0]

A rectangle colored pure yellow

'black''k'[0 0 0]

A rectangle colored black

'white''w'[1 1 1]

A rectangle colored white

Вот триплеты RGB для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Триплет RGBВнешний вид
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Пример: 'StripeColor','r'

Пример: 'StripeColor','green'

Пример: 'StripeColor',[0 0.4470 0.7410]

Пометьте, чтобы сопоставить с ROI в виде вектора символов или строкового скаляра. Используйте значение тега, чтобы найти объект ROI в иерархии объектов с помощью findobj функция.

Данные, чтобы сопоставить с ROI в виде любых данных MATLAB. Например, можно задать скаляр, вектор, матрицу, массив ячеек, строку, символьный массив, таблицу или структуру. drawpolygon объект не использует эти данные.

Видимость ROI в виде 'on' или 'off', или как числовой или логический 1 (TRUE) или 0 ложь. Значение 'on' эквивалентно истине и 'off' эквивалентно лжи. Значение хранится как логическое значение включения - выключения типа OnOffSwitchState.

ЗначениеОписание
'on'Отобразите ROI.
'off'Скройте ROI, не удаляя его. Все еще можно получить доступ к свойствам невидимого ROI.

Выходные аргументы

свернуть все

Многоугольный ROI, возвращенный как Polygon объект.

Советы

  • ROI поддерживает следующую интерактивность, включая горячие клавиши.

    ПоведениеГорячая клавиша
    Заставьте проведенную линию огрызаться на 15 углов степени.Удержите клавишу Shift при рисовании.
    Закончите чертить (близко) ROI.

    Дважды кликните, который добавляет новую вершину в позиции указателя и чертит линию к первой вершине, чтобы закрыть многоугольник.

    Нажмите Enter, который добавляет новую вершину в позиции указателя и чертит линию к первой вершине, чтобы закрыть многоугольник.

    Щелкните правой кнопкой, который не добавляет новую вершину, но закрывает многоугольник от предыдущей вершины.

    Указатель положения по первой вершине и нажатию кнопки.

    Отмена, чертящая ROI.Нажмите Esc. Функция возвращает допустимый объект ROI с пустым Position свойство.
    Добавьте новую вершину к ROI.

    Расположите указатель над ребром ROI и дважды кликните.

    Расположите указатель над ребром ROI, щелкните правой кнопкой и выберите Add Vertex из контекстного меню.

    Удалите последний раз добавленную вершину, но продолжите чертить.Нажмите Backspace. Функция перерисовывает линию от предыдущей вершины до текущего положения указателя. Можно только отступить до первой вершины, которую вы чертили.
    Измените размер (изменяют) ROI

    Указатель положения по вершине и затем перетаскивает.

    Добавьте новую вершину к ROI и затем перетащите.

    Удалите вершину. ROI перерисовывает линию, соединяющую две соседних вершины.

    Переместите ROI.Расположите указатель над ROI (не на вершине). Указатель превращается в форму fleur. Перетащите, чтобы переместить ROI.
    Удалите ROI.Расположите указатель где угодно на ROI и щелкните правой кнопкой. Выберите Delete Polygon из контекстного меню. Можно также удалить ROI с помощью delete функция.
  • drawpolygon функция создает Polygon объект. После того, как вы создадите объект, можно изменить форму, положение, внешний вид и поведение ROI при помощи этих объектных возможностей.

    ВозможностьПоддержка
    Свойства объектов

    Объекты ROI имеют свойства, которые задают их форму, положение, внешний вид и поведение. После того, как вы создаете объект ROI, свойства изменения с помощью записи через точку.

    Например, чтобы изменить цвет roi к желтому, устанавливает его Color свойство:

    roi.Color = 'yellow'

    Функции объектаОбъекты ROI имеют объектные функции, которые работают с ROI. Например, если вы хотите приостановить командную строку MATLAB после создания ROI, используйте wait функция.
    Уведомления о событии

    Объекты ROI могут уведомить ваш код, когда определенные события имеют место, такой как тогда, когда по ROI кликают или когда ROI перемещается. Чтобы получить уведомления о событии, настройте listeners. Когда ROI уведомляет ваше приложение через прослушиватель, это возвращает данные, характерные для события. Например, с ROIMoved событие, объект ROI возвращает свое предыдущее положение и свое текущее положение. Можно задать функцию обратного вызова, которая выполняется, когда событие имеет место.

    Для примера использования прослушивателей события с Polygon возразите, смотрите Настроенный Прослушиватель для Событий ROI Многоугольника.

Вопросы совместимости

развернуть все

Не рекомендуемый запуск в R2020a

Введенный в R2018b