fill_sp ( Image : ImageFillSP : MaskWidth, MaskHeight, MinThresh, MaxThresh : )

Replace values outside of thresholds with average value.

The operator fill_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)
image(-array) -> object : byte
Input image.

ImageFillSP (output_object)
image(-array) -> object : byte
Smoothed image.

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

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

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

MaxThresh (input_control)
integer -> integer
Maximum gray value
Default value: 254
Suggested values: 5, 7, 9, 11, 15, 23, 31, 43, 61, 101, 200, 230, 250, 254
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:::) >
fill_sp(Image,ImageMeansp:3,3,101,201::) >
disp_image(ImageMeansp:::).

Possible Successors

disp_image


Alternatives

mean_sp, mean__, median


See also

gauss__, smooth__, anisotrope_diff__, sigma__



Copyright © 1996-1997 MVTec Software GmbH