GLIGENTextBoxApplyBatchCoords

GLIGENTextBoxApplyBatchCoords 节点，该节点在技术上基于 GLIGEN 模型，通过解析 JSON 格式的坐标字符串来定义文本边界框的位置和大小

GLIGENTextBoxApplyBatchCoords 是一个用于在批量生成过程中，为特定文本内容精确控制其空间位置的节点。它的核心功能是接收一系列坐标点，并将指定的文本提示词绑定到图像生成画布上的特定区域，从而实现基于文本的空间构图引导。该节点专为需要随时间或按批次变化元素位置的工作流设计。

节点功能

该节点在技术上基于 GLIGEN 模型，通过解析 JSON 格式的坐标字符串来定义文本边界框的位置和大小。它接收来自潜在空间的输入以确定批次大小，并将空间约束信息与文本提示词一同编码到条件数据中，最终输出一个融合了位置信息的条件数据流。其坐标输入格式设计为与 Spline Editor 节点直接兼容，便于进行复杂的运动轨迹规划。

节点参数说明 - GLIGENTextBoxApplyBatchCoords

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`conditioning_to`	CONDITIONING	是	-	-	接收已有的条件数据，本节点将新的空间文本约束信息附加到其上。
`latents`	LATENT	是	-	-	提供潜在空间表示，主要用于确定生成过程的批次大小。
`clip`	CLIP	是	-	-	提供文本编码器，用于对输入的文本提示进行编码，应与主提示词使用相同的 CLIP 模型。
`gligen_textbox_model`	GLIGEN	是	-	-	连接已加载的 GLIGEN 模型，该模型负责处理空间约束的逻辑。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`coordinates`	STRING	是	-	-	接收定义边界框位置的 JSON 格式坐标字符串，通常来自 Spline Editor 节点。
`text`	STRING	是	-	-	输入需要被施加空间位置约束的文本描述部分。
`width`	INT	是	128	8 - 4096 (步长: 8)	设置 GLIGEN 文本边界框的宽度，取值范围 8 至 4096，调整步长为 8。
`height`	INT	是	128	8 - 4096 (步长: 8)	设置 GLIGEN 文本边界框的高度，取值范围 8 至 4096，调整步长为 8。
`size_multiplier`	FLOAT	否	[1.0]	1.0	-

Output 输出

参数名称	数据类型	说明
conditioning	CONDITIONING	输出附加了空间约束信息的最终条件数据。
coord_preview	IMAGE	输出一个可视化图像，用于预览坐标和边界框的位置。

使用场景

此节点主要应用于结合 AnimateDiff-Evolved 的动画生成工作流中。例如，用户可以先使用 Spline Editor 节点绘制一个物体（如"一只蝴蝶"）在多个关键帧中的飞行路径，然后将生成的坐标序列和对应的文本提示输入本节点，从而在生成的视频序列中精确控制蝴蝶的移动轨迹和出现位置。

注意事项

请注意，本节点需要配合专门的 GLIGEN 模型文件使用，该模型需单独下载。输入的坐标字符串必须为有效的 JSON 格式，且定义的边界框位置不应超出画布范围，否则可能导致不可预测的生成结果。