Add Label(AddLabel)
С технической точки зрения, этот узел использует библиотеку PIL для обработки изображений и рендеринга текста.
Add Label
Узел Add Label, с технической точки зрения, использует библиотеку PIL для обработки изображений и рендеринга текста.
Узел Add Label — это инструмент для аннотирования изображений, который позволяет добавлять к входному изображению текстовую метку с пользовательским текстом. Основная функция узла — создание фоновой области с текстом и её объединение или наложение на исходное изображение, тем самым добавляя к изображению пояснительный текст.
Функциональность узла
С технической точки зрения, узел использует библиотеку PIL для обработки изображений и рендеринга текста. Он поддерживает присоединение текстовой метки к краю изображения в четырёх направлениях: «сверху», «снизу», «слева», «справа», или её наложение непосредственно на изображение в режиме «overlay». Узел загружает файлы шрифтов из указанной папки (обычно ComfyUI/custom_nodes/ComfyUI-KJNodes/fonts) и позволяет пользователю определять цвет текста и фона метки с помощью строк цвета (например, "white", "#FF0000").
Описание параметров узла - Add Label
Входные соединения (Inputs)
| Название параметра | Тип данных | Обязательный | Значение по умолчанию | Диапазон/Опции | Описание |
|---|---|---|---|---|---|
image | IMAGE | Да | - | - | image (входной параметр): Входное исходное изображение, к которому нужно добавить метку. |
font | КОМБО | Да | - | - | font (входной параметр): Выбор файла шрифта для рендеринга текста. Файл шрифта должен находиться в указанном каталоге kjnodes_fonts. |
Параметры управления (Parameters)
| Название параметра | Тип данных | Обязательный | Значение по умолчанию | Диапазон/Опции | Описание |
|---|---|---|---|---|---|
direction | COMBO | Да | up | "up", "down", "left", "right", "overlay" | down (низ), left (левая сторона), right (правая сторона) или overlay (непосредственное наложение на изображение). |
text_x | INT | Да | 10 | 0 - 4096 (шаг: 1) | text_x (входной параметр): Устанавливает горизонтальную начальную позицию (координату X) текста внутри метки. Диапазон от 0 до 4096. |
text_y | INT | Да | 2 | 0 - 4096 (шаг: 1) | text_y (входной параметр): Устанавливает вертикальную начальную позицию (координату Y) текста внутри метки. Диапазон от 0 до 4096. |
height | INT | Да | 48 | -1 - 4096 (шаг: 1) | height (входной параметр): Устанавливает высоту метки (при направлениях left или right этот параметр контролирует ширину). При значении -1 высота будет автоматически адаптирована под размер шрифта. |
font_size | INT | Да | 32 | 0 - 4096 (шаг: 1) | font_size (входной параметр): Устанавливает размер шрифта для текста метки. Диапазон от 0 до 4096. |
font_color | STRING | Да | white | - | font_color (входной параметр): Определяет цвет текста метки. Поддерживаются названия цветов (например, "white") или шестнадцатеричные коды цветов (например, "#FF0000"). |
label_color | STRING | Да | black | - | label_color (входной параметр): Определяет цвет фона метки. Поддерживаются названия цветов (например, "black") или шестнадцатеричные коды цветов. |
text | STRING | Да | Text | - | text (входной параметр): Вводимый текст, который будет отображаться на метке. |
caption | STRING | Нет | "" | - | caption (входной параметр): Дополнительный текст подписи (необязательно). |
Выходные данные (Output)
| Название параметра | Тип данных | Описание |
|---|---|---|
| IMAGE | IMAGE | IMAGE (выходной параметр): Выводит изображение с добавленной текстовой меткой. |
Сценарии использования
Этот узел очень полезен в рабочих процессах пакетной обработки или генерации изображений. Например, после создания серии тестовых изображений в разных стилях, вы можете использовать этот узел, чтобы автоматически добавить к каждой картинке метку с описанием использованных параметров (например, название модели, количество шагов выборки), что облегчит последующее сравнение и отбор. Его также можно использовать для добавления текста диалогов или порядковых номеров к кадрам комиксов или раскадровкам.
Важные замечания
Следует отметить, что при выборе направлений «сверху», «снизу», «слева» или «справа» эта операция изменит размеры выходного изображения (высоту или ширину). Кроме того, цвета шрифта и фона метки поддерживают различные форматы, но необходимо убедиться, что введённая строка может быть корректно распознана как значение цвета RGB.
Ссылка на исходный код узла Add Label
Узел Add Label из пакета узлов ComfyUI-KJNodes.
Комментарии
Войдите через GitHub, чтобы участвовать в обсуждении.