HALCON Website / HALCON Operator Reference / File / Region
ClassesClassesClassesClasses | | | | Operators

write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion (Operator)

Name

write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion — Write regions to a file.

Signature

write_region(Region : : FileName : )

Herror write_region(const Hobject Region, const char* FileName)

Herror T_write_region(const Hobject Region, const Htuple FileName)

Herror write_region(Hobject Region, const HTuple& FileName)

void HRegion::WriteRegion(const HTuple& FileName) const

void HRegionArray::WriteRegion(const HTuple& FileName) const

void WriteRegion(const HObject& Region, const HTuple& FileName)

void HRegion::WriteRegion(const HString& FileName) const

void HRegion::WriteRegion(const char* FileName) const

void HOperatorSetX.WriteRegion(
[in] IHUntypedObjectX* Region, [in] VARIANT FileName)

void HRegionX.WriteRegion([in] BSTR FileName)

static void HOperatorSet.WriteRegion(HObject region, HTuple fileName)

void HRegion.WriteRegion(string fileName)

Description

The operator write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion 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 FileNameFileNameFileNameFileNameFileNamefileName. 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 FileNameFileNameFileNameFileNameFileNamefileName, the extension '.hobj'".hobj"".hobj"".hobj"".hobj"".hobj" will be appended. See write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject 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_regionReadRegionread_regionReadRegionReadRegion.

Parallelization

Parameters

RegionRegionRegionRegionRegionregion (input_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject

Region of the images which are returned.

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.write → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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')

Example (HDevelop)

regiongrowing(Img,Segments,3,3,5,10)
write_region(Segments,'result1')

Result

If the parameter values are correct the operator write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion returns the value 2 (H_MSG_TRUE). Otherwise an exception handling is raised.

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, read_imageread_imageReadImageread_imageReadImageReadImage, read_regionread_regionReadRegionread_regionReadRegionReadRegion, read_objectread_objectReadObjectread_objectReadObjectReadObject, thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing

See also

read_regionread_regionReadRegionread_regionReadRegionReadRegion

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH