Perform a grayvalue closing with a selected mask.
gray_closing_shape applies a gray value closing to the input image Image with the structuring element of shape MaskShape. The mask's offset values are 0 and its horizontal and vertical size is defined by MaskHeight and MaskWidth. The resulting image is returned in ImageClosing. If the parameters MaskHeight or MaskWidth are even, they are changed to the next larger odd value. In case of the values 'rhombus' and 'octagon' for the MaskShape control parameter, MaskHeight and MaskWidth must be equal. The parameter value 'octagon' for MaskShape 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 +- s = (i + s) - s ,i.e., a dilation of the image with s followed by an erosion with s (see gray_dilation_shape and gray_erosion_shape).
|
Image (input_object) |
image(-array) -> object : byte |
| Image for which the minimum gray values are to be calculated. | |
|
ImageClosing (output_object) |
image(-array) -> object : byte |
| Image containing the minimum gray values. | |
|
MaskHeight (input_control) |
extent.y -> integer |
| Height of the filter mask. | |
| Default value: 11 | |
| Suggested values: 3, 5, 7, 9, 11, 13, 15 | |
| Typical range of values: 3 <= MaskHeight <= 511 | |
| Minimum increment: 2 | |
|
Recommended increment: 2 | |
| Restriction: odd(MaskHeight) | |
|
MaskWidth (input_control) |
extent.x -> integer |
| Width of the filter mask. | |
| Default value: 11 | |
| Suggested values: 3, 5, 7, 9, 11, 13, 15 | |
| Typical range of values: 3 <= MaskWidth <= 511 | |
| Minimum increment: 2 | |
|
Recommended increment: 2 | |
| Restriction: odd(MaskWidth) | |
|
MaskShape (input_control) |
string -> string |
| Shape of the mask. | |
| Default value: 'octagon' | |
| List of values: 'rectangle', 'rhombus', 'octagon' | |
gray_closing_shape returns 2 (H_MSG_TRUE) if all parameters are correct.
gray_closing_shape is reentrant and automatically parallelized (on tuple level, channel level, domain level).
gray_dilation_shape, gray_erosion_shape, closing
Image filters
