gauss_image — Smooth an image using discrete Gaussian functions.
gauss_image is obsolete and is only provided for
reasons of backward compatibility. New applications should use the
gauss_image smoothes images using the discrete
Gaussian. 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.
binomial_filter can be used as an alternative
binomial_filter is significantly
gauss_image. 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_image 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_image 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.