ComfyUI-Image-Resizing

ComfyUI Image Resizing

Precision dimension control nodes for aspect ratio adjustments and resizing workflows

Core Features

📐 Analysis & Calculation

• image_aspect_ratio_extractor - Extract aspect ratios with constraints (0.25-4.0 range)
• image_resolution_extractor - Extract specific dimensions (width, height, shortest/longest side)
• calculate_aspect_ratio_extension - Compute pixel extensions for target aspect ratios
• calculate_upscale_factor - Determine optimal scaling ratios
• calculate_upscale_rounds - Calculate iteration count for multi-stage upscaling

🔧 Resizing & Cropping

• smart_image_resize - Intelligent resizing with min/max constraints, model-based upscaling, reference ratio matching, and standard ratio padding
• resize_to_multiple - Resize images to multiples of specified numbers (stretch/crop)
• image_crop_by_percentage - Precision cropping with percentage/pixel controls
• mask_crop_by_percentage - Synchronized mask cropping with detection modes
• extend_canvas_by_percentage - Expand canvas with color fill and feathering
• apply_mask_to_image - Apply mask as alpha channel (black mask areas become transparent)

Key Features

• Mathematical Precision - Pixel-perfect calculations with rounding control
• Dual Measurement Modes - Seamless percentage ↔ pixel conversion
• Non-Destructive Workflow - All operations preserve source data
• Advanced Detection - Mask-based cropping with multiple detection algorithms

Installation

1. Clone to your ComfyUI custom_nodes directory:

   ComfyUI/custom_nodes/image-resizing/
   

2. Restart ComfyUI

Nodes Overview

Analysis Nodes

• Aspect Ratio Extractor: Extracts ratios with constraints, supports rounding to common ratios
• Resolution Extractor: Extracts width, height, shortest, or longest side dimensions
• Aspect Ratio Extension: Calculates pixel extensions needed for target aspect ratios
• Upscale Factor: Determines optimal scaling ratios between source/target dimensions
• Upscale Rounds: Calculates iteration count for multi-stage upscaling workflows

Processing Nodes

• Smart Image Resize: Intelligent image resizing with min/max resolution constraints, reference ratio matching, model-based or basic upscaling, and standard ratio padding
• Resize to Multiple: Resizes images to multiples of specified numbers (32, 64, etc.)
• Image Crop by Percentage: Precision cropping with 9 position options and offset controls
• Mask Crop by Percentage: Advanced mask-based cropping with detection algorithms
• Extend Canvas by Percentage: Expands canvas with color fill, feathering, and mask support
• Apply Mask to Image: Combines image + mask into RGBA output, using mask as transparency (white=opaque, black=transparent)

Behavior Notes

• Percentage crop semantics: left/right/top/bottom percentages are defined over each side's half-axis (100 reaches the center from that side).
• Input limits by mode: with use_pixel=true, crop values are not upper-bounded; with use_pixel=false, crop inputs are clamped to 0-100.

Typical Use Cases

• Adapting assets for specific aspect ratios
• Matching images to reference aspect ratios without cropping
• Creating social media templates
• Matching AI model input requirements
• Batch canvas extensions and cropping
• Multi-stage upscale preparations

Requirements

• ComfyUI
• Standard ComfyUI dependencies

License

This project is provided as-is for the ComfyUI community.