Determine the gray value range within a rectangle.
gray_range_rect calculates the gray value range, i.e., the difference (max - min) of the maximum and minimum gray values, of the input image Image within a rectangular mask of size (MaskHeight, MaskWidth) for each image point. The resulting image is returned in ImageResult. If the parameters MaskHeight or MaskWidth are even, they are changed to the next larger odd value. At the border of the image the gray values are mirrored.
|
Image (input_object) |
image(-array) -> object : byte / direction / cyclic / int2 / int4 / real |
| Image for which the gray value range is to be calculated. | |
|
ImageResult (output_object) |
image(-array) -> object : byte / direction / cyclic / int2 / int4 / real |
| Image containing the gray value range. | |
|
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 (lin) | |
| 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 (lin) | |
| Minimum increment: 2 | |
|
Recommended increment: 2 | |
| Restriction: odd(MaskWidth) | |
gray_range_rect returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behaviour can be set via set_system('no_object_result',<Result>). If necessary, an exception is raised.
gray_range_rect is reentrant and automatically parallelized (on tuple level, channel level, domain level).
gray_dilation_rect, gray_erosion_rect, sub_image
Image filters
