1hew-ComfyUI-1hewNodes/web/docs/1hew_ImageBatchRange/zh.md

Image Batch Range - 按起点步长取图像批次

节点功能： Image Batch Range 根据 start_index、step 与 num_frame 从图像批次中提取图像。num_frame 表示最终取出的张数；当 num_frame = 0 时，表示从 start_index 开始按 step 一直取到末尾。当 start_index ≥ 总帧数 时输出为空批次。

输入

参数名称	入端选择	数据类型	默认值	取值范围	描述
image	-	IMAGE	-	-	输入图像批次
start_index	-	INT	0	0-8192	起始帧索引；当 start_index ≥ 总帧数 时返回空批次。
step	-	INT	1	1-8192	采样步长；1 表示连续取，2 表示每隔 1 张取 1 张。
num_frame	-	INT	1	0-8192	最终取出的图像数量；0 表示从 start_index 开始按 step 一直取到末尾。

输出

输出名称	数据类型	描述
image	IMAGE	按起点与步长提取后的图像批次；越界时为空批次

功能说明

• 边界安全：当 start_index ≥ 总帧数 时返回空批次。
• 步长采样：从 start_index 开始按 step 采样。
• 到末尾模式：当 num_frame = 0 时，从起点按步长一直取到最后一张。
• 异步切片：在工作线程执行切片避免阻塞。
• 空输出处理：返回与输入类型/设备匹配的空批次。

典型用法

• 连续取前几张：start_index=0、step=1、num_frame=N。
• 间隔抽帧：start_index=S、step=K、num_frame=N。
• 从某一帧开始抽到末尾：start_index=S、step=K、num_frame=0。

注意与建议

• 当 start_index ≥ 总帧数 时，输出为空批次。
• 当 num_frame > 0 且剩余可取数量不足时，仅返回实际能取到的图像。
• 当 step = 1 时，行为与旧版连续切片兼容。
• 当 总帧数 = 0 时，输出为空批次。