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 (from 0 to 50)
Text alignment settings (vertically: top/center/down, horizontally: left/center/right)
Line spacing (from 0.5 to 3.0)
Letter spacing (from -5 to 100)
Vertical text

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 100.0
Text Orientention: Switch between horizontal and vertical text orientation

🛠 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!