Gradient To Float (GradientToFloat) - ComfyUI-KJNodes

Gradient To Float 节点接收一个四维张量格式的图像（形状为 [批次, 高度, 宽度, 通道]），并沿着图像的宽度和高度方向进行均匀采样

Gradient To Float 节点是一个图像分析工具，其核心功能是从输入的图像中提取数值数据。它通过采样图像像素，将图像信息转换为一组浮点数列表，便于后续的数值化处理或分析。

节点功能

该节点接收一个四维张量格式的图像（形状为 [批次, 高度, 宽度, 通道]），并沿着图像的宽度和高度方向进行均匀采样。其内部机制是，根据用户指定的采样步数，在图像的两个主轴上等间隔地选取像素点，然后计算这些采样点在对应行或列上的平均值，最终生成两个独立的浮点数列表。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`image`	IMAGE	是	-	-	image（输入参数）：输入用于分析的源图像。节点将基于此图像计算浮点数列表。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`steps`	INT	是	10	2 - 10000 (步长: 1)	steps（输入参数）：设置沿图像宽度和高度方向的采样点数。取值范围为 2 至 10000，步长为 1。

参数名称	数据类型	说明
float_x	FLOAT	float_x（输出参数）：从图像宽度方向采样并计算得到的浮点数列表。
float_y	FLOAT	float_y（输出参数）：从图像高度方向采样并计算得到的浮点数列表。

在具体应用中，此节点常用于需要将视觉信息转化为可控数值序列的工作流。例如，在制作动态效果或参数化动画时，可以将一张渐变图输入此节点，输出的浮点数列表可以用来驱动其他节点的参数（如控制粒子的位置、颜色的变化或形状的变形），从而创建出与图像内容联动的复杂效果。

请注意，该节点默认只处理输入批次中的第一张图像和第一个颜色通道（通常为红色通道或灰度值）。如果输入的是彩色图像，它不会自动进行色彩空间转换，而是直接使用第一个通道的数据。