From 37db7e4d364368a82ae9bb2006ad18a69890ebfc Mon Sep 17 00:00:00 2001 From: Raykosan <71210053+Raykosan@users.noreply.github.com> Date: Sun, 8 Mar 2026 13:40:28 +0300 Subject: [PATCH] Update README.md --- README.md | 138 +++++++++++++++++++++++++----------------------------- 1 file changed, 63 insertions(+), 75 deletions(-) diff --git a/README.md b/README.md index 0674484..f1913e8 100644 --- a/README.md +++ b/README.md @@ -1,101 +1,89 @@ # 🦊 ComfyUI_RaykoStudio ComfyUI_RaykoStudio — a set of custom nodes for ComfyUI providing additional image processing capabilities -![Demo](web/preview.png) ![Demo](web/ComfyUI_00006_.png) +# 🦊 RaykoStudio Saturation Switch Node for ComfyUI +**Professional image saturation control with artifact and highlight protection.** -# 🦊 RS_RusTextOverlay Node +![Demo](web/RS-SaturationNode.png) -## 🔥 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 -### Features +- **Smooth adjustment** with 0.05 steps +- **Smart boosting** without overexposure +- **Artifact protection** even at extreme values +- **Batch processing** optimized +- **Supports**: Windows/Linux · Python 3.11+ · PyTorch 2.0+ -- 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 - -![Demo](examples/example.png) ![Demo](examples/Example2.png) +--- ## 🛠 Installation - Clone repository to `ComfyUI/custom_nodes/` folder: ``` -git clone https://github.com/Raykosan/ComfyUI_RaykoStudio.git +git clone https://github.com/Raykosan/ComfyUI_RS-SaturationNode.git ``` -- Copy RaykoStudio_Nodes folder to: ComfyUI/custom_nodes/ +- Copy ComfyUI_RS-SaturationNode 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 +🦊 RS Safe Saturation +| Range | Processing Type | Use Case | +|------------|-------------------------------|-----------------------------| +| 0.0-0.9 | Toning/desaturation | Gradual color removal | +| 1.0-1.3 | Natural enhancement | Recommended range | +| 1.3-2.0 | Vibrant artistic effects | Stylization | +| 2.0-3.0 | Maximum saturation | Cinematic effects | -## ✔️ Note +## ⚙️ Technical Details -- 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. +Algorithm workflow: -## ⚠️ Known issues +Luminance space conversion -Vertical and diagonal gradients do not work properly +Non-linear adjustment: +Values <1.0: Linear interpolation +Values >1.0: Adaptive S-curve + +Auto highlight recovery + +Recommended settings: +| Intensity | Effect | +|------------|---------------------------------| +| 0.0-0.9 | Toning/desaturation | +| 1.0-1.3 | Natural enhancement (recommended) | +| 1.3-2.0 | Vibrant artistic effects | +| 2.0-3.0 | Cinematic saturation | + +# Save Image Pair node +![Save Image Pair](https://github.com/user-attachments/assets/43fb95d6-3213-4c31-bb09-a722b463c62b) +(EN) The "Save Image Pair" node is used to save the source and destination images in a single image while preserving the workflow within the image. It is convenient for visual understanding of the workflow contained in the image. +Usage: place the file "Rayko_Save_Image_Pair.py" to the folder "...ComfyUI/custom_nodes" and restart ComfyUI if it was already running. +It is better to choose horizontal saving for portraits, and vertical saving for landscapes. The color is made to fill the empty space that is formed with different sizes of images. +Usage: place the file "Rayko_Save_Image_Pair.py " to the folder "...ComfyUI/custom_nodes" and restart ComfyUI if it was already running. + +(RU) Нода "Save Image Pair" используется для сохранения исходного и конечного изображения в одном изображении с сохранением рабочего процесса внутри изображения. Удобно для визуального понимания содержащегося в изображении воркфлоу. +Для портретов лучше выбирать горизонтальное сохранение, для лэндскейпов - вертикальное. Цвет сделан для заполнения пустующего места, которое образуется при разных размерах картинок. +Использование: поместите файл "Rayko_Save_Image_Pair.py" в папку "...ComfyUI/custom_nodes" и перезапустите ComfyUI если он был уже запущен. + +# Image Text node +![Screenshot_4](https://github.com/user-attachments/assets/0403a04c-df9e-4433-9239-c4b72fc893b5) +(EN) The Image-Text node writes any hidden text to any png and jpeg file (jpeg is converted to png). And outputs text from images recorded in this way. You can use it instead of a Load Image (without a mask) and transfer the recorded text to the promt node. It is useful if there is an image and a shortcut to it, but the image does not contain a workflow (often found on the site civitai.com). +Two modes: +Write - writes text to the uploaded image and saves it to the output folder with the prefix you specified. +Read - reads the text you wrote earlier in the uploaded image, sends the text and images further according to the scheme. +Usage: place the file "Rayko_Image_Text.py " to the folder "...ComfyUI/custom_nodes" and restart ComfyUI if it was already running + +(RU) Нода Image-Text записывает любой текст в любой файл формата png и jpeg (jpeg преобразуется в png) в скрытом виде и выводит из изображений текст, записанный таким способом. Вы можете использовать ноду вместо ноды Load Image (без маски) и передавать прочитанный текст в ноду prompt. Это полезно, если есть изображение и промпт к нему, но само изображение не содержит рабочего процесса (часто встречается на сайте civitai.com). +Два режима: +Write - записывает скрытый текст в загруженное изображение и сохраняет его в папку output с указанным вами префиксом. +Read - читает текст записанный вами ранее из загруженного изображения, и отправляет текст и изображение далее по схеме. +Использование: поместите файл "Rayko_Image_Text.py " в папку "...ComfyUI/custom_nodes" и перезапустите ComfyUI если он был уже запущен. + +Ссылка на видео https://youtu.be/1s26hUcVXX4 ## 🤝 Bug Reporting