LayerUtility: ImageShift

节点功能:实现图像在二维空间中的精确位移控制,提供循环位移和固定背景两种模式,支持边缘遮罩生成。

输入参数

参数名称说明
image输入图像,用于执行平移操作。
mask可选输入遮罩图,与图像一同平移。若为空将自动从 RGBA 图中提取 alpha 或默认生成全白遮罩。

输出参数

参数名称说明
image平移后的图像。
mask平移后的遮罩图。
border_mask经过绘制与模糊的边缘遮罩图。

控件参数

参数名称说明
shift_x向右平移像素数,负数为向左。建议根据图像宽度比例设置,如 512 宽图可尝试平移 ±128
shift_y向下平移像素数,负数为向上。建议根据图像高度比例设置,用于制造滚动效果或特效遮罩。
cyclic是否启用平移循环(卷轴式移位)。 若为 True,图像边缘将回绕;设为 False 则超出区域填充背景色。
background_color非循环模式下的背景填充颜色,支持 HEX。 如不循环时建议设为 #000000 黑或 #FFFFFF 白以突出内容。
border_mask_width边缘遮罩的宽度(单位:像素)。用于后续遮罩淡化处理,推荐值为 10–40。
border_mask_blur对边缘遮罩应用的模糊强度。建议为 8–32,可形成自然过渡边缘,用于合成或抠图。

cyclic为true时,启用循环填充,未开启则使用background_color,默认黑色填充。

更改颜色填充。

border_mask_blur: 遮罩羽化强度,值越大,遮罩越模糊。