write_region
— Write regions to a file.
The operator write_region
writes the regions in Region
into a binary file. The regions can be written in the HALCON Iconic Object
format (HOBJ), as TIFF files or as HALCON region files. The
format is selected via the file name extension of FileName
. If
no extension is specified or if the file extension is '.hobj' ,
the regions are stored in the HOBJ format. If no extension is specified
in FileName
, the extension '.hobj' will be appended.
See write_object
for more information about the
HOBJ format. If the extension '.tif' or '.tiff' is
specified, the regions are stored as TIFF files. If the extension
'.reg' is specified, the regions are stored as a HALCON region file.
The HALCON region file format is now legacy and the file format HOBJ should
be used instead unless the files must be readable with HALCON versions older
than 12.0. Iconic object tuples with an arbitrary number of regions
can be written. The output data can be read via the operator
read_region
.
Region
(input_object) region(-array) →
object
Region of the images which are returned.
FileName
(input_control) filename.write →
(string)
Name of region file.
Default: 'region.hobj'
File extension:
.hobj
, .reg
, .tif
, .tiff
regiongrowing(Img,Segments,3,3,5,10) write_region(Segments,'result1')
If the parameter values are correct the operator
write_region
returns the value 2 (
H_MSG_TRUE)
. Otherwise an exception
handling is raised.
read_image
,
read_region
,
read_object
,
threshold
,
regiongrowing
Foundation