canvas-pilot/docs/canvas-pilot/guide/format-matrix.md

8.6 KiB

Choosing a file or clipboard format

Guide contents · Import and export instructions · Starter files

Use Save project to continue editing later. Use SVG for straightforward vector-editor exchange, draw.io for diagrams.net, PPTX for slides, and FIG / FIGCRAFT for Figma / FigCraft files. Prefer SVG for Illustrator exchange unless you specifically need a native .ai file. DXF / DWG suit CAD geometry; JSON / CSV suit scripts and tables. HTML provides a browser-viewable layout.

These tables describe what Canvas Pilot implements, not everything each file format can theoretically contain. ✅ means supported; ❌ means unavailable in this workflow. Linked numbers refer to the notes below each table. These emoji are a reference, not interactive controls.

Format tiers

Tiers describe preservation of Canvas Pilot settings. Formats within a tier are tied; choose the one your editor supports.

🥇 Gold — complete project

Canvas Pilot

Save a .pilot.json to keep editable state and images together. This format opens only in Canvas Pilot. It is not an industry exchange standard; choose a format below to work in another application.

🥈 Silver — exchange with an optional snapshot

SVG draw.io JSON HTML PowerPoint FigCraft CSV DXF

Enable extra Canvas Pilot parameters when exporting to retain an optional snapshot of advanced settings. Recover it with Restore parameters from export. Other editors may discard this snapshot; keep a project file as your backup.

🥉 Bronze — geometry and artwork

Figma DWG Illustrator

Use these formats for their destination editors. Keep a companion .pilot.json for editable crops, masks, input settings and other Canvas Pilot state.

See the advanced feature matrix for every saved feature.

See also conversion examples and losses before passing files through several editors.

File exchange matrix

All eleven exchange formats import and export layer positions and sizes. Geometry import maps boxes to existing destination layers: it keeps their source settings and device links, and does not change the output resolution. Names stay unchanged unless you enable Rename destination layers in the import review.

File Import Export Layer names in export Rename on import 5 Background picture 1 Crop/mask preview pictures 1 Extra settings snapshot
Canvas Pilot project (.pilot.json) ✅ ✅ ✅ ✅ Always ✅ ✅ ✅
SVG (.svg) ✅ ✅ ✅ ✅ ✅ ✅ ✅ 4
draw.io (.drawio, XML) ✅ ✅ ✅ ✅ ✅ ✅ ✅ 4
Geometry JSON (.json) ✅ ✅ ✅ ✅ ✅ ✅ ✅ 4
HTML / CSS (.html) ✅ ✅ ✅ ✅ ✅ ✅ ✅ 4
PowerPoint (.pptx) 3 ✅ ✅ ✅ ✅ ✅ ✅ ✅ 4
FigCraft file (.figcraft) 3 ✅ ✅ ✅ ✅ ✅ ✅ ✅ 4
Geometry CSV (.csv) ✅ ✅ ✅ ✅ ❌ ❌ ✅ 4
DXF (.dxf) ✅ ✅ ✅ 2 ✅ ❌ ❌ ✅ 4
Figma file (.fig) 3 ✅ ✅ ✅ ✅ ✅ ✅ ❌
DWG (.dwg) 3 ✅ ✅ ✅ 2 ✅ ❌ ❌ ❌
Illustrator file (.ai) 3 ✅ ✅ ✅ 2 ✅ ✅ ✅ ❌

File notes

  1. Pictures: enable Include background layer and/or Include placeholder pictures when exporting.

  2. Names: exported as format-specific labels/metadata. CAD uses stable layer IDs with human names in descriptions; Illustrator files go through an SVG conversion. Another application's layer panel may display these differently.

  3. Native codecs: DWG, PPTX, FIG, FIGCRAFT and Illustrator require a build with vendor formats enabled (the default). Illustrator file exchange additionally requires the separately installed VectorCraft converter.

  4. Extra settings: experimental and opt-in. Restore the original snapshot with Project → Restore parameters from export…; ordinary geometry import never applies it. External applications may strip it or leave it stale after edits.

  5. Rename on import: projects restore saved names. For geometry exchange this is opt-in, using names actually present in the file. SVG and Illustrator conversion use labels, titles or explicit IDs; CAD prefers layer descriptions, then CAD layer names. Unnamed items keep their destination names. See renaming from imports.

Exports use one screen-sized canvas, slide, frame or artboard. PPTX import offers a slide picker; FIG / FIGCRAFT offer page/frame choices; Illustrator offers artboards. Draw.io supports single-page files, including compressed files. These are supported layout profiles, not general-purpose artwork importers: arbitrary HTML, SVG effects, CAD entities or complex native document features may be rejected or omitted. See file import limits before choosing a workflow for complex artwork.

Clipboard matrix

Figma file import and Figma copy/paste are different paths. The same distinction applies to Illustrator and draw.io. “Paste” below means into Canvas Pilot; “Copy out” means a clipboard format Canvas Pilot itself generates.

Clipboard path Paste positions and sizes Copy out in this format Rename destination layers Crop zoom Crop edges / offsets, fit and masks
Canvas Pilot Copy layer values, all fit modes ✅ ✅ ✅ ✅ ✅
Figma SVG text copy/paste ✅ ❌ ✅ how to ❌ ❌
Illustrator SVG text copy/paste ✅ ❌ ✅ how to ❌ ❌
draw.io diagram XML copy/paste ✅ ❌ ✅ how to ❌ ❌
SVG file contents pasted as text ✅ ❌ ❌ ❌ ❌
Geometry JSON / CSV file contents pasted as text ✅ ❌ ❌ ❌ ❌
Canvas Pilot HTML / ASCII DXF file contents pasted as text ✅ ❌ ❌ ❌ ❌
PowerPoint native clipboard ❌ ❌ ❌ ❌ ❌
QCAD native clipboard ❌ ❌ ❌ ❌ ❌

Figma SVG, Illustrator SVG and draw.io XML clipboard paths have been manually reviewed. This does not imply support for every application's native binary or HTML clipboard payload. Use the corresponding file path if no supported text is available. PowerPoint and QCAD use file exchange in this workflow.

Paste opens a mapping review with separate Position and Format (width/height) choices. Canvas Pilot copies also offer an Appearance group with Crop & fit and Blanking. Crop edges preserve normal zoom/offsets and all explicit fit modes; masks retain their Layer/Source reference and proportions. Enable Rename destination layers to apply supplied names; it starts unchecked.

Crop & fit requires matching source dimensions after input crop; it never changes source assignments or device mappings. If dimensions differ, match the local source or uncheck Crop & fit. Blanking can be pasted independently. Older clipboard text still offers Crop zoom when present, without full crop offsets or fit/masks. See clipboard preservation and limits.

SVG and draw.io imports can optionally include supported outline widths in the bounds. Colors, text styling and artwork are not applied to the destination. Pasting exported text with extra parameters still imports geometry; use the separate restore action to recover the embedded settings.

PNG, JPEG and BMP are reference-image imports, not layer-geometry formats. PDF, PSD, VSDX and ODG are not supported geometry-exchange choices.

For advanced save and restore details, see the advanced feature matrix in the import/export guide.