Save to disk

await painter.save(buffer, options?) and await painter.saveMultiple(buffers, options?) write image bytes to disk, optionally transcode with Sharp (JPEG / WebP / AVIF). Session state: a per-painter saveCounter (starts at 1) increments for naming: 'counter' (lib-next/output/save-buffer.ts, SaveOptions lib-next/types/output.ts).

resetSaveCounter is not exposed on lib-next ApexPainter — create a new painter or control names with filename, timestamp, or custom naming.

#save(buffer, options?)

1await painter.save(buffer: Buffer, options?: SaveOptions): Promise<SaveResult>;

##SaveOptions

##SaveResult

{ path, filename, size, format }

##Naming modes

#saveMultiple(buffers, options?)

1await painter.saveMultiple(buffers: Buffer[], options?: SaveOptions): Promise<SaveResult[]>;

• Requires a non-empty array.
• Iterates saveImageBuffer per entry. For naming: 'counter', the session counter advances once per file (sequential 1, 2, 3, … from the shared session).

#Formats & Sharp

• png: direct write (no Sharp re-encode).
• jpg / jpeg, webp, avif: require('sharp') must be available at runtime.
• gif: special-cased (non-GIF input logs a warning; buffer may pass through unchanged).

#Example

1const { buffer } = await painter.createCanvas({ width: 200, height: 200, color: '#1e293b' });2const meta = await painter.save(buffer, {3  directory: './out',4  naming: 'counter',5  prefix: 'frame-',6  format: 'webp',7  quality: 85,8});9console.log(meta.path, meta.size);