read_region — Read binary images or HALCON regions.
read_region reads regions from a binary file.
The following formats are currently supported:
File format for iconic HALCON objects. The HOBJ file must contain
only regions to be readable by
read_region. If other
objects (e.g., images or XLDs) are stored in the file,
an exception is raised. In this case
be used to read the corresponding HOBJ file.
The HOBJ format is the default file format for regions.
Therefore, the extension '.hobj' does not have to
be specified when reading or writing the file. See
write_object for more information about the HOBJ format.
File format for HALCON regions. This file format supports multiple regions in a single file. The file extension is '.reg'. This format is now legacy and the HOBJ format should be used instead.
Binary Tiff images with extension 'tiff' or 'tif'. A tiff image can contain any number of regions. The color white is used as foreground.
Binary PNG images with extension 'png'. The result is always one region. The color white is used as foreground.
Binary Windows bitmap images with extension 'bmp'. The result is always one region. The color white is used as foreground.
A search path ('image_dir') can be defined analogous
to the operator
The clipping based on the current image format is set via the
Consequently, if no image of sufficient size has been created before
the call to
set_system('clip_region','false') should be called before
read_region to ensure that the region is not being
Name of the region to be read.
File extension: .
* Reading of regions and giving them gray values. read_image(Img,'ima_test') read_region(Regs,'reg_test') reduce_domain(Img,Regs,Res)
If the parameter values are correct the operator
returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.