Skip to content

Commit 8503632

Browse files
committed
docs: clarify Auto-Detect controls and add Snap automation
- Rename ambiguous 'Auto Checkbox' labels to 'Fit Checkbox' and 'Resize Checkbox' - Add 'Auto-Snap Button' and 'Snap Checkbox' controls with descriptions - Clarify 'Calc Checkbox' behavior and 'Show Toggle' purpose - Replace duplicate control descriptions with 'Auto-Detect Automation Order' section explaining the sequential execution order (Fit → Resize → Snap → Calc) - Expand workflow setup notes to cover all four auto stages (Fit, Resize, Snap, Calc) alongside rescale_factor and canvas drag behavior
1 parent 8d7f310 commit 8503632

1 file changed

Lines changed: 25 additions & 19 deletions

File tree

README.md

Lines changed: 25 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -172,22 +172,30 @@ For new image generation:
172172
- Monitors input connection every second
173173
- Updates dimensions when new image is detected
174174
- Shows detected resolution in green text
175+
- Auto-Detect buttons can be clicked manually. The checkbox beside each button enables that same action automatically for newly detected images.
175176
- **🎯 Auto-fit Button**: Finds best matching preset for current dimensions
176177
- Analyzes both aspect ratio and total pixels
177178
- Checks both normal and flipped orientations
178179
- Applies category-specific scaling when Custom Calc is enabled
179-
- **Auto Checkbox**: Enable automatic fitting when dimensions change
180-
- Located next to Auto-Fit button
180+
- **Fit Checkbox**: Automatically run Fit when dimensions change
181+
- Located next to the Fit button
181182
- Only active when category is selected and image detected
182183
- **📐 Auto-Resize Button**: Applies scaling based on selected mode (Manual/Resolution/Megapixels)
183184
- Integrates with active scaling mode from Scaling section
184185
- Maintains manual scale value without reset to 1.0x
185-
- **Auto Checkbox**: Automatically apply scaling when new image is detected
186+
- **Resize Checkbox**: Automatically apply scaling when new image is detected
186187
- Works in sequence after Auto-fit (if enabled)
187188
- Applies chosen scaling mode to detected dimensions
189+
- **Auto-Snap Button**: Snaps current dimensions to the configured snap value
190+
- Uses the same snap logic as the Snap button in the Actions section
191+
- Prevents dimensions from snapping down to 0; small dimensions snap up to at least one snap step
192+
- **Snap Checkbox**: Automatically snap dimensions after Resize when a new image is detected
193+
- Runs in sequence after Auto-Fit and Auto-Resize
194+
- Useful for keeping detected or resized dimensions aligned to model-friendly multiples
188195
- **Detected Text (green)**: Click to apply the detected image's original dimensions
189196
- **⚡ Auto-calc Button**: Applies model-specific calculations to current dimensions
190-
- **Calc Checkbox**: Enables automatic model-specific optimizations
197+
- **Calc Checkbox**: Automatically applies model-specific optimizations after Fit, Resize, and Snap
198+
- **Show Toggle**: Shows or hides the orange Calc information panel without changing Auto-Calc behavior
191199

192200
### Presets Section
193201
- **Category Dropdown**: Select preset category (Standard, SDXL, Flux, etc.)
@@ -426,19 +434,14 @@ The node provides three scaling methods that work together:
426434
- **Ctrl + Drag**: Disables snap for fine-tuning without grid constraints
427435
- **Ctrl + Shift + Drag**: Preserves aspect ratio with 1px precision (no snap)
428436
429-
### Auto-Detect & Auto-Fit
437+
### Auto-Detect Automation Order
430438
431-
- **Auto-Detect Toggle**: Automatically detects dimensions from connected images
432-
- Monitors input connection every second
433-
- Updates dimensions when new image is detected
434-
- Shows detected resolution in green text
435-
- **Auto-Fit Button**: Intelligently matches detected dimensions to closest preset
436-
- Analyzes both aspect ratio and total pixels
437-
- Checks both normal and flipped orientations
438-
- Applies category-specific scaling when Custom Calc is enabled
439-
- **Auto Checkbox**: Enable automatic fitting when dimensions change
440-
- Located next to Auto-Fit button
441-
- Only active when category is selected and image detected
439+
The detailed controls are described in **Understanding the Controls > Auto-Detect Section**. When multiple Auto-Detect checkboxes are enabled, actions run in this order:
440+
441+
1. **Fit**: Match the detected size to the closest preset.
442+
2. **Resize**: Apply the active scaling mode.
443+
3. **Snap**: Round dimensions to the configured snap value.
444+
4. **Calc**: Apply model-specific constraints.
442445
443446
---
444447
@@ -525,9 +528,12 @@ Workflow Setup:
525528
When using auto-detect with scaling:
526529

527530
1. **Auto-detect updates base resolution** from connected images
528-
2. **Your scaling mode remains active** (manual/resolution/megapixel)
529-
3. **rescale_factor recalculates** to maintain your scaling intent
530-
4. **Canvas drag operations** update base resolution but preserve scaling intent
531+
2. **Auto-Fit can match the detected size** to the closest preset when enabled
532+
3. **Auto-Resize can apply the active scaling mode** (manual/resolution/megapixel)
533+
4. **Auto-Snap can round the result** to the configured snap value when enabled
534+
5. **Auto-Calc can apply model-specific constraints** when enabled
535+
6. **rescale_factor recalculates** to maintain your scaling intent
536+
7. **Canvas drag operations** update base resolution but preserve scaling intent
531537

532538
This design allows **resolution-independent workflows** where you can swap input images without breaking your scaling logic.
533539

0 commit comments

Comments
 (0)