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

write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject (Operator)

Name

write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject — Write an iconic object.

Signature

write_object(Object : : FileName : )

Herror write_object(const Hobject Object, const char* FileName)

Herror T_write_object(const Hobject Object, const Htuple FileName)

Herror write_object(Hobject Object, const HTuple& FileName)

void WriteObject(const HObject& Object, const HTuple& FileName)

void HObject::WriteObject(const HString& FileName) const

void HObject::WriteObject(const char* FileName) const

void HOperatorSetX.WriteObject(
[in] IHUntypedObjectX* Object, [in] VARIANT FileName)

void HImageX.WriteObject([in] BSTR FileName)

void HRegionX.WriteObject([in] BSTR FileName)

void HUntypedObjectX.WriteObject([in] BSTR FileName)

void HXLDContX.WriteObject([in] BSTR FileName)

void HXLDPolyX.WriteObject([in] BSTR FileName)

void HXLDParaX.WriteObject([in] BSTR FileName)

void HXLDModParaX.WriteObject([in] BSTR FileName)

void HXLDExtParaX.WriteObject([in] BSTR FileName)

static void HOperatorSet.WriteObject(HObject objectVal, HTuple fileName)

void HObject.WriteObject(string fileName)

Description

write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject writes the iconic ObjectObjectObjectObjectObjectobjectVal to the file FileNameFileNameFileNameFileNameFileNamefileName. The iconic object is a (possibly mixed) tuple of images, regions, or XLDs. If no extension is specified in FileNameFileNameFileNameFileNameFileNamefileName, the extension '.hobj'".hobj"".hobj"".hobj"".hobj"".hobj" will be appended. The iconic data is written in the HALCON Iconic Object format described below.

HALCON Iconic Object (HOBJ) (HALCON 12.0 or higher):

HOBJ is a binary file format, which provides the functionality to write and read all kinds of iconic HALCON objects (images, regions, and XLDs). Since data is written with neither compression nor conversion, writing this file format is faster than other supported file formats in most circumstances. Hence, if an application needs to read and write all kinds of iconic HALCON objects as fast as possible and no compression is required, this format should be used. The default file extension for this file format is '.hobj'".hobj"".hobj"".hobj"".hobj"".hobj". For images, all HALCON pixel types can be written. Multi-channel images are supported. The channels can have mixed pixel types but must have the same width and height. The domain of an image and it's creation date are stored in the file as well. An object tuple is written into a single file.

Parallelization

Parameters

ObjectObjectObjectObjectObjectobjectVal (input_object)  object(-array) → objectHObjectHObjectHObjectHObjectXHobject

Iconic object.

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name of file.

File extension: .hobj

Result

If the parameters are valid, the operator write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Successors

read_objectread_objectReadObjectread_objectReadObjectReadObject, read_imageread_imageReadImageread_imageReadImageReadImage

See also

read_objectread_objectReadObjectread_objectReadObjectReadObject, write_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage, read_imageread_imageReadImageread_imageReadImageReadImage, write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion, read_regionread_regionReadRegionread_regionReadRegionReadRegion

Module

Foundation

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