# ComfyUI-SplitImage

A collection of custom nodes for ComfyUI to split an image into overlapping tiles and stitch them back together seamlessly. This is particularly useful for processing high-resolution images in smaller chunks (tiles) to save VRAM or for specialized image-to-image workflows.

## Features

- **Seamless Stitching**: Uses a weight-normalized blending algorithm with linear ramps to eliminate visible seams in overlapping regions.
- **VRAM Efficient Processing**: Split images into tiles and process them one-by-one to handle massive resolutions.
- **Automatic Upscaling Support**: The stitching node automatically detects if tiles have been upscaled and adjusts the overlap and final image dimensions accordingly.
- **Flexible Grid**: Split images or latents into any number of rows and columns.
- **Collector Pattern**: The stitching node automatically collects tiles from lists or batches for reassembly.

## Nodes (Category: SplitImage)

### 1. Split Image into Tiles
Divides an image into a **List** of multiple overlapping tiles.

### 2. Split Latent into Tiles
Divides a latent batch into a **List** of multiple overlapping tiles.

### 3. Calculate Tiling Spec
Calculates a tiling configuration without needing an image.

### 4. Stitch Image Tiles
Reassembles a list or batch of tiles into a single image. **Acts as a Collector**: It waits for all items in a list to finish processing before stitching.

### 5. Merge Image Batches
Combines multiple image batches into one larger batch.

## Advanced Workflow: The "Collector" Pattern

To process large images without running out of VRAM (OOM):

1.  **Split**: Use `Split Image into Tiles`. It outputs a **List** of tiles.
2.  **Process Sequential**: Connect the list to your VAE Encode/KSampler/VAE Decode. ComfyUI will execute these nodes **one by one** for each tile in the list, keeping VRAM usage low.
3.  **Stitch (Collect)**: Connect the final list of processed images to `Stitch Image Tiles`. It will collect all tiles and stitch them into the final result.

## Installation

1.  Navigate to your ComfyUI `custom_nodes` directory.
2.  Clone this repository:
    ```bash
    git clone https://github.com/QuigleyDown/ComfyUI-SplitImage.git
    ```
3.  Restart ComfyUI.