Apply a user-defined filter to the input image.
The convolution kernel may have the size 2x2, 3x3 or 5x5. The filter
coefficients need to be specified as an array of double values passed
as the kernel argument. Please note that although
the kernel elements are of type double, the filter will only work on
and only create output data with 8 bits per pixel. Overflow and under-
flow values will be truncated to 0 and 255 respectively.
Namespace: Stemmer.Cvb.Minos
Assembly: Stemmer.Cvb.Minos (in Stemmer.Cvb.Minos.dll) Version: 14.0.0.0
Syntax
public static Image User( Image image, FilterKernelSize kernelSize, double[,] kernel )
Parameters
- image
- Type: Stemmer.CvbImage
image to be filtered - kernelSize
- Type: Stemmer.Cvb.MinosFilterKernelSize
kernel size to be used - kernel
- Type: SystemDouble
kernel coefficients; the number of coefficients that are needed depends on the kernelSize. If too many coefficients are given then any surplus coefficients will be ignored. The kernel coefficients may be passed as a 1D array with width * height elements or as a 2D array with width and height elements
Return Value
Type: Imagefiltered image
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | If the image parameter or the kernel parameter is null |
ObjectDisposedException | If the image has already been disposed of |
CvbException | when trying to call the filter function on an image with a pixel format other than 8 bits per pixel unsigned |
ArgumentException | If an invalid kernelSize was selected or if an insufficient number of coefficients was given |
See Also