将图像写入文件

使用此工具将图像写入文件。输入用于在参数“文件名称”中保存图像的目的地。MVApp 每次执行时都会应用写入操作。

执行行为

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

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

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

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

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

参数

基本参数

图像：

此参数表示写入到所选文件中的图像。

如果将彩色图像作为输入图像，彩色图像的所有通道都将用于处理。

文件名称：

此参数定义了写入图像的文件名称和路径。默认情况下设置为“Me_Image.png”，保存在“%USERPROFILE%\Desktop”目录中。您可以在相应的参数中更改文件名称并更改要写入图像的位置。如果定义了相对文件路径，则会在相对于默认目录“%USERPROFILE%\Desktop”的路径中搜索该文件。但是，如果在定义相对文件路径时已保存 MVApp，则会在相对于 MVApp 所在目录的路径搜索该文件。

文件格式：

此参数定义了写入文件的图像格式。默认情况下设置为“png 无”。您可以在相应的连接器中更改格式。

值	描述
png 无	图像以 png 格式写入，且不压缩。此选项比 png 快。
png 最快	图像以 png 格式写入，且使用速度最快的压缩。
png 最佳	图像以 png 格式写入，且采用最高的压缩级别。
png	图像以 png 格式写入。此选项比 png 无慢。
hobj	图像以 hobj 格式写入。HOBJ 是一种二进制文件格式，提供了写入和读取各种图标 HALCON MVTec HALCON 是一个用于机器视觉的综合标准软件，带有一个集成开发环境 (HDevelop)。MERLIC 利用了各种 HALCON 程序和其他程序功能。对象（图像、区域等）的功能。由于数据写入时无需压缩或转换，因此在大多数情况下，写入这种文件格式的速度比其他受支持的文件格式更快。因此，如果应用程序需要尽可能快地读写各种图标 HALCON 对象，并且不需要压缩，则应使用此格式。对于图像，所有 HALCON 像素类型都可写入。支持多通道图像。通道可以具有混合像素类型，但必须具有相同的宽度和高度。图像的域及其创建日期也存储在文件中。对象元组被写入单个文件。
tiff	图像以 tiff 格式写入。
bmp	图像以 bmp 格式写入。
jpeg	图像以 jpeg 格式写入。
jpeg 100	图像以 jpeg 100 格式写入。
jpeg 80	图像以 jpeg 80 格式写入。
jpeg 60	图像以 jpeg 60 格式写入。
jpeg 40	图像以 jpeg 40 格式写入。
jpeg 20	图像以 jpeg 20 格式写入。
ima	图像以 ima 格式写入。

创建目录：

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

其他参数

文件前缀：

此参数定义保存图像时添加为文件名前缀的字符串。默认情况下设置为“无”。您可以选择参数值列表中提供的值之一，也可以在参数的文本字段中键入字符串。这样可以为文件名定义自定义前缀。如果要将相应迭代的信息用于前缀，还可以将上一个工具的结果连接到此连接器。

值列表中有以下值：

值	描述
无	不会向图像的文件名添加前缀。
日期和时间	如果设置此值，将在文件名中添加包含当前日期和时间的前缀。前缀的格式如下： YYYY_MM_DDThh-mm-ss_lll 示例：2022_08_25T11-15-46_225_Me_Image.png

值

描述

无

不会向图像的文件名添加前缀。

日期和时间

如果设置此值，将在文件名中添加包含当前日期和时间的前缀。前缀的格式如下：

YYYY_MM_DDThh-mm-ss_lll

示例：2022_08_25T11-15-46_225_Me_Image.png

文件后缀：

此参数定义保存图像时添加为文件名后缀的字符串。默认情况下设置为“无”。您可以选择参数值列表中提供的值之一，也可以在参数的文本字段中键入字符串。这样，可以为文件名定义自定义后缀。如果要将相应迭代的信息用于后缀，还可以将上一个工具的结果连接到此连接器。

值列表中有以下值：

值	描述
无	不会向图像的文件名添加后缀。
日期和时间	如果设置此值，将在文件名中添加包含当前日期和时间的后缀。后缀的格式如下： YYYY_MM_DDThh-mm-ss_lll 示例：Me_Image_2022_08_25T11-15-46_225.png

值

描述

无

不会向图像的文件名添加后缀。

日期和时间

如果设置此值，将在文件名中添加包含当前日期和时间的后缀。后缀的格式如下：

YYYY_MM_DDThh-mm-ss_lll

示例：Me_Image_2022_08_25T11-15-46_225.png

结果

基本结果

当前文件名称：

此结果包含上次迭代中保存的图像的名称和绝对文件路径，如“C:\Users\Public\Documents\MVTec\MERLIC\write_to_file_images\2022_08_25T11-15-46_225_Me_Image.png”。

工具状态：

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

其他结果

处理时间:

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