98 lines
6.2 KiB
Markdown
98 lines
6.2 KiB
Markdown
## 🦊 ComfyUI_RaykoStudio
|
|
ComfyUI_RaykoStudio — это набор кастомных нод для ComfyUI, предоставляющий дополнительные возможности для работы с изображениями
|
|
В текущем релизе представлена нода `RS_RusTextOverlay`, которая позволяет накладывать текст на изображение в области, заданной маской, с поддержкой поворота текста, кастомных шрифтов, переноса строк и прозрачности.
|
|
|
|
|
|
|
|
## 🦊 RS_RusTextOverlay
|
|
|
|
## 🔥 Описание
|
|
|
|
`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`: Включить/выключить поворот текста в соответствии с углом наклона маски.
|
|
|
|
## 🛠 Установка
|
|
|
|
1. Клонируйте репозиторий в папку `ComfyUI/custom_nodes/`:
|
|
|
|
git clone [https://github.com/Raykosan/ComfyUI_RaykoStudio.git](https://github.com/Raykosan/ComfyUI_RaykoStudio)
|
|
|
|
Перезагрузите ComfyU
|
|
|
|
или
|
|
|
|
скопируйте папку RaykoStudio_Nodes в папку: ComfyUI/custom_nodes/
|
|
|
|
Перезагрузите ComfyU
|
|
|
|
3. Убедитесь, что папка `fonts` содержит шрифты (`.ttf` или `.otf`). Вы можете добавить свои шрифты в эту папку. Если папка пуста или отсутствует, будет использоваться шрифт по умолчанию.
|
|
|
|
4. Установите необходимые зависимости, указанные в `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!
|