Herror ::gen_disc_se (
    Hobject *SE,
    const HTuple &Width,
    const HTuple &Height,
    const HTuple &Smax
)
HImage HImage::GenDiscSe (
    const HTuple &Width,
    const HTuple &Height,
    const HTuple &Smax
)

Generate ellipsoidal structuring elements for gray morphology.

::gen_disc_se generates an ellipsoidal structuring element (SE) for gray morphology of images. The parameters Width and Height determine the length of the two major axes of the ellipse. The value of Smax determines the maximum gray value of the structuring element. For the generation of arbitrary structuring elements, see ::read_gray_se.


Parameters

SE (output_object)
image -> Hobject * : HImage ( byte )
Generated structuring element.

Width (input_control)
integer -> HTuple.long
Width of the structuring element.
Default value: 5
Suggested values: 0, 1, 2, 3, 4, 5, 10, 15, 20
Typical range of values: 0 <= Width <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Height (input_control)
integer -> HTuple.long
Height of the structuring element.
Default value: 5
Suggested values: 0, 1, 2, 3, 4, 5, 10, 15, 20
Typical range of values: 0 <= Height <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Smax (input_control)
integer -> HTuple.long
Maximum gray value of the structuring element.
Default value: 0
Suggested values: 0, 1, 2, 5, 10, 20, 30, 40
Typical range of values: 0 <= Smax <= 255 (lin)
Minimum increment: 1
Recommended increment: 1


Result

::gen_disc_se returns H_MSG_TRUE if all parameters are correct. If necessary, an exception is raised.


Possible Successors

::gray_erosion, ::gray_dilation, ::gray_opening, ::gray_closing, ::gray_tophat, ::gray_bothat


Alternatives

::read_gray_se


See also

::read_image, ::paint_region, ::paint_gray, ::crop_part


Module

Image filters



Copyright © 1996-2002 MVTec Software GmbH