66 lines
3.0 KiB
Markdown
66 lines
3.0 KiB
Markdown
# ComfyUI Constrain Resolution Node
|
|
|
|
A [ComfyUI](https://github.com/comfyanonymous/ComfyUI) node that analyzes images and suggests optimal dimensions while preserving aspect ratio. This node is particularly useful in image-to-image and image-to-video workflows where maintaining aspect ratios and resolution constraints is crucial.
|
|
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- Analyzes input images and suggests optimal dimensions
|
|
- Preserves aspect ratio while fitting within minimum and maximum resolution constraints
|
|
- Ensures dimensions are multiples of a specified number (useful for models requiring specific dimension constraints)
|
|
- Handles both landscape and portrait orientations
|
|
- Passes through the original image unmodified for chaining with other nodes
|
|
- Provides both constrained dimensions and aspect ratio information
|
|
|
|
## Inputs
|
|
|
|
- **Image**: The input image to analyze (required)
|
|
- **Min Resolution**: Minimum resolution in pixels for both width and height
|
|
- **Max Resolution**: Maximum resolution in pixels for both width and height
|
|
- **Multiple Of**: Ensure dimensions are multiples of this number (e.g., 8 for SD-XL, 16 for some models)
|
|
|
|
## Outputs
|
|
|
|
- **Image**: The unchanged input image (passed through)
|
|
- **Constrained Width**: Suggested width that fits within min/max constraints and multiple-of requirement
|
|
- **Constrained Height**: Suggested height that fits within min/max constraints and multiple-of requirement
|
|
- **Constrained Aspect Ratio**: The aspect ratio of the constrained dimensions
|
|
- **Original Aspect Ratio**: The original aspect ratio of the input image
|
|
|
|
## Usage
|
|
|
|
### Basic Workflow
|
|
1. Connect your image source to the `Image` input
|
|
2. Set your desired minimum and maximum resolution constraints
|
|
3. Set the "Multiple Of" value based on your model requirements (e.g., 8 for SDXL)
|
|
4. Connect the `Image` output to your preferred resize node (e.g., Image Resize)
|
|
5. Use the `Constrained Width` and `Constrained Height` outputs to set the dimensions in your resize node
|
|
|
|
Example:
|
|
|
|
|
|
|
|
### Common Use Cases
|
|
|
|
- **Image-to-Image**: Ensure consistent image sizes while maintaining aspect ratios
|
|
- **Image-to-Video**: Prepare frames with proper dimensions for video generation
|
|
- **Batch Processing**: Standardize image dimensions across multiple images
|
|
- **Resolution Optimization**: Find optimal dimensions for specific model requirements
|
|
- **Model Compatibility**: Ensure dimensions meet specific model requirements (e.g., multiples of 8 or 16)
|
|
|
|
## Installation
|
|
|
|
Use [ComfyUI Manager](https://github.com/ltdrdata/ComfyUI-Manager) or follow these manual installation steps:
|
|
|
|
1. Create a `custom_nodes` folder in your ComfyUI directory if it doesn't exist
|
|
2. Clone this repository into the `custom_nodes` folder:
|
|
```bash
|
|
git clone https://github.com/EnragedAntelope/ComfyUI-ConstrainResolution.git
|
|
```
|
|
|
|
## License
|
|
|
|
This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
|