将区域写入文件

使用此工具将区域写入文件。默认情况下区域写入文件格式为 .hobj HOBJ 是一种二进制文件格式，提供了写入和读取各种图标 HALCON 对象（图像、区域和 XLD）的功能。由于数据写入时无需压缩或转换，因此在大多数情况下，写入这种文件格式的速度比其他受支持的文件格式更快。因此，如果应用程序需要尽可能快地读取和写入各种图标 HALCON 对象，并且不需要压缩，则应使用此格式。对于图像，可以写入所有 HALCON 像素类型。支持多通道图像。通道可以具有混合像素类型，但必须具有相同的宽度和高度。图像的域及其创建日期也存储在文件中。对象 tuple 被写入单个文件。 的文件。MVApp 每次执行时都会应用写入操作。您可以在任何 MERLIC Vision App 中使用工具“从文件读取区域”从文件加载区域。

执行行为

此工具的执行行为不同于默认行为。通常，在以下情况下会执行 MERLIC 工具：

• MERLIC Vision App 在连续模式下显式执行。
• MERLIC Vision App 在“运行一次”模式下显式执行。
• 在 MERLIC Creator 中打开了包含该工具的 MERLIC Vision App。
• 在 MERLIC Creator 中更改了该工具的参数值。

不过，仅在以下情况下会执行工具 “将区域写入文件”：

• MERLIC Vision App 在连续模式下显式执行。
• MERLIC Vision App 在“运行一次”模式下显式执行。

这可以确保在加载 MVApp 或更改该工具的参数值时不应用写入操作。

参数

基本参数

图像:

使用此参数将图像设置为背景。这通常应该是处理的特征（如轮廓或 ROI）所连接的图像。如果未连接图像，背景将会是黑色。

区域：

此参数包含写入所选文件的区域。为了提供更好的可视化效果，区域边缘会突出显示。该区域必须传输自前一工具。因此，您必须将参数连接至前一工具的结果。已连接的区域随后会写入文件。

文件名称：

此参数定义了写入区域的文件名称和路径。默认情况下设置为“Me_region.hobj”，保存在“%USERPROFILE%\Documents”目录中。您可以在相应的连接器中更改或选择所需的文件名称和路径。默认情况下，区域以“.hobj”文件格式存储。但是，您也可以将区域写入“.reg ”格式的文件。如果定义了相对文件路径，则会在相对于默认目录“%USERPROFILE%\Documents”的路径中搜索该指定文件。但是，如果在定义相对文件路径时已保存 MVApp，则会在相对于 MVApp 所在目录的路径搜索该文件。

创建目录：

此参数定义 MERLIC 是否创建参数“文件名称”中指定的目录（如果该目录还不存在）。默认情况下，此参数设置为 0，这意味着不会创建任何目录。如果此参数设置为 1，并且在“文件名称”中指定的目录不存在，MERLIC 将在执行 MVApp 后立即创建缺少的目录。

结果

基本结果

当前文件名称：

此结果包含上次迭代中保存的文件的名称和绝对文件路径，如“C:\Users\Public\Documents\MVTec\MERLIC\Me_region.hobj”。

工具状态：

“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。

其他结果

处理时间:

此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。