visionhdl.ImageFilter
2-D FIR filtering
Description
visionhdl.ImageFilter
performs two-dimensional
finite-impulse-response (FIR) filtering on a pixel stream. It supports the use of
programmable filter coefficients.
Note
Starting in R2016b, instead of using the step
method to perform the operation defined by the System object™, you can call the object with arguments, as if it were a function. For
example, y = step(obj,x)
and y = obj(x)
perform equivalent operations.
Construction
returns a
System object, F
= visionhdl.ImageFilterF
, that performs two-dimensional FIR filtering on an
input pixel stream.
returns a 2-D FIR filter System object, F
= visionhdl.ImageFilter(Name
,Value
)F
, with additional options specified by one or more
Name,Value
pair arguments. Name
is a property
name and Value
is the corresponding value. Name
must appear inside single quotes (''
). You can specify several
name-value pair arguments in any order as
Name1,Value1,...,NameN,ValueN
. Properties not specified retain
their default values.
returns a 2-D FIR filter System object, F
= visionhdl.ImageFilter(coeff
,lineSize
,Name
,Value
)F
, with the Coefficients
property set to coeff
, the LineBufferSize
property to lineSize
, and additional options specified by one or
more Name,Value
pair arguments.
Input Arguments
|
Filter coefficients, specified as a matrix. Each dimension of the matrix must have at least 2 elements and no more than 64 elements. This argument sets the Coefficients property value. |
|
Size of the line memory buffer, specified as a power of two that
accommodates the number of active pixels in a horizontal line. This
argument sets the |
Output Arguments
|
|
Properties
|
Select the source for specifying the filter coefficients.
|
|
Coefficients of the filter, specified as a matrix. Each dimension of the
matrix must have at least 2 elements and no more than 64 elements. This
property applies when you set
Default: |
| Select one of these methods for padding the boundary of the input image.
For more information about these methods, see Edge Padding. Default: |
|
Constant value used to pad the boundary of the input image.
This property applies when you set Default: 0 |
|
Size of line memory buffer, specified as a positive integer. Choose a power of two that accommodates the number of active pixels in a horizontal line. If you specify a value that is not a power of two, the buffer uses the next largest power of two. Choose a power of two that accommodates the number of active pixels in a
horizontal line. If you specify a value that is not a power of two, the
object uses the next largest power of two. The object allocates
(coefficient rows –
1)-by- Default: 2048 |
|
Select the method for determining the data type of the filter
coefficients. This property applies when you set
When converting the coefficients to the specified data type, the object rounds to the nearest representable value and saturates on overflow. |
|
Data type for the filter coefficients, specified as
Default: |
|
Select the method for determining the data type of the output pixels.
|
|
Data type for the output pixels, specified as
Default: |
|
Overflow action used for fixed-point operations. The object uses fixed-point arithmetic for internal calculations
when the input is any integer or fixed-point data type. This option
does not apply when the input data type is Default: |
|
Rounding mode used for fixed-point operations. The object uses fixed-point arithmetic for internal calculations
when the input is any integer or fixed-point data type. This option
does not apply when the input data type is Default: |
Methods
step | 2-D FIR filtering |
Common to All System Objects | |
---|---|
release | Allow System object property value changes |
Examples
Algorithms
This object implements the algorithms described on the Image Filter block reference page.
Extended Capabilities
Version History
See Also
Image Filter | imfilter
(Image Processing Toolbox) | visionhdl.FrameToPixels