Name
gray_closing_shapegray_closing_shapeGrayClosingShapegray_closing_shapeGrayClosingShapeGrayClosingShape — Perform a grayvalue closing with a selected mask.
void GrayClosingShape(const HObject& Image, HObject* ImageClosing, const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape)
HImage HImage::GrayClosingShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HString& MaskShape) const
HImage HImage::GrayClosingShape(double MaskHeight, double MaskWidth, const HString& MaskShape) const
HImage HImage::GrayClosingShape(double MaskHeight, double MaskWidth, const char* MaskShape) const
gray_closing_shapegray_closing_shapeGrayClosingShapegray_closing_shapeGrayClosingShapeGrayClosingShape applies a gray value closing 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 ImageClosingImageClosingImageClosingImageClosingImageClosingimageClosing.
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 ImageClosingImageClosingImageClosingImageClosingImageClosingimageClosing
is interpolated from the two intermediate images. Therefore, note that
gray_closing_shapegray_closing_shapeGrayClosingShapegray_closing_shapeGrayClosingShapeGrayClosingShape 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 closing of an image i with a structuring element
s is defined as
i.e., a dilation of the image with s followed by an erosion with
s (see gray_dilation_shapegray_dilation_shapeGrayDilationShapegray_dilation_shapeGrayDilationShapeGrayDilationShape and gray_erosion_shapegray_erosion_shapeGrayErosionShapegray_erosion_shapeGrayErosionShapeGrayErosionShape).
Note that gray_closing_shapegray_closing_shapeGrayClosingShapegray_closing_shapeGrayClosingShapeGrayClosingShape 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 different width and height!
gray_closing_shapegray_closing_shapeGrayClosingShapegray_closing_shapeGrayClosingShapeGrayClosingShape 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.
Note that filter operators may return unexpected results if
an image with a reduced domain is used as input. Please refer to the
chapter Filters.
- Supports OpenCL compute devices.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on channel level.
- Automatically parallelized on domain level.
Image for which the minimum gray values are to
be calculated.
Image containing the minimum gray values.
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
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
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"
gray_closing_shapegray_closing_shapeGrayClosingShapegray_closing_shapeGrayClosingShapeGrayClosingShape returns 2 (H_MSG_TRUE) if all
parameters are correct.
gray_closinggray_closingGrayClosinggray_closingGrayClosingGrayClosing
gray_dilation_shapegray_dilation_shapeGrayDilationShapegray_dilation_shapeGrayDilationShapeGrayDilationShape,
gray_erosion_shapegray_erosion_shapeGrayErosionShapegray_erosion_shapeGrayErosionShapeGrayErosionShape,
closingclosingClosingclosingClosingClosing
Foundation