read_objectread_objectReadObjectReadObjectread_object (Operator)
Name
read_objectread_objectReadObjectReadObjectread_object — Read an iconic object.
Signature
Description
read_objectread_objectReadObjectReadObjectread_object reads an iconic object from the file FileNameFileNameFileNamefileNamefile_name.
The file must be written in the HALCON Iconic Object format (HOBJ),
which is supported by the operators write_objectwrite_objectWriteObjectWriteObjectwrite_object,
write_imagewrite_imageWriteImageWriteImagewrite_image, and write_regionwrite_regionWriteRegionWriteRegionwrite_region. See write_objectwrite_objectWriteObjectWriteObjectwrite_object
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
ObjectObjectObjectobjectValobject (output_object) object(-array) → objectHObjectHObjectHObjectHobject *
Iconic object.
FileNameFileNameFileNamefileNamefile_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_objectReadObjectReadObjectread_object returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
Possible Predecessors
write_imagewrite_imageWriteImageWriteImagewrite_image,
write_objectwrite_objectWriteObjectWriteObjectwrite_object
See also
write_objectwrite_objectWriteObjectWriteObjectwrite_object,
write_imagewrite_imageWriteImageWriteImagewrite_image,
read_imageread_imageReadImageReadImageread_image
Module
Foundation