ausboss
ac0bb08949
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.
76 lines
4.2 KiB
Markdown
76 lines
4.2 KiB
Markdown
# Save Image
|
|
|
|
Saves an `IMAGE` batch as **PNG**, **lossless WebP** or **lossless JPEG XL**,
|
|
with the workflow embedded or deliberately left out. The name is either
|
|
composed on the node from a prefix plus the tags you switch on, or supplied
|
|
exactly by the `filename` input, so a caption or edit pass keeps the source
|
|
file's name. A caption on the `caption_text` input writes the paired `.txt`.
|
|
|
|
## The card
|
|
|
|
- **Folder** (`output_dir`): empty saves to ComfyUI's output folder; a name
|
|
such as `sets/portraits` saves to that subfolder, created if missing. Save
|
|
Image never writes outside the output folder: absolute paths, drive
|
|
letters, `~` and `..` are refused before the run, and the path preview says
|
|
so once you press Enter or click away. **Browse** walks the subfolders of the output folder.
|
|
- **Filename** (`filename_prefix`): the local name, subfolders allowed
|
|
(`sets/shot`). While the `filename` input is linked the field reads
|
|
`{{filename}}` with a small *linked* tag, and the tags below go gray and
|
|
cannot be clicked - an exact name is never decorated.
|
|
A workflow saved with the old `exact_name` shows that name tagged *exact*;
|
|
clear it to compose locally.
|
|
- **Path preview**: the name this save will produce, in the order the tags
|
|
are appended: `prefix[_YYYY-MM-DD][_HH-mm-ss][_WIDTHxHEIGHT][_#####][_b###]`.
|
|
After a run it shows the first file actually written.
|
|
- **Tags**: **Counter** (`name_counter`, on by default) appends the next
|
|
free five-digit number for that stem in that folder, so a save never
|
|
collides. **Date** and **Time** (`name_date`, `name_time`) stamp the local
|
|
clock. **Size** (`name_size`) appends `1024x1536`. **Batch #**
|
|
(`name_batch`) appends `b001, b002...` across an image batch, which then
|
|
shares one counter; without it each frame takes the next number. With the
|
|
counter off a single image reuses the same path and replaces the file - the
|
|
dataset replacement case - and a batch still numbers its frames.
|
|
- **Format**: **PNG** saves everywhere and keeps alpha. **WebP**
|
|
(`webp lossless`) is usually smaller than PNG, keeps alpha, and carries the
|
|
workflow in EXIF. **JXL** (`jxl lossless`, lossless JPEG XL) is the most
|
|
compact; it needs the optional `pillow-jxl-plugin` in ComfyUI's python
|
|
(also the pack's `jxl` extra) and few browsers preview it.
|
|
- **Embed workflow** (`save_metadata`): **yes** stores the prompt and
|
|
workflow in the file (PNG text chunks, EXIF in webp and jxl) so it drags
|
|
back into ComfyUI; **no** writes a clean file for sharing or datasets.
|
|
`--disable-metadata` on the server wins.
|
|
- **Preview** (`preview`): the small switch under the card shows the saved
|
|
image on the node. Off, the picture's box goes away and the node is
|
|
shorter; on again, the node returns to its height with the last saved
|
|
image. It is display only: the file is saved either way and the queue
|
|
still lists it.
|
|
|
|
## Inputs
|
|
|
|
- **filename** (STRING, link only): the exact name from upstream - a Load
|
|
Image name, a caption tool's id. Its image extension is swapped for the
|
|
chosen format's (`photo123.jpg` -> `photo123.png`); a batch appends
|
|
`_001`, `_002`... A linked but empty value stops the run instead of saving
|
|
under a made-up name.
|
|
- **caption_text** (STRING, link only): saved as a UTF-8 `.txt` beside every
|
|
image with the same name (`portrait.png` -> `portrait.txt`). Empty writes
|
|
no sidecar. The old `caption` box still works underneath; a linked caption
|
|
wins.
|
|
|
|
Rooted paths and `..` in names typed on the node are rejected before the
|
|
run. A bad name arriving through the `filename` link stops the run at this
|
|
node, before any file is written. `on_existing`
|
|
from older workflows is still honored wherever a save can land on an
|
|
existing file (counter off, exact or linked names).
|
|
|
|
## Outputs
|
|
|
|
- **file_path**: absolute path of the first file saved this run (empty when
|
|
every file was skipped), for downstream nodes that want the file itself.
|
|
- **images**: the input batch, unchanged — save first, keep wiring.
|
|
|
|
The node always re-runs on Queue (a saver's job is the side effect, so
|
|
deleting a file and queueing again saves it again), and a server launched
|
|
with `--disable-metadata` overrides the metadata toggle — the owner's call
|
|
beats the widget.
|