53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
# ComfyUI Constrain Resolution Node
|
|
|
|
A 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
|
|
- 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
|
|
|
|
## Outputs
|
|
|
|
- **Image**: The unchanged input image (passed through)
|
|
- **Constrained Width**: Suggested width that fits within min/max constraints
|
|
- **Constrained Height**: Suggested height that fits within min/max constraints
|
|
- **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. Connect the `Image` output to your preferred resize node (e.g., Image Resize)
|
|
4. Use the `Constrained Width` and `Constrained Height` outputs to set the dimensions in your resize node
|
|
|
|
### 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
|
|
|
|
## Installation
|
|
|
|
Use Comfy Manager or:
|
|
|
|
1. Create a `custom_nodes` folder in your ComfyUI directory if it doesn't exist
|
|
2. Clone this repository into the `custom_nodes` folder:
|
|
git clone https://github.com/EnragedAntelope/ComfyUI-Constrain-Resolution
|
|
|
|
## License
|
|
|
|
This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
|