Video Helper Suite 🎥🅥🅗🅢generated
Load Image (Path) 🎥🅥🅗🅢(LoadImagePath)
此节点在技术上通过 `load_video` 函数处理输入路径,因此不仅能加载常见的静态图像格式(如 PNG、JPG),也能处理由多张图像组成的序列。
Load Image Path
vae
IMAGE
mask
image
STRING
custom_width
INT
custom_height
INT
VideoHelperSuite
Load Image (Path) 🎥🅥🅗🅢 节点在技术上通过 load_video 函数处理输入路径,因此不仅能加载常见的静态图像格式(如 PNG、JPG),也能处理由多张图像组成的序列。
Load Image (Path) 节点是 Video Helper Suite 中的一个核心工具,用于从本地文件系统加载单张图像或图像序列。其核心功能是读取指定路径的图像文件,并将其转换为可在 ComfyUI 工作流中使用的图像张量格式,同时支持可选的大小调整。
节点功能
此节点在技术上通过 load_video 函数处理输入路径,因此不仅能加载常见的静态图像格式(如 PNG、JPG),也能处理由多张图像组成的序列。其内部机制会检查图像是否包含 Alpha 通道(透明度)。若有,则自动分离出 RGB 图像和对应的遮罩;若无,则输出一个空的遮罩占位符。节点还包含路径验证和哈希检查功能,以确保输入有效性和缓存更新。
节点参数说明 - Load Image (Path) 🎥🅥🅗🅢
连接输入 (Inputs)
| 参数名称 | 数据类型 | 必填 | 默认值 | 取值范围/选项 | 描述 |
|---|---|---|---|---|---|
vae | VAE | 否 | - | - | vae(输入参数):可选的 VAE 模型。 |
控件参数 (Parameters)
| 参数名称 | 数据类型 | 必填 | 默认值 | 取值范围/选项 | 描述 |
|---|---|---|---|---|---|
image | STRING | 是 | - | - | image(输入参数):指定要加载的图像文件的完整系统路径。支持常见图像格式。 |
custom_width | INT | 是 | 0 | 0 - DIMMAX (步长: 8) | custom_width(输入参数):自定义输出图像的宽度。设置为 0 则使用原图宽度,取值范围为 0 至 DIMMAX,调整步长为 8。 |
custom_height | INT | 是 | 0 | 0 - DIMMAX (步长: 8) | custom_height(输入参数):自定义输出图像的高度。设置为 0 则使用原图高度,取值范围为 0 至 DIMMAX,调整步长为 8。 |
输出
| 参数名称 | 数据类型 | 描述 |
|---|---|---|
| IMAGE | UNKNOWN | IMAGE(输出参数):输出的图像张量,用于后续的图像处理节点。 |
| MASK | MASK | MASK(输出参数):遮罩输出——若加载的图像带有 Alpha 通道则为其透明度信息,否则为一个空的遮罩占位符。 |
使用场景
在视频帧处理或批量图像预处理的工作流中,此节点非常有用。例如,可将其与“VAE 编码”节点连接,将加载的图像编码为潜空间表示以进行后续的图生图操作;或者,利用其输出的遮罩与“应用 ControlNet”等节点结合,实现对图像特定区域的精细控制。
注意事项
请注意,输入的图像路径必须是系统可访问的有效路径。当 custom_width 和 custom_height 参数设置为 0 时,将保持图像的原始尺寸。
评论
使用 GitHub 登录后即可参与讨论。