Convert a region into a binary byte-image.
region_to_bin converts the input region given in Region into a byte-image and assigns a gray value of Grey 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 0.
Region (input_object) |
region(-array) -> object |
Regions to be converted. |
BinImage (output_object) |
image -> object : byte |
Result image of dimension Width * Height containing the converted regions. |
Grey (input_control) |
integer -> integer |
Gray value in which the regions are displayed. | |
Default value: 255 | |
Suggested values: 1, 50, 100, 128, 150, 200, 255 | |
Range of values: 1 <= Grey <= 255 (lin) | |
Recommended increment: 1 |
Width (input_control) |
extent.x -> integer |
Width of the image to be generated. | |
Default value: 512 | |
Suggested values: 256, 512, 1024 | |
Range of values: 1 <= Width <= 1024 (lin) | |
Minimum increment: 1 | |
Recommended increment: 16 | |
Restriction: Width >= 1 |
Height (input_control) |
extent.y -> integer |
Height of the image to be generated. | |
Default value: 512 | |
Suggested values: 256, 512, 1024 | |
Range of values: 1 <= Height <= 1024 (lin) | |
Minimum increment: 1 | |
Recommended increment: 16 | |
Restriction: Height >= 1 |
region_to_bin always returns 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_greyval__