read_objectread_objectReadObjectReadObject (Operator)
Name
read_objectread_objectReadObjectReadObject
— Read an iconic object.
Signature
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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
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