Files
ausboss-ComfyUI-AusBoss/js/docs/AUSBOSS_NODES_SelectFrame.md
T
ausboss 358ea00b4b Name controls in the help pages the way the node faces show them
Help pages named the raw widget (divisible_by, max_frames, color_match)
where the card shows a label (Multiple, Limit, Tone match), so a reader
could not find the control. Each such control now reads as the visible
label with the widget name beside it, and option values show the text
on the segment (match a, hist, cover, guided).
2026-09-24 00:46:14 -05:00

34 lines
1.4 KiB
Markdown

# Select Frame
Selects one unchanged image from an `IMAGE` batch. Frame numbers are one-based,
so `1` is the first frame and the last valid value is the batch size. Negative
numbers count from the end: `-1` is the last frame, `-2` the one before it —
handy when the batch length varies, as a video's often does. `0` is invalid in
both directions.
## Controls
- **frames**: A BHWC image batch, commonly the frame output of a video loader.
- **Frame** (`frame_number`): The one-based frame to return; negative
counts from the end (`-1` is the last frame). An out-of-range value stops
with the available range instead of silently clamping.
## Output
- **image**: The selected frame as a one-image BHWC batch.
## Preview
The panel shows the frame that was selected, so a picked frame can be checked
without a separate preview node. It updates when the graph runs — changing
**Frame** does not re-render it on its own, because the frame's pixels only
exist on the server.
The node performs no network requests. It writes one preview PNG per run into
ComfyUI's temp folder, the same place `PreviewImage` writes, which is cleared
with the rest of the session's scratch files.
The small **preview** switch at the right of the bar above the picture turns
it off: the picture's box disappears, the node is that much shorter, and no
preview file is written. The switch is the node's optional `preview` input.