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
the extension '.hobj' will be appended.
The iconic data is written in the HALCON Iconic Object format
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.
Name of file.
File extension: .
If the parameters are valid, the operator
write_object returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.