Insert Text
Чертите текст на изображениях или видеокадрах
- Библиотека:
Computer Vision Toolbox / текст & Графика
Описание
Блок Insert Text чертит форматированный текст на входном изображении или видеопотоке. Блок производит стилизованные текстовые битовые массивы с помощью библиотеки Free Type 2.3.5 механизма отображения шрифтов с открытым исходным кодом. Для получения дополнительной информации о библиотеке, смотрите веб-сайт Проекта FreeType.
Примечание
Этот блок поддерживает только символы ASCII.
Этот блок позволяет вам чертить:
Один экземпляр текста
Несколько инстанцируют того же текста
Несколько экземпляров текста, с различным текстом в каждом местоположении
Порты
Входной параметр
Image — Введите изображение
матрица | массив
Введите изображение или видео в виде M-by-N матрица, M-by-N-by-T массив, M-by-N-by-C массив или M-by-N-by-C-by-T массив. T является количеством кадров в видео или последовательности изображений, и C является количеством цветовых каналов.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на One multidimensional signal.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
R — Красный компонент цвета входного изображения
матрица | массив
Красный компонент цвета входного изображения или видео в виде M-by-N матрица или M-by-N-by-T массив, где T является количеством кадров во входном видео.
Примечание
Входные параметры к R, G и портам B должны иметь те же размерности и тип данных.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на Separate color signals.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
G — Зеленый компонент цвета входного изображения
матрица | массив
Зеленый компонент цвета входного изображения или видео в виде M-by-N матрица или M-by-N-by-T массив, где T является количеством кадров во входном видео.
Примечание
Входные параметры к R, G и портам B должны иметь те же размерности и тип данных.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на Separate color signals.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
B — Синий компонент цвета входного изображения
матрица | массив
Синий компонент цвета входного изображения или видео в виде M-by-N матрица или M-by-N-by-T массив, где T является количеством кадров во входном видео.
Примечание
Входные параметры к R, G и портам B должны иметь те же размерности и тип данных.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на Separate color signals.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
Select — Выберите текстовую строку
положительное целое число
Выберите текстовую строку в виде положительного целого числа. Когда значение параметра Text является массивом ячеек из символьных векторов, блок Insert Text отображает текстовую строку только от ячейки, обозначенной входным значением порта Select. Вход к этому порту должен быть в диапазоне от 1 к количеству текстовых строк в массиве ячеек, где 1 указывает на первый вектор символов.
Зависимости
Чтобы включить этот порт, задайте параметр Text как массив ячеек из символьных векторов, такой как {'Text1','Text2'}.
Типы данных: single | double
Color — Значение цвета текста
скаляр | вектор | матрица
Значение цвета текста в виде скаляра, вектора или матрицы. Тип данных входного изображения определяет область значений значений цвета. Например, значение цвета для входного типа данных image с плавающей точкой должно быть в области значений [0, 1]. Для входного изображения с uint8 типом данных значение должно быть в области значений [0, 255]. Форма входа к этому порту зависит от того, основан ли входной сигнал на интенсивности или цвет.
Сигнал интенсивности — Задает Color или как скалярное значение интенсивности, в этом случае блок применяет интенсивность ко всем текстовым строкам, или как вектор из значений интенсивности длины, равной количеству текстовых строк, заданных к параметру Text.
Сигнал цветности — Задает Color или как трехэлементный вектор, который задает цвет всех текстовых строк как триплет RGB или S-by-3 матрица значений цвета, где S является количеством текстовых строк, заданных к параметру Text.
Примечание
Вход к этому порту должен иметь совпадающий тип данных как входное изображение.
Зависимости
Чтобы включить этот порт, установите параметр Color value source на Input port.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32
Location — Индекс местоположения
вектор | матрица
Индекс местоположения, двухэлементный вектор или S-by-2 матрица, задает координаты входного изображения, в котором можно вставить текст. Если задано как двухэлементный вектор, первый элемент представляет строку, и второй элемент представляет столбец изображения, в котором можно вставить вектор символов. Если задано как S-by-2 матрица, каждая строка содержит индексы строки и столбца местоположения в изображении, в котором можно отобразить текст.
Зависимости
Чтобы включить этот порт, установите параметр Location source на Input port.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32
Opacity — Фактор непрозрачности
скаляр | вектор
Фактор непрозрачности в виде скаляра или вектора. Если задано как скаляр, фактор непрозрачности применяется ко всем текстовым строкам. Если задано как вектор из значений непрозрачности, длина вектора должна быть равна количеству текстовых строк, заданных в параметре Text. Каждый элемент фактора непрозрачности может лежать в диапазоне от 0 к 1.
Зависимости
Чтобы включить этот порт, установите параметр Opacity source на Input port.
Типы данных: single | double
Variables — Значения текстовой переменной
скаляр | вектор
Значения текстовой переменной в виде скаляра или вектора. Блок заменяет технические требования формата в параметре Text, такие как %dF, или %s, с элементами этого входа. Используйте %s опция, чтобы задать набор текстовых строк, разделенных значением 0 для блока, чтобы отобразиться одновременно в других местах. Например, чтобы вставить две строки, используйте блок Constant (Simulink) и задайте его значение к [uint8('Text1') 0 uint8('Text2')] во входном порту Variables. Для получения дополнительной информации о спецификаторах формата смотрите sprintf.
Зависимости
Чтобы включить этот порт, введите ANSI C printf- разработайте технические требования формата, такие как %dF, или %s к параметру Text.
Типы данных: uint8 | double
Вывод
Port_1 — Выходное изображение или видео
матрица | массив
Выходное изображение или видео, возвращенное как M-by-N матрица, M-by-N-by-T массив, M-by-N-by-C массив или M-by-N-by-C-by-T массив. T является количеством кадров в видео или последовательности изображений, и C является количеством цветовых каналов.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на One multidimensional signal.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
R — Красный компонент цвета выходного изображения
матрица | массив
Красный компонент цвета выходного изображения или видео, возвращенного как M-by-N матрица или M-by-N-by-T массив, где T является количеством кадров в выходном видео.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на Separate color signals.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
G — Зеленый компонент цвета выходного изображения
матрица | массив
Зеленый компонент цвета выходного изображения или видео, возвращенного как M-by-N матрица или M-by-N-by-T массив, где T является количеством кадров в выходном видео.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на Separate color signals.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
B — Синий компонент цвета выходного изображения
матрица | массив
Синий компонент цвета выходного изображения или видео, возвращенного как M-by-N матрица или M-by-N-by-T массив, где T является количеством кадров в выходном видео.
Зависимости
Чтобы включить этот порт, установите параметр Image signal на Separate color signals.
Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
Параметры
Основной
Text — Текст, чтобы вставить
'Text' (значение по умолчанию) | представляет в виде строки | скаляр | вектор символов | массив ячеек из символьных векторов
Задайте текст, чтобы вставить во входное изображение.
Можно задать этот параметр или как одну текстовую строку или как вектор символов, такой как
'Text1', или как массив ячеек из символьных векторов, такой как{'Text1','Text2'}. Если вы задаете массив ячеек, то необходимо также задать который текстовая строка отобразиться при помощи входного порта Select.Можно включать ANSI C
printf- разработайте технические требования формата, такие как'Text %d'. Необходимо затем задать их значения при помощи входного порта Variable. Спецификаторы поддерживаемого формата включают%diUCFOXXEEG, и%G. Для получения дополнительной информации о спецификаторах формата смотритеsprintf.
Color value source — Источник цвета текста
Specify via dialog (значение по умолчанию) | Input port
Выберите источник цвета текста из этих опций: Specify via dialog и Input port. Если вы устанавливаете этот параметр на Specify via dialog, затем необходимо задать цвета текста при помощи параметра Color value. Если вы устанавливаете этот параметр на Input port, затем необходимо задать цвета текста при помощи входного порта Color.
Color value — Значение цвета текста
[0 0 0]
Значение цвета текста в виде скаляра, вектора или матрицы. Тип данных входного изображения определяет область значений значений цвета. Например, значение цвета для входного типа данных image с плавающей точкой должно быть в области значений [0, 1]. Для входного изображения с uint8 типом данных значение должно быть в области значений [0, 255]. Размер значения цвета текста зависит от того, основан ли входной сигнал на интенсивности или цвет.
Сигнал интенсивности — Задает Color или как скалярное значение интенсивности, в этом случае блок применяет интенсивность ко всем текстовым строкам, или как вектор из значений интенсивности длины, равной количеству текстовых строк, заданных к параметру Text.
Сигнал цветности — Задает Color или как трехэлементный вектор, который задает цвет всех текстовых строк как триплет RGB или S-by-3 матрица значений цвета, где S является количеством текстовых строк, заданных к параметру Text.
Зависимости
Чтобы включить этот параметр, установите параметр Color value source на Specify via dialog.
Location source — Источник текстовых индексов местоположения
Specify via dialog (значение по умолчанию) | Input port
Выберите текстовый источник местоположения из этих опций: Specify via dialog и Input port. Если вы устанавливаете этот параметр на Specify via dialog, затем необходимо задать текстовые местоположения при помощи параметра Location [x y]. Если вы устанавливаете этот параметр на Input port, затем необходимо задать текстовые местоположения при помощи входного порта Location.
Location [x y] — Текстовый индекс местоположения
[1,1]
Текстовый индекс местоположения, двухэлементный вектор или S-by-2 матрица, задает координаты входного изображения, в котором можно вставить текст. Если задано как двухэлементный вектор, первый элемент представляет строку, и второй элемент представляет столбец изображения, в котором можно вставить вектор символов. Если задано как S-by-2 матрица, каждая строка содержит индексы строки и столбца местоположения в изображении, в котором можно отобразить текст.
Зависимости
Чтобы включить этот параметр, установите параметр Location source на Specify via dialog.
Opacity source — Источник фактора непрозрачности
Specify via dialog (значение по умолчанию) | Input port
Выберите источник фактора непрозрачности из этих опций: Specify via dialog и Input port. Если вы устанавливаете этот параметр на Specify via dialog, затем необходимо задать фактор непрозрачности при помощи параметра Opacity. Если вы устанавливаете этот параметр на Input port затем необходимо задать фактор непрозрачности при помощи входного порта Opacity.
Opacity — Фактор непрозрачности
1
Фактор непрозрачности в виде скаляра или вектора. Если задано как скаляр, фактор непрозрачности применяется ко всем текстовым строкам. Если задано как вектор из значений непрозрачности, длина вектора должна быть равна количеству текстовых строк, заданных в параметре Text. Каждый элемент фактора непрозрачности может лежать в диапазоне от 0 к 1.
Зависимости
Чтобы включить этот параметр, установите параметр Opacity source на Specify via dialog.
Image signal — Формат сигнала ввода и вывода
One multidimensional signal (значение по умолчанию) | Separate color signals
Задайте формат изображений ввода и вывода блока с помощью этих опций:
One multidimensional signal— Блок имеет один входной порт и один выходной порт.Separate color signals— Блок имеет три сигнала ввода и вывода, один для каждого цветового канала, которые принимают и возвращают отдельные цветовые каналы изображения.
Input image is transposed (data order is row major) — зеркальное текстовое и текстовое местоположение
off (значение по умолчанию) | on
Позвольте этому параметру зеркально отразить текстовую строку и инвертировать ее местоположение в изображении от [x y] к [y x].
Шрифт
Font face — Шрифт текста
LucidaSansRegular (значение по умолчанию) | Agency FB | Agency FB Bold | Algerian | Ariel | Arial Black | Arial Bold | Arial Bold Italic | ...
Задайте шрифт вставленного текста. Блок заполняет этот список со шрифтами, установленными в вашей системе. На Windows, поиски блока системный реестр для файлов шрифтов. На UNIX, поиски блока путь к шрифту X-сервера для файлов шрифтов.
Font size (points) 'FontSize'
12
Задайте размер шрифта вставленного текста.
Anti-aliased — Сглаженные текстовые ребра
on (значение по умолчанию) | off
Позвольте этому параметру сглаживать ребра вставленного текста. Процесс сглаживания является в вычислительном отношении дорогим.
