65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
# ComfyUI-Resolution-Divider
|
|
|
|
A smart utility node for **ComfyUI** designed to calculate downscaled resolutions while strictly maintaining the original aspect ratio.
|
|
|
|
This node is essential for **Image-to-Video (I2V)** workflows (like **Wan 2.2**), where using high-resolution input images often leads to **OOM (Out of Memory)** errors. It helps you find the "sweet spot" (e.g., 480p or 720p) instantly without manual calculations.
|
|
|
|
|
|
|
|
## 🚀 Key Features
|
|
|
|
* **Smart Parsing:** Accepts various format inputs like `1920x1080`, `1920 1080`, or `1920, 1080`.
|
|
* **Auto-Detect Resolution:** Select an image from your input folder or **upload one directly** on the node. It automatically reads the dimensions.
|
|
* **Real-Time Calculation:** The "Live Result" updates instantly via JavaScript as you adjust the slider—no need to queue the prompt to see the numbers.
|
|
* **VRAM Saver:** Perfect for downscaling 4K/HD images to manageable sizes for heavy models (Wan 2.2, Kling, etc.) without making the image "squashed" or "stretched".
|
|
* **Clean UI:** Optimized widget layout for a smooth user experience.
|
|
|
|
## 📦 Installation
|
|
|
|
### Method 1: Manual Clone
|
|
1. Navigate to your ComfyUI `custom_nodes` directory.
|
|
2. Open a terminal/command prompt.
|
|
3. Run the following command:
|
|
```bash
|
|
git clone https://github.com/CraftBlack/ComfyUI-Resolution-Divider.git
|
|
```
|
|
4. Restart ComfyUI.
|
|
|
|
### Method 2: ComfyUI Manager
|
|
*Coming soon... (Once registered in the index)*
|
|
|
|
## 🛠️ Usage
|
|
|
|
1. **Add the Node:**
|
|
* Right-click canvas -> `Add Node` -> `Resolution Utils` -> `Resolution Divider (VRAM Saver)`.
|
|
2. **Input:**
|
|
* **Option A:** Type the resolution manually in `res_string` (e.g., `1024x1024`).
|
|
* **Option B:** Click "Upload" or select an image from the dropdown. The node will auto-fill the resolution.
|
|
3. **Set Divider:**
|
|
* Adjust the `divider` float value.
|
|
* `1.0` = Original Size.
|
|
* `1.5` = 1.5x smaller (Great for Wan 2.2).
|
|
* `2.0` = Half size.
|
|
4. **Connect:**
|
|
* The node outputs a custom `RESULT` string (for display) and a standard `STRING` (for info).
|
|
* *Note:* This node is primarily a calculator. You manually use the numbers shown in "Live Result" to set your Latent size, or you can expand this node to output INT width/height in the future.
|
|
|
|
## 💡 Why "Divider"?
|
|
|
|
Unlike "Scale" nodes which usually multiply (upscale), this node **divides** (downscales).
|
|
|
|
$$ \text{New Size} = \frac{\text{Original Size}}{\text{Divider}} $$
|
|
|
|
Example:
|
|
* Input: `1280 x 720`
|
|
* Divider: `1.5`
|
|
* Result: `853 x 480` (Perfect 480p safe zone for heavy AI models)
|
|
|
|
## 🤝 Contributing
|
|
|
|
Feel free to submit issues or pull requests if you have ideas for improvements!
|
|
|
|
## 📄 License
|
|
|
|
MIT License. Free to use for everyone.
|