Circle

Круговая необходимая область

Описание

Circle объект является круговой видимой областью (ROI).

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

Создание

Описание

Создать Circle объект, используйте images.roi.Circle функция создания. После создания объекта вызовите draw возразите функции, чтобы начать чертить. Как удобство, можно также использовать drawcircle функция, чтобы создать Circle ROI. drawcircle функция создает объект ROI и автоматически вызывает draw объектная функция.

пример

roi = images.roi.Circle создает экземпляр images.roi.Circle класс со свойствами по умолчанию.

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

roi = images.roi.Circle(___,Name,Value) свойства наборов с помощью пар "имя-значение". Например, images.roi.Circle('Color','y') выбирает цвет Circle возразите против желтого. Можно задать несколько пар "имя-значение". Заключите каждое имя свойства в одинарные кавычки.

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

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

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

Свойства

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

Центр ROI, заданного как 1 2 числовой массив формы [x y]. Значения x и y являются координатами центральной точки ROI. Значение этого свойства изменяется автоматически, когда вы чертите или перемещаете ROI.

Цвет ROI, заданный как MATLAB® ColorSpec (Color Specification).

Пример: 'green'

Пример: 'g'

Пример: [0 1 0]

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

Область осей, в которые можно в интерактивном режиме поместить 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 не имеет никакой метки ('').

Видимость метки ROI, заданной как одно из этих значений:

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

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

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

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

Состояние выбора ROI, заданного как логическое значение true или false. Можно также установить это свойство в интерактивном режиме. Например, нажатие на ROI выбирает ROI и устанавливает это свойство на true. Точно так же нажатие клавиши Ctrl и нажатие на ROI отменяют выбор ROI и устанавливают значение этого свойства к false.

Цвет ROI, когда выбрано, заданный как ColorSpec (Color Specification) MATLAB. Интенсивность должна быть в области значений [0,1]. Если 'SelectedColor' установлен в 'none', затем значение Color задает цвет ROI для всех состояний, выбранных или нет.

Пример: 'green'

Пример: 'g'

Пример: [0 1 0]

Цвет дорожки ROI, заданной как ColorSpec (Color Specification) MATLAB значение. По умолчанию ребро ROI твердо окрашенный. Если вы задаете StripeColor, ребро ROI чередуется. Чередование состоит из комбинации значения, заданного 'Color' и это значение.

Пример: 'green'

Пример: 'g'

Пример: [0 1 0]

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

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

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

Местоположения точек на ребре ROI, возвращенного как n-by-2 массив, где n является общим количеством вершин.

Это свойство доступно только для чтения.

Видимость ROI, заданная как одно из значений в этой таблице.

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

Функции объекта

addlistenerСоздайте прослушиватель события, связанный с источником события
beginDrawingFromPointНачните чертить ROI от заданной точки
bringToFrontПеренесите ROI на передний план порядка размещения Осей
createMaskСоздайте бинарный рисунок маски из ROI
drawНачните чертить ROI в интерактивном режиме
inROIЗапросите, расположены ли точки в ROI
waitБлокируйте командную строку MATLAB, пока операция ROI не будет закончена

Примеры

свернуть все

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

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

Создайте круговой ROI на изображении. Используйте 'Center' свойство задать местоположение и 'Radius' свойство задать размер. Для программно созданных ROI, если вы хотите ROI, чертивший в определенные оси, необходимо указать что оси как входной параметр. В противном случае, экземпляр images.roi.Circle класс создан, но не отображен. В этом примере задайте текущую систему координат (gca), чтобы чертить ROI на изображении в этом оси.

h = images.roi.Circle(gca,'Center',[1000 1000],'Radius',500);

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

I = imread('cameraman.tif');

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

imshow(I);

Чертите круговой ROI на изображении. Поскольку этот пример задает размер и местоположение ROI, вы не должны вызывать draw метод, чтобы включить интерактивный рисунок.

roi = images.roi.Circle(gca,'Center',[100 100],'Radius',50);

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

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

allevents функция обратного вызова отображает в командной строке текущий центр и текущий радиус Circle ROI.

function allevents(src,evt)
evname = evt.EventName;
    switch(evname)
        case{'MovingROI'}
            disp(['ROI moving Current Center: ' mat2str(evt.CurrentCenter)]);
            disp(['ROI moving Current Radius: ' mat2str(evt.CurrentRadius)]);
        case{'ROIMoved'}
            disp(['ROI moved Current Center: ' mat2str(evt.CurrentCenter)]);
            disp(['ROI moved Current Radius: ' mat2str(evt.CurrentRadius)]);
    end
end

Больше о

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

Советы

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

    ПоведениеГорячая клавиша
    Конец, чертящий ROI.

    Выпустите курсор мыши.

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

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

    Переместите ROI.Расположите курсор где угодно в ROI, нажмите и содержите мышь и переместите ROI через изображение.
    Удалите ROI.Расположите курсор на круг, щелкните правой кнопкой и выберите Delete Circle из контекстного меню. Можно также удалить ROI программно с помощью delete объектная функция.
  • Для получения информации об использовании ROI в приложении, созданном с App Designer, смотрите Используя ROI в Приложениях, Созданных с App Designer.

Введенный в R2018b