Palette Save

Overview

Writes a graph palette to a GPL/ASE/PAL/HEX file. Use it to take a PixPipeline color scheme into Aseprite or another tool, or to share it between projects.

Usage tips

• Follow the standard export-node workflow: keep save_mode = Disabled while building, then switch to Overwrite / CreateIfMissing only when saving. This is a side-effect node that runs on every evaluation.
• The palette passes through unchanged via the palette output, so inserting this node mid-graph does not affect downstream processing.
• The save dialog starts from the configured user_data/palettes/ directory.
• Use palette_extract → palette_save to keep a reference list of colors used in the finished asset.

Common pitfalls

• Nothing is saved: save_mode is still the default Disabled, preventing accidental writes.
• The extension and format disagree: an extension in the path takes priority. If none is present, one is appended according to format.
• A translucent palette cannot be saved as GPL/ASE/JASC: those formats do not preserve alpha. Choose TXT / HEX, or explicitly enable allow_alpha_loss after accepting the loss.

Save modes

• Disabled
  • Does not save; the palette passes through unchanged.
• CreateIfMissing
  • Saves only when the file does not exist.
• Overwrite
  • Overwrites an existing file.
  • It avoids an unnecessary write when contents are identical.

Supported formats

• GPL
• ASE
• PAL (JASC)
• TXT / HEX

GPL, ASE, and JASC PAL store RGB only. By default, saving a palette containing alpha to those formats is rejected; TXT / HEX preserves alpha as #RRGGBBAA.

Usage

• Use it to export a palette created in the graph directly to an external file.
• PaletteCreate is for manual creation/editing, PaletteLoad for loading, and PaletteSave for saving.
• If path has no extension, the node adds one based on format.

Notes

• This is a side-effect node that performs file I/O.
• It starts in Disabled to prevent unintended writes during reevaluation.
• Switch to CreateIfMissing or Overwrite only when automatic saving is intended.

Related nodes

• palette_load — the reverse operation, loading a file
• palette_extract — collect colors before saving
• batch_export — image export with the same save_mode workflow