| Operators |
region_to_bin — Convert a region into a binary byte-image.
region_to_bin(Region : BinImage : ForegroundGray, BackgroundGray, Width, Height : )
region_to_bin converts the input region given in Region into a 'byte'-image and assigns a gray value of ForegroundGray to all pixels in the region. If the input region is larger than the generated image, it is clipped at the image borders. The background is set to BackgroundGray.
Regions to be converted.
Result image of dimension Width * Height containing the converted regions.
Gray value in which the regions are displayed.
Default value: 255
Suggested values: 0, 1, 50, 100, 128, 150, 200, 254, 255
Typical range of values: 0 ≤ ForegroundGray ≤ 255 (lin)
Recommended increment: 1
Gray value in which the background is displayed.
Default value: 0
Suggested values: 0, 1, 50, 100, 128, 150, 200, 254, 255
Typical range of values: 0 ≤ BackgroundGray ≤ 255 (lin)
Recommended increment: 1
Width of the image to be generated.
Default value: 512
Suggested values: 256, 512, 1024
Typical range of values: 1 ≤ Width ≤ 1024 (lin)
Minimum increment: 1
Recommended increment: 16
Restriction: Width >= 1
Height of the image to be generated.
Default value: 512
Suggested values: 256, 512, 1024
Typical range of values: 1 ≤ Height ≤ 1024 (lin)
Minimum increment: 1
Recommended increment: 16
Restriction: Height >= 1
region_to_bin always returns 2 (H_MSG_TRUE). The behavior in case of empty input (no regions given) can be set via set_system('no_object_result',<Result>) and the behavior in case of an empty input region via set_system('empty_region_result',<Result>). If necessary, an exception is raised.
threshold, connection, regiongrowing, pouring
region_to_label, paint_region, set_grayval
Foundation
| Operators |