# ComfyUI-Image-Resizing

**Repository Path**: erxatim/ComfyUI-Image-Resizing

## Basic Information

- **Project Name**: ComfyUI-Image-Resizing
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-18
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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

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

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