跳转至

SaveImage 图像持久化存储与格式导出节点

节点核心功能 (What is it?)

SaveImage 节点允许创作者将工作流处理生成的图像资产持久化保存至本地文件系统。它是各类图像处理管线末端至关重要的导出枢纽，支持将图像编码为多种专业工业格式（PNG、JPEG、BMP、TIFF 等），并提供细致的压缩画质与文件体积控制。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

  • 将生成或调色完成的图像保存到本地磁盘目录；
  • 导出指定格式标准（如支持透明通道的 PNG、体积紧凑的 JPEG、无损打印的 TIFF 等）的图像资产；
  • 精细控制 JPEG 有损压缩系数，平衡网络传输速度与视觉保真度；
  • 固化并备份 AI 生图与复杂节点图层混合的最终成果；
  • 将资产输出至特定共享目录供外部应用程序或影视制作流程实时读取。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 SaveImage 节点。
  2. 将待保存的图像数据源连接至 input_image 输入插槽。
  3. 指定输出目标路径（output_path）及图像封装格式（image_format）。
  4. 运行节点，图像即被编码并写入指定的存储位置。

参数输入插槽 (Parameters)

图像源输入 (Image Input)

  • input_image：待保存的目标图像（可连接来自任意图像处理、调色或生成节点的输出引脚）。

导出与路径配置 (Output Settings)

  • output_path：保存图像的目标物理路径：
    • 支持相对路径（例如 "output/image.png"，相对于当前工作目录）；
    • 支持绝对路径（例如 "C:/Users/username/Desktop/image.png"）；
    • 建议文件后缀名与所选的导出格式保持一致。
  • image_format：保存图像所采用的编码格式：
    • PNG：无损压缩格式，完美支持 Alpha 透明度通道；
    • JPEG：高压缩比有损格式，文件体积小，适合 Web 与快速分发；
    • BMP：未经压缩的标准位图格式；
    • TIFF：影视与专业印刷级别的高解析保真格式。

画质压缩配置 (仅针对 JPEG)

  • quality（1–100，默认 95）：JPEG 格式专属的压缩画质因子：
    • 数值越高 = 画面噪点伪影越少、画质越优异，但文件体积越大；
    • 数值越低 = 文件体积大幅缩减，但可能出现高频块状伪影。

输出引脚 (Outputs)

  • saved_path：图像最终成功落盘的规范化文件绝对路径字符串。
  • file_size：最终生成的图像文件物理大小（单位：字节 Bytes）。

典型工作流示例 (Example)

典型的图像后处理与导出流水线：

  1. 使用 AdjustImageEQ 节点调整画面对比度与饱和度。
  2. 将调色完成的图像输出接入 SaveImage 节点的 input_image 参数。
  3. 配置导出目标：
    • 将 output_path 设为 "processed_image.png"；
    • 将 image_format 设为 "PNG" 以确保色彩与边缘无损保留。
  4. 节点运行后将图片自动写入磁盘。
  5. 从 saved_path 引脚可提取落盘路径，供后续通知或外部调用脚本消费。

关键技术特性 (Important Notes)

  • 自动目录建置 (Auto Directory Creation)：若指定的保存路径中包含尚不存在的子文件夹层级，节点会自动在磁盘中递归创建该目录。
  • 格式特性差异：请依据需求选取格式——如需保留抠图透明轮廓，必须选用支持透明通道的 PNG 或 TIFF。
  • 覆写保护机制 (Overwrite Behavior)：若指定路径下已存在同名文件，节点将默认以当前图像内容进行覆盖更新。

常见问题与排查 (Common Issues)

  • 文件未能成功保存：检查 output_path 路径格式是否合法，以及当前操作系统用户是否对目标磁盘目录具备写入权限。
  • 扩展名与格式冲突：确保路径末尾的文件扩展名（如 .jpg）与参数项中的 image_format 选项保持逻辑统一。
  • JPEG 画质劣化：适当将 quality 滑块提高至 95 或更高，或直接切换为无损的 PNG 格式。

底层技术执行机制 (Technical Details)

节点基于 Pillow/PIL 图像编解码引擎构建：

  • PNG 编码：使用基于 Deflate 算法的无损压缩流水线，包含 8-bit 或 16-bit 深度与 Alpha 蒙版通道。
  • JPEG 编码：运用离散余弦变换（DCT）与量化表矩阵，根据指定的 quality 因子动态压缩色度与亮度频段。
  • BMP 编码：直接按行写入无压缩的 RGB 光栅扫描像素阵列。
  • TIFF 编码：遵循 Tagged Image File Format 规范，保留全部高位深色彩动态范围。