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)

参数名称数据类型必填默认值取值范围/选项描述
vaeVAE--vae(输入参数):可选的 VAE 模型。

控件参数 (Parameters)

参数名称数据类型必填默认值取值范围/选项描述
imageSTRING--image(输入参数):指定要加载的图像文件的完整系统路径。支持常见图像格式。
custom_widthINT00 - DIMMAX (步长: 8)custom_width(输入参数):自定义输出图像的宽度。设置为 0 则使用原图宽度,取值范围为 0 至 DIMMAX,调整步长为 8。
custom_heightINT00 - DIMMAX (步长: 8)custom_height(输入参数):自定义输出图像的高度。设置为 0 则使用原图高度,取值范围为 0 至 DIMMAX,调整步长为 8。

输出

参数名称数据类型描述
IMAGEUNKNOWNIMAGE(输出参数):输出的图像张量,用于后续的图像处理节点。
MASKMASKMASK(输出参数):遮罩输出——若加载的图像带有 Alpha 通道则为其透明度信息,否则为一个空的遮罩占位符。

使用场景

在视频帧处理或批量图像预处理的工作流中,此节点非常有用。例如,可将其与“VAE 编码”节点连接,将加载的图像编码为潜空间表示以进行后续的图生图操作;或者,利用其输出的遮罩与“应用 ControlNet”等节点结合,实现对图像特定区域的精细控制。

注意事项

请注意,输入的图像路径必须是系统可访问的有效路径。当 custom_widthcustom_height 参数设置为 0 时,将保持图像的原始尺寸。

Load Image (Path) 🎥🅥🅗🅢 节点源码链接

Load Image (Path) 🎥🅥🅗🅢 节点来自 ComfyUI-VideoHelperSuite 节点包。

评论

使用 GitHub 登录后即可参与讨论。

评论加载中…