Read image from file location
Computer Vision Toolbox / Sources
The Image From File block reads an image from a specified file location and imports it to the Simulink® workspace. The input file can contain a binary image, grayscale image, or color image.
Image
— Output imageOutput image, returned as a matrix or 3-D array. If the image read is a binary or grayscale image, the output is an M-by-N matrix. If the image read is a color image, the output is an M-by-N-by-3 array.
To enable this port, set the Image signal parameter to
One multidimensional signal
.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
| Boolean
| fixed point
R
— Red color component of imageRed color component of the image, returned as an M-by-N matrix. The block returns this output if the input is a color image. If the Image signal parameter is set to Separate color signals and the input image is grayscale, the block returns only this port.
To enable this port, set the Image signal parameter to
Separate color signals
.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
| Boolean
| fixed point
G
— Green color component of imageGreen color component of the image, returned as an M-by-N matrix. The block returns this output only if the input is a color image.
To enable this port, set the Image signal parameter to
Separate color signals
.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
| Boolean
| fixed point
B
— Blue color component of imageBlue color component of the image, returned as an M-by-N matrix. The block returns this output only if the input is a color image.
To enable this port, set the Image signal parameter to
Separate color signals
.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
| Boolean
| fixed point
File Name
— Input imagepeppers.png
(default) | file nameSpecify the name of the file that contains the image to read. If the file is not on
the MATLAB® path, click Browse and navigate to the file. For
the list of supported file formats, see the imread
function reference page in the MATLAB documentation.
Note
The File Name parameter supports URL paths.
Sample time
— Sample time for block executioninf
(default) | Positive scalar
| Vector
Specify the sample time for block execution. Vector length must be 2 which represents [Period, Offset] values where offset should be less than period and non-negative. Given the default value of inf, the block outputs a matrix for grayscale and binary. For an input grayscale or color image, the output is a 3-D or 4-D array, respectively.
The value of the added dimension is equal to floor((Tsim/Ts)+1).
Tsim is the simulation time and Ts is the sample time, for block execution. For example, if the input image is a 256-by-256 matrix, the simulation time is 10 sec, and the sample time is set to 0.5 sec, then the output is a 256-by-256-by-21 array.
Image signal
— Signal returned by blockOne multidimensional signal
(default) | Separate color signals
Specify how the block returns the image read from the file.
One multidimensional signal
— The block has
one output port, which returns the entire image.
Separate color signals
— The block has three
output ports, one for each color channel, which returns the individual color
channels of the image.
Output port labels
— Output port labelsR|G|B
(default) | port namesSpecify the labels for the output ports. Each label can be any value. Use vertical bar character, |, as a delimiter between the names of all the output ports.
To enable this parameter, set the Image signal parameter to
Separate color signals
.
Data type
Output data type
— Data type of output imageSpecify the data type of the output image. If the input image data type,differs from the selected value of the Output data type parameter, the block scales the pixel values, adds an offset to the pixel values so that they are in the dynamic range of the new data type, or both. Double- and single-precision floating-point pixel values must be in the range [0 1].
Signed
— Signed fixed-point data typeon
(default) | off
Select this parameter if the input image data type is signed fixed-point.
To enable this parameter, set the Output data type parameter
to Fixed-point
.
Word length
— Bits in fixed-point data typeSpecify the word length, in bits, of the fixed-point output data type. The value should be less than 32.
To enable this parameter, set the Output data type parameter
to Fixed-point
.
Set fraction length in output to
— Scaling factor of fixed-point data typeUser-defined
(default) | Best precision
Specify the scaling factor of the fixed-point output as one of these options.
Best precision
— The output scales automatically such
that the output signal has the best possible precision.
Choose User-defined
— Specify the output scaling in
the Fraction length parameter.
To enable this parameter, set the Output data type parameter
to Fixed-point
.
Fractional length
— Fractional bits15
(default) | scalarSpecify the number of bits to the right of the decimal point.
To enable this port ,set the Output data type parameter to
Fixed-point
, and set the Set fraction length in
output parameter to User-defined
.
User-defined data type
— User-defined fixed-point data typeuint(8)
(default) | User-defined fixed-point data type
Specify any built-in or fixed-point data type. You can specify the below fixed-point data types using the Fixed-Point Designer™ library.
To enable this parameter, set the Output data type parameter
to User-defined
.
Data Types |
|
Multidimensional Signals |
|
Variable-Size Signals |
|