Herror ::gray_erosion_rect (
    Hobject Image,
    Hobject *ImageMin,
    const HTuple &MaskHeight,
    const HTuple &MaskWidth
)
HImage HImage::GrayErosionRect (
    const HTuple &MaskHeight,
    const HTuple &MaskWidth
) const
HImageArray HImageArray::GrayErosionRect (
    const HTuple &MaskHeight,
    const HTuple &MaskWidth
) const

Determine the minimum gray value within a rectangle.

::gray_erosion_rect calculates the minimum gray value of the input image Image within a rectangular mask of size (MaskHeight, MaskWidth) for each image point. The resulting image is returned in ImageMin. 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) -> Hobject: HImage(Array) ( byte / direction / int4 / real )
Image for which the minimum gray values are to be calculated.

ImageMin (output_object)
image(-array) -> Hobject * : HImage(Array) ( byte / direction / int4 / real )
Image containing the minimum gray values.

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

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


Result

::gray_erosion_rect returns H_MSG_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.


See also

::gray_dilation_rect


Module

Image filters



Copyright © 1996-2002 MVTec Software GmbH