insertObjectAnnotation

Аннотировать труколор или полутоновое изображение или видеопоток

Описание

пример

RGB = insertObjectAnnotation(I,shape,position,label) возвращает изображение truecolor, аннотированное как shape и label в местоположении, заданном position.

пример

RGB = insertObjectAnnotation(I,shape,position,label,Name,Value) использует дополнительные опции, заданные одним или несколькими Name,Value аргументы в виде пар.

пример

insertObjectAnnotation(I,'rectangle',position,label) вставляет прямоугольники и метки в положение, обозначенное матрицей положения.

insertObjectAnnotation(I,'circle',position,label) вставляет круги и соответствующие метки в местоположение, обозначенное матрицей положения.

Примеры

свернуть все

Чтение изображения.

I = imread('board.tif');

Создайте метки чисел с плавающей точкой. Числа с плавающей точкой относятся к меткам доверительных значений.

label_str = cell(3,1);
conf_val = [85.212 98.76 78.342];
for ii=1:3
    label_str{ii} = ['Confidence: ' num2str(conf_val(ii),'%0.2f') '%'];
end

Установите положение прямоугольников равным [x y width height].

   position = [23 373 60 66;35 185 77 81;77 107 59 26];

Вставьте метки.

RGB = insertObjectAnnotation(I,'rectangle',position,label_str,...
    'TextBoxOpacity',0.9,'FontSize',18);

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

figure
imshow(RGB)
title('Annotated chips');

Figure contains an axes. The axes with title Annotated chips contains an object of type image.

Чтение изображения.

I = imread('coins.png');

Установите положения для кругов. Первые два значения представляют центр в (x, y), а третье значение является радиусом.

position = [96 146 31;236 173 26];

Установите метку, чтобы отобразить целые числа 5 и 10 (центы США).

label = [5 10];

Вставьте аннотации.

RGB = insertObjectAnnotation(I,'circle',position,label,'LineWidth',3,'Color',{'cyan','yellow'},'TextColor','black');

Отобразите.

figure
imshow(RGB)
title('Annotated coins');

Figure contains an axes. The axes with title Annotated coins contains an object of type image.

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

свернуть все

Труколор или полутоновое изображение, заданное как изображение или видеопоток. Изображение входа может быть или M <reservedrangesplaceholder2>-by-3 truecolor или M N 2-м изображением оттенков серого.

Типы данных: double | single | uint8 | uint16 | int16

Аннотация прямоугольника или окружности, заданная как вектор символов, указывающая на форму аннотации.

Типы данных: char

Расположение и размер формы аннотации, заданные как M -by-3 или M -by-4 матрица. Когда вы задаете прямоугольник, входная матрица положения должна быть матрицей M -by-4. Каждая строка, M, определяет прямоугольник как вектор с четырьмя элементами, [<reservedrangesplaceholder7> <reservedrangesplaceholder6> <reservedrangesplaceholder5> <reservedrangesplaceholder4>]. Элементы x и y указывают верхний левый угол прямоугольника, а width и height определяют размер.

Когда Вы определяете круг, матрица входа положения должна быть матрицей <reservedrangesplaceholder7>-by-3, где каждая строка, M, определяет вектор с тремя элементами [<reservedrangesplaceholder5> <reservedrangesplaceholder4> <reservedrangesplaceholder3>]. Элементы x и y указывают центр окружности и r задают радиус.

Пример: position = [50 120 75 75]

Прямоугольник с верхним левым углом, расположенным в x = 50, y = 120, с шириной и высотой 75 пикселей.

Пример: position = [96 146 31]

Окружность с центром, расположенная в x = 96, y = 146 и радиус 31 пикселей.

Пример: position = [23 373 60 66;35 185 77 81;77 107 59 26]

Расположение и размер для трех прямоугольников.

Метка для связи с формой, заданная как M числовой вектор, строка, категориальные метки или массив ячеек ASCII векторов символов. Символ, строка или категориальные метки должны быть закодированы как символы ASCII. Массив ячеек должен быть длиной, равной количеству положений формы. Можно задать скалярную метку для всех фигур как числовой скаляр, строку или категориальную.

Пример: label = [5 10], где функция помечает первую форму меткой 5, а вторую форму меткой 10.

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

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

Пример: 'Color', 'white' устанавливает белый цвет текстового поля метки.

Лицо шрифта текста, заданное как разделенная разделенными запятой парами, состоящая из 'Font'и вектор символов. Лицо шрифта должно быть одним из доступных шрифтов truetype, установленных в вашей системе. Чтобы получить список доступных шрифтов в вашей системе, введите listTrueTypeFonts в MATLAB® командная строка.

Типы данных: char

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

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

Цвет для формы и для соответствующего текстового поля метки, заданный как разделенная разделенными запятой парами, состоящая из 'Color' и либо вектор символов, вектор [R G B], массив ячеек или матрица M -by-3.

Чтобы задать один цвет для всех форм, установите этот параметр равным вектору символов или вектору [R G B]. Чтобы задать цвет для каждой из M фигур, задайте для этого параметра массив ячеек из M векторов символов. Кроме того, для каждой аннотации можно задать матрицу M -by-3 значений RGB. Значения RGB должны быть в область значений входа типа изображений.

Поддерживаемые цвета: 'blue', 'green', 'cyan', 'red', 'magenta', 'black', и 'white'.

Типы данных: char | uint8 | uint16 | int16 | double | single | cell

Цвет текста в текстовой метке, заданный как разделенная разделенными запятой парами, состоящая из 'TextColor' и либо вектор символов, вектор [R G B], массив ячеек или матрица M -by-3. Чтобы задать один цвет для всего текста, установите этот параметр равным либо вектору символов, либо вектору [R G B]. Чтобы задать цвет для каждой из M текстовых меток, задайте для этого параметра массив ячеек из M векторов символов. Кроме того, для каждой аннотации можно задать матрицу M -by-3 значений RGB. Значения RGB должны быть в область значений входа типа изображений.

Поддерживаемые цвета: 'blue', 'green', 'cyan', 'red', 'magenta', 'yellow', и 'white'.

Типы данных: char | uint8 | uint16 | int16 | double | single | cell

Непрозрачность фона поля текстовой метки, заданная как разделенная разделенными запятой парами, состоящая из 'TextBoxOpacity' и скаляр, определяющий непрозрачность фона текстового поля метки. Задайте это значение в области значений 0 на 1.

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

свернуть все

Изображение Truecolor с аннотацией, возвращаемое как изображение или видеопоток.

Типы данных: double | single | uint8 | uint16 | int16

Расширенные возможности

.
Введенный в R2012b