gauss_filter — Smooth using discrete Gauss functions.
gauss_filter smoothes images using the discrete
Gaussian, a discrete approximation of the Gaussian function,
The smoothing effect increases with increasing filter
size. The following filter sizes (
Size) are supported
(the sigma value of the Gauss function is indicated in brackets):
For border treatment the gray values of the images are reflected at
the image borders. Notice that, contrary to the operator
gauss_image, the relationship between the filter mask size
and its respective value for the sigma parameter is linear.
binomial_filter can be used as an alternative
binomial_filter is significantly
gauss_filter. It should be noted that the mask
binomial_filter does not lead to the same amount of
smoothing as the mask size in
mask sizes can be determined based on the respective values of the
Gaussian smoothing parameter sigma.
gauss_filter can be executed on OpenCL devices for all supported
image types. However, the OpenCL implementation can produce slightly
different results from the scalar implementation.
For an explanation of the concept of smoothing filters see the introduction of chapter Filters / Smoothing.
In order to be able to process
gauss_filter on on OpenCL device,
Image must be at least 64 pixels in both width and height.
Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.
→object (byte* / int2* / uint2* / int4* / real*) *allowed for compute devices
Image to be smoothed.
→object (byte / int2 / uint2 / int4 / real)
Required filter size.
Default value: 5
List of values: 3, 5, 7, 9, 11
For each pixel: O(Size * 2).
If the parameter values are correct the operator
returns the value 2 (H_MSG_TRUE). The behavior in case of empty input (no
input images available) is set via the operator
If necessary an exception is raised.