imrect

Создайте перемещаемый прямоугольник

imrect не рекомендуется. Используйте новый Rectangle Объект ROI вместо этого. Можно также использовать новую функцию удобства ROI drawrectangle. Для получения дополнительной информации см. Вопросы совместимости.

Описание

imrect объект инкапсулирует интерактивный прямоугольник по изображению.

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

Создание

Синтаксис

h = imrect

h = imrect(hparent)

h = imrect(hparent,position)

h = imrect(___,Name,Value)

Описание

h = imrect начинает интерактивное размещение прямоугольника на текущей системе координат и возвращает imrect объект.

h = imrect(hparent) начинает интерактивное размещение прямоугольника на объекте, заданном hparent.

пример

h = imrect(hparent,position) создает перемещаемый прямоугольник в положении position на объекте, заданном hparent.

h = imrect(___,Name,Value) задает пары "имя-значение", которые управляют поведением прямоугольника.

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

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

`hparent` — Обработайте к родительскому объекту
указатель

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

`position` — Положение прямоугольника
Вектор с 4 элементами

Положение прямоугольника, заданного как вектор с 4 элементами формы [xmin ymin width height]. Начальным размером прямоугольника является width- height, и верхний левый угол прямоугольника в (x, y) координата (xminymin ).

Аргументы в виде пар имя-значение

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

`'PositionConstraintFcn'` — Ограничительная функция положения
указатель на функцию

Ограничительная функция положения, заданная как разделенная запятой пара, состоящая из 'PositionConstraintFcn' и указатель на функцию. fcn называется каждый раз, когда мышь перетаскивается. Можно использовать эту функцию, чтобы управлять, куда прямоугольник может быть перетащен. Смотрите справку для setPositionConstraintFcn функция для получения информации о допустимых указателях на функцию.

Свойства

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

`Deletable` — ROI может быть удален
`true` (значение по умолчанию) | `false`

ROI может быть удален, задан как true или false.

Типы данных: логический

Использование

Когда вы вызываете imrect с интерактивным синтаксисом указатель превращается на крест нитей когда по изображению. Можно создать прямоугольник и настроить его размер и положение с помощью мыши. Прямоугольник также поддерживает контекстное меню, которое можно использовать, чтобы управлять аспектами его внешнего вида и поведения. Щелкните правой кнопкой по прямоугольнику, чтобы получить доступ к этому контекстному меню.

Таблица приводит интерактивные поведения, поддержанные imrect.

Интерактивное поведение	Описание
Перемещение прямоугольника.	Переместите указатель в прямоугольнике. Указатель превращается в форму fleur. Перетащите мышь, чтобы переместить прямоугольник.
Изменение размеров прямоугольника.	Переместите указатель через любое из ребер или углы прямоугольника, изменений формы в симметричной стреле. Перетащите ребро или угол с помощью мыши.
Изменение цвета прямоугольника.	Переместите указатель в прямоугольнике. Щелкните правой кнопкой и выберите Set Color из контекстного меню.
Получение координат текущего положения	Переместите указатель в многоугольнике. Щелкните правой кнопкой и выберите Copy Position из контекстного меню. `imrect` копирует четырехэлементный радиус-вектор в буфер обмена.
Сохраните текущее соотношение сторон прямоугольника во время интерактивного изменения размеров.	Переместите указатель в прямоугольнике. Щелкните правой кнопкой и выберите Fix Aspect Ratio из контекстного меню.
Удаление прямоугольника	Переместите указатель в прямоугольнике или на ребре прямоугольника. Щелкните правой кнопкой и выберите Delete из контекстного меню. Чтобы удалить эту опцию из контекстного меню, установите `Deletable` свойство ко лжи: `h = imrect(); h.Deletable = false;`

Когда вы используете setResizeable чтобы сделать прямоугольник неизменяемого размера, элемент контекстного меню Fix Aspect Ratio не обеспечивается.

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

Каждый imrect поддержка объектов много функций. Введите methods imrect видеть полный список.

`addNewPositionCallback`	Добавьте ново-позиционный коллбэк в объект ROI
`createMask`	Создайте маску в изображении
`delete`	Удалите объект указателя
`getColor`	Доберитесь цвет раньше чертил объект ROI
`getPosition`	Возвратите текущее положение объекта ROI
`getPositionConstraintFcn`	Возвратите указатель на функцию в ограничительную функцию текущего положения
`removeNewPositionCallback`	Удалите ново-позиционный коллбэк из объекта ROI
`resume`	(Не рекомендуемый) выполнение Резюме командной строки MATLAB
`setColor`	Выберите цвет, используемый, чтобы чертить объект ROI
`setConstrainedPosition`	Установите объект ROI на новое положение
`setFixedAspectRatioMode`	Сохраните соотношение сторон при изменении размеров объекта ROI
`setPosition`	Переместите объект ROI в новое положение
`setPositionConstraintFcn`	Установите ограничительную функцию положения объекта ROI
`setResizable`	Установите поведение при изменении размера объекта ROI
`wait`	(Не рекомендуемый), командная строка MATLAB Блока, пока создание ROI не закончено

Примеры

Обновите Заголовок когда Прямоугольные Перемещения

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

imshow('cameraman.tif')
h = imrect(gca,[10 10 100 100]);
addNewPositionCallback(h,@(p) title(mat2str(p,3)));

Задайте ограничительную функцию положения использование makeConstrainToRectFcn сохранить прямоугольник в исходном XLim и YLim области значений изображения.

fcn = makeConstrainToRectFcn('imrect',get(gca,'XLim'),get(gca,'YLim'));
setPositionConstraintFcn(h,fcn);

Теперь перетащите прямоугольник с помощью мыши. Заметьте, что прямоугольник больше не может расширять мимо границы изображения.

Перетащите, чтобы поместить прямоугольник

В интерактивном режиме поместите прямоугольник путем перетаскивания. Используйте wait блокировать командную строку MATLAB^®. Дважды кликните на прямоугольнике, чтобы возобновить выполнение командной строки MATLAB.

imshow('pout.tif');
h = imrect;
position = wait(h);

Советы

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

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

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

imrect не рекомендуется

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

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

Замените использование imrect Объект ROI с новым Rectangle Объект ROI. Можно также использовать функцию удобства создания ROI drawrectangle.

Обновите код создания ROI

Обновите все экземпляры imrect.

Нежелательное использование	Рекомендуемая замена
Этот пример создает прямоугольный ROI. imshow('cameraman.tif'); h = imrect(gca,[10 10 100 150]);	Вот эквивалентный код, заменяя старый объект ROI на новый объект ROI. Этот пример использует функцию удобства создания ROI. Обратите внимание на то, что необходимо задать размер и информацию о положении как имя, пара значения. imshow('cameraman.tif'); h = drawrectangle(gca,'Position',[10 10 100 150]);

Нежелательное использование

Рекомендуемая замена

Этот пример создает прямоугольный ROI.

imshow('cameraman.tif');
h = imrect(gca,[10 10 100 150]);

Вот эквивалентный код, заменяя старый объект ROI на новый объект ROI. Этот пример использует функцию удобства создания ROI. Обратите внимание на то, что необходимо задать размер и информацию о положении как имя, пара значения.

imshow('cameraman.tif');
h = drawrectangle(gca,'Position',[10 10 100 150]);

Другие обновления ROI кода

Обновите код, который использует любую из объектных функций imrect Объект ROI. Во многих случаях можно заменить вызов imrect возразите функции путем простого доступа или устанавливания значения Rectangle Свойство объекта ROI. Например, замените вызовы getColor или setColor с использованием Color свойство. В некоторых случаях необходимо заменить imrect возразите функции с объектной функцией нового Rectangle ROI. Каждый отдельный imrect Функции объекта ROI включают информацию о миграции на новый Rectangle Объект ROI. Для обзора миграции смотрите Миграцию ROI.

Документация

imrect

Описание

Создание

Синтаксис

Описание

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

`hparent` — Обработайте к родительскому объекту
указатель

`position` — Положение прямоугольника
Вектор с 4 элементами

Аргументы в виде пар имя-значение

`'PositionConstraintFcn'` — Ограничительная функция положения
указатель на функцию

Свойства

`Deletable` — ROI может быть удален
`true` (значение по умолчанию) | `false`

Использование

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

Примеры

Обновите Заголовок когда Прямоугольные Перемещения

Перетащите, чтобы поместить прямоугольник

Советы

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

imrect не рекомендуется

Обновите код создания ROI

Другие обновления ROI кода

Смотрите также

Представлено до R2006a

Документация Image Processing Toolbox

Поддержка

Документация

imrect

Описание

Создание

Синтаксис

Описание

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

hparent — Обработайте к родительскому объекту указатель

position — Положение прямоугольника Вектор с 4 элементами

Аргументы в виде пар имя-значение

'PositionConstraintFcn' — Ограничительная функция положения указатель на функцию

Свойства

Deletable — ROI может быть удален true (значение по умолчанию) | false

Использование

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

Примеры

Обновите Заголовок когда Прямоугольные Перемещения

Перетащите, чтобы поместить прямоугольник

Советы

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

imrect не рекомендуется

Обновите код создания ROI

Другие обновления ROI кода

Смотрите также

Представлено до R2006a

Документация Image Processing Toolbox

Поддержка

`hparent` — Обработайте к родительскому объекту
указатель

`position` — Положение прямоугольника
Вектор с 4 элементами

`'PositionConstraintFcn'` — Ограничительная функция положения
указатель на функцию

`Deletable` — ROI может быть удален
`true` (значение по умолчанию) | `false`