HALCON Reference Manual 10.0.2
Table of Contents / File / Region ClassesClassesClasses | | | Operators

write_regionwrite_regionwrite_regionWriteRegionWriteRegion (Operator)

Name

write_regionwrite_regionwrite_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 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_regionwrite_regionWriteRegionWriteRegion writes the regions in RegionRegionRegionRegionregion into a binary file. The regions can be written in the HALCON region format or as TIFF files. The format is selected via the file name extension of FileNameFileNameFileNameFileNamefileName. If no extension is specified or if the file extension is '.reg'".reg"".reg"".reg"".reg", the regions are stored in the HALCON region file format in packed form. If no extension is specified in FileNameFileNameFileNameFileNamefileName, the extension '.reg'".reg"".reg"".reg"".reg" is appended to FileNameFileNameFileNameFileNamefileName. If the extension '.tif'".tif"".tif"".tif"".tif" or '.tiff'".tiff"".tiff"".tiff"".tiff" is used, the regions are stored as TIFF files. In both cases, iconic object tuples with an arbitrary number of regions can be written. The output data can be read via the operator read_regionread_regionread_regionReadRegionReadRegion.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) → objectHRegionHRegionHRegionXHobject

Region of the images which are returned.

FileNameFileNameFileNameFileNamefileName (input_control)  filename.write → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Name of region file.

Default value: 'region.reg' "region.reg" "region.reg" "region.reg" "region.reg"

File extension: .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_regionwrite_regionWriteRegionWriteRegion returns the value 2 (H_MSG_TRUE). Otherwise an exception handling is raised.

Possible Predecessors

open_windowopen_windowopen_windowOpenWindowOpenWindow, read_imageread_imageread_imageReadImageReadImage, read_regionread_regionread_regionReadRegionReadRegion, thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing

See also

read_regionread_regionread_regionReadRegionReadRegion

Module

Foundation

Table of Contents / File / Region ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH