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

read_objectread_objectReadObjectread_objectReadObjectReadObject (Operator)

Name

read_objectread_objectReadObjectread_objectReadObjectReadObject — Read an iconic object.

Signature

read_object( : Object : FileName : )

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

Herror T_read_object(Hobject* Object, const Htuple FileName)

Herror read_object(Hobject* Object, const HTuple& FileName)

void ReadObject(HObject* Object, const HTuple& FileName)

void HObject::ReadObject(const HString& FileName)

void HObject::ReadObject(const char* FileName)

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

void HImageX.ReadObject([in] BSTR FileName)

void HRegionX.ReadObject([in] BSTR FileName)

void HUntypedObjectX.ReadObject([in] BSTR FileName)

void HXLDContX.ReadObject([in] BSTR FileName)

void HXLDPolyX.ReadObject([in] BSTR FileName)

void HXLDParaX.ReadObject([in] BSTR FileName)

void HXLDModParaX.ReadObject([in] BSTR FileName)

void HXLDExtParaX.ReadObject([in] BSTR FileName)

static void HOperatorSet.ReadObject(out HObject objectVal, HTuple fileName)

void HObject.ReadObject(string fileName)

Description

read_objectread_objectReadObjectread_objectReadObjectReadObject reads an iconic object from the file FileNameFileNameFileNameFileNameFileNamefileName. The file must be written in the HALCON Iconic Object format (HOBJ), which is supported by the operators write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject, write_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage, and write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion. See write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject for more information about the HOBJ format.

Parallelization

Parameters

ObjectObjectObjectObjectObjectobjectVal (output_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 read_objectread_objectReadObjectread_objectReadObjectReadObject returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

write_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage, write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject

See also

write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject, write_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage, read_imageread_imageReadImageread_imageReadImageReadImage

Module

Foundation

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