## 🦊 ComfyUI_RaykoStudio  
ComfyUI_RaykoStudio — это набор кастомных нод для ComfyUI, предоставляющий дополнительные возможности для работы с изображениями  
В текущем релизе представлена нода `RS_RusTextOverlay`, которая позволяет накладывать текст на изображение в области, заданной маской, с поддержкой поворота текста, кастомных шрифтов, переноса строк и прозрачности.  

![Demo](web/preview.png)  

## 🦊 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!