数据保存

功能介绍

模块位置：数据-数据保存

数据保存模块可将流程中其他模块的输出图像作为输入，通过指定的设置保存到指定文件路径。

使用场景

常用于保存流程执行过程中的数据，通过保存数据可以追溯历史数据；

示例说明

• 示例1：设置参数以下参数，保存文件类型为MPDAT (*.mpdat)，格式化文件名类型为序号_格式化文件名_日期时间， 格式化文件名为"fileName"，序号格式为01，日期时间格式为yyyy-MM-dd-HH-mm-ss-zzz，执行模块后保存文件名为00_fileName_2025-09-22 11-42-15-507.mpdat；
• 示例2：设置参数以下参数，保存文件类型为PLY (*.ply)，格式化文件名类型为序号_格式化文件名， 格式化文件名为"fileName"，序号格式为01，执行模块后保存文件名为00_fileName.ply；

输入

基础

输入	类型	说明
保存文件类型	枚举	决定保存文件的后缀名，需与数据类型对应（仅3D图像支持MPDAT，仅点云图像支持PLY），包括：MPDAT (.mpdat) / PLY (.ply) / PNG (.png) / JPG (.jpg) / BMP (*.bmp)
批处理使能	/	启用后，可通过输入数据列表和保存路径列表，批量指定需要保存的数据及其对应的存储位置；不启用时，则使用单个输入数据和单个保存路径进行保存。

启用格式化文件名 - 关闭

输入	类型	说明
启用格式化文件名	布尔	是否格式化生成文件名。
选择保存路径	字符串	指定数据保存时的路径及文件名。 当启用格式化文件名为关闭时需设置

启用格式化文件名 - 启用

输入	类型	说明
启用格式化文件名	布尔	是否格式化生成文件名。
文件保存根目录	字符串	指定数据保存时的路径。 当启用格式化文件名为启用时需设置
格式化文件名类型	枚举	指定文件名的组合方式。 当启用格式化文件名为启用时需设置
格式化文件名	字符串	指定文件名中的格式化文件名（当格式化文件名类型中包含格式化文件名时需设置）。
序号格式	枚举	指定文件名中序号的格式（当格式化文件名类型中包含序号时需设置）。
根目录修改重置序号	布尔	控制修改根目录后是否重置序号（当格式化文件名类型中包含序号时需设置）。
日期时间格式	枚举	指定文件名中日期时间的格式（当格式化文件名类型中包含日期时间时需设置）。

参数说明

条件保存

启用

是否启用根据条件保存。

条件输出

条件保存启用时，保存的判断条件；布尔量，可手动控制或选择模块输出。

最大保存天数

启用

最大保存天数启用时，模块执行时会删除根目录下保存超过一定天数的指定类型的文件。

最大保存天数

最大保存天数启用时，指定数据的最大保存天数，例如60，则会删除根目录下超过60天的指定类型的文件。

磁盘空间

显示当前根目录所在磁盘的空间情况（每5s刷新一次）。

高级

异步保存

启用后，数据保存任务将在独立线程中执行，不阻塞当前流程的其他操作；关闭后，数据保存将在当前流程中同步执行。

数据克隆并发数

用于设置数据克隆操作的最大并发数量，控制同时进行的数据克隆任务数量。

重名覆盖保存

启用后，当保存路径中存在同名文件时，将覆盖原有文件；关闭后，不覆盖已有文件。

输出

输出	类型	默认启用	额外启用条件	说明
执行时间（ms）	实数	是	/	/
执行状态	文本	是	/	/
执行结果	布尔值	是	/	/
文件后缀	文本	是	/	/
文件路径列表	文本列表	是	/	/
完整文件路径列表	文本列表	是	/	/