Skip to content

Commit 03a7dd7

Browse files
committed
docs: add Flux.2 support throughout descriptions, tooltips, and latent output docs
- README: restructure model-mode section as a comparison table (SDXL, Flux, Flux.2, WAN, HiDream Dev, Qwen-Image) for scannable reference - README: document both latent_4x8 and latent_128x16 output shapes in the Latent Output section - README: refine intro blurb and best-practices tips to cover all modes - ResolutionMasterConfig.js: add Flux.2 to the categoryDropdown tooltip - pyproject.toml: refresh package description to include Flux.2, HiDream Dev, Qwen-Image, and latent control
1 parent a03a49d commit 03a7dd7

3 files changed

Lines changed: 18 additions & 35 deletions

File tree

README.md

Lines changed: 16 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<h1 align="center">ResolutionMaster – Precise resolution and aspect ratio control for ComfyUI</h1>
22

33

4-
<p align="center"><i>ResolutionMaster A powerful and feature-rich ComfyUI custom node for precise resolution and aspect ratio control in AI image generation workflows. This node provides an intuitive interface with advanced scaling options, preset management, and model-specific optimizations.</i></p>
4+
<p align="center"><i>ResolutionMaster is a powerful ComfyUI custom node for precise resolution and aspect ratio control in AI image generation workflows. It provides an intuitive interface with advanced scaling options, preset management, latent output, and model-specific optimizations.</i></p>
55

66
<p align="center">
77

@@ -25,13 +25,13 @@
2525
<strong>⚠️ <a href="https://github.com/Azornes/Comfyui-Resolution-Master/tree/main?tab=readme-ov-file#%EF%B8%8F-known-issues--compatibility">Known Issues</a></strong>
2626
</p>
2727

28-
2928
https://github.com/user-attachments/assets/f9b51c0f-677c-410e-8980-3f75bb4f8032
3029

3130
https://github.com/user-attachments/assets/f15ea0c2-0a65-4578-b2c7-db812bf4020c
3231

32+
---
3333

34-
## Features
34+
## Detailed Features
3535

3636
### 🎯 Core Functionality
3737
- **Interactive 2D Canvas Control**: Visually select resolution with real-time preview
@@ -56,6 +56,7 @@ Extensive preset library organized by use case:
5656
- **Standard**: Common aspect ratios (1:1, 4:3, 16:9, 21:9, etc.)
5757
- **SDXL**: Optimized resolutions for Stable Diffusion XL
5858
- **Flux**: Flux model optimized presets with smart constraints
59+
- **Flux.2**: Flux.2 optimized presets with 128-channel latent support
5960
- **WAN**: Video model presets with resolution recommendations
6061
- **HiDream Dev**: HiDream model optimized presets
6162
- **Qwen-Image**: Qwen-Image model optimized presets
@@ -66,33 +67,14 @@ Extensive preset library organized by use case:
6667

6768
### 🤖 Model-Specific Optimizations
6869

69-
#### SDXL Mode
70-
- Enforces officially supported resolutions
71-
- Fixed dimensions for optimal generation quality
72-
73-
#### Flux Mode
74-
- 32px increment enforcement
75-
- Resolution range: 320px to 2560px
76-
- Maximum 4.0 megapixels constraint
77-
- Sweet spot recommendation: 1920×1080
78-
79-
#### WAN Mode
80-
- Flexible 320p to 820p range
81-
- 16px increments for video encoding compatibility
82-
- Automatic model recommendation (480p vs 720p)
83-
- Maintains proper aspect ratios for video generation
84-
85-
#### HiDream Dev Mode
86-
- Preset-based optimization system
87-
- Uses closest matching preset from HiDream Dev category
88-
- Automatically selects best preset based on input dimensions and aspect ratio
89-
- Supports both original and flipped orientations for optimal matching
90-
91-
#### Qwen-Image Mode
92-
- Resolution range: ~0.6MP to 4.2MP (589,824 to 4,194,304 pixels)
93-
- Smart scaling: If input is already within range, dimensions remain unchanged
94-
- Automatic scaling: Input outside range is scaled to fit while maintaining aspect ratio
95-
- Preserves original dimensions when already optimized
70+
| Mode | Best For | Optimization Rules |
71+
|------|----------|--------------------|
72+
| **SDXL** | Stable Diffusion XL generation | Enforces officially supported fixed resolutions for optimal generation quality |
73+
| **Flux** | Flux image workflows | Uses 32px increments, keeps dimensions between 320px and 2560px, and limits output to 4.0 MP |
74+
| **Flux.2** | Flux.2 workflows | Uses Flux.2-specific preset matching and supports the `latent_128x16` latent type |
75+
| **WAN** | Video generation | Supports 320p to 820p, uses 16px increments, keeps video-friendly ratios, and recommends 480p or 720p |
76+
| **HiDream Dev** | HiDream preset matching | Finds the closest HiDream Dev preset by dimensions and aspect ratio, including flipped orientations |
77+
| **Qwen-Image** | Qwen-Image workflows | Keeps images in the ~0.6 MP to 4.2 MP range, preserving valid inputs and scaling out-of-range inputs |
9678

