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

Connect your image source to the Image input
Set your desired minimum and maximum resolution constraints
Set the "Multiple Of" value based on your model requirements (e.g., 8 for SDXL)
Connect the Image output to your preferred resize node (e.g., Image Resize)
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 or follow these manual installation steps:

Create a custom_nodes folder in your ComfyUI directory if it doesn't exist

Clone this repository into the custom_nodes folder:

git clone https://github.com/EnragedAntelope/ComfyUI-ConstrainResolution.git

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.