Load Images From Folder (KJ) (LoadImagesFromFolderKJ) - ComfyUI-KJNodes

Load Images From Folder (KJ) 节点支持读取 JPG、JPEG、PNG、WEBP 和 TGA 格式的图像文件。

Load Images From Folder (KJ) 节点是一个图像加载器，专门用于从指定的文件夹中批量读取图像文件。它的核心功能是自动扫描文件夹，将找到的图像统一处理后输出，以便在后续的工作流中进行批处理或分析。

节点功能

此节点支持读取 JPG、JPEG、PNG、WEBP 和 TGA 格式的图像文件。它通过监控文件夹内文件的修改时间和数量变化来判断内容是否已更新，从而决定是否需要重新处理。节点提供了多种图像尺寸调整策略，以适应不同的处理需求。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`keep_aspect_ratio`	COMBO	是	crop	"crop", "pad", "stretch"	决定如何将图像调整到目标尺寸：“crop”（裁剪适应）、“pad”（填充透明度）或“stretch”（拉伸适应）。
`folder`	STRING	是	-	-	`folder`（输入参数）：指定要从中加载图像文件的文件夹路径。可以是绝对路径或相对于 ComfyUI 基础目录的相对路径。
`width`	INT	是	1024	-1 及以上	`width`（输入参数）：设置输出图像的目标宽度（像素）。设为 -1 则保持原始宽度。
`height`	INT	是	1024	-1 及以上	`height`（输入参数）：设置输出图像的目标高度（像素）。设为 -1 则保持原始高度。
`image_load_cap`	INT	否	0	0 及以上	限制从文件夹中加载的图像数量。值为 0 表示不限制。
`start_index`	INT	否	0	0 及以上	从排序后的文件列表中跳过该索引之前的图像。
`include_subfolders`	BOOLEAN	否	False	True / False	启用后，也会递归加载子文件夹中的图像。

参数名称	数据类型	说明
image	IMAGE	`image`（输出参数）：输出处理后的图像张量，供后续节点使用。
mask	MASK	`mask`（输出参数）：输出与图像对应的遮罩，通常用于标识非透明区域。
count	INT	`count`（输出参数）：输出本次成功加载的图像文件总数。
image_path	STRING	`image_path`（输出参数）：输出当前加载图像的完整文件路径字符串。

在构建批量图像处理或数据集准备的工作流时，此节点非常有用。例如，你可以将其连接到 Upscale 或 Style Transfer 节点，对文件夹中的所有图片进行统一规格的增强处理，或者用于创建训练集。

请注意，如果指定的文件夹路径不存在或为空，节点可能无法正常工作。此外，处理大量高分辨率图像时，需要留意系统内存的占用情况。