Files

T

ausboss 153eb3a25d Preview the file under the pointer in every Source list

A native select draws its option list itself, so hovering a name gave
nothing to go on: you picked by filename alone. Load Image + Pad, Load
Video and the crop / rotate / pad editors now open a list that shows the
hovered picture, or plays the hovered clip muted with its size and
length, and filters as you type; arrow keys, Enter and Escape work.

The picker (js/shared/media_picker.mjs) only reads the combo widget's
options and writes the chosen value back, so saved workflows, undo and
the API are unchanged. Pure parts live in media_list.mjs with tests.

2026-09-25 09:02:20 -05:00

4.4 KiB

Raw Blame History

Image Crop + Rotate + Pad

Loads an image and applies one reusable rotate → crop → pad transform. Click Open editor for the full-screen canvas; normal queued and API execution use the saved widget values without needing the editor.

Controls

Image source: Pick an existing input image (the list previews the image under the pointer and filters as you type) or click Upload in the compact source card. Dropping an image onto the node still works. The original image widget remains the saved/API value; the old picker and upload rows are hidden.
Rotate → Degrees (rotation_degrees): Clockwise rotation before crop and padding.
crop_aspect_ratio: Free crop, source ratio, or a fixed ratio.
crop_x / crop_y / crop_width / crop_height: Crop in rotated-image pixels. Width and height 0 mean the full available dimension.
pad_left / pad_top / pad_right / pad_bottom: New pixels around the crop.
feather: Feathers the mask into kept pixels and fades the image edge into the fill color, so outpaints blend instead of ending at a hard seam.
Align (canvas_multiple; Multiple in the editor): Rounds the final canvas up by adding the minimum extra pixels to the right and bottom.
Fill (fill_color): #RRGGBB or three RGB values used for generated pixels.
Resize output → Resize / Megapixels / Method / Steps (resize_to_megapixels / megapixels / resize_method / resolution_steps): Optional resize of the finished output to a pixel budget, with core Scale Image to Total Pixels semantics — the budget is megapixels × 1024 × 1024, aspect is preserved, and each dimension rounds to a multiple of Steps (8 or 64 keeps VAE-friendly sizes). The image uses the chosen Method; the mask always resizes bilinear so feathered edges cannot ring.

On the node

Choose Crop or Pad below the format chips. Crop trims to the selected ratio and keeps that shape while dragging, without adding padding. Pad preserves the whole source and adds centered bands; tap its active ratio again to lock the outer canvas, and again to clear. Align exposes the canvas pixel multiple (1 disables it; 8/16/32 can add pixels on the right and bottom).

The canvas row below holds Fill, the Feather amount in px, and Resize with its megapixel budget; Method and Steps stay in the editor, under Resize output. Reset crop restores the full source crop without changing rotation or padding. Reset clears rotation, crop and padding; fill, feather and Align stay.

The output pixel size is drawn centered just below the image — outside the pixels being judged — and shows the resize target when one is active (576 x 1024 → 768 x 1344).

Fill, Feather and Resize stay synchronized with the editor. Changing the resize budget updates the size readout immediately. Restoring a workflow or undoing a change refreshes the source card and preview without resetting the saved framing.

Outputs

image: BHWC float image batch. Animated image frames receive the identical transform.
mask: BHW generated-area mask combining source transparency, empty rotation corners, and padding.
stitcher: Wire to Stitch Inpaint to restore the kept canvas around an outpaint result, with a 32-pixel blend into the source. It follows the final resized canvas.
original: The loaded RGB image batch before rotation, crop, padding, or resize. Existing image and mask sockets keep their positions.
width / height: The output size after the transform and any resize.

Editor gestures

Choose Target aspect, then Crop to aspect to trim the largest centered crop, or Pad to aspect to keep the full rotated source and add centered fill-color bands. Both replace existing crop and padding. The target selection alone does not change the transform. Padding unlocks the inner crop; its target choice stays in the editor. Canvas multiple and resize steps can slightly change the fitted aspect.

Drag cyan squares to resize the crop, drag inside to move it, orange diamonds to add padding, and the green handle to rotate. Hold Shift while rotating to snap to 15 degrees. Use the wheel to zoom and middle mouse or Alt-drag to pan. The same handles work directly on the node's compact preview (fit-only there — the wheel keeps zooming the graph); zoom and pan are editor-only.

The node performs no network requests and writes no files beyond a normal user-initiated ComfyUI upload.

4.4 KiB Raw Blame History Unescape Escape