exponenta event banner

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.

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

свернуть все

Truecolor или изображение в градациях серого, указанное как изображение или видеопоток. Входное изображение может быть или M N 3 truecolor или 2-м изображением оттенков серого M на Н.

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

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

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

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

При задании круга матрица ввода позиции должна быть матрицей M-by-3, где каждая строка, M, задает трехэлементный вектор [x y r]. Элементы 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