Herror ::eliminate_sp (
    Hobject Image,
    Hobject *ImageFillSP,
    const HTuple &MaskWidth,
    const HTuple &MaskHeight,
    const HTuple &MinThresh,
    const HTuple &MaxThresh
)
HImage HImage::EliminateSp (
    const HTuple &MaskWidth,
    const HTuple &MaskHeight,
    const HTuple &MinThresh,
    const HTuple &MaxThresh
) const
HImageArray HImageArray::EliminateSp (
    const HTuple &MaskWidth,
    const HTuple &MaskHeight,
    const HTuple &MinThresh,
    const HTuple &MaxThresh
) const

Replace values outside of thresholds with average value.

The operator ::eliminate_sp replaces all gray values outside the indicated gray value intervals (MinThresh to MaxThresh) with the neighboring mean values. Only those neighboring pixels which also fall within the gray value interval are used for averaging. If no such pixel is present in the vicinity the original gray value is used. The gray values in the input image falling within the gray value interval are also adopted without change.


Attention

If even values instead of odd values are given for MaskHeight or MaskWidth, the routine uses the next larger odd values instead (this way the center of the filter mask is always explicitly determined).


Parameters

Image (input_object)
(multichannel-)image(-array) -> Hobject: HImage(Array) ( byte )
Input image.

ImageFillSP (output_object)
(multichannel-)image(-array) -> Hobject * : HImage(Array) ( byte )
Smoothed image.

MaskWidth (input_control)
extent.x -> HTuple.long
Width of filter mask.
Default value: 3
Suggested values: 3, 5, 7, 9, 11
Typical range of values: 3 <= MaskWidth <= 512 (lin)
Minimum increment: 2
Recommended increment: 2
Restriction: odd(MaskWidth)

MaskHeight (input_control)
extent.y -> HTuple.long
Height of filter mask.
Default value: 3
Suggested values: 3, 5, 7, 9, 11
Typical range of values: 3 <= MaskHeight <= 512 (lin)
Minimum increment: 2
Recommended increment: 2
Restriction: odd(MaskHeight)

MinThresh (input_control)
integer -> HTuple.long
Minimum gray value.
Default value: 1
Suggested values: 1, 5, 7, 9, 11, 15, 23, 31, 43, 61, 101
Typical range of values: 0 <= MinThresh <= 254 (lin)
Minimum increment: 1
Recommended increment: 1

MaxThresh (input_control)
integer -> HTuple.long
Maximum gray value.
Default value: 254
Suggested values: 5, 7, 9, 11, 15, 23, 31, 43, 61, 101, 200, 230, 250, 254
Typical range of values: 1 <= MaxThresh <= 255 (lin)
Minimum increment: 1
Recommended increment: 1
Restriction: MinThresh <= MaxThresh


Example
read_image(&Image,"meer_rot");
disp_image(Image,WindowHandle);
eliminate_sp(Image,&ImageMeansp,3,3,101,201);
disp_image(ImageMeansp,WindowHandle); 

Possible Successors

::disp_image


Alternatives

::mean_sp, ::mean_image, ::median_image, ::eliminate_min_max


See also

::gauss_image, ::smooth_image, ::anisotrope_diff, ::sigma_image, ::eliminate_min_max


Module

Image filters



Copyright © 1996-2002 MVTec Software GmbH