ImageAndMaskPreview

ImageAndMaskPreview 节点继承自 SaveImage 类，但主要目的是生成临时预览图而非永久保存。

ImageAndMaskPreview 节点是一个用于预览图像和遮罩的实用工具。它的核心功能是允许用户单独查看图像或遮罩，或者将遮罩以指定的颜色和透明度叠加在图像之上，从而直观地检查遮罩区域。

节点功能

该节点继承自 SaveImage 类，但主要目的是生成临时预览图而非永久保存。它支持多种颜色格式定义遮罩颜色，包括 RGB 元组、RGBA 元组和十六进制代码。当同时提供图像和遮罩时，节点会将遮罩按设定的不透明度和颜色合成到图像上；如果只提供其中一种，则直接输出该元素的预览。

节点参数说明 - ImageAndMaskPreview

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`image`	IMAGE	否	-	-	可选输入图像，用于预览或在其上合成遮罩。
`mask`	MASK	否	-	-	可选输入遮罩，用于预览或合成到图像之上。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`mask_opacity`	FLOAT	是	1.0	0.0 - 1.0 (步长: 0.01)	控制遮罩叠加在图像上的整体不透明度。取值范围为 0.0（完全透明）到 1.0（完全不透明），调整步长为 0.01。
`mask_color`	STRING	是	255, 255, 255	-	RGBA（如"255,255,255,128"）或十六进制（如"#FF0000"）格式。
`pass_through`	BOOLEAN	是	False	-	启用时，节点将禁用界面预览，并直接从输出端口传递合成后的图像数据。

输出 (Outputs)

参数名称	数据类型	说明
composite	IMAGE	输出合成后的预览图像或直接传递的图像数据。

使用场景

在图像处理工作流中，此节点非常有用。例如，在生成一个遮罩后，你可以将其连接到该节点，并设置 mask_color 为醒目的红色，以快速验证遮罩是否准确地覆盖了目标区域。或者，在视频合成流程前，利用其 pass_through 功能将合成结果直接传递给后续的动画组合节点，而无需中断流程查看预览。

注意事项

需要注意的是，当启用 pass_through 模式时，节点将不会在界面中显示预览图像，而是直接从输出端口传递合成结果。此外，遮罩颜色支持 RGBA 格式，这意味着你可以为颜色本身指定独立的透明度，与整体的 mask_opacity 参数共同作用。