range__ ( Image : ImageResult : MaskHeight, MaskWidth : )

Determine the gray value range within a rectangle.

range__ calculates the gray value range, i.e., the difference (max - min) of the maximum and minimum gray values, of the input image Image within a rectangular mask of size (MaskHeight, MaskWidth) for each image point. The resulting image is returned in ImageResult. If the parameters MaskHeight or MaskWidth are even, they are changed to the next larger odd value. At the border of the image the gray values are mirrored.


Parameters

Image (input_object)
image(-array) -> object : byte / direction / int4 / real
Image for which the gray value range is to be calculated.

ImageResult (output_object)
image(-array) -> object : byte / direction / int4 / real
Image containing the gray value range.

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

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


Result

range__ returns TRUE if all parameters are correct. If the input is empty the behaviour can be set via set_system(::'no_object_result',<Result>:). If necessary, an exception is raised.


Alternatives

max1__, min1__, sub__



Copyright © 1996-1997 MVTec Software GmbH