gauss_image

Herror ::gauss_image ( Hobject Image, Hobject *ImageGauss, const HTuple &Size ) HImage HImage::GaussImage ( const HTuple &Size ) const HImageArray HImageArray::GaussImage ( const HTuple &Size ) const

Smooth using discrete gauss functions.

The operator ::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):

    3    (0.81)
    5    (0.93)
    7    (1.50)
    9    (2.00)
    11   (2.45)

For margin control the gray values of the images are reflected at the image borders.

Parameters

`Image` (input_object)	(multichannel-)image(-array) `->` Hobject: HImage(Array) ( byte / int4 / int2 )
Image to be smoothed.

`ImageGauss` (output_object)	(multichannel-)image(-array) `->` Hobject : HImage(Array)* ( byte / int4 / int4 )
Filtered image.

`Size` (input_control)	integer `->` HTuple.long
Required filter size.
Default value: 5
List of values: 3, 5, 7, 9, 11

Example

gauss_image(Input,&Gauss,7,);
regiongrowing(Gauss,&Segments,7,7,5,100,);

Complexity

For each pixel: O(Size * 2).

Result

If the parameter values are correct the operator ::gauss_image returns the value H_MSG_TRUE. The behavior in case of empty input (no input images available) is set via the operator ::set_system('no_object_result',<Result>). If necessary an exception handling is raised.

Possible Predecessors

::read_image, ::grab_image

Possible Successors

::regiongrowing, ::threshold, ::sub_image, ::dyn_threshold, ::auto_threshold

Alternatives

::smooth_image, ::derivate_gauss

Module

Image filters