Image From Workspace
Import image from MATLAB workspace
Libraries:
Computer Vision Toolbox /
Sources
Description
The Image From Workspace block imports an image from a matrix, 3-D array, MATLAB function, or variable stored in the MATLAB® workspace, to the Simulink® workspace.
Examples
Import Image From MATLAB Workspace
Import an image from MATLAB to Simulink workspace using Image
From
Workspace
block.
Ports
Output
Image — Output image
matrix | 3-D array
Output image, returned as a matrix or 3-D array. If the imported image is binary or grayscale image, the output is a matrix of size M-by-N. If the imported image is a color image, the output is a 3-D array of size M-by-N-by-3.
Dependencies
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 image
matrix
Red 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 binary
or grayscale, the block returns only this port
Dependencies
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 image
matrix
Green 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.
Dependencies
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 image
matrix
Blue 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.
Dependencies
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
Parameters
Main
Value — Image to be imported
rand(100,100,3)
(default) | vector | matrix | 3-D array | MATLAB workspace variable
| MATLAB function
Specify the image as a vector, matrix, 3-D array, function, or MATLAB workspace variable. The value parameter can be:
Vector — The value given to the Value parameter can be a row vector or column vector
3-D numeric array — The value given to the Value parameter can be 3-D array, which is generated using MATLAB functions
MATLAB workspace variable — The value given to the Value parameter can be a variable name, which is MATLAB workspace variable
MATLAB function — The value given to the Value parameter can be a MATLAB function with specified input arguments to generate a numeric array
Sample time — Sample time for block execution
inf
(default) | positive scalar
| Vector
This parameter specifies 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. The output is 3-D or 4-D, if the input image is a gray scale or color image 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 block
One multidimensional signal
(default) | Separate color signals
Specify how the block returns the image read from the MATLAB workspace.
One multidimensional signal
— The block has one output port, Image, that returns the entire image.Separate color signals
— The block has an output port for each color channel. Each port returns a single color channel of the image.
Output port labels — Output port labels
R|G|B
(default) | port names
Specify labels for the output ports. Each label can be any value. Use the vertical bar character, |, as a delimiter to name all the output ports.
Dependencies
To enable this parameter, set the Image signal parameter to
Separate color signals
.
Data type
Output data type — Data type of the output image
Inherit from Value
(default) | double
| single
| int8
| uint8
| int16
| uint16
| int32
| uint32
| boolean
| Fixed-point
| User-defined
| Inherit via back propagation
| ...
Specify the data type of the output image. If the data type of the imported image, specified in the Value parameter, differs from the 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 does both. Double- and single-precision floating-point pixel values must be in the range of [0, 1].
Signed — Signed fixed-point data type
on
(default) | off
Select this parameter if the input image data type is signed fixed-point.
Dependencies
To enable this parameter, set the Output data type parameter
to Fixed-point
.
Word length — Bits in fixed-point data type
16
(default) | positive scalar
Specify the word length, in bits, of the fixed-point output data type. The value should be less than 32.
Dependencies
To enable this parameter, set the Output data type parameter
to Fixed-point
.
Set fraction length in output to — Scaling factor of the fixed-point
User-defined
(default) | Best precision
Specify the scaling factor of the fixed-point output by either of the following two methods:
Best precision
— The output scaling automatically such that the output signal has the best possible precision.User-defined
— The output scaling in the Fraction length parameter.
Dependencies
To enable this parameter, set the Output data type parameter
to Fixed-point
.
Fractional length — Fractional bits
15
(default) | scalar
Specify the number of bits to the right of the decimal point.
Dependencies
To enable this parameter, 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 type
sfix(16)
(default) | user-defined fixed-point data type
Specify any built-in or fixed-point data type. You can specify fixed-point data
types using the fixdt
(Simulink) function.
Dependencies
To enable this parameter, set the Output data type parameter
to User-defined
.
Block Characteristics
Data Types |
|
Multidimensional Signals |
|
Variable-Size Signals |
|
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Version History
Introduced before R2006aR2022b: Image From Workspace
block default value changes
This release changes the default value for the Image
From Workspace block to rand(100,100,3)
. Previously, the
default value was checker_board
.
See Also
Blocks
Functions
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)