read_objectread_objectReadObjectReadObjectread_object (Operator)

Name

read_objectread_objectReadObjectReadObjectread_object — 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)

def read_object(file_name: str) -> HObject

Description

read_objectread_objectReadObjectReadObjectReadObjectread_object reads an iconic object from the file FileNameFileNameFileNameFileNamefileNamefile_name. The file must be written in the HALCON Iconic Object format (HOBJ), which is supported by the operators write_objectwrite_objectWriteObjectWriteObjectWriteObjectwrite_object, write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image, and write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region. See write_objectwrite_objectWriteObjectWriteObjectWriteObjectwrite_object for more information about the HOBJ format.

Execution Information

Parameters

ObjectObjectObjectObjectobjectValobject (output_object)  object(-array) objectHObjectHObjectHObjectHobject *

Iconic object.

FileNameFileNameFileNameFileNamefileNamefile_name (input_control)  filename HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of file.

File extension: .hobj

Result

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

Possible Predecessors

write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image, write_objectwrite_objectWriteObjectWriteObjectWriteObjectwrite_object

See also

write_objectwrite_objectWriteObjectWriteObjectWriteObjectwrite_object, write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image, read_imageread_imageReadImageReadImageReadImageread_image

Module

Foundation