Add Label(AddLabel)
Desde la perspectiva de la implementación técnica, este nodo utiliza la biblioteca PIL para el procesamiento de imágenes y la renderización de texto.
Add Label
El nodo Add Label, desde una perspectiva de implementación técnica, utiliza la biblioteca PIL para el procesamiento de imágenes y la renderización de texto.
El nodo Add Label es una herramienta de anotación de imágenes que permite agregar una barra de etiqueta con texto personalizado sobre la imagen de entrada. Su función principal es generar un área de fondo con texto y combinarla o superponerla con la imagen original, añadiendo así texto descriptivo a la imagen.
Funcionalidad del Nodo
Desde una perspectiva de implementación técnica, este nodo utiliza la biblioteca PIL para el procesamiento de imágenes y la renderización de texto. Admite la unión de la barra de etiqueta en los bordes de la imagen en las cuatro direcciones "arriba, abajo, izquierda, derecha", o en modo "superposición" directamente sobre la imagen. El nodo carga archivos de fuente desde una carpeta de fuentes especificada (normalmente ComfyUI/custom_nodes/ComfyUI-KJNodes/fonts) y permite al usuario definir el color del texto y del fondo de la etiqueta mediante cadenas de color (como "white", "#FF0000").
Explicación de los Parámetros del Nodo - Add Label
Entradas de Conexión (Inputs)
| Nombre del Parámetro | Tipo de Dato | Obligatorio | Valor por Defecto | Rango de Valores/Opciones | Descripción |
|---|---|---|---|---|---|
image | IMAGE | Sí | - | - | image (parámetro de entrada): Imagen original de entrada a la que se le añadirá la etiqueta. |
font | COMBO | Sí | - | (Lista de fuentes disponibles) | font (parámetro de entrada): Selecciona el archivo de fuente utilizado para renderizar el texto. El archivo de fuente debe estar ubicado en el directorio especificado kjnodes_fonts. |
Parámetros de Control (Parameters)
| Nombre del Parámetro | Tipo de Dato | Obligatorio | Valor por Defecto | Rango de Valores/Opciones | Descripción |
|---|---|---|---|---|---|
direction | COMBO | Sí | up | "up", "down", "left", "right", "overlay" | down (abajo), left (izquierda), right (derecha) o overlay (superposición directa sobre la imagen). |
text_x | INT | Sí | 10 | 0 - 4096 (incremento: 1) | text_x (parámetro de entrada): Establece la posición horizontal inicial (coordenada X) del texto dentro de la barra de etiqueta. Rango de valores de 0 a 4096. |
text_y | INT | Sí | 2 | 0 - 4096 (incremento: 1) | text_y (parámetro de entrada): Establece la posición vertical inicial (coordenada Y) del texto dentro de la barra de etiqueta. Rango de valores de 0 a 4096. |
height | INT | Sí | 48 | -1 - 4096 (incremento: 1) | height (parámetro de entrada): Establece la altura de la barra de etiqueta (cuando la dirección es izquierda o derecha, este parámetro controla el ancho). Un valor de -1 hará que la altura se ajuste automáticamente al tamaño de la fuente. |
font_size | INT | Sí | 32 | 0 - 4096 (incremento: 1) | font_size (parámetro de entrada): Establece el tamaño de fuente del texto de la etiqueta. Rango de valores de 0 a 4096. |
font_color | CADENA | Sí | white | - | font_color (parámetro de entrada): Define el color del texto de la etiqueta. Admite nombres de color (ej. "white") o códigos de color hexadecimales (ej. "#FF0000"). |
label_color | CADENA | Sí | black | - | label_color (parámetro de entrada): Define el color de fondo de la barra de etiqueta. Admite nombres de color (ej. "black") o códigos de color hexadecimales. |
text | CADENA | Sí | Text | - | text (parámetro de entrada): Introduce el contenido de texto que se mostrará en la barra de etiqueta. |
caption | CADENA | No | "" | - | caption (parámetro de entrada): Texto de subtítulo adicional opcional. |
Salida (Output)
| Nombre del Parámetro | Tipo de Dato | Descripción |
|---|---|---|
| IMAGE | IMAGE | IMAGE (parámetro de salida): Imagen de salida con la etiqueta de texto añadida. |
Casos de Uso
Este nodo es muy útil en flujos de trabajo de procesamiento por lotes o generación de imágenes. Por ejemplo, después de generar una serie de imágenes de prueba de estilos, puedes usar este nodo para agregar automáticamente a cada imagen una etiqueta que describa los parámetros utilizados (como el nombre del modelo, pasos de muestreo), facilitando la comparación y selección posterior. También se puede utilizar para añadir texto de diálogo o números de secuencia a viñetas de cómics o imágenes de guiones gráficos.
Consideraciones
Es importante tener en cuenta que al seleccionar las direcciones "arriba, abajo, izquierda, derecha", esta operación cambiará las dimensiones de la imagen de salida (altura o ancho). Además, los colores de fuente y fondo de la etiqueta admiten múltiples formatos, pero es necesario asegurarse de que las cadenas de entrada puedan ser interpretadas correctamente como valores de color RGB.
Enlace al Código Fuente del Nodo Add Label
El nodo Add Label proviene del paquete de nodos ComfyUI-KJNodes.
Comentarios
Inicia sesión con GitHub para unirte a la conversación.