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

Connect your image source to the Image input
Set your desired minimum and maximum resolution constraints
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

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:

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

License

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