Рисование фигур

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

Библиотека:
Панель инструментов компьютерного зрения/Текст и графика

Описание

Блок «Рисование фигур» рисует прямоугольники, линии, многоугольники или окружности на изображениях путем перезаписи значений пикселов. В результате фигуры встраиваются в выходное изображение. Блок использует алгоритм рисования линий Бресенхэма для рисования линий, многоугольников и прямоугольников, а алгоритм рисования кругов Бресенхема - для рисования окружностей. Выходной сигнал имеет тот же размер и тот же тип данных, что и входы в порты Image, R, G и B.

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

Порты

Вход

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

`Image` - Входное изображение
Матрица M-by-N значений интенсивности | M-by-N-by-P значения цвета

Входное изображение, определяемое как матрица M-за-N значений интенсивности или матрица M-за-N-за-P значений цвета с цветовыми плоскостями P.

`R` - Красный видеопоток
скаляр | вектор | матрица

Красный видеопоток, заданный как скаляр, вектор или матрица. Вход представляет одну плоскость видеопотока RGB. Порты R, G и B должны иметь одинаковые размеры и тип данных.

Зависимости

Чтобы включить этот порт, установите для параметра Image signal значение Separate color signals.

`G` - Зеленый видеопоток
скаляр | вектор | матрица

Зеленый видеопоток, заданный как скаляр, вектор или матрица. Вход представляет одну плоскость видеопотока RGB. Порты R, G и B должны иметь одинаковые размеры и тип данных.

Зависимости

Чтобы включить этот порт, установите для параметра Image signal значение Separate color signals.

`B` - Синий видеопоток
скаляр | вектор | матрица

Синий видеопоток, заданный как скаляр, вектор или матрица. Вход представляет одну плоскость видеопотока RGB. Порты R, G и B должны иметь одинаковые размеры и тип данных.

Зависимости

Чтобы включить этот порт, установите для параметра Image signal значение Separate color signals.

`Pts` - Координаты формы
M-by-3 матрица | M-by-4 матрица | M-by-2L

Координаты фигуры. Формат точек зависит от типа формы, заданного с помощью параметра «Форма».

Rectangles - матрица M-by-4 из М прямоугольников. Формат каждого прямоугольника должен быть, [x y width height].

Форма Вход в порт Pts Нарисованная форма

Одиночный прямоугольник

Форма	Вход в порт Pts	Нарисованная форма
Одиночный прямоугольник	Четырехэлементный вектор строки в формате `[x y width height]`, где: `x` и `y` - одноосновные координаты верхнего левого угла прямоугольника. `width` и `height` - ширина и высота прямоугольника в пикселях. Значения `width` и `height` должно быть больше 0.
М Прямоугольники	Матрица M-by-4 в формате $\begin{matrix} _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{[x1y1width1height1x2y2width2height2 xMyMwidthMheightM} \end{matrix}]$ где каждая строка матрицы соответствует другому прямоугольнику и имеет ту же форму, что и вектор для одного прямоугольника.

Четырехэлементный вектор строки в формате
[x y width height], где:

x и y - одноосновные координаты верхнего левого угла прямоугольника.
width и height - ширина и высота прямоугольника в пикселях. Значения width и height должно быть больше 0.

М Прямоугольники

Матрица M-by-4 в формате

$\begin{matrix} _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{[x1y1width1height1x2y2width2height2 xMyMwidthMheightM} \end{matrix}]$

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

Lines - M-by-2L матрица М полилиний. Формат каждой полилинии должен иметь вид [x1, y1, x2, y2,..., xL, yL].

Форма	Вход в порт Pts	Нарисованная форма
Одиночная линия	Четырехэлементный вектор строки в формате `[x₁ y₁ x₂ y₂]`, где: `x₁` и `y₁` - координаты начала линии. `x₂` и `y₂` - координаты конца линии.
М линий	Матрица M-by-4 в формате $\begin{matrix} _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} \end{matrix} [x11y11x12y12x21y21x22y22 xM1yM1xM2yM2]$ где каждая строка матрицы соответствует другой строке и имеет ту же форму, что и вектор для одной строки.
Одиночная полилиния с (L-1) сегментами	Вектор размера 2L, где L - число вершин, в формате, `[x₁, y₁, x₂, y₂, ..., x_L, y_L`, где _x1 и _y1 - координаты начала первого отрезка линии. _x2 и _y2 - координаты конца первого отрезка и начала второго отрезка. _xL и _yL - координаты конца (L-1) -^го отрезка линии. Полилиния всегда содержит (L-1) число сегментов, поскольку первая и последняя точки вершины не соединены. Блок выдает сообщение об ошибке, если число строк меньше двух или не кратно двум.
M полилинии с (L-1) сегментами	Матрица M-by-2L в формате $\begin{matrix} _{} & _{} & _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} & _{} & _{[x11y11x12y12x1Ly1Lx21y21x22y22x2Ly2L xM1yM1xM2yM2xMLyML} \end{matrix}]$ где каждая строка матрицы соответствует другой полилинии и имеет ту же форму, что и вектор для одной полилинии. Если требуется, чтобы одна полилиния содержала меньше (L-1) числа сегментов, заполните матрицу, повторяя координаты последней вершины. Блок выдает сообщение об ошибке, если число строк меньше двух или не кратно двум.