9779
---
9880

@@ -458,8 +440,9 @@ The detailed controls are described in **Understanding the Controls > Auto-Detec
458440
- Use this when you need to generate multiple images with the same resolution settings
459441
- Connect to nodes that support batch processing
460442
- **latent** (LATENT): Generated empty latent tensor ready for sampling
461-
- Automatically created based on width, height, and batch_size
462-
- Dimensions: [batch_size, 4, height÷8, width÷8]
443+
- Automatically created based on width, height, batch_size, and latent_type
444+
- `latent_4x8`: `[batch_size, 4, height/8, width/8]` for SD/SDXL/Flux-style latents
445+
- `latent_128x16`: `[batch_size, 128, height/16, width/16]` for Flux.2-style latents
463446
- Connect directly to KSampler or other sampling nodes
464447
- Eliminates the need for a separate "Empty Latent Image" node
465448
@@ -586,7 +569,7 @@ The rescale_factor **always reflects your active scaling mode**, not the drag op
586569
## Tips & Best Practices
587570

588571
1. **Start with Presets**: Use category presets as starting points, then fine-tune
589-
2. **Enable Custom Calc**: For SDXL, Flux, and WAN models to ensure compatibility
572+
2. **Enable Custom Calc**: For SDXL, Flux, Flux.2, WAN, HiDream Dev, and Qwen-Image workflows to keep dimensions model-friendly
590573
3. **Use Snap for Clean Values**: Helps avoid odd dimensions that may cause issues
591574
4. **Monitor Info Messages**: Pay attention to mode-specific recommendations
592575
5. **Leverage Rescale Factor**: Connect to upscaling nodes for resolution-independent workflows

js/utils/ResolutionMasterConfig.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ export const tooltips = {
3939
detectedInfo: "Click to apply detected image resolution directly",
4040

4141
// Preset controls
42-
categoryDropdown: "Select preset category (Standard, SDXL, Flux, HiDream Dev, Qwen-Image, etc.)",
42+
categoryDropdown: "Select preset category (Standard, SDXL, Flux, Flux.2, WAN, HiDream Dev, Qwen-Image, etc.)",
4343
presetDropdown: "Choose specific preset from selected category",
4444
customCalcCheckbox: "Automatically apply model-specific optimizations for the new detected image resolution",
4545
autoCalcBtn: "Apply model-specific optimizations for current resolution",

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "Comfyui-Resolution-Master"
3-
description = "ResolutionMaster is for total control over resolution and aspect ratio. It provides an intuitive interface with an interactive canvas, advanced scaling options, extensive presets (SDXL, Flux, WAN), and model-specific optimizations for high-quality AI image generation."
3+
description = "ResolutionMaster is a ComfyUI custom node for resolution, aspect ratio, scaling, preset, and latent control. It provides an interactive canvas, auto-detect workflows, model-specific optimizations, and presets for SDXL, Flux, Flux.2, WAN, HiDream Dev, Qwen-Image, social media, print, cinema, and display resolutions."
44
version = "1.5.14"
55
license = { text = "MIT License" }
66

0 commit comments

Comments
 (0)