read_objectread_objectReadObjectReadObject (Operator)

Name

read_objectread_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)

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

void HObject::ReadObject(const HString& FileName)

void HObject::ReadObject(const char* FileName)

void HObject::ReadObject(const wchar_t* FileName)   (Windows only)

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

void HObject.ReadObject(string fileName)

Description

read_objectread_objectReadObjectReadObjectReadObject reads an iconic object from the file FileNameFileNameFileNameFileNamefileName. The file must be written in the HALCON Iconic Object format (HOBJ), which is supported by the operators write_objectwrite_objectWriteObjectWriteObjectWriteObject, write_imagewrite_imageWriteImageWriteImageWriteImage, and write_regionwrite_regionWriteRegionWriteRegionWriteRegion. See write_objectwrite_objectWriteObjectWriteObjectWriteObject for more information about the HOBJ format.

Execution Information

Parameters

ObjectObjectObjectObjectobjectVal (output_object)  object(-array) objectHObjectHObjectHobject *

Iconic object.

FileNameFileNameFileNameFileNamefileName (input_control)  filename HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of file.

File extension: .hobj

Result

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

Possible Predecessors

write_imagewrite_imageWriteImageWriteImageWriteImage, write_objectwrite_objectWriteObjectWriteObjectWriteObject

See also

write_objectwrite_objectWriteObjectWriteObjectWriteObject, write_imagewrite_imageWriteImageWriteImageWriteImage, read_imageread_imageReadImageReadImageReadImage

Module

Foundation