Use Illustrator instead of AI in format names and documentation
This commit is contained in:
parent
2d2d1ab1cd
commit
8cf3d41f90
|
|
@ -57,7 +57,7 @@ impl Codec {
|
|||
Self::Pptx => "PowerPoint · PPTX",
|
||||
Self::Figma => "Figma · FIG",
|
||||
Self::Figcraft => "FigCraft · FIGCRAFT",
|
||||
Self::Illustrator => "Illustrator · AI (VectorCraft)",
|
||||
Self::Illustrator => "Illustrator (VectorCraft)",
|
||||
}
|
||||
}
|
||||
pub fn extension(self) -> &'static str {
|
||||
|
|
@ -200,7 +200,7 @@ pub fn import(bytes: &[u8], filename: &str) -> Result<Vec<Page>, String> {
|
|||
}]);
|
||||
}
|
||||
let text = std::str::from_utf8(bytes).map_err(
|
||||
|_| "Unrecognized binary format. Choose PPTX, FIG, FIGCRAFT, AI or a supported geometry file.",
|
||||
|_| "Unrecognized binary format. Choose PPTX, FIG, FIGCRAFT, Illustrator or a supported geometry file.",
|
||||
)?;
|
||||
Ok(vec for your
|
||||
application: its file and copy/paste workflows can support different features.
|
||||
|
||||
Drop SVG, draw.io/XML, geometry JSON/CSV, DXF/DWG, HTML, PPTX, FIG, FIGCRAFT or AI files into
|
||||
Drop SVG, draw.io/XML, geometry JSON/CSV, DXF/DWG, HTML, PPTX, FIG, FIGCRAFT or Illustrator files into
|
||||
the window to open the same geometry review as **Import → Geometry file…**.
|
||||
Native codecs still require their normal build options/dependencies. Filename
|
||||
extensions are case-insensitive; PNG/JPEG/BMP drops remain reference images.
|
||||
|
|
@ -156,17 +156,17 @@ The [starter-file catalog](../../templates/canvas-pilot/catalog.md) contains all
|
|||
exchange formats, with two layers for 1920 × 1080 and 3840 × 2160 canvases.
|
||||
|
||||
**Project → Export → Export layers…** opens one shared window. Choose SVG,
|
||||
draw.io, JSON, CSV, DXF/DWG, HTML, PPTX, Figma FIG, FigCraft or Illustrator AI, then
|
||||
draw.io, JSON, CSV, DXF/DWG, HTML, PPTX, Figma FIG, FigCraft or Illustrator, then
|
||||
**Current layer…**,
|
||||
**Selected layers…**, **Specific layer…**, **All layers…** and **Visible layers
|
||||
only…**. A current-layer export keeps its original screen position and full-screen
|
||||
canvas. The window offers **Include background layer**. SVG, draw.io, geometry
|
||||
JSON, HTML, PPTX, FIG, FIGCRAFT and AI also offer **Include placeholder pictures** with embedded source-grid
|
||||
JSON, HTML, PPTX, FIG, FIGCRAFT and Illustrator also offer **Include placeholder pictures** with embedded source-grid
|
||||
imagery; CSV and DXF explicitly disable pictures and carry rectangle geometry.
|
||||
|
||||
Import a supported format with **Import → Geometry file…** or paste its text, then
|
||||
choose a slide/page/frame where applicable, then map detected layers to destinations.
|
||||
PPTX uses 96 pixels per inch; FIG/FIGCRAFT use native pixels. AI requires a separately
|
||||
PPTX uses 96 pixels per inch; FIG/FIGCRAFT use native pixels. Illustrator file exchange requires a separately
|
||||
installed `vectorcraft-cli`; its artboards appear in the same canvas selector.
|
||||
Import/export runs in the background and reports conversion failures without
|
||||
modifying the project. Backgrounds are automatically ignored;
|
||||
|
|
@ -344,7 +344,7 @@ In **Export layers**, enable **Include extra Canvas Pilot parameters (experiment
|
|||
store the exported layers' source/crop settings, fit modes, masks, saved input proposals, names, folders, links and workspace
|
||||
setup alongside the geometry. It is available for SVG, draw.io, JSON, CSV, DXF,
|
||||
HTML, PPTX and FigCraft. Images/capture assignments are excluded from this snapshot; the
|
||||
background and placeholder options remain separate. DWG, FIG and AI show why the
|
||||
background and placeholder options remain separate. DWG, FIG and Illustrator show why the
|
||||
option is unavailable with the current codecs.
|
||||
|
||||
Use **Project → Restore parameters from export…** to restore that original
|
||||
|
|
@ -362,18 +362,18 @@ See the [format-by-format audit and metadata contract](../../interfaces/midra-ex
|
|||
See the [advanced feature matrix](advanced-exchange.md) for complete project, snapshot
|
||||
and geometry-only preservation, including input corrections.
|
||||
|
||||
## Illustrator AI: optional converter required
|
||||
## Illustrator: optional converter required
|
||||
|
||||
**SVG is the preferred format for exchanging layer layouts with Illustrator.**
|
||||
Midra imports and exports SVG directly, without Illustrator or VectorCraft installed.
|
||||
AI remains an optional compatibility format; both AI import and AI export require
|
||||
Native Illustrator files remain an optional compatibility format; import and export require
|
||||
**VectorCraft CLI**, which is not bundled with Canvas Pilot. Installing the
|
||||
VectorCraft graphical application alone does not guarantee that its CLI is
|
||||
available to Midra.
|
||||
|
||||
The normal build includes all other supported exchange formats without external
|
||||
applications: SVG, draw.io, geometry JSON/CSV, HTML, DXF/DWG, PPTX, FIG and FIGCRAFT.
|
||||
A build made with `no_proprietary` disables DWG, PPTX, FIG, FIGCRAFT and AI support.
|
||||
A build made with `no_proprietary` disables DWG, PPTX, FIG, FIGCRAFT and Illustrator support.
|
||||
Installing a converter does not re-enable formats excluded from that build.
|
||||
|
||||
Obtain VectorCraft CLI from the [VectorCraft project](https://github.com/storytold/vectorcraft).
|
||||
|
|
@ -396,11 +396,11 @@ $env:MIDRA_VECTORCRAFT_CLI = 'C:\Tools\VectorCraft\vectorcraft-cli.exe'
|
|||
.\canvas-pilot.exe
|
||||
```
|
||||
|
||||
Select **Illustrator · AI (VectorCraft)** in Export layers, or import an `.ai` file
|
||||
Select **Illustrator (VectorCraft)** in Export layers, or import an `.ai` file
|
||||
through Geometry file. Conversion is local and temporary; it does not use a cloud
|
||||
service. A missing converter produces an error without changing the project.
|
||||
Use SVG if you do not want to install or configure the converter.
|
||||
|
||||
AI exchanges layer geometry and optional artwork, not the complete editor project.
|
||||
Illustrator exchanges layer geometry and optional artwork, not the complete editor project.
|
||||
Use a `.pilot.json` project to preserve all settings. See the
|
||||
[AI format contract and round-trip checks](../../interfaces/canvas-pilot-exchange.md#illustrator-ai).
|
||||
[Illustrator format contract and round-trip checks](../../interfaces/canvas-pilot-exchange.md#illustrator).
|
||||
|
|
|
|||
|
|
@ -4,8 +4,8 @@
|
|||
|
||||
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 over AI** for Illustrator
|
||||
unless you specifically need a native AI file. **DXF / DWG** suit CAD geometry;
|
||||
**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
|
||||
|
|
@ -17,7 +17,7 @@ a reference, not interactive controls.
|
|||
|
||||
**Gold — complete project:** `.pilot.json` retains editable state and images.
|
||||
**Silver — optional snapshot:** eight exchange formats preserve advanced settings
|
||||
when extra parameters are enabled. **Bronze — geometry/artwork:** FIG, DWG and AI
|
||||
when extra parameters are enabled. **Bronze — geometry/artwork:** FIG, DWG and Illustrator
|
||||
need a companion project to retain those settings. Tiers describe preservation;
|
||||
formats within a tier are tied, with picture-capable formats listed first.
|
||||
See the [advanced feature matrix](advanced-exchange.md) for every saved feature.
|
||||
|
|
@ -40,23 +40,23 @@ and layer labels can help identify the boxes; they do not rename destinations.
|
|||
| 🥈 Silver<br> DXF (`.dxf`) | ✅ | ✅ | ✅ [2](#file-notes) | ❌ | ❌ | ✅ [4](#file-notes) |
|
||||
| 🥉 Bronze<br> Figma file (`.fig`) [3](#file-notes) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
|
||||
| 🥉 Bronze<br> DWG (`.dwg`) [3](#file-notes) | ✅ | ✅ | ✅ [2](#file-notes) | ❌ | ❌ | ❌ |
|
||||
| 🥉 Bronze<br> Illustrator file (`.ai`) [3](#file-notes) | ✅ | ✅ | ✅ [2](#file-notes) | ✅ | ✅ | ❌ |
|
||||
| 🥉 Bronze<br> Illustrator file (`.ai`) [3](#file-notes) | ✅ | ✅ | ✅ [2](#file-notes) | ✅ | ✅ | ❌ |
|
||||
|
||||
### 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; AI goes through an SVG conversion.
|
||||
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 AI require a build with vendor
|
||||
formats enabled (the default). AI additionally requires the separately installed
|
||||
[VectorCraft converter](files.md#illustrator-ai-optional-converter-required).
|
||||
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](files.md#illustrator-optional-converter-required).
|
||||
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.
|
||||
|
||||
Exports use one screen-sized canvas, slide, frame or artboard. PPTX import offers
|
||||
a slide picker; FIG / FIGCRAFT offer page/frame choices; AI offers artboards.
|
||||
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.
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@ explains source selection, install locations and replacement behavior.
|
|||
installation, remove its extracted folder and shortcut. Neither instruction asks
|
||||
you to delete saved projects or manually remove application preferences.
|
||||
- **Do I need a switcher?** No. Local editing and file exchange work offline.
|
||||
- **Do I need extra converters?** FFprobe is not needed. Illustrator AI exchange
|
||||
- **Do I need extra converters?** FFprobe is not needed. Illustrator exchange
|
||||
requires VectorCraft; SVG exchange works without that optional converter.
|
||||
|
||||
## Run the development version
|
||||
|
|
|
|||
|
|
@ -76,9 +76,9 @@ a format for your editor and see which settings it preserves.
|
|||
- **Work with another application:** drop a supported geometry file into the window,
|
||||
use **Import → Geometry file…**, or **Project → Export → Export layers…**. The [starter-file catalog](../templates/canvas-pilot/catalog.md)
|
||||
has matching Full HD and 4K files in SVG, draw.io, geometry JSON, CSV, DXF/DWG,
|
||||
HTML, PPTX, Figma FIG, FigCraft and Illustrator AI. Prefer SVG for Illustrator
|
||||
exchange: AI requires a separately installed VectorCraft CLI for both import
|
||||
and export. See [AI setup](guide/files.md#illustrator-ai-optional-converter-required).
|
||||
HTML, PPTX, Figma FIG, FigCraft and Illustrator. Prefer SVG for Illustrator
|
||||
exchange: Illustrator requires a separately installed VectorCraft CLI for both import
|
||||
and export. See [Illustrator setup](guide/files.md#illustrator-optional-converter-required).
|
||||
- **Use a supported device:** connect, review layer mappings, then explicitly load or
|
||||
send the chosen layers. Ordinary editing does not send commands to the device.
|
||||
Follow the [connection and transfer guide](guide/device.md) and its linked
|
||||
|
|
|
|||
|
|
@ -41,7 +41,7 @@ device readback and physical-screen acceptance.
|
|||
size/position/available-zoom toggles, draw.io stroke handling and own-copy
|
||||
round trips. Real draw.io clipboard sample and draw.io-exported SVG supported.
|
||||
- [x] Eleven-format file exchange: SVG, draw.io, geometry JSON, CSV, DXF/DWG, HTML,
|
||||
PPTX, FIG, FIGCRAFT and AI through VectorCraft. Shared geometry, scope and review,
|
||||
PPTX, FIG, FIGCRAFT and Illustrator through VectorCraft. Shared geometry, scope and review,
|
||||
optional artwork where supported, page/frame selection and licensing build flag.
|
||||
Two-layer Full HD and UHD templates exist for all eleven formats.
|
||||
- [x] Project JSON v15, tested legacy/recovery migration, saved layer links,
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ Run these commands from the extracted directory. Linux launchers reference this
|
|||
location; keep it in a permanent folder. macOS launchers copy the executable.
|
||||
The helper does not sign/notarize the application or bypass OS security checks.
|
||||
|
||||
FFprobe is not required. Illustrator AI exchange needs a separately installed
|
||||
FFprobe is not required. Illustrator exchange needs a separately installed
|
||||
VectorCraft CLI; SVG exchange can be used without it.
|
||||
|
||||
License: LICENSES/MIT.txt. Independent software, not affiliated with Analog Way.
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 307 B After Width: | Height: | Size: 307 B |
|
|
@ -4,7 +4,7 @@ Canvas Pilot was formerly named Midra Layout. The rename preserves existing wire
|
|||
|
||||
The Export menu writes **SVG v2**, **draw.io v1**, **geometry JSON v1**,
|
||||
**geometry CSV v1**, **DXF/DWG**, **HTML/CSS v1**, **PPTX**, **Figma FIG / FigCraft** and
|
||||
**Illustrator AI** (the latter via a local VectorCraft CLI). Project
|
||||
**Illustrator** (the latter via a local VectorCraft CLI). Project
|
||||
JSON is version 16 and is the full-fidelity save format. These exchanges
|
||||
preserve layer **visible-box geometry**, not sources, crop settings, zoom, pivots,
|
||||
Midra links, locks, visibility, camera or selection. Pictures illustrate current
|
||||
|
|
@ -12,24 +12,24 @@ cropping; importing a picture does not reconstruct its crop or source settings.
|
|||
|
||||
The [starter-file catalog](../templates/canvas-pilot/catalog.md) centralizes ready-to-open
|
||||
two-layer templates under `docs/templates/canvas-pilot/` for Full HD (1920 × 1080) and UHD 4K
|
||||
(3840 × 2160), in all eleven exchange formats (including PPTX, FIG and AI). The 4K geometry is an exact
|
||||
(3840 × 2160), in all eleven exchange formats (including PPTX, FIG and Illustrator). The 4K geometry is an exact
|
||||
2× scale of the Full HD layout. Regenerate them with:
|
||||
|
||||
```sh
|
||||
cargo run --locked -p canvas-pilot --example check_geometry_exchange -- templates docs/templates/canvas-pilot
|
||||
# Optional native codecs (default build); AI requires VectorCraft CLI:
|
||||
# Optional native codecs (default build); Illustrator requires VectorCraft CLI:
|
||||
MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo run --locked -p canvas-pilot --example check_geometry_exchange -- templates docs/templates/canvas-pilot pptx fig ai
|
||||
```
|
||||
|
||||
The generator verifies imported geometry before writing each template and replaces
|
||||
existing templates in the explicitly supplied directory. Samples contain only two
|
||||
editable layer boxes, with no background or placeholder images. PPTX uses one slide,
|
||||
FIG one frame, and AI one artboard. Their canvas sizes are pixels (PPTX uses the
|
||||
FIG one frame, and Illustrator one artboard. Their canvas sizes are pixels (PPTX uses the
|
||||
documented 96 pixels/inch conversion). These files are geometry examples, not
|
||||
full-fidelity project saves. AI samples were generated and round-trip checked with
|
||||
full-fidelity project saves. Illustrator samples were generated and round-trip checked with
|
||||
VectorCraft CLI 0.24.1; Adobe Illustrator itself was not used for validation.
|
||||
Native fixtures are checked semantically rather than byte-for-byte because encoder
|
||||
metadata can vary. The AI regression check is opt-in and requires the real CLI:
|
||||
metadata can vary. The Illustrator regression check is opt-in and requires the real CLI:
|
||||
|
||||
```sh
|
||||
MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo test --locked -p canvas-pilot --test exchange illustrator_readme_templates -- --ignored
|
||||
|
|
@ -48,7 +48,7 @@ MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo test --locked -p canvas-pil
|
|||
| PowerPoint, LibreOffice Impress, DeckCraft | PPTX | Yes; slide picker on import | Embedded PNG | Embedded PNG |
|
||||
| Figma, FigCraft | Native FIG | Yes; page/frame picker on import | Embedded PNG | Embedded PNG |
|
||||
| FigCraft | Native FIGCRAFT | Yes; page/frame picker on import | Embedded PNG | Embedded PNG |
|
||||
| Illustrator, VectorCraft | Native AI via VectorCraft CLI | Yes; artboard picker on import | Embedded PNG | Embedded PNG |
|
||||
| Illustrator, VectorCraft | Native Illustrator via VectorCraft CLI | Yes; artboard picker on import | Embedded PNG | Embedded PNG |
|
||||
|
||||
PSD, VSDX and ODG remain future adapters rather than implied support.
|
||||
PDF is a useful final visual but does not retain a
|
||||
|
|
@ -80,7 +80,7 @@ they do not modify the project/settings schema:
|
|||
|
||||
- **Include background layer** adds a first, full-screen shape with ID
|
||||
`midra-background`, explicitly marked as background. SVG, draw.io, JSON, HTML,
|
||||
PPTX, FIG and AI
|
||||
PPTX, FIG and Illustrator
|
||||
embed all visible references composited in project order over a dark backdrop
|
||||
using each image's fit/stretch/native-size, offset and opacity; otherwise they embed a plain dark
|
||||
backdrop. This is a baked visual reference, not an editable copy of reference
|
||||
|
|
@ -107,15 +107,15 @@ The default `vendor_formats` Cargo feature uses the published, pinned
|
|||
[`figcraft-format 0.5.1`](https://crates.io/crates/figcraft-format/0.5.1) crates with
|
||||
their document/geometry types. Their licenses are `MIT OR Apache-2.0`; vendor file
|
||||
formats do not imply a proprietary implementation license. No upstream app UI,
|
||||
font bundle, media engine or online service is embedded. VectorCraft's AI readers
|
||||
are unpublished and pull in rendering, font and PDF stacks, so AI uses a separate
|
||||
font bundle, media engine or online service is embedded. VectorCraft's Illustrator readers
|
||||
are unpublished and pull in rendering, font and PDF stacks, so Illustrator uses a separate
|
||||
optional executable rather than embedding that stack. Upstream licenses still
|
||||
apply to separately distributed tools; Midra does not bundle VectorCraft.
|
||||
|
||||
```sh
|
||||
# Normal build: native PPTX/FIG/DWG codecs and the optional AI converter interface.
|
||||
# Normal build: native PPTX/FIG/DWG codecs and the optional Illustrator converter interface.
|
||||
cargo build --locked --release -p canvas-pilot
|
||||
# Excludes vendor codecs, their optional dependency trees and the AI interface.
|
||||
# Excludes vendor codecs, their optional dependency trees and the Illustrator interface.
|
||||
cargo build --locked --release -p canvas-pilot --no-default-features --features no_proprietary
|
||||
```
|
||||
|
||||
|
|
@ -184,18 +184,18 @@ Midra or recreated on export. Reader repair warnings appear in the import review
|
|||
This option shares the FIG vendor feature and is excluded by `no_proprietary`.
|
||||
Tests cover native resaving, bare JSON, geometry, artwork and both starter sizes.
|
||||
|
||||
### Illustrator AI
|
||||
### Illustrator
|
||||
|
||||
Optional compatibility target: **prefer SVG for Illustrator exchange**. AI import
|
||||
Optional compatibility target: **prefer SVG for Illustrator exchange**. Illustrator import
|
||||
and export require a separately installed VectorCraft CLI; it remains external
|
||||
and is not embedded or bundled. See the [manual setup instructions](../canvas-pilot/guide/files.md#illustrator-ai-optional-converter-required).
|
||||
and is not embedded or bundled. See the [manual setup instructions](../canvas-pilot/guide/files.md#illustrator-optional-converter-required).
|
||||
|
||||
Uses [VectorCraft CLI](https://github.com/storytold/vectorcraft), discovered through
|
||||
`MIDRA_VECTORCRAFT_CLI`, beside the Midra executable, in its `bin/` subdirectory,
|
||||
then on PATH. Conversion runs locally in safe mode in a temporary directory, with
|
||||
a 60-second timeout and 16 MiB result limit. Nothing is installed automatically.
|
||||
The CLI reads AI and converts to SVG for the shared geometry importer, or writes
|
||||
PDF-compatible AI from Midra SVG. Import enumerates up to 64 artboards and presents
|
||||
The CLI reads Illustrator and converts to SVG for the shared geometry importer, or writes
|
||||
PDF-compatible Illustrator from Midra SVG. Import enumerates up to 64 artboards and presents
|
||||
each separately in the same canvas selector. Converter import warnings are shown
|
||||
in the mapping review; export warnings reject the result instead of silently
|
||||
losing content. SVG's rectangle/path/image restrictions
|
||||
|
|
@ -210,7 +210,7 @@ MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo run --locked -p canvas-pilo
|
|||
|
||||
These generate plain and illustrated documents, with backgrounds, and verify the
|
||||
imported layer boxes. Existing diagnostic files are not overwritten. VectorCraft
|
||||
0.24.1 native AI round trips were checked for both variants. DeckCraft 0.8.0
|
||||
0.24.1 native Illustrator round trips were checked for both variants. DeckCraft 0.8.0
|
||||
rendered the exported PPTX independently of the pinned 0.6.1 codec; the resulting
|
||||
Full HD image was visually inspected.
|
||||
|
||||
|
|
@ -383,7 +383,7 @@ the only positions present in that SVG. Include Canvas Pilot's background layer
|
|||
before exporting through draw.io when the full output-screen origin must survive
|
||||
the round trip.
|
||||
|
||||
Tests cover each format/artwork combination, the twelve text templates and eight native PPTX/FIG/FIGCRAFT/DWG templates (plus two AI templates in the opt-in CLI check),
|
||||
Tests cover each format/artwork combination, the twelve text templates and eight native PPTX/FIG/FIGCRAFT/DWG templates (plus two Illustrator templates in the opt-in CLI check),
|
||||
full-screen layers vs backgrounds,
|
||||
negative/fractional coordinates, repeat round trips, compressed clipboard/files,
|
||||
embedded references, invalid IDs/versions and no-overwrite file handling.
|
||||
|
|
@ -443,7 +443,7 @@ capture bindings. See the [complete carrier contract and format audit](midra-ext
|
|||
|
||||
Restore the original snapshot with **Project → Restore parameters from export…**.
|
||||
Normal geometry import continues to use the artwork's current boxes, including any
|
||||
external edits. Third-party editors may strip metadata. DWG, FIG and AI are not
|
||||
external edits. Third-party editors may strip metadata. DWG, FIG and Illustrator are not
|
||||
enabled until their current codec paths can preserve it reliably.
|
||||
|
||||
Embedded project snapshots now contain project version 16 and family-aware `device_link` objects. Geometry representation versions are unchanged. Existing embedded versions 1–15 migrate using the [project contract](canvas-pilot.md); plain geometry continues to omit device destinations.
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@ external editor moves/resizes a shape without updating the embedded snapshot.
|
|||
| DWG | Not enabled | DXF comments do not provide a reliable binary-DWG carrier. XRECORD/XData are potential future paths, but the current Craft conversion bridge has no verified application-payload round trip. No bytes are appended to the binary file. |
|
||||
| FigCraft FIGCRAFT | First page node `plugin_data.beffroi_midra_parameters` in native v1 `document.json` | ZIP and bare JSON restore supported. Native FigCraft 0.5.1 load/save preserves the field. Duplicate payloads are rejected; document JSON reads are bounded to 16 MiB. Other ZIP members are preserved. |
|
||||
| Figma FIG | Not enabled | Figma has plugin data, but the installed FigCraft 0.5.1 native exporter explicitly warns `plugin data was left out`. Its model field is not evidence of native preservation. |
|
||||
| Illustrator AI | Not enabled | PDF-compatible AI can have document metadata, but the current VectorCraft SVG↔AI conversion path has no verified application-payload preservation. No unverified PDF/AI trailer changes are made. |
|
||||
| Illustrator | Not enabled | PDF-compatible Illustrator can have document metadata, but the current VectorCraft SVG↔Illustrator conversion path has no verified application-payload preservation. No unverified PDF/Illustrator trailer changes are made. |
|
||||
| Midra project JSON | Already complete | Project v16 remains the authoritative full-fidelity save. |
|
||||
|
||||
Unsupported codecs disable the option with an explanation. Programmatic attempts
|
||||
|
|
|
|||
|
|
@ -44,15 +44,15 @@ These starter downloads are plain geometry templates, without embedded snapshots
|
|||
| 🥈 Silver |  DXF | [Download .dxf](canvas-pilot-1080p-2-layers.dxf) | [Download .dxf](canvas-pilot-4k-2-layers.dxf) | CAD tools |
|
||||
| 🥉 Bronze |  Figma FIG | [Download .fig](canvas-pilot-1080p-2-layers.fig) | [Download .fig](canvas-pilot-4k-2-layers.fig) | Figma or FigCraft |
|
||||
| 🥉 Bronze |  DWG | [Download .dwg](canvas-pilot-1080p-2-layers.dwg) | [Download .dwg](canvas-pilot-4k-2-layers.dwg) | CAD tools; Craft bridge |
|
||||
| 🥉 Bronze |  Illustrator AI (optional) | [Download .ai](canvas-pilot-1080p-2-layers.ai) | [Download .ai](canvas-pilot-4k-2-layers.ai) | Requires VectorCraft CLI for Canvas Pilot import/export; prefer SVG |
|
||||
| 🥉 Bronze |  Illustrator (optional) | [Download .ai](canvas-pilot-1080p-2-layers.ai) | [Download .ai](canvas-pilot-4k-2-layers.ai) | Requires VectorCraft CLI for Canvas Pilot import/export; prefer SVG |
|
||||
|
||||
FIG, FIGCRAFT, DXF and DWG import/export were manually reviewed on
|
||||
2026-11-15. PPTX, draw.io and SVG were previously confirmed; see the
|
||||
[format acceptance list](../../canvas-pilot/plan.md#completed-acceptance).
|
||||
|
||||
**Prefer SVG when exchanging layouts with Illustrator.** The AI templates remain
|
||||
**Prefer SVG when exchanging layouts with Illustrator.** The Illustrator templates remain
|
||||
available for compatibility, but Canvas Pilot needs the separately installed VectorCraft
|
||||
CLI to import or export them. See [AI setup](../../canvas-pilot/guide/files.md#illustrator-ai-optional-converter-required).
|
||||
CLI to import or export them. See [Illustrator setup](../../canvas-pilot/guide/files.md#illustrator-optional-converter-required).
|
||||
|
||||
## Geometry files and saved projects
|
||||
|
||||
|
|
@ -64,7 +64,7 @@ Save project…** for a full `.pilot.json` project; see the
|
|||
examples stay beside their [interface contracts](../../interfaces/README.md).
|
||||
|
||||
PPTX and FIG support uses the optional native codecs included in the default
|
||||
build. Illustrator AI import/export requires a separately installed VectorCraft
|
||||
build. Illustrator import/export requires a separately installed VectorCraft
|
||||
CLI. See [dependencies and licensing builds](../../interfaces/canvas-pilot-exchange.md#optional-native-document-codecs-and-licensing-builds).
|
||||
|
||||
## Maintaining the base files
|
||||
|
|
@ -81,8 +81,8 @@ the file names and bytes and the manual includes the same archive.
|
|||
Keep all formats here and link to this catalog instead of copying files or
|
||||
maintaining separate download lists. The [generation and verification commands](../../interfaces/canvas-pilot-exchange.md)
|
||||
rebuild both canvas sizes with the application exporter and verify their geometry.
|
||||
Text and native PPTX/FIG/DWG fixtures are covered by regression tests; the AI check
|
||||
requires VectorCraft and is opt-in. The AI samples were checked with VectorCraft
|
||||
Text and native PPTX/FIG/DWG fixtures are covered by regression tests; the Illustrator check
|
||||
requires VectorCraft and is opt-in. The Illustrator samples were checked with VectorCraft
|
||||
0.24.1, not Adobe Illustrator.
|
||||
|
||||
The DXF and DWG samples were opened and rendered with **QCAD Professional 3.28.2**.
|
||||
|
|
|
|||
Loading…
Reference in New Issue