region_to_bin ( Region : BinImage : Grey, Width, Height : )

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.


Parameters

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


Complexity

O(2*Height*Width).


Result

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.


Possible Predecessors

threshold__, connection, regiongrowing__, pouring


Possible Successors

get_greyval__


Alternatives

region_to_label, paint_region__, set_greyval__


See also

clear_image, paint_grey__



Copyright © 1996-1997 MVTec Software GmbH