Polygons - матрица M-by-2L М многоугольников. Формат каждого многоугольника должен иметь вид [x1, y1, x2, y2,..., xL, yL]. Точки задаются последовательно для формирования многоугольника.

Форма Вход в порт Pts Нарисованная форма

Форма	Вход в порт Pts	Нарисованная форма
Одиночный полигон с L-сегментами линий	Вектор строки размера 2L, где L - число вершин, в формате `[x₁ y₁ x₂ y₂ ... x_L y_L]`, где: _x1 и _y1 - координаты начала первого отрезка линии. _x2 и _y2 - координаты конца первого отрезка и начала второго отрезка. _xL и _yL - координаты конца (L-1) -^го отрезка линии и начала ^L-го отрезка линии. Блок подключается `[x₁ y₁]` кому `[x_L y_L]` для завершения многоугольника. Блок создает ошибку, если число строк отрицательное или не кратное двум.
M Многоугольники с наибольшим числом отрезков в любой линии L	Матрица M-by-2L в формате $\begin{matrix} _{} & _{} & _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} & _{} & _{[x11y11x12y12x1Ly1Lx21y21x22y22x2Ly2L xM1yM1xM2yM2xMLyML} \end{matrix}]$ где каждая строка матрицы соответствует другому многоугольнику и имеет ту же форму, что и вектор для одного многоугольника. Если некоторые многоугольники короче других, повторите конечные координаты для заполнения матрицы многоугольников. Блок выдает сообщение об ошибке, если число строк меньше двух или не кратно двум.

Одиночный полигон с L-сегментами линий

Вектор строки размера 2L, где L - число вершин, в формате [x₁ y₁ x₂ y₂ ... x_L y_L], где:

_x1 и _y1 - координаты начала первого отрезка линии.
_x2 и _y2 - координаты конца первого отрезка и начала второго отрезка.
_xL и _yL - координаты конца (L-1) -^го отрезка линии и начала ^L-го отрезка линии.

Блок подключается [x₁ y₁] кому [x_L y_L] для завершения многоугольника. Блок создает ошибку, если число строк отрицательное или не кратное двум.

M Многоугольники с наибольшим числом отрезков в любой линии L

Матрица M-by-2L в формате

$\begin{matrix} _{} & _{} & _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} & _{} & _{} \\ _{} & _{} & _{} & _{} & _{} & _{[x11y11x12y12x1Ly1Lx21y21x22y22x2Ly2L xM1yM1xM2yM2xMLyML} \end{matrix}]$

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

Блок выдает сообщение об ошибке, если число строк меньше двух или не кратно двум.

Circles - матрица M-by-3 из М кругов. Формат для каждой окружности должен быть, [x y radius].

Форма Вход в порт Pts Нарисованная форма

Одиночный круг

Форма	Вход в порт Pts	Нарисованная форма
Одиночный круг	Трехэлементный вектор строки в формате `[x y radius]`, где: `x` и `y` - координаты центра окружности. `radius` - радиус окружности, который должен быть больше 0.
M кругов	Матрица M-by-3 в формате $[\begin{matrix} _{} & _{} & _{} \\ _{} & _{} & _{} \\ _{} & _{} & _{x1y1radius1x2y2radius2⋮⋮⋮xMyMradiusM} \end{matrix}]$ , где каждая строка матрицы соответствует различной окружности и имеет ту же форму, что и вектор для одной окружности.

Трехэлементный вектор строки в формате
[x y radius], где:

x и y - координаты центра окружности.
radius - радиус окружности, который должен быть больше 0.

M кругов

Матрица M-by-3 в формате

$[\begin{matrix} _{} & _{} & _{} \\ _{} & _{} & _{} \\ _{} & _{} & _{x1y1radius1x2y2radius2⋮⋮⋮xMyMradiusM} \end{matrix}]$

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

