2.0 KiB
2.0 KiB
Mask Batch Range - 按起点步长取遮罩批次
节点功能： Mask Batch Range 根据 start_index、step 与 num_frame 从遮罩批次中提取遮罩。num_frame 表示最终取出的张数；当 num_frame = 0 时，表示从 start_index 开始按 step 一直取到末尾。当 start_index ≥ 总帧数 时输出为空批次。
输入
| 参数名称 | 入端选择 | 数据类型 | 默认值 | 取值范围 | 描述 |
|---|---|---|---|---|---|
mask |
- | MASK | - | - | 输入遮罩批次 |
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 一直取到末尾。 |
输出
| 输出名称 | 数据类型 | 描述 |
|---|---|---|
mask |
MASK | 按起点与步长提取后的遮罩批次；越界时为空批次 |
功能说明
- 边界安全：当
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。
注意与建议
- 行为与
Image Batch Range在张量层面保持一致。 - 当
start_index ≥ 总帧数时为空。 - 当
num_frame > 0且剩余可取数量不足时，仅返回实际能取到的遮罩。 - 当
step = 1时，行为与旧版连续切片兼容。 - 当
总帧数 = 0时为空。