🦊 ComfyUI_RaykoStudio

ComfyUI_RaykoStudio — a set of custom nodes for ComfyUI providing additional image processing capabilities

🦊 RS_RusTextOverlay Node

🔥 Description

RS_RusTextOverlay allows you to overlay text on an image in the area specified by the mask. The node supports text rotation depending on the mask angle, automatic font size adjustment, custom fonts, line breaks and text transparency settings, line spacing and letter spacing adjustment, text color and fill gradient selection.

Features

• Overlay text on image in mask area
• Automatic text rotation depending on mask angle (optional)
• Support for custom fonts (.ttf or . otf) downloaded from fonts folder
• Automatic font size adjustment for text placement in the mask area
• Text color and transparency settings (from 0 to 100%)
• Text gradient (horizontal, vertical, diagonal)
• Text stroke with color and thickness adjustment
• Text alignment settings (vertically: top/center/down, horizontally: left/center/right)
• Line spacing (from 0.5 to 3.0)
• Letter spacing (from -5 to 20)

Inputs

• image: Image (RGB tensor)
• mask: Mask (L tensor) defining the text area

Outputs

• IMAGE: Image with overlaid text (RGB tensor)

⚙️ Parameters

• text: Text to overlay (supports line breaks)
• font_name: Select font from available in fonts folder (or use default)
• text_color: Text color (HEX format, e.g. #FFFFFF)
• use_gradient: Use gradient text filling
• directiont: Gradient direction
• start_color: Start gradient color
• end_color: Finish gradient color
• outline_thickness: Border Thickness
• outline_color: Color of stroke
• rotate_with_mask: Enable/disable text rotation according to mask's tilt angle
• text_opacity: Text transparency (0-100%, where 0 - fully transparent, 100 - fully opaque)
• min_font_size: Minimum font size (if text doesn't fit, default font is used)
• padding: Padding around text within mask
• vertical_align: Vertical text alignment (top/center/bottom)
• horizontal_align: Horizontal text alignment (left/center/right)
• line_spacing: Adjusts the line spacing from 0.5 to 3.0
• letter_spacing: Adjusts the letter spacing from -5.0 to 20.0

🛠 Installation

• Clone repository to ComfyUI/custom_nodes/ folder:

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

• Copy RaykoStudio_Nodes folder to: ComfyUI/custom_nodes/
• You can install this node using the ComfyUI_Manager
• Ensure fonts folder contains fonts (.ttf or .otf). You can add your fonts to this folder. If folder is empty or missing, default font will be used.
• Install required dependencies from requirements.txt:

pip install -r requirements.txt  

⛓️ Dependencies

Required libraries (specified in requirements.txt):

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

🎛 Usage

After installation find node in ComfyUI under name 🦊 RS_RusTextOverlay (category: 🦊 RaykoStudio/Image).
Connect inputs (image and mask) and adjust parameters.
Example workflow can be found in examples folder:
example workflow.json: example ComfyUI workflow
example.png: Result screenshot

✔️ Note

• Warning: the correct placement of text depends on the fonts used. Try to use standard Windows fonts, working with custom fonts does not guarantee the correct placement of text on the image.
• The mask should not touch the edge of the image.

⚠️ Known issues

Vertical and diagonal gradients do not work properly

🤝 Bug Reporting

If you encounter an issue or find a bug:

Check Issues section on GitHub, maybe problem is already known.
If new problem, create new Issue describing:

• ComfyUI and Python versions
• Problem description and reproduction steps
• Screenshots or error logs (if available)

📜 License

MIT License. Use node at your own risk without any warranties.

❤️ Acknowledgments

Thanks to ComfyUI community for inspiration and support! If you like this node, don't forget to star on GitHub!