Mask Or Image To Weight (MaskOrImageToWeight) - ComfyUI-KJNodes

Mask Or Image To Weight 节点，该节点在技术上会遍历输入的图像或遮罩批次，对每个元素计算其所有像素值的平均值。

Mask Or Image To Weight 节点是一个用于提取图像或遮罩批量数据平均值的工具。其核心功能是接收一批图像或遮罩，计算其中每一张的平均像素值，并将这些数值以指定的格式输出。该节点简化了从视觉数据中获取量化统计信息的过程。

节点功能

该节点在技术上会遍历输入的图像或遮罩批次，对每个元素计算其所有像素值的平均值。它支持两种可选输入类型：IMAGE 和 MASK。至少应提供一种输入。计算出的平均值列表可以根据 output_type 参数转换为列表、Pandas Series 或 PyTorch 张量等不同格式。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`images`	IMAGE	否	-	-	images（输入参数）：输入一个图像批次，节点将计算其中每张图像的平均像素值。
`masks`	MASK	否	-	-	masks（输入参数）：输入一个遮罩批次，节点将计算其中每个遮罩的平均像素值。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`output_type`	COMBO	是	list	"list", "pandas series", "tensor", "string"	"list"、"pandas series"、"tensor" 或 "string"。

参数名称	数据类型	说明
FLOAT	FLOAT	FLOAT（输出参数）：以指定格式输出的平均值数据。
STRING	STRING	STRING（输出参数）：平均值列表转换成的字符串，便于查看或记录。

在需要根据图像内容动态调整工作流权重的场景中，此节点非常有用。例如，在一个图像生成或处理流程中，你可以将一组风格参考图输入此节点，获取其平均亮度值，然后将这些值作为权重传递给后续的混合或条件控制节点，从而实现基于图像特征的自动化参数调节。

使用时需注意，节点要求 pandas 库来支持“pandas series”输出格式，若未安装则选择此格式会报错。此外，它设计为仅接受图像或遮罩其中一种输入，不能同时使用两者。