ComfyUI-PredefinedResolution

ComfyUI-PredefinedResolution

A ComfyUI custom node that automatically snaps input dimensions to predefined resolutions and aspect ratios.

Features

• Automatic Ratio Detection: Analyzes input width/height and snaps to the closest standard aspect ratio (21:9, 16:9, 1:1, 9:16, 9:21)
• Predefined Output Resolutions: Choose from 720p, 1080p, 2K, or 4K output resolutions
• Custom Resolution Support: Define your own resolution presets for each aspect ratio
• Ratio Outputs: Returns both width/height and height/width ratios for downstream nodes

Installation

1. Clone this repository into your ComfyUI custom_nodes folder:

cd ComfyUI/custom_nodes
git clone https://github.com/pipelet-ai/ComfyUI-PredefinedResolution.git

2. Restart ComfyUI

Usage

Inputs

Required:

• width (INT): Input image width (64-8192)
• height (INT): Input image height (64-8192)
• output_resolution: Select from "720p", "1080p", "2K", "4K", or "Custom"
• target_ratio: Target aspect ratio (21:9, 16:9, 1:1, 9:16, 9:21)

Optional:

• width_height_scale (FLOAT): Override the calculated ratio with a manual value (0.0 = use calculated ratio)
• custom_21_9 (STRING): Custom resolution for 21:9 ratio (format: "width,height", e.g., "2560,1080")
• custom_16_9 (STRING): Custom resolution for 16:9 ratio (default: "1920,1080")
• custom_1_1 (STRING): Custom resolution for 1:1 ratio (default: "1080,1080")
• custom_9_16 (STRING): Custom resolution for 9:16 ratio (default: "608,1080")
• custom_9_21 (STRING): Custom resolution for 9:21 ratio (default: "464,1080")

Outputs

• width (INT): Output width
• height (INT): Output height
• width_height_ratio (FLOAT): Width divided by height
• height_width_ratio (FLOAT): Height divided by width

Example

Input: 720 x 800 (from an uploaded image)

• Detected ratio: Closest to 1:1
• Output resolution: 1080p
• Output: 1080 x 1080, ratio: 1.0, 1.0

Input: 1920 x 800

• Detected ratio: Closest to 21:9
• Output resolution: 2K
• Output: 4608 x 2048, ratio: 2.25, 0.44

How It Works

1. The node calculates the aspect ratio from input width/height (or uses the optional width_height_scale if provided)
2. It finds the closest matching standard aspect ratio (21:9, 16:9, 1:1, 9:16, 9:21)
3. Based on the selected output resolution preset, it calculates the appropriate dimensions
4. Returns the final width, height, and both ratio values

License

See LICENSE file for details.