images.roi. Класс кубоида

Пакет: images.roi

Кубовидная видимая область

Описание

Класс images.roi.Cuboid создает кубовидный объект видимой области (ROI). Вы вызываете метод draw объекта начать чертить ROI в интерактивном режиме при помощи вашей мыши. Можно также настроить размер и положение ROI при помощи мыши. ROI также имеет контекстное меню, которое управляет аспектами его внешнего вида и поведения.

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

Класс images.roi.Cuboid является классом handle.

Создание

Описание

пример

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

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

h = images.roi.Cuboid(___,Name,Value) изменяет внешний вид или поведение ROI путем определения значений для одного или нескольких свойств ROI. Можно установить свойства с помощью пар "имя-значение" с или не задавая оси.

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

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

Родительский элемент ROI, заданного как объект Axes.

Свойства

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

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

Пример: 'green'

Пример: 'g'

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

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

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

ЗначениеОписание
'auto'

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

'unlimited'Область рисунка не имеет никакого контура, и КОРОЛИ могут чертиться или перетаскиваться, чтобы расширить вне пределов осей.
[x,y,z,w,h,d]Область рисунка ограничивается областью, начинающейся в (x, y, z), с шириной w, высота h и глубина d.

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

Пример: drawcuboid('EdgeAlpha',0.2)

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

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

Пример: drawcuboid('FaceAlphaOnHover',1)

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

Пример: drawcuboid('FaceAlphaOnHover',1)

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

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

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

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

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

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

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

Ширина ребра ROI, заданного в виде положительного числа в точках.

Родительский элемент ROI, заданный как объект Axes. UIAxes не может быть родительским элементом ROI.

Положение кубоида, заданного как 1 6 массив формы [xmin, ymin, zmin, width, height, depth]. Эти обновления свойства автоматически, когда вы чертите или перемещаете кубоид.

Способность кубоида, который будет вращаться, заданный как одно из этих значений:

ЗначениеОписание
'all'ROI является полностью поворотным.
'x' ROI может только вращаться об оси x
'y'ROI может только вращаться об оси y.
'z'ROI может только вращаться об оси z.
'none'ROI не является поворотным.

Угол вращения ROI, заданного как 1 3 числовой массив углов поворота, измеренных в градусах. Массив углов поворота имеет форму [x_angle y_angle z_angle], измеренный о x - y - и z - ось, соответственно. Вращение применяется о центроиде ROI по порядку z, затем y, затем x.

Значение RotationAngle не влияет на значения в свойстве Position. Position представляет кубоид до любого вращения. Когда вы будете вращать кубоид, используйте свойство Vertices определить местоположение вращаемого кубоида.

Способность колесика прокрутки настроить размер кубоида во время интерактивного размещения, заданного как одно из этих значений:

ЗначениеОписание
'allresize'Колесико прокрутки влияет на все размерности ROI.
'xresize' Колесико прокрутки влияет только на размерность x.
'yresize' Колесико прокрутки влияет только на размерность y.
'zresize' Колесико прокрутки влияет только на размерность z.
'none'Колесико прокрутки не имеет никакого эффекта.

Состояние выбора 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, возвращенного как 8 3 массив.

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

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

Методы

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

События

EventNameТриггерДанные о событияхАтрибуты события
DeletingROIROI собирается быть в интерактивном режиме удаленным.event.EventData

NotifyAccess: private

ListenAccess: public

DrawingStartedROI собирается в интерактивном режиме чертиться.event.EventData

NotifyAccess: private

ListenAccess: public

DrawingFinishedROI в интерактивном режиме чертился.event.EventData

NotifyAccess: private

ListenAccess: public

MovingROIФорма ROI или местоположение в интерактивном режиме изменяются.images.roi.CuboidMovingEventData

NotifyAccess: private

ListenAccess: public

ROIMovedФорма ROI или местоположение были в интерактивном режиме изменены.images.roi.CuboidMovingEventData

NotifyAccess: private

ListenAccess: public

ROIClickedПо ROI кликнули. images.roi.ROIClickedEventData

NotifyAccess: private

ListenAccess: public

Примеры

свернуть все

Задайте векторы для 3-D поля точек данных.

[x,y,z] = sphere(16);
X = [x(:)*.5 x(:)*.75 x(:)];
Y = [y(:)*.5 y(:)*.75 y(:)];
Z = [z(:)*.5 z(:)*.75 z(:)];

Задайте размер и цвет каждого маркера.

S = repmat([1 .75 .5]*10,numel(x),1);
C = repmat([1 2 3],numel(x),1);

Создайте 3-D график рассеивания и используйте представление для изменения угол осей в фигуре.

figure
hScatter = scatter3(X(:),Y(:),Z(:),S(:),C(:),'filled'); 
view(-60,60);

Начните помещать кубоид в оси, который привязывается к самой близкой точке из графика рассеивания. Настройте размер кубоида во время интерактивного размещения при помощи колесика прокрутки.

ax = gca;
h = images.roi.Cuboid(ax);
draw(h)

Советы

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

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

    Расположите указатель на одну из видимых поверхностей кубоида и перетащите поверхность. Вам придется вращать кубоид, чтобы выбрать поверхность.

    Если вы нажимаете Shift, перетаскивание мыши перемещает ROI, но не изменяет ни одной из размерностей.

    Переместите ROI.

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

    Расположите указатель на любую видимую поверхность ROI, щелкните правой кнопкой и выберите Lock Dimensions. Перетащите, чтобы переместить ROI.

  • Для получения информации об использовании ROI в приложении, созданном с App Designer, смотрите Используя КОРОЛЕЙ в Приложениях, Созданных с App Designer.

Введенный в R2019a

Для просмотра документации необходимо авторизоваться на сайте