Determine the maximum gray value within a selected mask.
gray_dilation_shape calculates the maximum gray value of the input image Image within a mask of shape MaskShape, vertical size MaskHeight and horizontal size MaskWidth for each image point. The resulting image is returned in ImageMax. If the parameters MaskHeight or MaskWidth are even, they are changed to the next larger odd value. In case of the values 'rhombus' und '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.
|
Image (input_object) |
image(-array) -> object : byte |
| Image for which the maximum gray values are to be calculated. | |
|
ImageMax (output_object) |
image(-array) -> object : byte |
| Image containing the maximum 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 | |
| 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 | |
| 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_dilation_shape returns 2 (H_MSG_TRUE) if all parameters are correct.
gray_dilation_shape is reentrant and automatically parallelized (on tuple level, channel level, domain level).
gray_dilation, gray_dilation_rect
gray_opening_shape, gray_closing_shape, gray_skeleton
Image filters
