Offset Mask (OffsetMask) - ComfyUI-KJNodes

Offset Mask 节点接收一个或多个遮罩作为输入，并允许用户指定水平和垂直方向的偏移量（x, y）、旋转角度（angle）以及遮罩的复制次数（duplication_factor）。

Offset Mask 节点是一个用于处理和变换遮罩的工具。其核心功能是通过平移、旋转和复制等操作，对输入的遮罩进行空间位置调整，从而生成新的遮罩。此节点特别适合在需要精确控制图像局部处理区域的工作流中使用。

节点功能

此节点接收一个或多个遮罩作为输入，并允许用户指定水平和垂直方向的偏移量（x, y）、旋转角度（angle）以及遮罩的复制次数（duplication_factor）。它支持三种边缘填充模式（padding_mode）来处理偏移后产生的空白区域，并提供了“滚动”（roll）和“增量”（incremental）两种特殊处理选项，以实现更复杂的变换效果。

节点参数说明 - Offset Mask

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`mask`	MASK	是	-	-	待变换的输入遮罩或遮罩批次。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`padding_mode`	COMBO	是	empty	"empty", "border", "reflection"	“empty”：将外部区域留空（零值）；“border”（使用边缘像素扩展）；“reflection”（镜像反射边缘像素）。
`x`	INT	是	0	-4096 - MAX_RESOLUTION (步长: 1)	：设置遮罩在水平方向（左右）的偏移量。正值向右偏移，负值向左偏移，取值范围为 -4096 至 MAX_RESOLUTION。
`y`	INT	是	0	-4096 - MAX_RESOLUTION (步长: 1)	：设置遮罩在垂直方向（上下）的偏移量。正值向下偏移，负值向上偏移，取值范围为 -4096 至 MAX_RESOLUTION。
`angle`	INT	是	0	-360 - 360 (步长: 1)	：设置遮罩的旋转角度，单位为度。正值逆时针旋转，负值顺时针旋转，取值范围为 -360 至 360。
`duplication_factor`	INT	是	1	1 - 1000 (步长: 1)	：指定将输入遮罩复制的次数，以形成输出批次。取值范围为 1 至 1000。用于创建多个相同的遮罩进行批量处理或后续差异操作。
`roll`	BOOLEAN	是	False	-	：启用后，当遮罩偏移超出边界时，超出的部分会从另一侧重新进入画面，实现循环滚动的效果。
`incremental`	BOOLEAN	是	False	-	：启用后，旋转角度（angle）将对批次中的每个遮罩依次累加。第一个遮罩旋转 angle 度，第二个旋转 2*angle 度，依此类推。

输出 (Output)

参数名称	数据类型	说明
mask	MASK	旋转等变换处理后的新遮罩。

使用场景

在图像生成或编辑工作流中，你可以使用此节点来创建动态的遮罩序列。例如，通过设置递增的旋转角度（启用 incremental 选项）和复制因子，可以生成一系列旋转角度逐步变化的遮罩，用于控制一个物体在动画帧中的旋转过程，或者为同一区域应用不同角度的特效。

注意事项

请注意，当使用较大的偏移值或旋转角度时，遮罩的主要区域可能会移出画布边界，导致有效遮罩区域变小。此外，duplication_factor 参数会显著增加输出的遮罩批次大小，在处理大量复制时需考虑系统内存。

Offset Mask 节点源码链接

Offset Mask 节点来自 ComfyUI-KJNodes 节点包。

Offset Mask(OffsetMask)

Offset Mask