Files
ausboss-ComfyUI-AusBoss/js/docs/AUSBOSS_NODES_AlignImage.md
ausboss ac0bb08949 Help pages: say what the nodes do today
32 of the ? help pages checked against the code and corrected.

Wrong claims fixed: Stitch Inpaint's empty-area check (20/255), what a
new video keeps on both Video Crop + Rotate + Pad pages, Load Video's
frame picker and player height, where Run Timer lists earlier runs,
inpainting on the Krea 2 Outpaint Model Patch page, Workflow Note's
banner layout and pack detection, Image Resize's pad bars and mask,
Save Image's path preview and tags, Free Memory's steps, and Latent
Size's sockets.

Image Crop + Rotate + Pad now follows the node from top to bottom; the
saved values no row shows moved under Technical details.

Controls are named the way the node shows them, with the input name
beside. Pages that opened with jargon now open with what the node does
and when to use it. LoRA Loader gained the Civitai lookup, suggested
strength and the gear options it did not name.
2026-10-06 12:59:04 -05:00

55 lines
2.5 KiB
Markdown

# Align Image
Snaps an image's width and height to a clean multiple of a number you pick —
8, 16, 32, 64, whatever the model downstream wants. Qwen image models, VAEs,
and plenty of samplers behave best (or only work) on sizes that divide
cleanly; this node makes any input legal without hand-typing resolutions.
## Controls
- **image**: BHWC batch to align; every frame is treated the same.
- **Multiple** (`multiple`, starts at `16`): Both output sides come out
divisible by this. `16` or `32` suits most diffusion models; latent nodes
generally want at least `8`.
- **Mode** (`mode`): How the multiple is reached. Each mode implies its own
rounding direction, so there is no separate rounding widget:
- **resize** — rescale to the *nearest* multiple. A slight stretch, but
every pixel's content survives. The default.
- **crop** — crop *down* to the next multiple. No distortion; a few edge
pixels are trimmed where **Anchor** says.
- **pad** — pad the edges *up* to the next multiple. No distortion; the
new pixels land where **Anchor** says and are filled per **Pad fill**.
- **Anchor** (`crop_position`): Crop mode only — which part of the frame
survives. `center` trims both edges evenly; `top`, `bottom`, `left`, or
`right` pin that edge and trim the opposite one. Ignored by resize and pad.
- **Anchor** (`pad_position`): Pad mode only — where the image sits on the
grown canvas; the new pixels land on the opposite side. `center` splits
them evenly. Same vocabulary as `crop_position`.
- **Pad fill** (`pad_fill`): Pad mode only — what fills the new area.
`replicate` stretches the edge pixels out; `color` uses **Pad color** as a
solid.
- **Pad color** (`pad_color`, starts black): The solid fill, shown only
while **Pad fill** is `color`. Hex, `R,G,B` numbers, or a CSS color name;
a color the node cannot read becomes mid-gray.
The two **Anchor** rows, **Pad fill** and **Pad color** only show in the
mode that uses them.
A side already smaller than one multiple can never be cropped legal, so it
snaps up to exactly one multiple in every mode (in crop mode the deficit is
replicate-padded evenly, whatever the **Anchor**).
## Outputs
- **image**: The aligned batch.
- **width** / **height**: The new size as INTs — wire them into an Empty
Latent, a resize, or conditioning nodes so the numbers can never drift
from the actual image.
## Notes
At most `multiple - 1` pixels are added or removed per side, so the change
is invisible at 16 or 32 on normal resolutions. Batches keep their frame
count; values stay in `[0, 1]`.