gen_disc_se ( : SE : Width, Height, 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 -> object : byte
Generated structuring element.

Width (input_control)
integer -> integer
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 -> integer
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 -> integer
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 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.


Parallelization Information

gen_disc_se is reentrant and processed without parallelization.


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-2005 MVTec Software GmbH