Skip to content
ArcBrush ArcBrush Docs

Export Image

Node icon
Export

Saves a single image to disk in PNG, JPEG, BMP, WebP, TIFF, or TGA format with filename token support.

Export Image writes the connected image to a file on disk. Choose from six formats, each with its own compression options. PNG supports lossless compression with adjustable level. JPEG and lossy WebP have quality controls. TIFF supports multiple compression algorithms.

Paths can be relative to your .arcb file: type export/sprite.png and the path resolves relative to where your project is saved. Directories are created automatically. A hint below the path input shows the resolved absolute path. Hovering the path field shows the fully expanded path in a tooltip.

After each export, the node displays the file size and duration (e.g., “Saved: sprite.png (45 ms, 128.3 KB)”). File writes happen off the UI thread, so exporting large images does not block the interface.

For JPEG output (which doesn’t support transparency), a matte color fills behind transparent areas.

Filename Tokens

Section titled “Filename Tokens”

The output path supports tokens wrapped in curly braces that are replaced with dynamic values at export time. Tokens can appear anywhere in the path or filename.

TokenDescriptionExample
{source}Source image filename without extensionhero-character
{label}Custom label of the source node, falling back to the source filename when the node has not been renamedhero
{width}Image width in pixels1024
{height}Image height in pixels768
{date}Export date (YYYY-MM-DD)2026-05-27
{time}Export time (HH-MM-SS); pair with {date} for a sortable timestamp14-30-52
{quality}JPEG or WebP quality; empty for formats without a quality setting90
{compression}Format’s compression setting (PNG level, TGA RLE, WebP lossy or lossless, or TIFF codec); empty for formats without one6
{node}This export node’s canonical name: the node type as a PascalCase identifier (spaces and punctuation removed) followed by the node’s unique per-type number. Not the custom label or the spaced display name.ExportImage1
{graph}Project filename without extension (untitled if unsaved)hero-banner

Examples:

TemplateExpands to
output/{source}.pngoutput/hero-character.png
exports/{date}/{source}_{width}x{height}.pngexports/2026-05-27/hero-character_1024x768.png
{graph}_export.pnghero-banner_export.png

Forward slashes in the path create subdirectories automatically. ~/ at the start expands to the user’s home directory (macOS and Linux).

Parameters

Section titled “Parameters”

Pins

ImageImage
InputRequired

Export

Output PathText

Where the file is written

FormatChoice
Default: Auto (from extension)

File format. Auto follows the extension

  • Auto (from extension)Detect format from file extension — .png, .jpg, .webp, etc.
  • PNGLossless with transparency support. Best for icons, sprites, and assets that need alpha.
  • JPEGLossy compression, small file size. Best for photographs. No transparency.
  • TGATarga format with optional RLE compression. Common in game engines.
  • BMPUncompressed bitmap. Large files, maximum compatibility.
  • WebPModern format with both lossy and lossless modes. Smaller than PNG/JPEG.
  • TIFFProfessional format with multiple compression options. Used in print and archival.
QualityInteger
Default: 90 Range: 0–100
JPEG / WebP only

JPEG/WebP quality (0-100)

MatteColor (RGB)
Default: rgb(255, 255, 255)

Background mattefor formats without alpha

PNG CompressionInteger
Default: 8 Range: 0–9
PNG only

zlib compression level (0=none, 9=max)

TGA RLEToggle
Default: true
TGA only

Use TGA RLE compression

WebP LosslessToggle
Default: false
WebP only

Lossless WebP encoding

TIFF CompressionChoice
Default: None
TIFF only

TIFF compression codec

  • NoneNo compression — fastest but largest files.
  • LZWLossless compression — good balance of size and speed.
  • DeflateLossless compression — smaller files than LZW but slower.
  • PackBitsSimple RLE compression — fast but less effective on complex images.
Embed RecipeToggle
Default: false
PNG, WebP, JPEG, TIFF

Embed this graph into the exported file's metadata so it can be reopened in ArcBrush. Includes all node settings, prompts, notes, and input file NAMES (never full paths). Adds a few KB

Usage Tips

Section titled “Usage Tips”
  • Use PNG for images with transparency or when you need lossless quality.
  • JPEG quality of 85-92 is a good balance between file size and quality for photographs.
  • WebP lossless is smaller than PNG for most images.
  • Turn on Embed Recipe (off by default) to store a privacy-sanitized copy of the whole graph inside PNG, WebP, JPEG, and TIFF files. Dropping that image back onto ArcBrush, or File > Open Recipe from Image…, reopens the graph. Absolute paths, AI spend, and machine identifiers are stripped (input file names are kept, never full paths). It adds a few KB per file.
  • Use relative paths (e.g., output/icon.png) to keep exports portable alongside your .arcb file.
  • Use Ctrl+Shift+E to quick-export selected export nodes, or File > Export All (Ctrl+Shift+Alt+E) to run every export node in the graph at once.
  • Picking an explicit Format (PNG, JPEG, TGA, BMP, WebP, TIFF) updates the output path’s extension to match. .jpeg and .tiff are preserved if you’ve typed them. A warning appears if the extension still doesn’t match the chosen format.
Section titled “Related Nodes”