write_object — Write an iconic object.
write_object writes the iconic Object to the file
FileName. The iconic object is a (possibly mixed) tuple of
images, regions, or XLDs. If no extension is specified in FileName,
the extension '.hobj' will be appended.
The iconic data is written in the HALCON Iconic Object format
described below.
HOBJ is a binary file format, which provides the functionality to write and read all kinds of iconic HALCON objects (images, regions, and XLDs). Since data is written with neither compression nor conversion, writing this file format is faster than other supported file formats in most circumstances. Hence, if an application needs to read and write all kinds of iconic HALCON objects as fast as possible and no compression is required, this format should be used. The default file extension for this file format is '.hobj'. For images, all HALCON pixel types can be written. Multi-channel images are supported. The channels can have mixed pixel types but must have the same width and height. The domain of an image and it's creation date are stored in the file as well. An object tuple is written into a single file.
Object (input_object) object(-array) → object
Iconic object.
FileName (input_control) filename → (string)
Name of file.
File extension:
.hobj
If the parameters are valid, the operator
write_object returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
read_object,
write_image,
read_image,
write_region,
read_region
Foundation