Зависимости

Плавающая точка с двойной точностью поддерживается только в том случае, если вход в порты Image или R, G и B является плавающей точкой.
Плавающая точка с одинарной точностью (поддерживается только в том случае, если вход в порты Image или R, G и B является плавающей точкой).

`ROI` - Регион интересов
четырехэлементный вектор

Интересующая область, заданная как четырехэлементный вектор [x y width height]. Область определяет прямоугольную область для рисования фигур. Первые два элемента представляют одноосновные координаты верхнего левого угла области. Вторые два элемента представляют ширину и высоту области.

Зависимости

Чтобы включить этот порт, установите порт ROI, отображаемый при установке параметра Draw shapes в значении Specify region of interest via port.

`Clr` - Цвет формы
Вектор P-элемента | матрица M-by-P

Цвет формы, определяемый как вектор P-элемента или матрица M-by-P из M форм и P цветовых плоскостей. Можно указать цвет (RGB) для каждой фигуры или один цвет для всех фигур.

Зависимости

Чтобы включить этот порт, установите для параметра Источник цвета границы значение Входной порт.

Продукция

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

`Port_1` - Выходное изображение
скаляр | вектор | матрица

Выходное изображение, возвращаемое в виде скаляра, вектора или матрицы.

Параметры

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

Главная вкладка

`Fill Shapes` - Цвет заливки
off (по умолчанию) | on

Выберите «Фигуры заливки», чтобы задать значение интенсивности или цвет.

Примечание

При создании кода и установке флажка «Заполнить фигуры» длина слова ввода блока не может превышать 16 бит.

`Fill color source` - Источник для цвета заливки
`Specify via dialog` (по умолчанию) | `Input port`

Укажите источник для значения цвета заливки: Specify via dialog или Input port.

Зависимости

Чтобы включить этот параметр, выберите Заливка фигур.

`Fill color` - Цвет заливки формы
`Black` (по умолчанию) | `White` | `User-specified value`

Укажите цвет заливки фигуры.

Зависимости

Чтобы включить этот параметр, выберите параметр Заливка фигур.

`Border color source` - Источник цвета границы
(по умолчанию) |

Укажите источник для значения цвета границы: Specify via dialog или Input port.

Зависимости

Чтобы включить этот параметр, выберите параметр Заливка фигур.

`Border color` - Цвет границы
`Black` (по умолчанию) | `White` | `User-specified value`

Укажите внешний вид границы фигуры. Можно указать Black, White, или User-specified value. В этой таблице описано, что следует ввести для значения цвета на основе ввода блока и количества вычерчиваемых фигур.

Вход блока	Значения цвета для рисования одной или нескольких фигур с одинаковым цветом	Значения цвета для рисования нескольких фигур с уникальными цветами
Изображение интенсивности	Значение скалярной интенсивности	Вектор R-элемента, где R - количество фигур
Цветное изображение	Вектор P-элемента, где P - количество цветовых плоскостей	Матрица R-by-P, где P - количество цветовых плоскостей, а R - количество фигур

Для каждого значения параметра «Значения цвета» введите число между минимальным и максимальным значениями, которое может быть представлено типом данных входного изображения. При вводе значения за пределами этого диапазона блок выдает сообщение об ошибке.

Зависимости

Чтобы включить этот параметр, снимите флажок «Заливка фигур».

`Color value(s)` - Значение цвета
значение цвета | значение интенсивности

Задайте значение интенсивности или цвета для границы или заливки фигуры.

Настраиваемый: Да

Зависимости

Чтобы включить этот параметр, задайте для параметра Цвет границы или Цвет заливки значение User-specified value.

`Opacity factor (between 0 and 1)` - Коэффициент непрозрачности
значение в диапазоне [0,1] | вектор R-элемента

Укажите непрозрачность затенения внутри фигуры, где 0 прозрачен и 1 непрозрачен.

Значение коэффициента непрозрачности для рисования одной или нескольких фигур с одинаковым цветом	Значение коэффициента непрозрачности для рисования нескольких фигур с уникальными цветами
Значение скалярной интенсивности	Вектор R-элемента, где R - количество фигур

Зависимости

Чтобы включить этот параметр, снимите флажок «Заливка фигур».

`Use antialiasing` - Алгоритм сглаживания
off | on

Выполните алгоритм сглаживания для линии, многоугольника или окружности.

Зависимости

Чтобы включить этот параметр, задайте для параметра Shape значение Lines, Polygons, или Circles.

