Yotsuba Games
Back to Guide
Guide

Image Input & Output

Loading

  • Image Load (image_load) — brings PNGs and other external images into the graph
  • Aseprite files (.ase/.aseprite) are read layer-by-layer and frame-by-frame with the nodes in the Aseprite category

Reloading assets edited externally

  • After saving a referenced file again in Krita, Aseprite, or another editor, use Reload selected file input in the top node toolbar. Only that loader and its downstream chain are evaluated again.
  • Use Reload all file inputs after updating several assets. It includes open/read file paths in the current project, but excludes save destinations and directory pickers.
  • Reloading adds no Undo step and does not mark the project as unsaved. Save the project or exported result normally if you want to preserve a changed result.
  • PixPipeline does not watch files continuously. Trigger reload after the external edit is complete to avoid reading a half-written save or repeatedly evaluating a heavy graph.
  • Reloading never bypasses Safe Open. A path that is not allowed remains subject to the existing confirmation and denial rules.

Touching up generated results in Pixel Canvas

  • Press the brush button at the top-right of an image preview to copy its current full-resolution result into a new Pixel Canvas
  • The new canvas has one layer and one frame. It is placed to the right of the source without an input edge, so later source changes do not overwrite final one-pixel corrections or hand-painted details
  • The entire creation is one Undo action; press Ctrl+Z if the copy was accidental
  • Use the paste button in the node toolbar to bring a clipboard image into the same editable canvas workflow. External file paths and clipboard metadata are not stored in the project
  • Editable canvases are limited to 256 by 256 px. Larger images are rejected with an explanation instead of being silently scaled; crop or resize them before importing

Keep a normal graph connection when the result must continue following its source. Use the editable copy after generation is settled and only manual finishing remains.

Exporting

  • Preview/output nodes save results as PNG
  • For unsaved projects the default export destination is projects/exports/images/ (audio goes to exports/audio/)

Batch export

  • Batch Export (batch_export) and friends write whole sets of outputs in one go
  • Nodes that write files are "side-effect nodes" that run on every evaluation — build your graph with save_mode disabled and enable it only when you are ready to write

Automated exports

  • Launching with --headless opens a project, evaluates it, and runs the export nodes automatically (→ 12 AI Integration)
Image Input & Output — PixPipeline User Guide