export-image

name	export-image
description	Convert a single image (XCF, PSD, PNG, JPG, TIFF, WebP, etc.) to another format via GIMP headless. Use when the user wants to export a GIMP-native file to a web format, or when format support outside GIMP is missing.

Export Image

Inputs

• input_path
• output_path — extension determines format
• quality (optional, for JPEG/WebP, 0–100, default 90)
• flatten (optional bool, default true) — flatten layers before export

Steps

1. Map output extension → Script-Fu save procedure:
   • .png → file-png-save
   • .jpg|.jpeg → file-jpeg-save
   • .webp → file-webp-save
   • .tiff|.tif → file-tiff-save
   • .bmp → file-bmp-save
   • .xcf → gimp-xcf-save
2. Build a Script-Fu expression that loads, optionally flattens, and saves with the right args (each save procedure has its own arg list — check gimp-cli-reference or PDB browser if unsure).
3. Hand off to run-script-fu.

Notes

• For lossless quick conversions, prefer magick input output — only use this skill when GIMP-specific fidelity matters (XCF, layered PSD round-trip).