`Image Signal` - Сигнал изображения

Укажите способ ввода и вывода цветного видеосигнала. Выберите один из следующих вариантов цветного видеосигнала:

One multidimensional signal - Блок принимает цветной видеосигнал M-by-N-by-P, где P - количество цветовых плоскостей, на одном порту.
Separate color signals - Включает входные порты R, G и B. Каждый порт принимает одну плоскость M-на-N видеопотока RGB.

Вкладка «Типы данных»

Дополнительные сведения о параметрах блока с фиксированной точкой см. в разделе Задание атрибутов блока с фиксированной точкой.

Характеристики блока

Типы данных	`Boolean` \| `double` \| `fixed point` \| `integer` \| `single`
Многомерные сигналы	`yes`
Сигналы переменного размера	`yes`

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

Создание кода C/C + +
Создайте код C и C++ с помощью Simulink ® Coder™

Преобразование с фиксированной точкой
Проектирование и моделирование систем с фиксированной точкой с помощью Designer™ с фиксированной точкой.

См. также

Рисование маркеров | Вставить текст

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

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

Рисование фигур

Описание

Порты

Вход

Image - Входное изображение Матрица M-by-N значений интенсивности | M-by-N-by-P значения цвета

R - Красный видеопоток скаляр | вектор | матрица

Зависимости

G - Зеленый видеопоток скаляр | вектор | матрица

Зависимости

B - Синий видеопоток скаляр | вектор | матрица

Зависимости

Pts - Координаты формы M-by-3 матрица | M-by-4 матрица | M-by-2L

Зависимости

ROI - Регион интересов четырехэлементный вектор

Зависимости

Clr - Цвет формы Вектор P-элемента | матрица M-by-P

Зависимости

Продукция

Port_1 - Выходное изображение скаляр | вектор | матрица

Параметры

Fill Shapes - Цвет заливки off (по умолчанию) | on

Fill color source - Источник для цвета заливки Specify via dialog (по умолчанию) | Input port

Зависимости

Fill color - Цвет заливки формы Black (по умолчанию) | White | User-specified value

Зависимости

Border color source - Источник цвета границы (по умолчанию) |

Зависимости

Border color - Цвет границы Black (по умолчанию) | White | User-specified value

Зависимости

Color value(s) - Значение цвета значение цвета | значение интенсивности

Зависимости

Opacity factor (between 0 and 1) - Коэффициент непрозрачности значение в диапазоне [0,1] | вектор R-элемента

Зависимости

Use antialiasing - Алгоритм сглаживания off | on

Зависимости

Image Signal - Сигнал изображения

Характеристики блока

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

Создание кода C/C + + Создайте код C и C++ с помощью Simulink ® Coder™

Преобразование с фиксированной точкой Проектирование и моделирование систем с фиксированной точкой с помощью Designer™ с фиксированной точкой.

См. также

Документация по инструментарию компьютерного зрения

Поддержка

`Image` - Входное изображение
Матрица M-by-N значений интенсивности | M-by-N-by-P значения цвета

`R` - Красный видеопоток
скаляр | вектор | матрица

`G` - Зеленый видеопоток
скаляр | вектор | матрица

`B` - Синий видеопоток
скаляр | вектор | матрица

`Pts` - Координаты формы
M-by-3 матрица | M-by-4 матрица | M-by-2L

`ROI` - Регион интересов
четырехэлементный вектор

`Clr` - Цвет формы
Вектор P-элемента | матрица M-by-P

`Port_1` - Выходное изображение
скаляр | вектор | матрица

`Fill Shapes` - Цвет заливки
off (по умолчанию) | on

`Fill color source` - Источник для цвета заливки
`Specify via dialog` (по умолчанию) | `Input port`

`Fill color` - Цвет заливки формы
`Black` (по умолчанию) | `White` | `User-specified value`

`Border color source` - Источник цвета границы
(по умолчанию) |

`Border color` - Цвет границы
`Black` (по умолчанию) | `White` | `User-specified value`

`Color value(s)` - Значение цвета
значение цвета | значение интенсивности

`Opacity factor (between 0 and 1)` - Коэффициент непрозрачности
значение в диапазоне [0,1] | вектор R-элемента

`Use antialiasing` - Алгоритм сглаживания
off | on

`Image Signal` - Сигнал изображения

Создание кода C/C + +
Создайте код C и C++ с помощью Simulink ® Coder™

Преобразование с фиксированной точкой
Проектирование и моделирование систем с фиксированной точкой с помощью Designer™ с фиксированной точкой.