Image To Matrix

R2026b

Converts Simulink image data to matrix data

• 

Image To Matrix block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
Computer Vision Toolbox OpenCV Interface for Simulink

Description

The Image To Matrix block converts Simulink^® image data to matrix data.

Examples

Smile Detection by Using OpenCV Code in Simulink

Build a smile detector by using the OpenCV Importer app. The detector estimates the intensity of the smile on a face image or a video. Based on the estimated intensity, the detector identifies an appropriate emoji from its database, and then places the emoji on the smiling face.

• Open Script

Convert RGB Image to Grayscale Image by Using OpenCV Importer

Convert an RGB image to a grayscale image by using the OpenCV Importer app. The converter converts an RGB image to a grayscale image by eliminating the hue and saturation information while retaining the luminance.

• Open Script

Shadow Detection by Using OpenCV Code in Simulink

Detect shadows in a recorded video by using the OpenCV Importer app.

• Open Script

Ports

Input

Port_1 — Input signal

Simulink.ImageType

Input signal to the Image To Matrix block. The input is a Simulink image data type.

Data Types: Simulink.ImageType

Output

Port_1 — Output signal

matrix

Output signal from the Image To Matrix block. The output is a matrix or an array, depending on the format of the input.

• M-by-N matrix — The input is a Grayscale image. M and N are the height and width of the image, in pixels.

• M-by-N-by-C matrix — The input is an RGB or BGR image. M and N are the height and width of the image, in pixels. C is the number of color channels.

Data Types: uint8 | uint16 | int8 | int16 | single | double

Parameters

Rows — Number of rows in image data

'480' (default) | positive integer

Specify the number of rows in the image data as a positive integer.

Programmatic Use

Block Parameter: Rows

Type: double

Value: positive integer

Default: '480'

Columns — Number of columns in image data

'640' (default) | positive integer

Specify the number of columns in the image data as a positive integer.

Programmatic Use

Block Parameter: Columns

Type: double

Value: positive integer

Default: '640'

Channels — Number of color channels or samples for each pixel

3 (default) | 1

Specify the number of color channels or samples for each pixel in the array as 1 or 3. The number of channels must correspond to the number of color channels in the color format of the image data. These are the values of Channels for the supported color formats:

Color Format	Channels
Grayscale	1
RGB	3
BGR	3

Programmatic Use

Block Parameter: Channels

Type: double

Value: positive integer

Default: '3'

Block Characteristics

Data Types	double | single | uint8 | uint16 | int8 | int16 | int32 | image
Direct Feedthrough	Yes
Multidimensional Signals	Yes
Variable-Size Signals	No

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"opencvConverterBlockset/Image To Matrix"

Example: add_block("opencvConverterBlockset/Image To Matrix","myModel/myBlock",MakeNameUnique="on")

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using Simulink® Coder™.

Supports C++ code generation.

Version History

Introduced in R2021b