From 02e4b3041357394eabe58cc5e0fb42feb26d6bb7 Mon Sep 17 00:00:00 2001 From: "Mr. Einhorn" Date: Tue, 22 Jul 2025 17:23:02 +0200 Subject: [PATCH] Update README.md --- README.md | 72 +++++++++++++++++++------------------------------------ 1 file changed, 24 insertions(+), 48 deletions(-) diff --git a/README.md b/README.md index a0246d2..2fa2735 100644 --- a/README.md +++ b/README.md @@ -1,70 +1,46 @@ # ComfyUI-ImageProcessUtilities -A collection of **custom nodes for [ComfyUI](https://github.com/comfyanonymous/ComfyUI)** designed to enhance image processing workflows — especially for high-resolution rendering, complex inpainting, tiling, and batch manipulation tasks. +A collection of custom nodes for [ComfyUI](https://github.com/comfyanonymous/ComfyUI) designed to enhance image processing workflows. Especially useful for high-resolution rendering, complex inpainting, tiling, and batch manipulation. This allows you to perform processing that would otherwise exceed your VRAM limits. --- -## 🔑 Key Features +## Key Features -- **🧩 Seamless Image Tiling & Untiling** - Process huge images by breaking them into overlapping tiles and perfectly reassembling them. This is **non-destructive**, using padding instead of cropping to preserve all image data. +- **Image Tiling & Untiling** + Break large images into overlapping tiles and reassemble them seamlessly without losing data. -- **📐 Coordinate-Based Transforms** - Precisely crop and paste images using a flexible coordinate system. Ideal for targeted inpainting or complex composites. +- **Coordinate-Based Transforms** + Crop and paste image regions using flexible coordinate inputs. -- **🔁 Modular Coordinate System** - Convert strings to coordinates and combine/split coordinate lists, enabling complex and dynamic workflows. +- **Coordinate Utilities** + Convert strings to coordinates and manipulate coordinate lists for dynamic workflows. -- **📦 Batch Manipulation Utilities** - Reorder or modify image batches — useful for animations, video workflows, or layout transforms. +- **Batch Tools** + Reorder or adjust batches of images for animation, video, or layout tasks. --- -## 🧱 Nodes +## Available Nodes -### 🟦 Tiling +### Tiling +- `ImageTiler` +- `ImageUntiler` -- **Tile Image (`ImageTiler`)** - Splits an image into a batch of overlapping tiles. Uses non-destructive padding to handle images of any size. +### Transform +- `CropByCoords` +- `PasteByCoords` +- `ReorderBatch` -- **Untile Image (`ImageUntiler`)** - Reassembles a batch of tiles into a single, seamless image — correctly cropping it to original dimensions. +### Coordinates +- `StringToIntegers` +- `CombineCoords` +- `SplitCoords` --- -### 🔲 Transform - -- **Crop Image by Coords (`CropByCoords`)** - Crops one or more regions from an image or batch at specified coordinates. - -- **Paste Image by Coords (`PasteByCoords`)** - Pastes insert images onto a base image at specified coordinates. Supports optional **edge feathering** for smooth blending. - -- **Reorder Batch (`ReorderBatch`)** - Changes the order of images in a batch. Modes include: - - `reverse` - - `ping-pong` - - `row_to_column` - ---- - -### 🧮 Coordinates - -- **String to Integers (`StringToIntegers`)** - Converts a comma-separated string like `"128, 256, 512"` into a list of integers. - -- **Combine Coords (`CombineCoords`)** - Combines two lists of X and Y values into a `COORDS` structure. - -- **Split Coords (`SplitCoords`)** - Splits a `COORDS` input into two lists: X and Y. - ---- - -## ⚙️ Installation - -1. Navigate to your ComfyUI `custom_nodes/` directory: +## Installation +1. Navigate to your `ComfyUI/custom_nodes/` directory: ```bash cd ComfyUI/custom_nodes/