An all-in-one, multi-pass generative upscaling and post-processing node designed to simplify complex workflows and add a professional finish to your images.
This node replaces a complex chain of 10+ nodes, combining a latent refine pass, two generative tiled upscale passes, and a final Post-FX (Sharpen & Grain) stage into a single, convenient, and collapsible unit.
Here's a short text describing the new feature, perfect for your README:
---
### 🌟 New Feature: Masked Final Blending
This node now includes an optional `mask_in` input and a `mask_blend_weight` slider under **"Final Settings"**.
This powerful feature allows you to protect specific areas of your image (like skies or smooth surfaces) from the entire generative and post-processing pipeline, preventing unwanted noise or artifacts in those regions.
The `mask_blend_weight` slider controls the "cleanliness" of the protected areas.
* At **1.0** (default), the protected area is 100% replaced by the clean upscale.
* At **0.5**, the protected area is a 50/50 mix of the clean and processed versions.
* **All-in-One Pipeline:** A single node to take your image from 1K to 4K+ with generative details, sharpening, and realistic film grain.
* **Dynamic & Collapsible UI:** Tidy up your workflow\! Each major pass can be toggled on or off, hiding its settings to save space.
* **Multi-Pass Upscaling:**
* **Pass 1: Latent Refine:** A subtle `img2img`-style pass to refine the base image before the main upscale.
* **Pass 2 & 3: Tiled Generative Upscale:** Two independent generative (img2img) passes that use tiling to perform large upscales (e.g., 2x + 2x) on low-VRAM GPUs.
* **Professional Post-FX Stage:**
* **Frequency-Split Sharpening:** A high-quality sharpening method (`scipy.ndimage.gaussian_filter`) that sharpens details without introducing harsh halos.
* **Realistic Film Grain:** Adds `poisson`, `gaussian`, or `perlin` grain to break up digital smoothness, add texture, and make images feel more realistic and less "plastic."
* **Global Seed Control:** A single, globally accessible seed controls all three generative passes, ensuring consistent and reproducible results.
-----
## ⚙️ Node Parameters (The Pipeline)
The node is organized into sections that follow the image processing pipeline.
### 1\. Latent Pass (Pass 1)
* **Purpose:** A gentle, non-tiled `img2img` pass.
* **Use Case:** Ideal for slightly modifying or refining the base image *before* the main upscale. Uses a low `denoise` (e.g., 0.4) and a small `upscale_by` (e.g., 1.1x).
### 2\. Tiled Pass 2 (Pass 2)
* **Purpose:** The primary generative upscale pass.
* **Use Case:** This is your main 2x or 3x upscale. It uses tiling, so you can use large `tile_size` (like 768) with low VRAM. A moderate `denoise` (e.g., 0.35) will add generative details.
### 3\. Tiled Pass 3 (Pass 3)
* **Purpose:** A second, optional generative upscale pass.
* **Use Case:** Use this for a 4x \> 8x upscale. It takes the output of Pass 2 and tiles it again. Typically, this pass uses a much lower `denoise` (e.g., 0.15) to refine details without changing the image.
### 4\. Post-FX (Pass 4)
This stage is applied in pixel-space at the very end.
* **Enable Sharpen:**
* **Amount:** Strength of the sharpening effect.
* **Radius:** How wide the detail-detection radius is.
* **Enable Grain:**
* **Grain Intensity:** The overall strength/visibility of the grain.
* **Grain Type:** `poisson` (default, very organic), `gaussian`, or `perlin`.
* **Grain Size:** The scale of the grain particles.
* **Saturation Mix:** How colorful the grain is (1.0 = full color, 0.0 = monochrome).
* **Adaptive Grain:** Ties the grain strength to the image's brightness (more grain in shadows).
### 5\. Global Seed
* **Purpose:** Controls all three generative passes (Pass 1, 2, and 3) simultaneously for consistent results.
* **Features:** Includes the standard ComfyUI `fixed`, `increment`, `randomize` controls.
