GLIGENTextBoxApplyBatchCoords

El nodo GLIGENTextBoxApplyBatchCoords, que técnicamente se basa en el modelo GLIGEN, define la posición y el tamaño de los cuadros delimitadores de texto analizando una cadena de coordenadas en formato JSON.

GLIGENTextBoxApplyBatchCoords es un nodo utilizado en procesos de generación por lotes para controlar con precisión la posición espacial de contenidos de texto específicos. Su función principal es recibir una serie de puntos de coordenadas y vincular las indicaciones de texto especificadas a áreas concretas del lienzo de generación de imágenes, logrando así una guía de composición espacial basada en texto. Este nodo está diseñado específicamente para flujos de trabajo que requieren variar la posición de elementos a lo largo del tiempo o por lotes.

Funcionalidad del Nodo

Este nodo se basa técnicamente en el modelo GLIGEN y define la posición y el tamaño de los cuadros delimitadores de texto analizando una cadena de coordenadas en formato JSON. Recibe entradas del espacio latente para determinar el tamaño del lote, y codifica la información de restricción espacial junto con las indicaciones de texto en los datos de condicionamiento, produciendo finalmente un flujo de datos de condicionamiento que incorpora información de posición. Su formato de entrada de coordenadas está diseñado para ser directamente compatible con el nodo Spline Editor, facilitando la planificación de trayectorias de movimiento complejas.

Explicación de Parámetros del Nodo - GLIGENTextBoxApplyBatchCoords

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`conditioning_to`	CONDITIONING	Sí	-	-	Recibe los datos de condicionamiento existentes; este nodo añadirá la nueva información de restricción espacial de texto sobre ellos.
`latents`	LATENT	Sí	-	-	Proporciona la representación del espacio latente, utilizada principalmente para determinar el tamaño del lote del proceso de generación.
`clip`	CLIP	Sí	-	-	Proporciona el codificador de texto para codificar las indicaciones de texto de entrada; debe usar el mismo modelo CLIP que la indicación principal.
`gligen_textbox_model`	GLIGEN	Sí	-	-	Conecta el modelo GLIGEN ya cargado, responsable de manejar la lógica de las restricciones espaciales.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`coordinates`	STRING	Sí	-	-	Recibe la cadena de coordenadas en formato JSON que define la posición del cuadro delimitador, normalmente proveniente del nodo Spline Editor.
`text`	STRING	Sí	-	-	Introduce la parte de la descripción de texto a la que se le aplicará la restricción de posición espacial.
`width`	INT	Sí	128	8 - 4096 (incremento: 8)	Establece el ancho del cuadro delimitador de texto GLIGEN, rango de 8 a 4096, con un incremento de ajuste de 8.
`height`	INT	Sí	128	8 - 4096 (incremento: 8)	Establece la altura del cuadro delimitador de texto GLIGEN, rango de 8 a 4096, con un incremento de ajuste de 8.
`size_multiplier`	FLOAT	No	[1.0]	1.0	-

Salidas (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
conditioning	CONDITIONING	Salida de los datos de condicionamiento finales con la información de restricción espacial añadida.
coord_preview	IMAGE	Salida de una imagen de visualización para previsualizar las coordenadas y la posición del cuadro delimitador.

Casos de Uso

Este nodo se aplica principalmente en flujos de trabajo de generación de animación combinados con AnimateDiff-Evolved. Por ejemplo, un usuario puede primero usar el nodo Spline Editor para dibujar la trayectoria de vuelo de un objeto (como "una mariposa") a través de múltiples fotogramas clave, y luego introducir la secuencia de coordenadas generada y la indicación de texto correspondiente en este nodo, controlando así con precisión la trayectoria de movimiento y la posición de aparición de la mariposa en la secuencia de video generada.

Consideraciones

Tenga en cuenta que este nodo requiere el uso de un archivo de modelo GLIGEN específico, que debe descargarse por separado. La cadena de coordenadas de entrada debe tener un formato JSON válido, y la posición del cuadro delimitador definido no debe exceder los límites del lienzo, de lo contrario podrían producirse resultados de generación impredecibles.

Enlace al Código Fuente del Nodo GLIGENTextBoxApplyBatchCoords

El nodo GLIGENTextBoxApplyBatchCoords proviene del paquete de nodos ComfyUI-KJNodes.