Raykosan-ComfyUI_RaykoStudio

RS_RusTextOverlay позволяет накладывать текст на изображение в области, заданной маской. Нода поддерживает поворот текста в соответствии с углом наклона маски, автоматический подбор размера шрифта, кастомные шрифты, перенос строк и настройку прозрачности текста.

Возможности

Наложение текста на изображение в области, заданной маской.
Автоматический поворот текста в соответствии с углом наклона маски (опционально).
Поддержка кастомных шрифтов (.ttf или .otf), загружаемых из папки fonts.
Автоматический подбор размера шрифта для вписывания текста в область маски.
Настройка цвета текста и прозрачности (от 0 до 100%).
Настройка выравнивания текста (вертикальное: top/center/bottom, горизонтальное: left/center/right).
Настройка отступов (padding) вокруг текста.

Входы

image: Изображение (тензор формата RGB).
mask: Маска (тензор формата L), определяющая область для текста.

Выходы

IMAGE: Изображение с наложенным текстом (тензор формата RGB).

⚙️ Параметры

text: Текст для наложения. Поддерживает перенос строк.
font_name: Выберите шрифт из списка доступных в папке fonts (или используйте default).
text_color: Цвет текста (в формате HEX, например #FFFFFF).
text_opacity: Прозрачность текста (0–100%, где 0 — полностью прозрачный, 100 — полностью непрозрачный).
min_font_size: Минимальный размер шрифта (если текст не помещается, используется шрифт по умолчанию).
padding: Отступы вокруг текста внутри маски.
vertical_align: Вертикальное выравнивание текста (top/center/bottom).
horizontal_align: Горизонтальное выравнивание текста (left/center/right).
rotate_with_mask: Включить/выключить поворот текста в соответствии с углом наклона маски.

🛠 Установка

Клонируйте репозиторий в папку ComfyUI/custom_nodes/:

git clone https://github.com/Raykosan/ComfyUI_RaykoStudio.git

Перезагрузите ComfyU

или

скопируйте папку RaykoStudio_Nodes в папку: ComfyUI/custom_nodes/

Перезагрузите ComfyU

Убедитесь, что папка fonts содержит шрифты (.ttf или .otf). Вы можете добавить свои шрифты в эту папку. Если папка пуста или отсутствует, будет использоваться шрифт по умолчанию.
Установите необходимые зависимости, указанные в requirements.txt: pip install -r requirements.txt
Перезапустите ComfyUI, чтобы нода стала доступна.

⛓️‍💥 Зависимости

Для работы ноды требуются следующие библиотеки (указаны в requirements.txt):

torch>=1.7.0  
numpy>=1.19.0  
Pillow>=8.0.0  
opencv-python>=4.5.0

🎛 Использование

После установки найдите ноду в ComfyUI под названием 🦊 RS_RusTextOverlay (категория: 🦊 RaykoStudio/Image).
Подключите входные данные (image и mask) и настройте параметры.
Пример рабочего процесса можно найти в папке examples:
example workflow.json: Пример рабочего процесса для ComfyUI.
example.png: Скриншот результата.

🤝 Сообщение об ошибках (Issues)

Если вы столкнулись с проблемой или нашли баг:

Проверьте раздел Issues на GitHub, возможно, проблема уже известна.
Если проблема новая, создайте новый Issue, описав:
Версию ComfyUI и Python.
Описание проблемы и шаги для ее воспроизведения.
Скриншоты или логи ошибок (если есть).

📜 Лицензия

MIT License. Используйте ноду на свое усмотрение, но без каких-либо гарантий.

❤️ Благодарности

Спасибо сообществу ComfyUI за вдохновение и поддержку! Если вам понравилась эта нода, не забудьте поставить звездочку на GitHub!