Cuboid

Кубоидные необходимые области

Описание

The Cuboid объект является кубоидной видимой областью (ROI).

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

Создание

Описание

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

пример

roi = images.roi.Cuboid создает Cuboid Объект информация только для чтения со свойствами по умолчанию.

roi = images.roi.Cuboid(ax) создает Cuboid Объект информация только для чтения на осях, заданных ax.

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

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

расширить все

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

Свойства

расширить все

Информация только для чтения, заданный как MATLAB® ColorSpec (Color Specification).

Пример: 'green'

Пример: 'g'

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

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

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

Область осей, в которой можно в интерактивном режиме разместить информация только для чтения, заданную в качестве одного из значений в этой таблице.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пометьте цвет текста, заданный как MATLAB ColorSpec (Color Specification). Интенсивность должна быть в области значений [0,1].

Видимость метки, заданная в качестве одного из следующих значений:

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

Ширина ребра информация только для чтения, заданная как положительный числовой скаляр в точках.

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

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

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

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

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

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

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

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

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

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

Пример: 'green'

Пример: 'g'

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

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

Пример: 'green'

Пример: 'g'

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

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

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

Местоположения углов кубоидального информация только для чтения, возвращенные как массив 8 на 3.

Видимость информация только для чтения, заданная как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

Примеры

свернуть все

Задайте векторы для 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)

Задайте векторы для 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);

Создайте объект Cuboid информации только для чтения, задав цвет. Вызовите draw функция объекта для активации интерактивного рисования кубоидной формы.

roi = images.roi.Cuboid(gca,'Color','r');
draw(roi)

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

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

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

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

Подробнее о

расширить все

Совет

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

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

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

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

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

расширить все

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

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