Latents Composite Mask 算子节点

在指定的物理像素偏移坐标下，将源潜变量张量贴入目标潜变量画布中，并可选地通过外部图像蒙版实现平滑羽化融合。

算子所属分类：ModularDiffusion/Transform

核心速查 (TL;DR)

潜空间精准拼贴与加权融合：在 (x_offset, y_offset) 像素偏移处将 source_latent 贴合注入到 destination_latent 中。在遮罩蒙版中：白色像素区域 ($\approx 1.0$) 呈现源张量；黑色像素区域 ($\approx 0.0$) 保留目标底图张量；
直观的物理像素级偏移：偏移参数采用直观的人类像素单位；节点底层会自动将其按 VAE 下采样比率（通常为 $\div 8$）折算为潜空间微观网格坐标；
源图像自动缩放适配：开启 resize_source 开关可使源潜变量在拼贴前双线性插值缩放到目标画布的相同空间几何尺寸；
智能遮罩自适应重采样：输入的图像遮罩会自动重采样以完美贴合源潜变量的张量维度。

Generate Latents (目标基底画布) ──┐
Generate Latents (源插入内容) ────┼─→ [Latents Composite Mask] → Generate Media Latents
Paint Mask (绘制的黑白遮罩) ──────┘

Latents Composite Mask 算子节点外观

端口名称	数据类型	是否必填	详细功能与业务规范说明
`destination_latent`	`LatentArtifact`	是	承载贴图的目标底图画布潜变量。
`source_latent`	`LatentArtifact`	是	准备拼贴嵌入的源特征潜变量。
`mask_image`	`ImageArtifact` / `ImageUrlArtifact`	否	用于权重混合的黑白/透明度遮罩图像。若未连接，则源张量会在其覆盖的几何矩形区域内进行全量硬覆盖替换。

端口名称	数据类型	详细功能与业务规范说明
`output_latent`	`LatentArtifact`	完成空间贴合与蒙版权重融合后的全新目标画幅潜变量对象。

参数名称	数据类型	默认值	详细业务功能与调优说明
`x_offset`	`int` (像素, 0~2000)	`0`	水平方向拼贴偏移量（底层自动 $\div 8$ 折算为潜空间单位）。
`y_offset`	`int` (像素, 0~2000)	`0`	垂直方向拼贴偏移量（底层自动 $\div 8$ 折算为潜空间单位）。
`resize_source`	`bool`	`False`	是否在合成前通过双线性插值将源张量强制缩放至与目标画布完全同等的空间分辨率。

参数名称	数据类型	默认值	详细功能说明
`channel`	下拉枚举	`alpha`	提取作为混合权重依据的图像物理通道（如 `alpha`、`red`、`luminance` 等）。
`invert_mask`	`bool`	`False`	反转蒙版极性（将源内容与目标底图的作用区域对调）。
`grow_shrink`	`float` (-100~100)	`0`	边缘形态学膨胀 (+) 或腐蚀 (-)，微调遮罩贴合边缘。
`blur_mask`	`float` (0~100)	`0`	高斯羽化遮罩边缘，有效消除特征拼接处的阶梯状生硬接缝。

严格遵守空间几何交集原则：只有真正重叠的交集区域才会发生特征合成。如果 x_offset + 源张量宽度超出了目标画布的边界，超出画幅的溢出部分会被自动物理裁切丢弃；若两者完全没有任何几何相交，节点将无损直出原始目标底图。
牢记输入参数为像素坐标，绝非潜空间坐标：例如在 1024px 宽度的目标画布上，对应的潜变量宽度仅为 128 个单位。在配置 x_offset 时，请按常规图像的 1024 像素坐标系进行心智对齐，节点内部会自动完成下采样折算。
完美兼容 4D 图像与 5D 视频潜变量：若传入的是视频潜变量（5 维张量），输入的 2D 蒙版会自动沿时间步长（Temporal 轴）进行全局广播复制。
张量元数据继承规则：最终输出产物严格继承目标底图 destination_latent 的张量物理形状与属性字典；当遇到元数据键冲突时，目标底图拥有绝对裁决权。