# 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.

![image](https://github.com/user-attachments/assets/a5934b47-12d2-47ec-9db5-765648aa76be)


## 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:
![image](https://github.com/user-attachments/assets/8a47cba5-be81-4053-89f5-234cac007448)


### 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.