ClassesClassesClassesClasses | | | | Operators

gray_opening_shapegray_opening_shapeGrayOpeningShapegray_opening_shapeGrayOpeningShapeGrayOpeningShape (Operator)

Name

gray_opening_shapegray_opening_shapeGrayOpeningShapegray_opening_shapeGrayOpeningShapeGrayOpeningShape — Perform a gray value opening with a selected mask.

Signature

gray_opening_shape(Image : ImageOpening : MaskHeight, MaskWidth, MaskShape : )

Herror gray_opening_shape(const Hobject Image, Hobject* ImageOpening, double MaskHeight, double MaskWidth, const char* MaskShape)

Herror T_gray_opening_shape(const Hobject Image, Hobject* ImageOpening, const Htuple MaskHeight, const Htuple MaskWidth, const Htuple MaskShape)

Herror gray_opening_shape(Hobject Image, Hobject* ImageOpening, const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape)

HImage HImage::GrayOpeningShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape) const

HImageArray HImageArray::GrayOpeningShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape) const

void GrayOpeningShape(const HObject& Image, HObject* ImageOpening, const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape)

HImage HImage::GrayOpeningShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HString& MaskShape) const

HImage HImage::GrayOpeningShape(double MaskHeight, double MaskWidth, const HString& MaskShape) const

HImage HImage::GrayOpeningShape(double MaskHeight, double MaskWidth, const char* MaskShape) const

void HOperatorSetX.GrayOpeningShape(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ImageOpening, [in] VARIANT MaskHeight, [in] VARIANT MaskWidth, [in] VARIANT MaskShape)

IHImageX* HImageX.GrayOpeningShape(
[in] VARIANT MaskHeight, [in] VARIANT MaskWidth, [in] BSTR MaskShape)

static void HOperatorSet.GrayOpeningShape(HObject image, out HObject imageOpening, HTuple maskHeight, HTuple maskWidth, HTuple maskShape)

HImage HImage.GrayOpeningShape(HTuple maskHeight, HTuple maskWidth, string maskShape)

HImage HImage.GrayOpeningShape(double maskHeight, double maskWidth, string maskShape)

Description

gray_opening_shapegray_opening_shapeGrayOpeningShapegray_opening_shapeGrayOpeningShapeGrayOpeningShape applies a gray value opening to the input image ImageImageImageImageImageimage with the structuring element of shape MaskShapeMaskShapeMaskShapeMaskShapeMaskShapemaskShape. The mask's offset values are 0 and its horizontal and vertical size is defined by MaskHeightMaskHeightMaskHeightMaskHeightMaskHeightmaskHeight and MaskWidthMaskWidthMaskWidthMaskWidthMaskWidthmaskWidth. The resulting image is returned in ImageOpeningImageOpeningImageOpeningImageOpeningImageOpeningimageOpening.

If the parameters MaskHeightMaskHeightMaskHeightMaskHeightMaskHeightmaskHeight or MaskWidthMaskWidthMaskWidthMaskWidthMaskWidthmaskWidth are of the type integer and are even, they are changed to the next larger odd value. In contrast, if at least one of the two parameters is of the type float, the input image ImageImageImageImageImageimage is transformed with both the next larger and the next smaller odd mask size, and the output image ImageOpeningImageOpeningImageOpeningImageOpeningImageOpeningimageOpening is interpolated from the two intermediate images. Therefore, note that gray_opening_shapegray_opening_shapeGrayOpeningShapegray_opening_shapeGrayOpeningShapeGrayOpeningShape returns different results for mask sizes of, e.g., 4 and 4.0!

In case of the values 'rhombus' and 'octagon' for the MaskShapeMaskShapeMaskShapeMaskShapeMaskShapemaskShape control parameter, MaskHeightMaskHeightMaskHeightMaskHeightMaskHeightmaskHeight and MaskWidthMaskWidthMaskWidthMaskWidthMaskWidthmaskWidth must be equal. The parameter value 'octagon' for MaskShapeMaskShapeMaskShapeMaskShapeMaskShapemaskShape denotes an equilateral octagonal mask which is a suitable approximation for a circular structure. At the border of the image the gray values are mirrored.

The gray value opening of an image i with a structuring element s is defined as

  i -+ s = (i - s) + s ,

i.e., an erosion of the image with s followed by a dilation with s (see gray_erosion_shapegray_erosion_shapeGrayErosionShapegray_erosion_shapeGrayErosionShapeGrayErosionShape and gray_dilation_shapegray_dilation_shapeGrayDilationShapegray_dilation_shapeGrayDilationShapeGrayDilationShape).

Attention

Note that gray_opening_shapegray_opening_shapeGrayOpeningShapegray_opening_shapeGrayOpeningShapeGrayOpeningShape requires considerably more time for mask sizes of type float than for mask sizes of type integer. This is especially true for rectangular masks with differnt width and height!

gray_opening_shapegray_opening_shapeGrayOpeningShapegray_opening_shapeGrayOpeningShapeGrayOpeningShape can be executed on OpenCL devices. In case of mask sizes of type float the result can vary slightly from the CPU as the interpolation is calculated in single precision on the OpenCL device.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte* / uint2*) *allowed for compute devices

Image for which the minimum gray values are to be calculated.

ImageOpeningImageOpeningImageOpeningImageOpeningImageOpeningimageOpening (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (byte / uint2)

Image containing the minimum gray values.

MaskHeightMaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control)  extent.y HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Height of the filter mask.

Default value: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15

Typical range of values: 1.0 ≤ MaskHeight MaskHeight MaskHeight MaskHeight MaskHeight maskHeight ≤ 511.0

MaskWidthMaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control)  extent.x HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Width of the filter mask.

Default value: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15

Typical range of values: 1.0 ≤ MaskWidth MaskWidth MaskWidth MaskWidth MaskWidth maskWidth ≤ 511.0

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

Shape of the mask.

Default value: 'octagon' "octagon" "octagon" "octagon" "octagon" "octagon"

List of values: 'octagon'"octagon""octagon""octagon""octagon""octagon", 'rectangle'"rectangle""rectangle""rectangle""rectangle""rectangle", 'rhombus'"rhombus""rhombus""rhombus""rhombus""rhombus"

Result

gray_opening_shapegray_opening_shapeGrayOpeningShapegray_opening_shapeGrayOpeningShapeGrayOpeningShape returns 2 (H_MSG_TRUE) if all parameters are correct.

Alternatives

gray_openinggray_openingGrayOpeninggray_openingGrayOpeningGrayOpening

See also

gray_dilation_shapegray_dilation_shapeGrayDilationShapegray_dilation_shapeGrayDilationShapeGrayDilationShape, gray_erosion_shapegray_erosion_shapeGrayErosionShapegray_erosion_shapeGrayErosionShapeGrayErosionShape, openingopeningOpeningopeningOpeningOpening

Module

Foundation


ClassesClassesClassesClasses | | | | Operators