| 参数名称 | 说明 |
|---|---|
| background_image | 背景图像，作为最终合成基底。 |
| layer_image | 图层图像，将经过定位、缩放、镜像、旋转等变换后合成到背景图中。 |
| layer_mask | 前景遮罩图，用于限制贴图区域。白色区域为可见区。 |
LayerUtility: ImageBlendAdvance
节点功能：用于将图层图像按照指定模式与背景图像混合，增强版。
输入参数
输出参数
| 参数名称 | 说明 |
|---|---|
| image | 合成后的图像，包含变换后图层叠加结果。 |
| mask | 图层实际叠加区域对应的遮罩图（受旋转、缩放等影响）。 |
控件参数
| 参数名称 | 说明 |
|---|---|
| invert_mask | 是否反转遮罩图。 |
| blend_mode | 混合模式。 normal：正常混合，无特殊处理。是默认模式，适合大多数通用叠加场景。 multiply：正片叠底，颜色变暗。可模拟阴影、加深色块，常用于投影、合成。 overlay：叠加，依背景变亮或变暗。能增强对比度与光感，适合图标投影或文字高光。 screen：滤色，颜色变亮。常用于制作高光或光晕效果。 darken：仅保留较暗部分。用于遮罩交集、裁剪图形。 lighten：仅保留较亮部分。可制作柔光遮罩、合成闪光。 color_dodge：颜色减淡。能强调亮部，可用于高光效果或火光特效。 color_burn：颜色加深。可强调暗部，用于制造压暗区域或表现金属质感。 soft_light：柔光混合。带来柔和的亮度变化，用于自然光影融合。 hard_light：强光混合。产生更强对比的叠加，适合艺术性合成。 difference：差值混合。对比明显，用于制作特效或差异对比。 exclusion：排除混合。效果与 difference 类似但更柔和，适用于高对比风格。 |
| opacity | 图层透明度（0~100%）。控制叠加强度。推荐 40~80，避免完全不透明造成生硬拼接。 |
| x_percent | 图层横向放置位置，以背景图宽度百分比表示（默认居中为 50）。设为 0 表示左对齐，100 表示右对齐，50 表示居中。适合通过百分比实现相对定位，兼容不同尺寸背景图。 |
| y_percent | 图层纵向放置位置，以背景图高度百分比表示。同上，0 为顶部，100 为底部，推荐配合 x_percent 一起构造弹性布局合成。 |
| mirror | 镜像翻转模式： • None：不翻转 • horizontal：水平翻转 • vertical：垂直翻转 |
| scale | 缩放比例（1 = 原尺寸），支持 0.01 ~ 100。控制图层整体大小，适合将贴图缩小定位到局部区域。推荐设置为 0.3 ~ 1.5 范围内以获得可控贴合。 |
| aspect_ratio | 缩放时的纵横比（1 = 不变）。>1 表示拉高，<1 表示压扁。可用于构造非正比贴图效果，如细长形状、扁平图案等。与 scale 联用实现更强的图像空间调整。 |
| rotate | 旋转角度，单位为度。正值为顺时针，负值为逆时针。可实现角度错位贴图、视觉变换合成等。支持大范围角度（如 90、180、360 旋转等）。 |
| transform_method | 图像插值方式： • lanczos（高质量） • bicubic（平滑） • hamming / bilinear / nearest / box。 建议图像锐化要求高时选用 lanczos 或 bicubic，贴图简单时使用 nearest 更快。 |
| anti_aliasing | 抗锯齿等级（0~16），影响旋转插值边缘质量。推荐设置为 1~4，提升边缘过渡平滑性。过高数值可能影响性能。 |
x_percent: X轴中心位置(%)
y_percent: Y轴中心位置(%)
mirror镜像翻转：水平翻转和垂直翻转。
scale：图像缩放系数，<1缩小，>1放大。
aspect_ratio: 宽高比调整，从上面scale以及下面图片中可以看到，这些参数只对图像的主体有效，对背景无效。
rotate: 旋转角度(度)，对图像的主体进旋转。