Read Region from File

Use this tool to read a region from a file that was previously saved using the tool Write Region to File. The tool instantly reads the region from the file if the "File Name" is changed.

Parameters

Basic Parameters

File Name:

This parameter defines the name and path of the file from which the region is read. It is set to "Me_region.hobj" by default which is located in the directory "%USERPROFILE%\Documents". You can change or select the desired file name and path at the corresponding connector. You can read regions from files of type ".reg" or ".hobj 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 are 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. 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 its creation date are stored in the file as well. An object tuple is written into a single file.". If you define a relative file path, the file is searched relative to the default directory "%USERPROFILE%\Documents". However, if your MVApp was already saved when you define a relative file path, the file is searched relative to the directory in which the MVApp is located.

Results

Basic Results

Region:

This result contains the region that is read from the selected file. The region is also highlighted in the Tool Board.

Current File Name:

This result contains the name and absolute file path of the file that was read in the last iteration, e.g., "C:\Users\Public\Documents\MVTec\MERLIC\Me_region.hobj".

Tool State:

"Tool State" returns information about the state of the tool and thus can be used for error handling. For more information, see Tool State Result

Additional Results

Processing Time:

This result returns the duration of the most recent execution of the tool in milliseconds. The result is provided as additional result. Therefore, it is hidden by default but it can be displayed via the button beside the tool results. For more information see the section Processing Time in the tool reference overview.