Sign in

Nodes Browser

ComfyDeploy: How ComfyUI-ConstrainResolution works in ComfyUI?

What is ComfyUI-ConstrainResolution?

Given min/max resolution constraints, this automatically suggests optimal dimensions while preserving aspect ratio. Ideal for Image to Image (I2I) and Image to Video (I2V) workflows!

How to install it in ComfyDeploy?

Head over to the machine page

  1. Click on the "Create a new machine" button
  2. Select the Edit build steps
  3. Add a new step -> Custom Node
  4. Search for ComfyUI-ConstrainResolution and select it
  5. Close the build step dialig and then click on the "Save" button to rebuild the machine

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.

image

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

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.