write_regionwrite_regionWriteRegionWriteRegionwrite_region (Operator)
Name
write_regionwrite_regionWriteRegionWriteRegionwrite_region — Write regions to a file.
Signature
Description
The operator write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region writes the regions in RegionRegionRegionRegionregionregion
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 FileNameFileNameFileNameFileNamefileNamefile_name. If
no extension is specified or if the file extension is '.hobj'".hobj"".hobj"".hobj"".hobj"".hobj",
the regions are stored in the HOBJ format. If no extension is specified
in FileNameFileNameFileNameFileNamefileNamefile_name, the extension '.hobj'".hobj"".hobj"".hobj"".hobj"".hobj" will be appended.
See write_objectwrite_objectWriteObjectWriteObjectWriteObjectwrite_object for more information about the
HOBJ format. If the extension '.tif'".tif"".tif"".tif"".tif"".tif" or '.tiff'".tiff"".tiff"".tiff"".tiff"".tiff" is
specified, the regions are stored as TIFF files. If the extension
'.reg'".reg"".reg"".reg"".reg"".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_regionread_regionReadRegionReadRegionReadRegionread_region.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
RegionRegionRegionRegionregionregion (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Region of the images which are returned.
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of region file.
Default value:
'region.hobj'
"region.hobj"
"region.hobj"
"region.hobj"
"region.hobj"
"region.hobj"
File extension: .hobj, .reg, .tif, .tiff
Example (HDevelop)
regiongrowing(Img,Segments,3,3,5,10)
write_region(Segments,'result1')
Example (C)
regiongrowing(Img,&Segments,3,3,5,10);
write_region(Segments,"result1");
Example (HDevelop)
regiongrowing(Img,Segments,3,3,5,10)
write_region(Segments,'result1')
Example (HDevelop)
regiongrowing(Img,Segments,3,3,5,10)
write_region(Segments,'result1')
Example (HDevelop)
regiongrowing(Img,Segments,3,3,5,10)
write_region(Segments,'result1')
Result
If the parameter values are correct the operator
write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region returns the value 2 (H_MSG_TRUE). Otherwise an exception
handling is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window,
read_imageread_imageReadImageReadImageReadImageread_image,
read_regionread_regionReadRegionReadRegionReadRegionread_region,
read_objectread_objectReadObjectReadObjectReadObjectread_object,
thresholdthresholdThresholdThresholdThresholdthreshold,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing
See also
read_regionread_regionReadRegionReadRegionReadRegionread_region
Module
Foundation