ClassesClassesClassesClasses | | | | Operators

gen_disc_segen_disc_seGenDiscSegen_disc_seGenDiscSeGenDiscSe (Operator)

Name

gen_disc_segen_disc_seGenDiscSegen_disc_seGenDiscSeGenDiscSe — Generate ellipsoidal structuring elements for gray morphology.

Signature

gen_disc_se( : SE : Type, Width, Height, Smax : )

Herror gen_disc_se(Hobject* SE, const char* Type, const Hlong Width, const Hlong Height, double Smax)

Herror T_gen_disc_se(Hobject* SE, const Htuple Type, const Htuple Width, const Htuple Height, const Htuple Smax)

Herror gen_disc_se(Hobject* SE, const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& Smax)

HImage HImage::GenDiscSe(const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& Smax)

void GenDiscSe(HObject* SE, const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& Smax)

void HImage::GenDiscSe(const HString& Type, Hlong Width, Hlong Height, const HTuple& Smax)

void HImage::GenDiscSe(const HString& Type, Hlong Width, Hlong Height, double Smax)

void HImage::GenDiscSe(const char* Type, Hlong Width, Hlong Height, double Smax)

void HOperatorSetX.GenDiscSe(
[out] IHUntypedObjectX*SE, [in] VARIANT Type, [in] VARIANT Width, [in] VARIANT Height, [in] VARIANT Smax)

void HImageX.GenDiscSe(
[in] BSTR Type, [in] Hlong Width, [in] Hlong Height, [in] VARIANT Smax)

static void HOperatorSet.GenDiscSe(out HObject SE, HTuple type, HTuple width, HTuple height, HTuple smax)

void HImage.GenDiscSe(string type, int width, int height, HTuple smax)

void HImage.GenDiscSe(string type, int width, int height, double smax)

Description

gen_disc_segen_disc_seGenDiscSegen_disc_seGenDiscSeGenDiscSe generates an ellipsoidal structuring element (SESESESESESE) for gray morphology of images. The parameter TypeTypeTypeTypeTypetype determines the image type. It must match the image type of the image to be processed in subsequent operator calls using this structuring element. The parameters WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight determine the length of the two major axes of the ellipse. The value of SmaxSmaxSmaxSmaxSmaxsmax determines the maximum gray value of the structuring element. For the generation of arbitrary structuring elements, see read_gray_seread_gray_seReadGraySeread_gray_seReadGraySeReadGraySe. The structuring element can be saved as image with the help of the operator write_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage. However, take care to use an image format that supports alpha channels to save the shape of the structuring element such as 'tiff', 'jp2' or 'png'. These files can then be loaded again with the operator read_imageread_imageReadImageread_imageReadImageReadImage.

Parallelization

Parameters

SESESESESESE (output_object)  image objectHImageHImageHImageHImageXHobject * (byte / uint2 / real)

Generated structuring element.

TypeTypeTypeTypeTypetype (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Pixel type.

Default value: 'byte' "byte" "byte" "byte" "byte" "byte"

List of values: 'byte'"byte""byte""byte""byte""byte", 'real'"real""real""real""real""real", 'uint2'"uint2""uint2""uint2""uint2""uint2"

WidthWidthWidthWidthWidthwidth (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

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 Width Width Width Width width ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

HeightHeightHeightHeightHeightheight (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

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 Height Height Height Height height ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

SmaxSmaxSmaxSmaxSmaxsmax (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Maximum gray value of the structuring element.

Default value: 0

Suggested values: 0, 1, 2, 5, 10, 20, 30, 40

Result

gen_disc_segen_disc_seGenDiscSegen_disc_seGenDiscSeGenDiscSe returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Possible Successors

gray_erosiongray_erosionGrayErosiongray_erosionGrayErosionGrayErosion, gray_dilationgray_dilationGrayDilationgray_dilationGrayDilationGrayDilation, gray_openinggray_openingGrayOpeninggray_openingGrayOpeningGrayOpening, gray_closinggray_closingGrayClosinggray_closingGrayClosingGrayClosing, gray_tophatgray_tophatGrayTophatgray_tophatGrayTophatGrayTophat, gray_bothatgray_bothatGrayBothatgray_bothatGrayBothatGrayBothat, write_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage

Alternatives

read_gray_seread_gray_seReadGraySeread_gray_seReadGraySeReadGraySe, read_imageread_imageReadImageread_imageReadImageReadImage

See also

paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, crop_partcrop_partCropPartcrop_partCropPartCropPart

Module

Foundation


ClassesClassesClassesClasses | | | | Operators