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
• 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 Passthrough 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 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:

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

License

See the LICENSE file for details.