Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

All manuals

Canvas Pilot

Read the full manual →

Canvas Pilot icon

Canvas Pilot (formerly Midra Layout) is an independent project, not affiliated with Analog Way.

Canvas Pilot helps you prepare screen layouts for presentations and live events. Place video and slide layers on a canvas, check their sizes and positions, and frame their content before working with the screen processor. You can design offline, exchange geometry with drawing and presentation tools, and connect to a supported Midra 4K or Aquilon / LivePremier device when you are ready to review and transfer a layout.

Install and update · Quick start · Advanced guide · Starter files for all formats · Changelog

Démarrage rapide en français — traduction automatique non vérifiée. The rest of the manual remains in English, the authoritative source.

Start a layout

Run the desktop app from the repository root:

cargo run --locked -p canvas-pilot

A graphical desktop and a Rust build environment are required; see development setup. No device connection is needed for local editing.

A new project starts with a 1920 × 1080 canvas and two layers, Slides and Presenter. Select a layer on the canvas or in the list, drag it into place, and use its handles to resize it. Shift-click to select several layers; use Undo if you want to try a different arrangement.

The canvas shows the layout; the inspector gives exact dimensions and positions. Screenshots in this introduction predate the Canvas Pilot rename.

Position and organize layers

Enter exact pixel positions and dimensions in the inspector, or open Layer properties by clicking the layer-resolution field. Keep the aspect ratio locked when resizing, align layers, and group related layers in folders. Add more layers through Manage… in the Layers panel.

Use numeric controls for precise sizing, or work directly on the canvas.

See layers and editing for selection, alignment, folders and group resizing.

Frame content and use visual references

Open Layer properties → Crop to frame the source inside a layer. Crop editing keeps the visible layer box fixed while you adjust the content within it. You can also add reference images to the canvas to match an existing screen design.

Preview how the source fits inside the layer before transferring a layout.

See formats and crop and canvas and reference images for the detailed controls.

Save, exchange or send a layout

Use the file and clipboard feature matrix to choose a format for your editor and see which settings it preserves.

  • Save your work: use Project → Save project… for a .pilot.json file that retains the full editor project.
  • Work with another application: drop a supported geometry file into the window, use Import → Geometry file…, or Menu → Export → Export layers…. The starter-file catalog has matching Full HD and 4K files in SVG, draw.io, geometry JSON, CSV, DXF/DWG, 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.
  • 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 and its linked hardware-verification notes before using device writes.

For advanced workflows, start at the advanced guide.

All manuals

Install and update Canvas Pilot

Introduction · Your first layout · Advanced guide

Open the Canvas Pilot releases page →

Download the ready-to-run application for your computer. You do not need to install Rust, Cargo or Git.

  1. Open the newest stable release and find its Assets list.
  2. Download the file starting with canvas-pilot-portable- that matches your computer in the table below. Choose the portable archive, not Source code.
  3. Extract the entire archive into a folder you want to keep.
  4. Open the application inside that folder. On Windows, double-click canvas-pilot.exe. Then follow your first layout.

Before the first release: no releases were published when checked on 2026-11-16. If the release page is empty, there is nothing to download yet. The development build is available for people comfortable compiling software; otherwise, return when a release is published.

Which file should I download?

vX.Y.Z below stands for the version shown on the release page.

Your computerDownload this portable archiveOpen after extraction
Windows, Intel or AMD 64-bitcanvas-pilot-portable-x86_64-pc-windows-gnu-vX.Y.Z.zipcanvas-pilot.exe
Linux, Intel or AMD 64-bitcanvas-pilot-portable-x86_64-unknown-linux-gnu-vX.Y.Z.tgzcanvas-pilot from your desktop file manager
Mac with Apple Silicon (M-series), macOS 13 or latercanvas-pilot-portable-aarch64-apple-darwin-vX.Y.Z.zipcanvas-pilot; optional app launcher below
Mac with an Intel processor, macOS 13 or latercanvas-pilot-portable-x86_64-apple-darwin-vX.Y.Z.zipcanvas-pilot; optional app launcher below

On a Mac, Apple menu → About This Mac shows whether it has an Apple chip or an Intel processor. Linux downloads target glibc systems; Windows ARM, Linux ARM and Alpine/musl are not currently packaged.

Keep the extracted folder intact: portable archives include icons, launcher helpers, license information and a quick-start file. The executable is named canvas-pilot.exe on Windows, not release.exe. Separate archives without portable in their name are intended for the Cargo installation method below.

If your desktop asks for permission to run the downloaded application, follow its normal approval process. Some Linux file managers require enabling execution in the file’s properties or launching it from a terminal. Linux also needs the application’s desktop/OpenGL runtime libraries. Check the release notes for any platform-specific requirements.

Desktop shortcut or macOS launcher

On Windows, right-click canvas-pilot.exe to create a shortcut using your desktop’s shortcut options.

Optional Linux/macOS launcher setup (uses the command line)

Linux/macOS portable archives include an optional launcher helper requiring Python 3.11+. From the extracted folder, run the command for your system:

# Linux
python3 scripts/create-desktop-launcher.py canvas-pilot --binary "$PWD/canvas-pilot" --output "$HOME/.local/share"
# macOS
python3 scripts/create-desktop-launcher.py canvas-pilot --platform macos --binary "$PWD/canvas-pilot" --output "$HOME/Applications"

The Linux shortcut points to the extracted folder; keep that folder in place. The macOS launcher copies the executable and must be recreated after an update. The helper refuses existing launchers and does not sign or notarize the app. Follow your operating system’s normal approval process for downloaded applications.

Command-line installation — optional

The methods below are for people who already use Cargo or want to compile the application. Most readers can use the portable download above.

Choose the newest stable release on the release page. Replace vX.Y.Z in every command with its actual tag, including the v prefix. The main branch may contain changes that are not in that release.

Install a compiled release with cargo binstall

Install Cargo and cargo-binstall first. Its upstream installation page offers prebuilt cargo-binstall downloads. You also need Git for the tagged checkout below.

Canvas Pilot’s release metadata lives in its Gitea repository. Use the manifest from the selected release instead of relying on crates.io package discovery:

git clone --depth 1 --branch vX.Y.Z https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot.git canvas-pilot-release
cargo binstall canvas-pilot --manifest-path canvas-pilot-release/crates/canvas-pilot/Cargo.toml --strategies crate-meta-data

On Windows, use this installation command after the same clone command to select the published GNU target explicitly:

cargo binstall canvas-pilot --manifest-path canvas-pilot-release/crates/canvas-pilot/Cargo.toml --strategies crate-meta-data --targets x86_64-pc-windows-gnu

The tagged manifest supplies the version, download URL and binary layout. --strategies crate-meta-data restricts installation to the project’s release assets: if no suitable binary exists, it fails without starting a source build. Review the proposed download and confirm installation. Then run:

canvas-pilot

This installs the executable, not the portable bundle’s icons and launcher helper. For those extras, use the portable download. See the upstream cargo-binstall manifest documentation for how this installation method resolves release assets.

Build a release with cargo install

This method compiles locally and can take substantial time and disk space. Use prebuilt downloads or cargo-binstall on a computer with limited build capacity. Install a current stable Rust toolchain and your platform’s native compiler/linker; Linux also needs the development libraries used by egui/rfd’s desktop backend. See development guidance.

Select the actual tag of the latest published release, then run:

cargo install --git https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot.git --tag vX.Y.Z --locked canvas-pilot
canvas-pilot

The Git URL selects this project, and --tag selects the released source rather than the development branch. The default build includes the optional vendor format codecs. Cargo’s installation documentation explains source selection, install locations and replacement behavior.

Update, uninstall and common questions

  • Update a portable installation: close the app, extract the new release into a separate folder, then update your shortcut or recreate the launcher. Keep your saved projects. Do not overwrite a running executable.
  • Update a Cargo installation: select the new release tag and repeat the chosen method. For cargo-binstall, use a fresh tagged checkout directory or deliberately update your existing release checkout. If an existing binary causes a conflict, review its origin before explicitly choosing --force to replace it.
  • Command not found: ensure Cargo’s executable directory is on PATH, normally ~/.cargo/bin on Linux/macOS or %USERPROFILE%\.cargo\bin on Windows; a custom CARGO_HOME or installation root changes that location. Reopen the terminal.
  • No matching binary: check the selected release’s assets and target table. Cargo-binstall cannot download an asset that has not been published. It will not compile as a fallback with the command above.
  • Remove a Cargo installation: run cargo uninstall canvas-pilot. For a portable 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 exchange requires VectorCraft; SVG exchange works without that optional converter.

Run the development version

Before the first release, or when intentionally testing unreleased changes:

git clone https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot.git
cd canvas-pilot
cargo run --locked

This compiles the checkout and runs it locally; it does not install a released binary. Once the app opens, continue with your first layout.

All manuals

Quick start: your first layout

English — authoritative version · Français — démarrage rapide

Introduction · Advanced guide · Starter files

Make a simple Slides + Presenter layout, save an editable project, and export its geometry. This walkthrough uses the default Full HD canvas and works offline; no screen processor is needed.

1. Open a fresh layout

First follow Install and update to get Canvas Pilot, then launch it. If working from a development checkout, run this command from the repository root:

cargo run --locked -p canvas-pilot

See development setup if you need the build tools. If a previous layout was restored, save any work you want to keep, then choose Project → New project… and confirm.

The default canvas is 1920 × 1080, with Slides and Presenter layers. Leave that resolution unchanged for this walkthrough.

2. Place and size the layers

  1. Click Presenter in the Layers list or on the canvas.
  2. Drag the layer to position it. Drag a corner handle to resize it; keep Keep aspect ratio when resizing checked to preserve its proportions.
  3. For exact placement, use the inspector’s position fields. Check the selected measurement corner first: “From right” measures from the right edge, not the left.
  4. Select Slides and position it beside the presenter. Use Undo if a move or resize is not what you wanted.

The layer-resolution field opens Layer properties, where you can enter exact width and height. Leave the default sizes if you only want to try positioning.

3. Try framing the content

With Presenter selected, open Layer properties → Crop. The source pattern shows how content fits inside the visible layer box. Drag the content to adjust its position or use the crop handles to change its zoom.

The visible layer box stays fixed while cropping. Use Reset crop to return to the default framing, then switch back to the Layer tab to finish crop editing. You can skip this step if you only need rectangle positions.

4. Save the editable project

Apply any pending property edits, then choose Project → Save project… and save as first-layout.pilot.json. This is the file to reopen when you want to continue editing: it retains the project, including source/crop settings and reference images.

Use Project → Open project… to load it later.

5. Export the layer geometry

Choose Menu → Export → Export layers…, select SVG and All layers, then click Export… and save the file. For plain layer boxes, leave the background and placeholder pictures disabled. The SVG can be opened in a vector editor.

Compare file and clipboard capabilities in the format feature matrix before choosing an exchange format.

Keep the .pilot.json project as well: a geometry export does not retain all editor settings. The starter-file catalog has matching layouts in every supported format if you prefer to start in another app.

Continue with the advanced guide

You now have an editable project and a geometry export. Choose your next task:

The advanced guide also links to settings, compatibility contracts and hardware-verification details.

All manuals

Démarrage rapide : votre première composition

Français · English — version de référence

À propos de cette version française. Ce guide est issu d’une traduction automatique ; la terminologie de l’interface française a été validée. Le manuel anglais reste la référence et peut évoluer avant cette page. En cas de différence, consultez la version anglaise. Seul ce démarrage rapide est traduit pour le moment ; les autres chapitres sont en anglais. Les captures montrent l’interface en français. Les noms des calques, les titres d’exemple et les termes propres aux appareils conservent leur langue d’origine.

Créez une composition simple avec les calques Slides (diapositives) et Presenter (présentateur), enregistrez un projet modifiable, puis exportez sa géométrie. Ce tutoriel utilise le canevas Full HD par défaut et fonctionne hors ligne : aucun processeur vidéo n’est nécessaire.

1. Ouvrir une nouvelle composition

Suivez d’abord les instructions d’installation et de mise à jour (en anglais), puis lancez Canvas Pilot. Dans Menu → Ouvrir tous les réglages…, choisissez Français dans Language / Langue, en haut des réglages. Le changement est immédiat : confirmez avec Oui dans les 20 secondes pour le conserver au prochain lancement. Le bouton de refus reste dans la langue précédente. Un refus, la touche Échap ou la fin du décompte rétablit cette langue.

Si vous travaillez depuis les sources du projet, exécutez cette commande à la racine du dépôt :

cargo run --locked -p canvas-pilot

Consultez la configuration de développement (en anglais) si vous avez besoin des outils de compilation. Si une composition précédente a été restaurée, enregistrez le travail à conserver, puis choisissez Projet → Nouveau projet… et confirmez.

Le canevas par défaut mesure 1920 × 1080 et contient les calques Slides et Presenter. Conservez cette résolution pour ce tutoriel.

Interface en français ; les noms et le contenu du projet restent inchangés.

2. Placer et dimensionner les calques

  1. Cliquez sur Presenter dans la liste Calques ou sur le canevas.
  2. Faites glisser le calque pour le déplacer. Faites glisser une poignée d’angle pour le redimensionner ; laissez Conserver le ratio au redimensionnement coché pour conserver ses proportions.
  3. Pour un placement précis, utilisez les champs de position de l’inspecteur. Vérifiez d’abord le coin de référence choisi : Depuis la droite mesure la distance depuis le bord droit, et non depuis le bord gauche.
  4. Sélectionnez Slides et placez-le à côté du présentateur. Utilisez Annuler pour annuler un déplacement ou un redimensionnement qui ne vous convient pas.

Le champ de résolution du calque ouvre Propriétés du calque, où vous pouvez saisir une largeur et une hauteur exactes. Conservez les dimensions par défaut si vous souhaitez seulement essayer le placement.

3. Essayer le cadrage du contenu

Avec Presenter sélectionné, ouvrez Propriétés du calque → Recadrage. La mire de la source montre comment le contenu s’inscrit dans le rectangle visible du calque. Faites glisser le contenu pour ajuster sa position ou utilisez les poignées de recadrage pour modifier son zoom.

Le rectangle visible du calque reste fixe pendant le recadrage. Utilisez Réinitialiser le recadrage pour retrouver le cadrage par défaut, puis revenez à l’onglet Calque pour terminer. Vous pouvez ignorer cette étape si seules les positions des rectangles vous intéressent.

4. Enregistrer le projet modifiable

Appliquez les modifications de propriétés en attente, puis choisissez Projet → Enregistrer le projet… et enregistrez le fichier sous first-layout.pilot.json. C’est ce fichier qu’il faut rouvrir pour poursuivre l’édition : il conserve le projet, notamment les réglages des sources, le recadrage et les images de référence.

Utilisez Projet → Ouvrir un projet… pour le charger ultérieurement.

5. Exporter la géométrie des calques

Choisissez Menu → Exporter → Exporter les calques…, sélectionnez SVG et Tous les calques, puis cliquez sur Exporter… et enregistrez le fichier. Pour exporter uniquement les rectangles des calques, laissez désactivées les images d’arrière-plan et les images de substitution. Le SVG peut être ouvert dans un éditeur vectoriel.

Comparez les possibilités des fichiers et du presse-papiers dans le tableau des fonctionnalités par format (en anglais) avant de choisir un format d’échange.

Conservez aussi le projet .pilot.json : un export de géométrie ne garde pas tous les réglages de l’éditeur. Le catalogue de modèles (en anglais) propose des compositions équivalentes dans chaque format pris en charge si vous préférez commencer dans une autre application.

Poursuivre avec le guide avancé

Vous disposez maintenant d’un projet modifiable et d’un export de géométrie. Choisissez la prochaine étape parmi ces chapitres en anglais :

Le guide avancé (en anglais) donne aussi accès aux réglages, aux contrats de compatibilité et aux détails des vérifications matérielles.

All manuals

Canvas Pilot starter files

Canvas Pilot · User guide · Geometry format contract

Download all templates as ZIP — all eleven formats in both Full HD and UHD 4K (22 files). Extract the archive and use whichever format suits your editor. This also preserves file names when browsers would otherwise preview a template, including PDF-compatible Illustrator files.

Pick a template and send back your layout

  1. Choose your application and the requested canvas size in the table below.
  2. Download the matching file and open it in your editor.
  3. Arrange and resize the layer boxes, save the file, and send it back to the person preparing the screen layout. You do not need Canvas Pilot to edit it.

Unsure which format to choose? See the format recommendations and feature matrix. Individual downloads are listed below.

This folder is the single source for the base files in every supported geometry exchange format. Each file contains the same two named 16:9 layer boxes on an exact pixel canvas, without backgrounds or placeholder pictures. The UHD layout is an exact 2× scale of the Full HD layout.

Choose your canvas and format, download the file, then edit it in the matching application or import it through Import → Geometry file… in Canvas Pilot. Review the detected rectangles and their destination layers before applying.

Tiers follow the format matrix: Gold is a complete .pilot.json project for Canvas Pilot only, not an industry exchange standard; Silver formats can carry optional advanced-settings snapshots; Bronze exchanges geometry/artwork. These starter downloads are plain geometry templates, without embedded snapshots.

TierFormatFull HD · 1920 × 1080UHD 4K · 3840 × 2160Use with
🥈 Silver SVGDownload .svgDownload .svgVector editors and browsers
🥈 Silver draw.ioDownload .drawioDownload .drawiodiagrams.net / draw.io
🥈 Silver Geometry JSONDownload .jsonDownload .jsonScripts and geometry exchange
🥈 Silver HTMLDownload .htmlDownload .htmlBrowsers and web layouts
🥈 Silver PowerPointDownload .pptxDownload .pptxPowerPoint, LibreOffice Impress or DeckCraft
🥈 Silver FigCraftDownload .figcraftDownload .figcraftFigCraft
🥈 Silver Geometry CSVDownload .csvDownload .csvSpreadsheets and data tools
🥈 Silver DXFDownload .dxfDownload .dxfCAD tools
🥉 Bronze Figma FIGDownload .figDownload .figFigma or FigCraft
🥉 Bronze DWGDownload .dwgDownload .dwgCAD tools; Craft bridge
🥉 Bronze Illustrator (optional)Download .aiDownload .aiRequires 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.

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 Illustrator setup.

Geometry files and saved projects

These files exchange visible layer boxes. They do not store the complete editor state, source assignments, crop settings or device links. In particular, the .json starter is geometry JSON, not a saved Canvas Pilot project. Use Project → Save project… for a full .pilot.json project; see the project format. Versioned schema and migration examples stay beside their interface contracts.

PPTX and FIG support uses the optional native codecs included in the default build. Illustrator import/export requires a separately installed VectorCraft CLI. See dependencies and licensing builds.

Maintaining the base files

After updating any starter file, rebuild the combined download from this folder:

python3 -m zipfile -c canvas-pilot-all-templates.zip canvas-pilot-*-2-layers.*

The archive contains exact copies of all 22 templates; regression tests verify 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 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 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. Both formats were also saved as R21 (2007) in QCAD and reimported with unchanged layer coordinates. DXF and DWG carry unitless pixel geometry and no pictures.

All manuals

Canvas Pilot advanced guide

Introduction · Install and update · Quick start: your first layout · Starter files · Changelog

Use this guide after the first-layout walkthrough, or jump directly to the detailed controls, workflows and limitations you need. The illustrated chapters show real offline application sessions; screenshots retain the former Midra Layout header still displayed by the current interface.

ChapterWhat it covers
Installation and updatesPrebuilt downloads, cargo-binstall, source installation and troubleshooting
Layers and editingSelect, move, resize, align, name, order and group layers
Canvas and reference imagesWorkspace defaults, view tools, guides, grid, reference pictures and positioning points
File and clipboard feature matrixChoose a format by geometry, naming, pictures, crop and saved settings support
Formats, crop and precisionInput/output sizes, content framing, visual crop controls and numeric precision
Import, export and project filesClipboard mapping, geometry files, export scopes, saving and recovery
Menus and preferencesApplication menus, themes, saved settings and snapping
Midra connection and transfersConnection, reviewed device writes, folder layouts and input snapshots

All manuals

Layers and editing

Canvas Pilot · Guide contents · Starter files

Layer folders

The Layers sidebar groups folder members under collapsible folder rows. Click the chevron to expand/collapse; click the folder name to select its visible, unlocked layers. Shift-click adds/removes its contents from the selection. Click empty space in the Layers list (including the gutter beside folder contents) to deselect all layers. Double-click a folder or layer name to rename it. Folder eye and lock icons apply to every member; Undo restores each member’s previous state, including mixed states.

Use the Create folder icon to create an empty folder, regardless of selection. Drag a layer onto a folder name to move it inside, or onto LAYERS or the full-width No folder drop area below the list to return it to the root. You can also drag left into the wide gutter beside any folder child; the gutter accepts drops along the full row, including the gap below it. Root drop targets highlight cyan while dragging, and the bottom strip shows Release to move out of folder. Dropping on another layer also changes stacking order and adopts that layer’s folder. Drag folder names above/below another folder to reorder all their layers as one block. Right-click offers rename, selection, visibility, locking, moving up/down, and Ungroup folder (keeps the layers). A layer’s right-click Move to folder menu also offers existing folders, the root, and a new folder. Right-click a selected layer in either the list or viewport to move all selected layers together; right-click an unselected layer to move only that layer.

Use the Add layer (+) icon beside the Layers heading, or right-click the viewport or empty layer-list space and choose Add layer. These shortcuts add and select a layer without opening the manager. Right-click a layer or folder for Move up / Move down. Layers inside a folder move among its members; root layers and populated folders move past adjacent root entries, keeping folder members together. Up moves toward the front. Boundary actions are disabled.

Folders are local, single-level groups. Explicitly created folders survive empty, can be renamed or deleted, and are saved with their collapse state. Legacy groups created only by layer labels still disappear when empty. Empty folders appear after the layer-backed groups; stacking movement applies to folders with layers. The existing Manage layers and folders remains available for bulk name/folder editing. Grouping does not affect device links or source assignments. All document edits support Undo.

Use the Layer tab for precise dimensions; the inspector keeps the selected layer in view. The header still uses the former Midra Layout name.

Size presets

Open the toolbar’s Size presets icon to find all size and placement presets. They work on the selected visible, unlocked layers:

  • Fullscreen: place every selected layer at the output’s top-left and set its width and height to the full output size. Multiple layers overlap intentionally.
  • Quarter: with one layer, choose one of nine positions: top/middle/bottom and left/center/right. The layer is half the output width and half its height. With two selected layers, choose Up / Down halves or Left / Right halves. With three or more, choose Four quarters. Selections over four repeat the quarter positions, so extra layers overlap earlier ones.
  • Tiling: set X (columns) and Y (rows), then Apply tiling. Layers fill cells left to right, then top to bottom. Empty cells remain empty; if there are more layers than cells, positions repeat and the menu explains the overlap.
  • Portrait / Landscape: swap each layer’s dimensions only when needed for that orientation. Its top-left position stays unchanged; square layers stay square. This changes the box dimensions, not the rotation of the source picture.

Placement follows the layer list from top to bottom, including selected members of collapsed folders. Presets use the output dimensions and preserve fractional pixels for odd screen sizes or uneven tile divisions. These explicit sizes override the manual aspect-ratio lock when Keep proportions is off.

Enable Keep proportions at the top of the preset menu to preserve each layer’s current width-to-height ratio. Fullscreen, all nine quarter positions, Up / Down, Left / Right, Four quarters and tiling then fit the layer inside its assigned region and center it, leaving space where needed instead of stretching it. Each selected layer keeps its own ratio. Portrait and Landscape still explicitly swap dimensions. The toggle starts off and is retained for the current session only.

Tiling shows separate X (columns) and Y (rows) labels beside bordered numeric fields. Counts range from 1 to 256 on each axis and are retained for the session.

Each operation is one Undo step, including any crop adjustment from resizing. Sources, masks, layer names, folders, stacking and device links remain unchanged; no device transfer occurs. Finish pending numeric/property edits before applying a preset. Hover an icon for its name, or enable toolbar icon names in Options.

Move and edit layers

  • Click a layer or its list entry to select it alone. Shift-click toggles that layer in the selection. Selection does not change stacking. The top row of the layer list is the frontmost layer. In overlaps, the frontmost selectable layer wins; the list lets you reach the lower layer. Clicking empty canvas clears selection; Shift-clicking empty canvas preserves it.
  • Left-drag on empty canvas draws a selection box, selecting every rectangle it intersects, in either drag direction. Shift-drag on empty canvas draws an additive box, including when starting over a layer. Escape cancels the box and restores the previous selection.
  • Drag a selected layer to move the whole selection together; dragging an unselected layer selects and moves it alone. Movement uses whole-screen-pixel deltas and preserves fractional starting positions, sizes and relative spacing. Drag a corner handle to resize that layer, or use the single-layer numeric fields.
  • Arrow keys move the selection by 1 px; Shift-arrow moves it by 10 px.
  • Open the Measure position from dropdown to choose a corner or the center marker. The From · screen and To · layer squares sit side by side; To follows From until Use a different measure point is enabled. The closed dropdown summarizes both points. Center offsets measure layer center from screen center (positive right/down); zero centers the layer. Switching reference changes the displayed offsets without moving the layer. Position and size edits apply when you leave a field or press Enter. Resizing preserves that reference point’s offsets. Invalid values leave the document unchanged.
  • Escape cancels a drag or restores uncommitted numeric fields. In the paste dialog it asks whether to Apply or Discard detected values. Group drags cancel atomically.
  • The history toolbar icons (Undo/Redo) or Ctrl/Cmd-Z, Ctrl/Cmd-Shift-Z (also Ctrl/Cmd-Y) reverse edits. Each drag, alignment, applied paste or numeric edit is one step; retain 100 undo records. View changes and selection are not document edits.
  • Scroll over the viewport to zoom around the pointer. Space-drag or middle-drag pans. In the compact toolbar’s view group, Fit screen resets the view and Zoom to selection frames the entire selection. A view warning appears only when a visible layer is completely out of view; select it in the layer list to frame it. The inspector separately flags layers partly or entirely beyond the output screen and suggests alignment or position edits. A divider separates view tools from Undo/Redo. Hover an icon for its label. Camera changes do not modify coordinates. Off-screen layers retain their exact coordinates, display a warning and remain selectable through the layer list.
  • Copy layer values (or Copy selected layer values for multiple layers) copies a readable position summary plus exact geometry, crop, fit and blanking. Ctrl/Cmd-C does the same when the viewport has focus. Paste with Ctrl/Cmd-V or Paste layer(s) values, then review the destination mapping. Appearance lets you choose Crop & fit and Blanking independently; source assignments and device links stay unchanged. Crop & fit requires matching source dimensions after input crop. See layer clipboard for the paste options and compatibility details. This is not a native WebRCS clipboard payload.

Right-click a layer for Source properties, Layer properties, Crop properties, Configure capture, Crop & mask, alignment, Copy layer values, Paste layer values, and lock/hide actions. Paste reads the clipboard and opens the existing value/mapping review before applying changes. Right-clicking a layer already in a selection keeps the whole selection and offers Resize together. Right-clicking an unselected layer selects it first. Locked/hidden layers remain protected; use the layer list to unlock/show them. Right-click empty canvas for Output format.

Resize selected layers together

Select multiple layers, then choose Same handles, Mirror horizontally, or Opposite handles in the right-hand inspector’s resize dropdown. Drag a corner or side handle on any selected layer to scale the selection together. All three modes use equal proportional scaling, not equal pixel additions: a 10% width increase applies to every selected layer’s own width.

  • Same handles uses the matching handle on every layer.
  • Mirror horizontally requires exactly two layers. Left/right handles are mirrored: bottom-right matches bottom-left, and top-right matches top-left. Top and bottom midpoint handles remain top and bottom respectively.
  • Opposite handles requires exactly two layers. The other layer uses the opposite handle: right/left, top/bottom, and diagonally opposite corners (bottom-right matches top-left). This was previously called Mirror resize.
  • Each layer keeps the opposite edge or corner fixed. With aspect ratio locked, both dimensions use the same scale; otherwise width and height scale independently. Side handles affect only their axis when the ratio is unlocked.
  • Minimum sizes constrain the shared scale. Invalid geometry rejects the whole update. Crops adjust with sizing, and one Undo restores all layers and crops.
  • The resize mode survives selection changes, Escape and Undo/Redo, and is saved with the project. Opening a project restores its saved resize mode. A single selected layer resizes individually; reselecting multiple layers reuses the chosen mode. Mirror and Opposite still require exactly two layers. Choose Resize: individual layer to change back explicitly. Escape cancels an active drag without resetting the choice. Locking/hiding during a drag cancels the entire gesture.

Align selected layers

Open the Align selected layers icon menu beside the view/history toolbar. The Align to dropdown automatically uses Screen (one selected layer) for a single layer and Selected layers (their combined bounds) for multiple layers. Screen alignment uses the current output resolution. It also lists Layer 1: Presenter, Layer 2: Slides, and any future layers. An explicitly chosen reference layer takes precedence, stays fixed and does not need to be selected. There is no separate Screen option for multi-selection.

In Adjust layer crop mode, alignment positions the zoomed content inside the selected layer’s visible box. Left/top/right/bottom align the corresponding content edge to the box edge; center resets that axis’s offset. Corners align both axes in one Undo step. Zoom, source proportions and layer geometry stay fixed; leaving crop mode restores normal layer alignment and its previous target.

The compact icon grid offers four corners, top/bottom/left/right edges, center on both axes, and separate horizontal/vertical centering. The top-right button centers horizontally (X); the bottom-right button centers vertically (Y). Edge buttons change only their axis; corner buttons change both axes. Hover an icon for its label. Every action preserves layer sizes and is one undo step, including corner moves. The menu also works with one selected layer and a different reference layer. The inspector lists each selected layer’s resulting center coordinates; select one layer for numeric size editing, or use a shared resize mode for the selection. Paste/import accepts the full selection.

Text inputs receive normal text paste and arrow navigation while focused; they never interpret these actions as geometry import or layer movement. Paste preview identifies every destination explicitly and applies the mapped selection together.

Layer management

Use Layers → Manage layers & folders… or the Manage layers and folders icon above the inspector list. Add layers, select one or more to remove, and edit names/folder labels. Names and folders commit on Enter or focus loss. These changes support Undo/Redo; at least one layer must remain. Folder filtering helps manage the list without changing stacking order. Lock/Show remain local, undoable flags. Use each row’s ↑ / ↓ buttons in Layers & folders to reorder immediately, or drag a layer name in the right-hand list and drop above/below another row. A cyan line marks the drop position; Escape or releasing outside the list cancels. Choose All folders to enable the manager’s reorder buttons. Hidden/locked layers can be reordered without changing their flags. Each move is one Undo step; pending names/folders follow their layer. The list reads front-to-back (top row on top); saved arrays and SVG read back-to-front. Moving a row up brings it forward; moving down sends it backward. Selection does not change stacking. Reordering never changes geometry, source assignments or Midra links, and never sends to the device.

Stable IDs survive removal and are independent of Midra layer numbers. Group movement, alignment and Same-handles resizing work across the selection; Mirror/Opposite resizing still require exactly two layers.

Projects support migration from older supported versions. Every format’s Selected layers scope exports just the current selection, including a single layer. All/visible export remains available.

Viewport context menu

Right-click a layer for rename/folder actions, copy/paste, aspect-ratio locking and alignment. Crop & mask pairs Adjust layer crop with Reset crop, and Adjust layer mask with Reset mask. Reset mask clears all four edges while preserving Mask from, crop, fitting and layer geometry; Undo restores it. Properties groups the Source, Layer, Crop, Mask and Mapping windows. Input preview & crop guides → Configure capture… opens the Preview tab; an existing preview also offers an enable toggle and crop guide opacity directly in that submenu. Opacity is adjustable only with an available preview image. Input selection stays in the window, so long input lists do not interfere with the context menu.

Lock, Hide and Delete follow the editing controls. Canvas groups Snapping, Reference images and Output format at the bottom: these apply to the workspace rather than the selected layer. Right-clicking empty canvas keeps these options at the top level. Multiple selection retains its Resize together and alignment actions; crop/mask resets require one selected layer.

Cancel an accidental close

When a draft window asks whether to Apply or Discard changes, choose Cancel to return to the window with your edits intact. Cancel neither applies nor discards them. This also works for clipboard and device-import reviews, layer properties, layer renaming and batch names/folders. If a layer-list action triggered the prompt, Cancel stops that action and keeps the draft open.

All manuals

Canvas and reference images

Canvas Pilot · Guide contents · Starter files

The default layout shows layer bounds, measurements and the screen canvas together. The header still uses the former Midra Layout name.

Workspace defaults and limits

New projects start with two local rectangles and two source identities; you can add more layers and editor inputs. Output resolution defaults to 1920 × 1080 (16:9) and can be changed. The output dialog identifies standard aspect ratios from the current resolution; nonstandard ratios display as Custom. The example backdrop is titled Example Conference Name by default. Edit it under Options → Example backdrop or Settings → Reference images. Changes appear immediately and save with the project; leave it blank to hide the text, or use Reset example title. Up to 128 single-line characters are allowed. The title is clipped to the banner and appears only without an imported reference image, at any output resolution. It is not exported to SVG or sent to Midra.

The initial backdrop is illustrative and adapts to every output resolution/aspect ratio; importing a reference picture replaces it. Project save/load, ten-format geometry exchange, arbitrary layer collections, single-level folders and persistent Midra screen/layer links are implemented. File export offers current/specific/selected/all/visible scopes; device transfers use All/Selected/Folder. Organization never sends commands by itself.

The Midra connection and mapping/transfer UI supports explicit sends and loads, with both sizing strategies and Centered crop conversion readback-tested on Eikos 3.3.10. Program sending is enabled by a manual preference. Ordinary local editing does not send; linked send is a direct user action. Physical-output comparison, broader firmware coverage and precise mask rasterization remain acceptance/backlog work. Visible-box center readouts are distinct from crop-corrected device containers. Internal precision is retained; views show one decimal and exports whole pixels.

The window can be resized; the screen keeps its aspect ratio, and the right inspector scrolls on shorter windows. Minimum size is 1000 × 720 logical points. A graphical desktop session is required to launch.

The Cargo workspace includes this crate in lint, tests, docs and coverage. Regression tests cover the supplied clipboard, malformed/unsupported input, corner conversion, group drag/undo, selection boxes, alignment targets, and GUI paste/focus behavior. Layer-list scrolling uses the wheel or scrollbar so dragging across list entries cannot accidentally scroll while selecting.

See the project plan and resolution/cropping specification for the implemented geometry model and remaining hardware-verification work.

Each layer row has Lock / Locked and Hide / Show buttons. Locked layers remain visible but cannot be selected, dragged, nudged, aligned or edited. Hidden layers keep their geometry and stay in the list, but are excluded from drawing and selection. Locking or hiding clears that layer’s selection; showing it does not unlock it. These are local session controls, separate from geometry undo/redo (which can still restore earlier geometry), and never send device commands.

Selected layers use gold outlines, labels, handles and position guides; unselected layers use muted outlines and labels. Gold in the layer list follows the same selection state, including when several layers are selected. When a higher layer covers an editing box, covered edge portions are dashed and exposed portions stay solid. Resize, crop (cyan) and mask (magenta) corner and side handles remain visible above the artwork, so you can edit a selected layer underneath another. Hidden layers and blanked regions do not cover guides. This display does not change stacking, geometry or device output.

Reference pictures

The screen name and output resolution remain visible above the output when reference images are loaded; Fit screen includes room for both labels.

Imported images accumulate in a purple Reference images section below the layer list, newest/topmost first. Add image… and + Add… accept multiple files. Use each eye icon to show/hide a guide, the remove icon to delete it, or right-click Show only this reference to switch guides quickly. Double-click opens that image’s settings. Reference rows cannot be dragged, resized, aligned or sent to Midra; selecting one clears the editable-layer selection.

Removal is also available in Import → Remove reference image and the viewport context menu’s Reference images submenu, with a picker for the target image. Images remain fixed behind the layers; their existing explicit fit/opacity settings remain available. Visible images composite back-to-front. Saves and recovery retain all images and settings, while background-enabled exports flatten visible guides. Older single-image projects migrate automatically to the new v10 collection.

The Import dropdown groups layer-value imports and screen references. Layer imports offer destination mapping. After importing a reference picture, Import → Reference settings… opens its visibility, opacity and scaling controls.

Drop one or more PNG, JPEG or BMP images into the window, or choose Import → Add reference images…. The image is fixed behind the layers in screen coordinates; zooming and panning keep it aligned. Layer fills become translucent to reveal the image. Use the reference window to pick an imported image, hide it, adjust opacity or remove it.

Fill screen maps the entire image to the current output resolution. An exact pixel match needs no warning. Scaling up or down with matching proportions shows an amber warning; a different aspect ratio (such as 16:10) shows a red SEVERE WARNING because the image is distorted. Neither warning blocks importing or moving layers. Fit inside preserves proportions and centers the image with empty margins where needed; scaling still produces an amber warning.

Up to 32 images with a combined 64 MiB of file bytes can be stored; dimensions are limited to 8192 pixels per side or the GPU’s texture limit, whichever is smaller. Invalid imports keep all existing images. Reference images and settings are saved with the project; their edits are independent of layer undo/redo.

Optional independent positioning points

Measure position from normally uses matching screen/layer points, keeping the inspector compact. Enable Use a different measure point to reveal To layer point. The first selector is the screen origin; the second is the layer endpoint. For absolute center coordinates, choose screen Top left and layer Center.

Changing points or turning the toggle off only updates the displayed offsets. Numeric size and ratio edits keep the selected layer endpoint fixed. Screen-right and screen-bottom origins keep their existing inward-positive signs; screen center uses positive right/down. Both points and the toggle autosave immediately to the opened or last-saved project. Only these choices are written; other edits still need Save. For a new project, save it once to establish its file. Write failures keep the selection active and show an error. Older projects open with matched points. Canvas guides show the chosen endpoints.

Displaying and entering aspect ratios

Layer dimensions and resolution controls show their current width:height ratio (e.g. 16:9). A ratio field beside Keep aspect ratio when resizing accepts 16:9, 4/3, or a positive decimal such as 1.85. Press Enter or leave the field to commit. With the lock checked, width stays fixed and height changes, preserving the selected position reference (including center). Undo restores the geometry and crop together. Zero, negative, non-finite and out-of-range results are rejected.

With the lock unchecked, entering a ratio does not resize: it stays ready until the lock is enabled. The displayed current ratio still describes the actual sizes. Selecting another layer discards that prepared value. In Layer properties, manual ratios and presets resize immediately when locked, as do width/height edits. The Layer tab needs no Apply; pending Source edits still require their own Apply. Unapplied ratio text/targets are temporary UI state, not saved settings or a separate project constraint. Source content remains proportionally scaled.

Select, Move, Pan and Zoom tools

The toolbar’s Select, Move, Pan and Zoom icons are mutually exclusive and remain selected until another is chosen. V, M, H and Z select them when not typing in a field; hover the icons for help. Grid/Pivot toggle choices are retained independently.

  • Select (V): select, move, resize and marquee-select layers using the existing controls; crop editing remains available.
  • Move (M): drag anywhere to move the current selection without changing it or resizing. In crop mode, moves the selected layer’s content.
  • Pan (H): drag anywhere in the viewport to move the camera without editing layers or changing selection.
  • Zoom (Z): click to zoom in around the pointer, Alt-click to zoom out. Drag right to zoom in or left to zoom out, anchored at the gesture’s starting point.
  • Space-drag / middle-drag: temporarily pan from any tool. Scroll zoom works from every tool. Escape restores the camera if a pan/zoom drag is in progress.

Navigation tool choice survives selection changes and project loads in the current session; a new launch starts with Select. Pan/Zoom do not alter geometry, crop values or document history. Existing project saves still preserve zoom/pan values.

Layer border snapping

Layer borders is independent of Mask edges & centers. Turn it off to stop using outer layer borders as movement anchors or stationary snapping targets. You can leave mask snapping on to position the visible masked picture, or disable both options. Neither checkbox changes the other. Screen/grid center alignment, pixel rounding and directly dragged resize handles retain their own behavior; mirrored/opposite border-contact snapping follows Layer borders.

Snap to masks

Enable Mask edges & centers in the snapping options to add the visible mask boundaries and their centers as targets, independently of Layer borders. Movement can align either outer layer edges or mask edges to those targets, screen guides and grid lines. The center of a moving visible masked area can align to screen interior guides, overlay grid lines and other masked-area centers. Whole-layer centers can also align to masked-area centers. The center comes from the visible remainder after masking, rather than the hidden/blanked part. Groups move rigidly and Undo restores the complete move without changing mask values. Resize handles and pivots can snap to stationary layers’ mask boundaries or centers; resize handles still belong to the outer layer rectangle. Mirrored/opposite resize contact remains based on outer layer edges.

Both layer-relative and source-relative masks are supported, including source crop, pan and zoom. Mask bounds are clipped to the layer aperture and fitted picture, so empty letterbox margins add no mask targets; fully masked areas and hidden layers supply no mask targets. Locked visible layers still do. This option starts disabled and is saved in preferences and projects. Crop and mask-editing gestures remain free of snapping.

Persistent editing tools

The toolbar’s Snap ▾ dropdown groups the 10 px grid and 100 px grid icon toggles with the snapping options. Its label shows the effective grid, including modifier overrides. Pivot stays beside it as an independent toggle. Click again to turn a tool off. Only one grid can stay selected; Pivot can combine with either. A cyan outline marks the selected toggle; the fill shows its current effect, including temporary modifier changes. Tooltips explain the shortcuts. Icons wrap onto another row when the window is narrow.

In double-click crop editing, Tab switches between crop and mask (normal crop and 1:1, Select tool). Tab retains focus navigation in property windows and other controls. See mask editing.

Held modifierTemporary effect
Shift10 px grid; disables it if that grid is already selected
Ctrl+Shift100 px grid; disables it if that grid is already selected
Ctrl without ShiftInverts Pivot on/off
AltOverrides either grid and inverts ordinary snapping

A different grid shortcut temporarily replaces the selected grid. Ctrl+Shift does not invert Pivot, so a selected Pivot tool can combine with the 100 px grid. Releasing modifiers restores the selected tools, including during a drag. Tools stay selected across selection changes and project loads in this session; they are not saved to projects/settings and start off on launch. They affect layer movement/resize, not numeric edits or crop-content handles.

With snapping enabled, Pixel edges gives whole output pixels a small magnetic zone during layer movement and resizing. Screen, layer and grid alignment keeps priority. Moving beyond one quarter pixel from the nearest integer retains the fractional coordinate, so precise subpixel placement remains available at high zoom.

Grid visibility and snapping are independent controls. The header still uses the former Midra Layout name.

Overlay grid

The Grid toolbar icon opens Show overlay grid, Snap to overlay grid, and Columns / Rows controls (1–64 each, default 8 × 6). The grid is drawn above reference images and the sample artwork, below layers, across the full output. Subdivisions scale with the output resolution and can fall on fractional pixels.

Enable snapping in the magnet menu and Snap to overlay grid in the Grid menu to snap layer edges, centers, resize handles and pivots to these lines. Showing and snapping are independent; the 10/100 px modifier grids still take precedence. These options are saved in application preferences. The guide is not included in exports.

Ctrl resize pivot

With Pivot off, hold Ctrl (or select Pivot) to show a draggable crosshair on selected layers (center by default). Drag the marker to place it, including outside the layer; this changes only its saved pivot, not its geometry. Double-click the visible pivot to reset to center. Ctrl-drag a layer resize handle to resize around the fixed pivot. Ctrl can be pressed/released during the gesture; the result is recalculated from the starting geometry. With Pivot selected, Ctrl temporarily restores the normal opposite-edge anchor. Escape cancels a resize or restores the previous pivot placement.

Resize modePivot behavior
IndividualOnly the dragged layer resizes around its pivot
Same handlesPlacing a marker sets the same relative pivot on selected layers
Mirror horizontallyPlacing a marker reflects the partner’s pivot left/right
Opposite handlesPlacing a marker reflects the partner’s pivot on both axes

Dragging a pivot snaps within six logical display pixels of the layer’s four corners, four side midpoints and center, even with snapping disabled. Nearby local anchors win over a grid; elsewhere the active 10/100 px grid or enabled pixel/screen-edge/ visible-layer-edge options apply. Guides show reached anchors/edges/grid lines. Alt bypasses the nine built-in anchors and grids while retaining its usual inversion of configured snapping. Release uses the current modifiers.

Moving any marker updates the related markers as above. Changing selection or resize mode preserves stored points. Each layer’s own pivot stays fixed while resizing; unequal sizes retain proportional scaling. Aspect-ratio lock, snapping (including edge contact), Alt inversion and Undo still apply. A handle on the pivot’s axis cannot resize that axis; move the pivot or use another handle. Layers do not flip when dragged through the pivot; minimum sizes still apply. Ctrl+Shift remains the 100 px grid (or temporarily disables a selected 100 px grid); it uses pivot anchoring if Pivot is selected. Pivot positions are saved per layer in the project, survive selection changes and reopening, and follow layers when moved. Placement and reset support Undo/Redo. They do not affect numeric sizing. In Adjust layer crop mode, Ctrl/Pivot scales the image with its source pixel under the gravity point fixed; the visible layer box stays unchanged. Crop limits stop scaling before revealing empty space, including with outside pivots.

Resizing with corner handles

Drag a selected layer’s gold corner handles to resize it; the opposite corner stays fixed. Keep aspect ratio when resizing, above the viewport, is enabled by default. Clear it to adjust width and height independently against the reference picture. The same toggle links numeric width/height edits. Pasted dimensions remain exactly as supplied by the source.

Dragging a handle in a multiple selection selects and resizes only that layer. Sizes cannot flip or shrink below one pixel during dragging. Escape cancels; one Undo restores the complete resize. Locked or hidden layers cannot be resized.

Reference placement and loading

Reference settings now offer Native pixels, mapping each image pixel to one screen pixel at the screen’s top-left, plus X/Y offsets in screen pixels. Offsets also work with Fit/Stretch. The image is clipped to the output screen. Native mode does not scale or distort the image, so stretch warnings do not apply. Outline-only layers keeps the reference unobscured while retaining selection and resize handles; it is also available in viewport options. Crop editing still shows its source guide. Placement and outline mode are saved in project v4.

Picture import/drop reads and decodes off the UI thread, retaining the current reference until successful completion. Canceling/removing discards late results; failed replacements keep the current image. Decoder work is serialized to bound peak memory. Minification uses linear filtering, magnification nearest-neighbor. Project/recovery reads and embedded reference decoding also run in a worker; the editor is installed atomically after all images validate.

Resize snapping now uses the same preference and Alt inversion as movement snapping. It preserves opposite anchors, aspect ratio and group-resize proportions. Guides appear only when the resulting handle reaches the target; crop-content gestures remain unsnapped. At 2 logical pixels per screen pixel, adaptive coordinate rulers appear; at 8, a pixel grid appears. Guide drawing is limited to the visible region.

Every exchange format also offers Specific layer…, listing every local layer, including hidden/locked layers. Choosing one explicitly exports its geometry without changing visibility or selection. No device mapping or send is implied.

Midra explicit fit modes are available behind Crop → Advanced layer fit. Their container/image geometry is previewed locally; exact scaler rasterization remains an engineering stretch goal.

All manuals

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

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

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

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.

Document reference pictures

PDF pages and SVG artwork can be rendered directly as reference images. Other supported documents also have reference import, using built-in artwork rendering, optional local converters or an explicitly labelled layout-box preview. See the reference-picture support table for each format’s requirements and limits. This does not add PDF geometry export or recover editable layers from a PDF.

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.

FileImportExportLayer names in exportRename on import 5Background picture 1Crop/mask preview pictures 1Extra 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 pathPaste positions and sizesCopy out in this formatRename destination layersCrop zoomCrop 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 processed source dimensions; 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.

All manuals

Advanced exchange feature matrix

Format tiers and basic matrix · Starter downloads

Gold saves the full project. Silver restores an optional embedded snapshot. Bronze imports geometry only. These tiers describe Canvas Pilot state preservation, not application quality or a guarantee that third-party editors retain metadata. Gold uses Canvas Pilot’s application-specific .pilot.json format, intended only for Canvas Pilot. It is not an industry standard or a measure of compatibility with other editors; use an exchange format for those workflows.

Which editing features survive?

This table separates editable state from a picture of its appearance. “Snapshot” means a supported exchange format exported with extra parameters and reopened through Restore parameters from export.

FeatureProject Open/SavePlain geometry file importSnapshot restore
Layer position and size✅✅✅
Full-precision saved coordinates✅❌ 1✅
Output screen resolution✅❌✅
Layer names✅✅ · opt-in, when supplied✅
Stacking order✅❌✅
Folders, collapsed folders, visibility and locks✅❌✅ 2
Source formats, assignments and shared input relationships✅❌✅ 2
Normal layer crop zoom and offsets✅❌✅
Advanced fit modes and their crop edges✅❌✅
Editable blanking masks (Layer / Source)✅❌✅
Resize pivots and group resize settings✅❌✅
Saved device screen/layer links (not physical source routing)✅❌✅
Shared device input settings drafts (session-only)❌❌❌
Reference images and their individual settings✅❌❌
Capture assignments and saved preview stills✅❌❌
Selection, camera, guides, snapping and workspace settings✅❌✅ 2
Undo history, pending edits and active device operations❌❌❌
Application theme, connection history and Program permission❌ 3❌❌

Editing notes

  1. Geometry exports round boxes to whole pixels; import can retain fractional coordinates where the reader supports them. Use a project or snapshot for full-precision recovery. Geometry import never reorders destination layers.
  2. Snapshot restoration includes only exported layers and their referenced inputs; selection and folders are filtered accordingly. It replaces the document with the saved snapshot, not a merge of the external artwork’s latest edits.
  3. Application preferences are saved separately from projects. Opening a project or restoring a snapshot does not connect or send to a switcher.

For a complete editable backup, Save project remains the recommended choice.

Copying layer appearance

Canvas Pilot’s Copy layer values also preserves exact geometry, crop edges, offsets, fit and blanking through the clipboard. Its mapping review offers an optional Appearance group. Pasted crop edges adapt proportionally to the destination input and use its selected Advanced fit; the copied fit does not replace that choice. Source assignments and device links remain unchanged. The separate Rename destination layers option applies supplied source names. See clipboard preservation and limits. This is separate from plain geometry import and export snapshot restoration.

Saved input corrections

Device input corrections live in the shared Input settings window. Drafts are session-only and require explicit review and send. Projects and exchange snapshots save processed source dimensions and layer settings, but no input crop or inactive device-input proposal. Opening an older native project reports discarded legacy settings; inspect the recovered layout before saving.

For practical examples across editors, see what gets lost between formats.

Limits and round trips

Silver formats are SVG, draw.io, geometry JSON, HTML, PPTX, FigCraft, CSV and DXF. Their snapshots preserve the original values, independently of rounded artwork. They do not turn crop, mask or source settings into native editing controls in the other application. Background/placeholder pictures can show the result, but cannot restore editable state by themselves.

FIG, DWG and Illustrator have no verified metadata carrier through the current codecs. Keep a .pilot.json companion when using these Bronze formats. Clipboard geometry also does not restore embedded snapshots. Use Restore parameters from export for Silver; use ordinary geometry import for the artwork’s latest positions.

Automated round trips cover all fit modes, fractional crops, both mask references, shared inputs, mappings and workspace state through every Silver codec. FigCraft metadata is also tested through its native load/save cycle. External application resaves can strip metadata; this is not a promise of lossless round trips through every editor. See the carrier contract for format-specific limits and validation evidence.

All manuals

What gets lost between formats?

Format recommendations · Advanced feature matrix

A conversion can preserve the picture while losing the information needed to edit it in the same way. Here are a few common paths, rather than a complete compatibility survey. External-editor behavior below is based on linked vendor documentation; possible losses during later re-saving are cautions, not claims that every editor was tested. Canvas Pilot behavior follows its current import/export implementation.

Three different things to preserve

What survives?What that actually means
AppearanceIt still looks right. Text might now be outlines, or several objects might be one image.
Editable geometryIndividual shapes can still move or resize. They need not retain their original names, grouping or behavior.
Application structureComponents, diagram connections or Canvas Pilot source mappings still have their original meaning. This normally needs native data understood by the receiving application.

SVG can contain vectors, text, images and extra metadata. The .svg extension alone does not tell you which of those a particular exporter wrote or an importer reads.

1. Figma → SVG → another vector editor

Typical goal: send a layout or drawing for further visual editing.

Shapes can remain vector artwork. Figma offers text outlining and layer-name IDs: outlined lettering keeps its shape but ceases to be editable text; keeping text requires suitable fonts in the receiving environment. Including IDs gives names a chance to travel, but does not guarantee the destination uses them as layer names. See Figma’s SVG export settings.

Treat this as artwork exchange: do not expect the receiver to reconstruct Figma components, variants, Auto Layout rules or prototype interactions from the SVG. That is a workflow inference, not a promise about every importer. Returning the SVG to Figma does not make it a replacement for the original design file.

Keep: the original Figma document if those editing relationships matter.

2. draw.io → SVG → draw.io

Typical goal: share a picture that can also be reopened as an editable diagram.

With Include a copy of my diagram, the SVG carries diagram data alongside the rendering. draw.io can use that data to reopen the diagram. Without it, the SVG picture alone is not the original diagram model. This is documented by draw.io’s SVG export guide.

This embedded diagram is different from a Canvas Pilot extra-parameters snapshot; the two are not interchangeable. Prefer .drawio when the recipient primarily needs to edit diagram shapes and connections.

3. Figma → SVG → draw.io → SVG

Typical goal: insert a Figma drawing into a diagram, then share the result.

An ordinary SVG inserted into draw.io is an image shape: you can position and resize it, but its internal rectangles do not become independent diagram nodes with editable connector relationships. It can still be vector artwork; “one image” does not necessarily mean rasterized pixels. draw.io documents this import limitation.

The final SVG therefore should not be assumed to contain separately editable versions of the original Figma objects. If you need two independently movable screen boxes, create two diagram shapes rather than inserting both as one SVG image.

4. Figma or draw.io → SVG → Canvas Pilot

Typical goal: transfer the positions and sizes of screen/layer boxes.

Canvas Pilot reads supported rectangle geometry, including supported rectangular paths, and offers supplied names through Rename destination layers. It does not recreate the source application’s components, connectors or arbitrary artwork. SVG IDs may be technical identifiers rather than useful names: check the review.

Masks, clipping, effects, rounded corners and rotated geometry are not equivalent to plain layout rectangles; unsupported constructions can be rejected instead of being silently approximated. A picture that looks like two boxes is not necessarily two importable boxes. Import into existing layers also leaves their source settings and device links in place.

Example: two plain 640 × 360 rectangles exported from Figma can provide two layer boxes. The same drawing inserted into draw.io as one SVG image cannot be assumed to yield those same two boxes when exported again. Inspect the import review. See the file and clipboard matrix for supported paths.

5. Canvas Pilot → SVG → another editor → Canvas Pilot

Typical goal: adjust placement elsewhere without losing crop and mask work.

A plain export carries geometry, names and optional preview pictures. Its box coordinates are rounded to whole pixels. Pictures can show a crop or mask, but do not encode its editable controls. Source assignments, device links and the Layer/ Source mask reference are not recovered by ordinary geometry import.

With extra Canvas Pilot parameters, the SVG also contains an original project snapshot. If that metadata survives the external editor, Restore parameters from export restores that snapshot—not the external editor’s subsequent changes.

Example: export a box at x=100 with a source mask, then move the SVG box to x=200. Normal import reads the new geometry. Snapshot restoration restores the original x=100 and mask. It does not automatically merge the new position with the old state. You can instead reopen the saved project and import the edited geometry into its layers, reviewing the result because resizing can reframe a crop.

An editor or SVG optimizer may remove metadata. Saving as PNG cannot preserve the editable vector boxes merely because the picture still looks correct. Keep the .pilot.json companion; see snapshot limits.

A small check before committing to a conversion path

Try two differently named boxes, some editable text and one crop/mask. After each hop, check the box count, names, coordinates, text editability and whether the crop is still a control or only visible artwork. If native metadata is involved, change one box before reopening to check whether you are seeing the latest artwork or an older embedded snapshot. Keep the original file until that path meets your needs.

All manuals

Formats, crop and precision

Canvas Pilot · Guide contents · Starter files

Choosing an exchange format? See the file and clipboard feature matrix for naming, crop, pictures and editable-settings support.

Formats and content framing

Open the Output format icon (screen with sliders), first in the toolbar, for HD (1280 × 720), Full HD (1920 × 1080), UHD 4K (3840 × 2160), aspect presets or a custom whole-pixel resolution. Output/native sizes support 1–16384 pixels per side as an implementation limit, not a promise of hardware support. Layer positions/sizes remain unchanged; screen-corner coordinates, alignment, reference-image mapping and warnings use the new output. Valid output presets and numeric resolution edits apply immediately; invalid drafts leave the output unchanged and are retained for correction. The same window offers numeric camera zoom relative to fit-to-screen and a 1:1 display pixels action; camera changes never modify crop geometry. Scroll zoom and the Zoom tool retain the full precision camera range. At extreme zoom, decorative screen titles and reference-hint text are hidden before their camera-scaled glyphs would slow the renderer; layers, handles, fixed-size layer labels, pixel guides and placement remain visible and editable.

Select one layer and click its Layer resolution card to open Layer properties:

  1. Use Source → Open shared input settings… for physical input preprocessing. Review and send input changes separately, then reload affected layers. The former local Editor input/pre-crop controls have been removed.
  2. Set Layer resolution to the final visible box. Use the aspect toggle to enter an independent custom width and height. Layer changes apply immediately; the selected measurement anchor stays fixed. Device input changes require their own review and send.
  3. Use Layer crop / zoom & position for zoom (100–10000%) and X/Y offsets in output pixels. Zoom is bounded to 100–10000%; negative or non-finite entries are rejected. X/Y offsets remain signed for left/up positioning; they are not crop amounts. These controls operate on the applied formats and update immediately as edited. A continuous zoom/offset drag is one Undo step; Recenter preserves zoom; Reset crop returns to the minimum centered cover crop. Invalid typed offsets show the permitted range and do not apply.
  4. Click Adjust layer crop in the selected layer’s parameters, below its format summary, or double-click a layer on the canvas, to drag or arrow-nudge content inside the fixed box. The button highlights while active; press Enter, double-click again or click Done adjusting crop to leave the mode. Drags clamp at valid crop boundaries; Escape cancels a drag and leaves this mode. Wheel zoom still controls the camera. A source-coordinate test pattern illustrates framing; it is deliberately separate from the screen reference. While editing, cropped-out content appears at 50% opacity outside the box, behind other layers. This preview stops at the usable input boundary; input cropping remains excluded. The content inside the box stays fully opaque. Grab the faded area to reframe content too; other visible layers covering it take precedence. Empty space beyond the usable input is not draggable content.

Layers keep independent crops and masks. Physical input preprocessing is shared by every layer consuming that signal, including layers outside this project.

Moving/alignment preserves crops. Resizing keeps content zoom and the retained center where possible, automatically shifting the crop when needed to fit the new size. Reloading from the device refreshes processed source dimensions. No recentering or extra acceptance is needed. Undo restores both size and crop. Layer properties → Crop activates visual crop editing while the tab is open. Switching to Source/Layer or closing the window turns it off; no extra button is needed. The standalone inspector and context-menu crop controls remain available.

Adjust layer crop changes the crop values inside the layer while keeping its visible box fixed; Reset crop returns to the minimum centered crop.

Calculated crops / provisional WebRCS mapping shows layer crops in processed-source pixels, retained bounds, visible size/center, and projected full-input geometry. These values are not a verified device recipe: Centered-mode container behavior, crop units/limits and quantization still require offline firmware verification. No hardware commands are generated or sent. See the resolution model for equations and worked examples.

The cyan helper frames the content while the visible layer box stays fixed. The header still uses the former Midra Layout name.

Crop ratio presets for embedded black borders

In Layer properties → Crop, use the Crop borders to ratio box: 4:3, 16:9 or 16:10. These presets trim symmetric borders baked into a signal, such as a 4:3 PowerPoint slide sent inside a 16:9 video resolution. They shrink the visible layer around its center to the requested ratio and crop its picture at the same time, rather than stretching the slide. The largest rectangle of the chosen ratio that fits inside the uncropped layer bounds is retained. Each click restores those bounds first, so switching ratios replaces the previous crop.

For example, 4:3 on a full 1920×1080 layer removes 240 pixels from each side and leaves 1440×1080. Conversely, 16:9 on an 800×600 layer removes 75 pixels from the top and bottom and leaves 800×450. Repeated clicks on the same ratio do not progressively crop the picture.

Right-click selected layers in the viewport or layer list and choose Crop presets to apply the same correction to several layers in one Undo step. Enable Crop within existing crop to keep the old behavior and trim the current crop further. This session-only toggle is off by default and is shared between the properties and context menus. Presets do not detect black pixels. Use manual crop controls for asymmetric borders. Explicit layer-fit modes are retained and fit the cropped picture into the new box. Shared input settings, source routing and masks are unchanged. No device command is sent. Finish pending numeric or property edits before applying a preset.

Display/export precision and midpoint handles

Geometry in the viewport, inspector and calculation view is shown to the nearest 0.1 pixel. Copied positions and provisional calculation exports use whole pixels (round-half-away-from-zero). Internal geometry and crops retain full precision; viewing/copying or applying unchanged rounded fields does not quantize the document. This presentation rule does not validate the hardware’s crop/container mapping.

Each selected box also has a handle at the middle of every side. Dragging top or bottom resizes height with the opposite edge fixed; left or right does the same for width. With the aspect lock enabled, the other dimension scales around its center, keeping the opposite edge’s midpoint fixed. Disable it to change just one axis. Corner handles still keep the opposite corner fixed. Crop preservation, lock protection, Escape and Undo apply to both kinds of resize handles.

Apply buttons are muted and disabled when their values already match the layout. Pending changes make Apply solid purple. This applies to position/size, output resolution drafts, names/folders, and mapped imports. Each section tracks its own values; reverting an edit clears its pending state.

Source links to the shared Input settings window for native device preprocessing. These input-only edits require their own explicit review and send; a layer-layout send never includes them.

Layer properties has six tabs: Source links to shared input settings, Layer edits the visible box, Crop edits content framing, Mask edits blanking, Mapping edits device destinations, and Preview controls capture, refresh, preview visibility and guide opacity. The right-click properties entries open their matching tab directly. Mapping offers device screen/layer selectors when connected, or numeric IDs offline. Link edits apply locally immediately and support Undo. Unmap removes the link, excluding the layer from linked sends and loads; it does not change the device. Layer size and Crop changes apply immediately; normal zoom/offset drags are one Undo step.

Position/size edits commit on Enter or focus loss, output resolution changes apply as edited, and names/folders commit on Enter or focus loss (also before closing or changing the layer list). These controls have no Apply button. Invalid geometry stays unchanged and errors appear inline. Closing output settings discards invalid uncommitted values without a confirmation dialog.

Source edits remain staged; Apply source changes commits them. Closing with pending Source edits, a rename, invalid batch names/folders, or mapped Midra imports asks Would you like to apply changes?, with Apply and Discard. Invalid Apply keeps the draft and error. Clipboard/SVG review uses Import mapped values; Escape or clicking outside asks Apply/Discard, while Cancel discards. Pending property/name edits temporarily disable the main workspace to preserve the edited layer. Switching property tabs keeps pending Source edits.

Reference display, camera, theme and preference controls already apply immediately. Device destination links also save to the local document immediately. Device sends remain explicit: closing export configuration never sends, and local Apply/Discard prompts never write to Midra. This does not change project save or application-exit behavior. Applied edits recover automatically on launch; use Save project for a separate named copy.

While adjusting a layer crop, click empty canvas or another layer to leave crop mode and select normally. Clicking or dragging the visible image or its faded outside preview keeps crop mode active. Property controls remain usable while editing the crop.

In visual crop mode, an accent-colored bounding box surrounds the full usable input image, including the faded preview. Drag any corner or side midpoint to zoom the content through cropping; the gold visible layer box stays fixed. Content always keeps its proportions, independently of the layer resize ratio toggle. The opposite content corner or edge stays anchored where possible; offsets clamp to keep the visible box filled when zooming out. Zoom is limited to 100–10000%. Drag the image to pan its content. Each zoom gesture is one undo step; Escape cancels an active gesture. Use viewport zoom/pan to reach content handles beyond the current view.

Advanced layer fit (Midra)

In Layer properties → Crop, check Advanced layer fit to expose explicit 1:1, Centered (fit), Fullscreen (stretch) and Cropped (fill) modes. The layer rectangle now describes a container. Crop edges, entered in source pixels, apply first; the retained image is centered and clipped to that container. 1:1 preserves pixel scale, Centered preserves proportions with transparent margins, Fullscreen stretches, and Cropped fills while clipping overflow.

Resize changes the container and preserves these crop edges. Double-click, Enter, or Adjust edge crop opens the advanced helper. Its green outline shows the retained image; the full usable source appears faded behind it. Drag a side to trim/restore that edge, or a corner to change two edges independently. The image stays still during the drag, with discarded areas shaded. On release, the chosen fit recenters/refits the retained image inside the unchanged container. Aspect lock and pivot scaling do not affect this edge operation.

Use viewport zoom/pan to reach handles outside the screen. Each drag is one Undo step; Escape cancels it. In 1:1 mode, dragging the picture or using arrow keys also repositions the crop without changing its retained size (Shift moves ten pixels). Numeric crop controls remain available in Crop properties.

Convert to Smart crop, in the right-click menu and Crop properties, switches to Canvas Pilot’s normal zoom/position algorithm. It preserves an exactly matching crop; otherwise it resets to centered cover framing, so the picture can change. Convert to Edge crop appears in the same places for a Smart crop. It keeps the current picture, crop, container and mask exactly as they are, selects Centered fit, and opens the green edge helper. Undo returns to Smart crop. Unchecking Advanced layer fit resets to centered cover framing. Pending Source edits still require Apply.

Device loads use Smart crop when the retained picture exactly fills the container with uniform scaling and the crop is representable by the normal algorithm. Centered/Cropped fits with rounding differences of up to one output pixel per image dimension also use Smart crop: a tiny symmetric crop adjustment restores the exact aspect while preserving the source center and layer container. Larger letterboxing/overflow differences and stretching retain their advanced fit. Existing saved projects keep their explicitly chosen modes. Sends use container dimensions regardless of sizing strategy, and never change input routing. Aquilon sends reject advanced fit until its adapter supports it. Projects/recovery preserve the mode. Pixel rounding is approximate pending the engineering precision follow-up.

Masking without resizing

Mask from selects the reference:

  • Layer (default): edges are measured from the layer boundary and stay proportional to the layer when resized.
  • Source: edges are measured from the usable source picture, after device input preprocessing but before layer crop/zoom and fit. The magenta guide can extend outside the layer and follows the picture when panning or zooming. A faded source preview helps position it. Only the intersection with the visible layer is rendered.

Switching reference keeps the edge percentages, so it can change the visible result. Numeric fields use output pixels for Layer and source pixels for Source. Reset mask clears all edges while keeping the selected reference.

Open Layer properties → Mask, or right-click a selected layer and choose Crop & mask → Adjust layer mask. Crop & mask → Reset mask clears its edges without changing the mask reference, crop or layer dimensions, and supports Undo. For keyboard editing, double-click a layer to enter crop mode, then press Tab to switch to the mask; press Tab again to return to crop. This works with normal crop and 1:1 editing using the Select tool. It avoids Alt mouse gestures that some Wayland desktops/window managers intercept.

Tab switches only in the canvas editing mode, with no control focused or property window open. In settings and text fields it retains normal keyboard navigation; Shift+Tab is unchanged. Holding Tab does not repeatedly toggle, and active drags keep their mode. No crop or mask values change just by switching.

You can also hold Alt (Option on macOS) with the Select tool to temporarily show and edit the mask instead. Release Alt to return to crop; mask changes are kept. No properties window opens. If you release Alt during a drag, the mask guide stays active until that drag ends. Alt alone does nothing outside crop mode and still zooms out with the Zoom tool. Some Linux window managers reserve Alt + mouse gestures; use the context menu if the desktop intercepts it. The magenta rectangle reveals the image; outside pixels are blanked transparently in normal viewing and output. While editing the selected layer’s crop or mask, the masked portions inside the layer instead show a 25%-opacity source guide with sparse magenta diagonal hatching. This keeps hidden content readable and distinguishes masking from the ordinary faded crop overflow outside the layer. The hatching and masked-content guide disappear when editing ends; they are never exported or sent to the device. It works with normal crop and every advanced fit.

  • Drag a side or corner independently to blank more or fewer pixels.
  • Drag anywhere inside the layer to move the reveal window without resizing it.
  • Arrow keys move one output pixel; Shift+arrows move ten.
  • Enter Left/Right/Top/Bottom distances in output pixels.
  • The alignment menu aligns the mask window to the selected reference’s edges or center.
  • Center mask preserves its size; Reset mask removes all blanking.
  • Enter opens crop editing for the selected editable layer, just like double-click. Press it again to finish crop/mask editing and keep the live changes. When typing in a numeric field, Enter confirms that value first; press Enter again after leaving the field to finish. Other unapplied properties use the existing Apply/Discard review, so finishing cannot silently discard them.
  • Undo restores a complete drag; Escape cancels the active drag.

Opposite edges can meet to blank the whole layer, and remain draggable afterwards. Masking never modifies the crop, fit, image scale or layer bounds. Blank areas reveal lower layers. A mask over already cropped or transparent pixels has no visible effect. Mask proportions stay relative to the selected reference. Project files and embedded snapshots retain masks; plain geometry exports omit them. Midra and Aquilon load/send support the resulting blanking for either mode. Device loads return a layer-relative mask because devices do not store the editor’s source reference. Aquilon supports rectangular blanking with Centered framing; its explicit fit and Cut & Fill modes are separate limitations. Sending a zero mask clears destination blanking in the reviewed transfer.

The left mask edge blanks part of the picture without resizing the gold layer box. The header still uses the former Midra Layout name.

Content ratio versus Transform to

The Midra 4K v3.1 manual, §10.2.6.1, page 65 distinguishes two input corrections:

  • Content ratio interprets the source’s intended proportions, including non-square pixels. Native is the normal choice. Its fixed presets are 5:4, 4:3, 16:10, 15:9, 16:9, 21:9, 256:135 and 64:27; this selector has no Custom.
  • Transform to sets the final ratio presented to layers. Signal Aspect Ratio keeps the signal ratio; alternatives include fixed ratios and Custom.
  • Layer fill option is separate: it controls fitting when a layer inherits input settings. Canvas Pilot uses explicit layer fitting instead.

These are input-level corrections shared by every layer using the input, not layer cropping or masking. They can correct stretched content, but an arbitrary ratio can also introduce distortion. Leave Native / Signal Aspect Ratio unless correction is intentional.

Canvas Pilot exposes both device selectors in Input settings…, with Custom ratio displayed as 0.250–10.000:1 and encoded in thousandths. They are staged device controls, not persistent local image deformation. Merely opening the controls never writes. A local source resolution is a separate quantity and should not be changed just to pretend a ratio correction occurred.

The manual establishes the purpose and scope, but does not give the exact corrected pixel dimensions, rounding or interaction with layer 1:1. A local preview model must distinguish sampled input pixels from corrected display proportions and avoid applying a correction twice when loading device-reported content dimensions. These details need evidence before claiming an exact device round trip.

Device input drafts are session-only; project snapshots omit them. Opening a file never changes an input.

Shared device input settings

Open Input settings… from the application menu, or Open shared input settings… in the layer’s Source tab. Choose a physical input independently of editor layer selection. On Aquilon, Read input settings loads that input’s additional controls without downloading the complete device store.

This edits preprocessing shared by every consumer of that input, including Program and layers outside the project. Nothing is sent while dragging, selecting an input, capturing an image or opening the window. Use Send changes above the editor to apply the edited fields directly, with fresh device validation and verified readback.

The input selector, Send changes, pending-change count and undo/discard/reload controls stay above the scrolling editor. The larger Input crop workspace contains its own protection toggle and live-capture control. Expand Crop values & presets for exact edge values. Use the Input processing category picker for Aspect, Color, Processing, Keying or LUT; only available categories appear. Narrow windows stack processing below the crop workspace. Send changes is highlighted when changes are pending; sending remains an explicit action.

  • Keep device values: each category has this toggle. Check it to discard that category’s draft edits, disable its controls and leave it untouched when sending. Crop protection prevents crop edits, but wheel zoom, middle-drag panning, View zoom and Fit view remain available. These only change your view; the captured picture and sizing grid remain at full opacity. Uncheck to edit again. All categories start protected. Uncheck only the categories you want to edit; unchanged fields are never sent. Protection is retained when discarding edits, and all categories return to protected when reloading the input.
  • Input crop: drag edges/corners or move the retained box. Crop zoom reduces or expands the retained region around the selected pivot using the − slider + percentage control. The slider spans 100–500%; click its numeric value to enter a percentage beyond that range, within device limits. 100% clears all crop edges exactly. This does not add a second zoom stage. Numeric edges use native device crop coordinates.
  • View zoom: changes only the editor view; wheel zooms and middle drag pans. Reset crop, Undo input edit and Escape during a drag help recover an edit.
  • Aspect, Color and Processing expose adapter-specific settings. Keying and LUT controls appear only when supported/available. Resource allocation, signal negotiation and HDCP remain in WebRCS.
  • Capture input (live): refreshes while enabled and this window is open, using the same interval as automatic layer previews (10 seconds by default, at least 5 seconds). Matching input requests share a capture. Closing the window or switching the toggle off stops its refresh requests. Captured pixels appear directly inside the device’s captured crop region; unknown pixels retain the sizing grid. Moving the draft crop never moves or stretches those pixels. After Send, the old capture is cleared while settings are applied and verified; Refreshing capture… remains until a new capture arrives. Unverified capture geometry shows the grid rather than a distorted image. Midra’s already-cropped PNG and Aquilon’s full-frame thumbnail are handled separately, avoiding a second crop. No raw/pre-crop endpoint is confirmed.

Drafts are session-only and are not included in projects or exports. Switching inputs retains their drafts; changing connection discards them. Reload selected input replaces its draft with device values. If another controller, signal or plug changes, refresh and review before sending. After changing input geometry, reload its affected layers before sending their layout.

Current Aquilon limitation: framing transfers still reject inputs with active shared crop or aspect correction. The input editor can edit those settings, but reloading does not bypass that restriction. Correct conversion of those processed inputs remains pending; the removal of local pre-crop does not claim that support.

The old local source pre-crop model and saved input proposals have been removed. Projects retain processed source dimensions and independent layer framing; legacy native projects can be opened with a reported best-effort recovery.

Enabling Enable input preview in the right-click menu or Preview properties requests a fresh still for the configured input immediately. It does not enable recurring auto-refresh. A capture already in progress or the five-second request cooldown can defer that request; no device request is made for a local picture or when no capture input is configured.

Captured picture proportions

Input captures and local reference pictures fit centered inside the source format without changing their ratio. Midra captures already include the input crop; they are not stretched back to the uncropped signal size. The layer’s crop, zoom, fit and mask then apply normally. Centered (fit) preserves proportions; Fullscreen (stretch) still deliberately stretches. This preview does not change source dimensions or device input settings.

Switching to a different input size

Selecting a physical input in Source properties or a different capture input in Preview adapts that layer’s source dimensions to the valid signal. Its position and outer size stay fixed. Normal crop mode retains zoom and normalized focus (clamped at the new image edges); advanced fit retains proportional crop edges. Other layers keep their source dimensions, even if they previously shared the same editor source. Undo restores the previous framing. Input routing remains opt-in through Change input, applied only on Send.

Explicit input-switch sends also adapt framing when a saved source size differs. Midra inputs with applied crop are supported once crop controls and processed image dimensions agree. Input crop is already included in those dimensions; layer crop and fit apply afterward. Input aspect correction and Aquilon shared input crop retain their existing transfer restrictions.

All manuals

Import, export and project files

Canvas Pilot · Guide contents · Starter files

Choosing an exchange format? See the file and clipboard feature matrix for naming, crop, pictures and editable-settings support.

The toolbar has adjacent Import (arrow into a box) and Export (arrow out of a box) icons. They open the same import/export menus available from Menu; opening a menu does not read or write device values. Hover for the label, or turn on toolbar icon names in Options.

Recovering a partly readable project

Open project attempts to recover usable layers and valid settings from recognized Canvas Pilot JSON. A report lists skipped or reset content. Repaired documents open as unsaved copies: inspect them and use Save as to choose a new filename. The original is unchanged. Invalid JSON, unsupported future versions or files without usable layers cannot be recovered this way; your current work remains open.

Older local input pre-crops and inactive device-input proposals are no longer supported. Recovery discards them with a warning, so appearance may change. Use shared Input settings… for device preprocessing, then reload affected layers. Layer crop, fit and masks remain project settings.

PDF pages and documents as reference pictures

Choose Add reference images from the reference list or Import menu, then select a picture or supported document. For documents, choose Artwork (when available) or Layout boxes, select the page/slide/frame and resolution, inspect the preview, and click Add reference. Repeat to add another page. Closing the dialog leaves the document unchanged. PDF drops open this dialog directly; other exchange files normally open geometry review, unless the Reference image window is open.

SourceArtwork reference
PDFBuilt-in page rendering; no external application required
SVGBuilt-in rendering of artwork, text and embedded images
PPTXSlides converted locally by an installed LibreOffice
draw.io / XMLPages converted locally by an installed draw.io Desktop
FIG / FIGCRAFTBuilt-in FigCraft artwork rendering in the normal build; best effort for native FIG
IllustratorArtboards converted by the existing optional VectorCraft CLI
Geometry JSON / Canvas Pilot HTMLLayout artwork including embedded PNG images; HTML uses the exchange data, not custom CSS/scripts
CSV / DXF / DWGLayout boxes from supported geometry, with labels; not a full CAD drawing renderer

Layout boxes is available for every compiled geometry importer. It draws the detected rectangles and their labels, fitted to their bounds; it does not reproduce original artwork. This is useful when a converter is unavailable. For a faithful reference from an unsupported drawing feature, export PDF or SVG from its editor.

PDF pages render on a white background; SVG transparency is retained. References preserve proportions by default and contain the rendered PNG, so saving and reopening a project needs neither the source document nor its converter. These are static pictures, without editable text, automatic layer detection or playback.

The default longest edge is 1920 px; choose up to 4096 px for detailed artwork. Input files are limited to 64 MiB, PDFs to 256 pages, and the existing 32-reference / 64 MiB combined image limits still apply. Render only the pages you need. Export an unlocked copy of password-protected PDFs. Inspect font substitutions and complex PDF effects in the preview; SVG external linked images are omitted.

For PPTX conversion, install LibreOffice and put libreoffice (soffice.exe on Windows) on PATH, or set CANVAS_PILOT_LIBREOFFICE to the executable. For draw.io, use drawio (draw.io.exe on Windows) or CANVAS_PILOT_DRAWIO. Executables beside Canvas Pilot or in its bin/ folder are also found. On macOS, the executable may be inside the installed application’s Contents/MacOS/ directory. Conversion uses temporary copies and has a 60-second timeout; source files are never overwritten. These converters are optional and are not bundled. At startup Canvas Pilot looks for executable files using the configured environment override, its own folder and bin/, PATH, and common macOS/Windows installation folders. An invalid explicit override is reported rather than silently using another installation. Discovery does not launch the applications or verify their versions. The same detected path is used for conversion; runtime failures are still reported.

Open Application menu → Software integrations… to see each tool, its status, path and the features it enables. Missing integrations remain listed there for setup, but their unavailable actions are hidden: PPTX/draw.io references default to Layout boxes without an Artwork choice, and Illustrator is omitted from file filters and export choices when VectorCraft is missing. Built-in geometry import and export remain available for PPTX/draw.io. Restart Canvas Pilot after installing software or changing an override; discovery is a session snapshot, not a live connection. No executable paths are saved in the project.

Draw.io Desktop may require a graphical desktop session. The existing VectorCraft setup is described below.

Paste layer values and import geometry

Check the clipboard feature matrix 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 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 and PDF drops open as references. While the Reference image window is open, supported document drops also open as references instead of layer geometry. Multiple geometry files appear in the File / page / frame / slide chooser; choose one document/page to map at a time. Reading runs in the background, and nothing changes in the layout until Apply. The entire geometry drop is limited to 16 MiB; a failed document leaves the batch unapplied and reports its filename.

  1. Copy layer values or geometry and use Import → Clipboard values or Ctrl/Cmd-V with the viewport focused. Alternatively use Import → Geometry file… or drop a supported file. These entry points share one mapping review. If entering text manually, paste it and click Review pasted values.
  2. Once geometry is detected, the review only shows the loaded data, mapping and import options. Clipboard data is a collapsed, read-only preview; there are no additional file/paste buttons inside the review. Multiple documents/pages retain their page chooser.
  3. Under Destination layers, choose All layers, Selected layers, or Folder: …. Imports try exact included-item counts against the selection, then all available layers in its shared folder, then all available layers. Background items and hidden/locked destinations do not count. Selections spanning folders skip the folder fallback. Matches map in layer order; review before applying. If no count matches, the initial scope remains available for manual mapping. Choosing a scope manually disables automatic scope changes for that review. Changing the scope never changes canvas selection and preserves mappings still in scope. Hidden/locked layers are excluded. Each source item has a prominent destination dropdown and collapsed Geometry · before / after details. Uncheck Include item to skip an item. Each included item must map to a different destination; fewer source items than destinations are fine. Duplicate or missing mappings block import. Other layers stay unchanged.
  4. Choose Format (width / height) and Position independently. For Canvas Pilot copies, expand Appearance to choose Crop & fit and Blanking; the collapsed heading shows what will be applied. Legacy text offers Crop zoom when present. Available values start enabled. Unchecked values retain destination settings; resizing may adjust its existing crop. Outline bounds are offered only when the source includes an outline. At least one available geometry, appearance or name value must be enabled.
  5. Click Import mapped values to update the mapped layers in one undo step. Cancel leaves all layers unchanged. Invalid geometry blocks the whole batch, without partial changes.

The workspace supports 1–256 layers; the import review handles all selected layers rather than choosing one rectangle from a larger clipboard selection.

Rename destination layers

Enable Rename destination layers in the mapping review to use names from the copied or imported shapes. It starts unchecked and appears only when included items have names. The review shows each proposed name. To rename only, uncheck Position, Format and any appearance options. Unnamed items keep their current names; folders, layer IDs, stacking order and device links remain unchanged. Names must contain 1–128 characters. An invalid name blocks the whole operation; renaming and geometry/appearance changes undo together.

SourceNames used when available
Canvas Pilot clipboardActual layer name, without the displayed ID prefix; new copies only
SVG, including Figma/Illustrator SVG textInkscape label, shape title, data-name, then explicit SVG ID; nearest named group if the shape has none
draw.io XMLCell label; supported well-formed HTML labels are reduced to plain text
Geometry JSON / CSVname field
HTML geometrydata-name attribute
PowerPointShape name
Figma / FigCraft fileNode name
DXF / DWGCAD layer description, otherwise CAD layer name
Illustrator fileNames retained by its SVG conversion

An editor may omit names or emit generated SVG IDs. Review the proposed names before applying them. Canvas Pilot never turns its own generated review labels (such as “rect 1”) into names. Draw.io-rendered SVG cell IDs and older Canvas Pilot clipboard labels are not treated as source names. File names and document titles are not layer names. This works within the existing supported geometry profiles; it does not add support for arbitrary artwork.

Canvas Pilot layer clipboard

Copy layer values preserves exact geometry, crop edges and offsets, all fit modes and blanking masks. The clipboard still begins with readable values; an appended versioned payload holds the exact data. Editing only the readable summary does not change what Canvas Pilot pastes.

To copy only appearance, uncheck Position and Format. Expand Appearance to choose Crop & fit, Blanking, or both. Source assignments, device mappings and input settings stay unchanged. Crop edges adapt proportionally to the destination input dimensions. The destination layer’s Advanced fit stays selected; the copied fit mode does not replace it. A normal crop that does not match the destination box uses Centered (fit), preserving ratio without stretching. You do not need to match source dimensions or include Format. Blanking works independently of source dimensions. A failed batch changes nothing; a successful paste undoes in one step.

Older normal-crop text remains supported, with its optional zoom. It cannot supply missing offsets or masks. The new full payload needs a current Canvas Pilot version; use a project or snapshot for references, inputs and other document state. See the clipboard contract and example.

SVG bounds

SVG import accepts square-corner rectangles and simple closed rectangular paths/polygons, including translated/scaled groups and inline styles. It applies page dimensions and viewBox transforms, using CSS units at 96 px/in. Coordinates are relative to the SVG page; exporting only a selection may lose its original document position. This geometry-import action uses bounds. For the complete SVG artwork, use Add reference images instead.

A first full-page rectangle or image is marked as a possible background. Uncheck Include full-page background to exclude it from the count and mapping. This is explicit: a full-page rectangle can also be a real layer. Image backgrounds must be excluded; their contents and external links are never loaded.

Midra SVG v2 placeholder images import as one layer box each; their image content is not decoded. Other visible artwork, rotation/skew, rounded rectangles, clipping, masks, filters, stylesheets, and unsupported SVG features are refused with an error. Hidden objects and definitions are ignored. Export simple rectangles with inline styles for predictable results. Files are limited to 16 MiB, 256 rectangles plus an optional background, and 64 levels of nesting. SVG imports retain the same outline and position-only choices as draw.io imports.

Clipboard detection and fallback

Paste examines the text supplied by the clipboard. Unrecognized text is not assumed to be draw.io XML. For well-formed HTML supplied as text, it tries a single embedded draw.io document, then a single embedded SVG if the first candidate fails. The review identifies the chosen representation and any rejected candidates. Only the embedded drawing’s coordinates are imported; surrounding HTML layout and CSS are not. Multiple drawings of the same format require exporting a single file.

This does not enumerate native operating-system clipboard formats. PowerPoint objects copied inside PowerPoint remain unsupported; use Import geometry with the .pptx file. Invalid Canvas Pilot data keeps its specific error rather than silently dropping settings in a fallback.

Figma SVG clipboard text

The supplied Figma SVG sample works through the existing SVG/value paste parser: two 640 × 360 rectangular paths at (0, 0) and (1040, 0), including their matrix translations and order. Paste SVG text and review the detected shapes in the mapping dialog. Figma copy/paste was manually reviewed on 2026-11-15. This validates the tested SVG workflow, not every native binary/HTML clipboard format.

Illustrator SVG clipboard text

The supplied Illustrator SVG sample works through the existing SVG/value paste parser. Its two 1814.174 × 1020.473 rectangles retain fractional positions (0.354, 0.354) and (395.791, 461.357). Enabling outline inclusion adds the centered 0.709-unit stroke to their bounds, producing 1814.883 × 1021.182 boxes. Stroke colors are not imported as artwork through this geometry workflow. Illustrator copy/paste was manually reviewed on 2026-11-15; other native clipboard formats are outside this validation.

For QCAD and PowerPoint, use file exchange; no clipboard-export integration is planned for these workflows.

draw.io clipboard

The draw.io adapter accepts single-page .drawio/.xml files (including native compression) and raw or once-percent-encoded mxGraphModel clipboard XML, like the supplied clipboard fixture. Draw.io coordinates map 1:1 to screen pixels, with a top-left origin. This is an explicit import convention; no page-scale, physical-unit or viewport-size conversion is inferred. Missing X/Y means zero. Decimal dimensions are preserved.

The supplied example imports X 12, Y 271, width 945, height 531.58. The center is 484.5, 536.79. The visible box has its exact imported ratio; it is not rounded or coerced into a 16:9 preset. “Format” here means the visible rectangle’s width, height and aspect, not native source format or advanced cropping.

Include outline in bounds is off by default on each paste. For an outline of width s, enabling it subtracts s/2 from X and Y and adds s to width and height, preserving the center. This follows the half-stroke expansion in mxGraph’s bounding-box calculation. Your sample’s 5 px outline gives 950 × 536.58 at (9.5, 268.5). Only the bounds are imported; no border is drawn or configured on the device.

The option is disabled for position-only paste: that mode uses the original geometry’s top-left and keeps the target layer’s dimensions. Zero-width, strokeColor=none/transparent, zero stroke opacity and zero overall opacity produce no outline expansion. A missing width uses the standard 1 px default; the detected width is shown in the preview. Each rectangle in a multi-object paste uses its own width. Shadows, sketch effects and raster antialiasing fringes are not included. Invalid thickness/opacity values or bounds beyond the application limits are rejected without changing the document.

The adapter otherwise ignores colors, text, style aspect locks and other appearance settings. It currently rejects grouped/nested geometry, connections, nonrectangular shapes, relative coordinates, alternate bounds, rotated/flipped objects, named/inherited styles, wrapped objects and compressed .drawio files. Mixed selections containing unsupported objects are rejected as a whole. Invalid input makes no document changes. Text is limited to 16 MiB; geometry must have finite coordinates within ±1,000,000 px and positive sizes up to 1,000,000 px. These are application limits, not verified Eikos limits.

Draw.io also exposes raw page XML through Extras → Edit Diagram, as described in its source-editing documentation. Support is covered by the supplied clipboard data and regression fixtures. Draw.io copy/paste was manually reviewed on 2026-11-15.

Save, open and export

Use the Project toolbar menu to Save project… or Open project…. Save project… suggests a .pilot.json name. Open project… lets you try any .json file, including legacy .midra.json projects; the contents must be a valid Canvas Pilot project. Existing files are not renamed automatically.

Projects use readable, versioned .pilot.json files and preserve applied output, inputs, layer bounds/crops, source assignments, locks, visibility, selection, viewport preferences, and all embedded reference images. Apply pending edits before saving. Opening asks before replacing current work and starts a fresh undo history. Existing files require confirmation before replacement.

The starter-file catalog contains all eleven exchange formats, with two layers for 1920 × 1080 and 3840 × 2160 canvases.

Menu → Export → Export layers… opens one shared window:

  1. Choose the Format.
  2. Choose Layers: Selected layers, All layers, Visible layers only, or Specific layer. With Selected layers, Choose layers… lets you adjust the selection.
  3. Click Export… and choose a file. The layer count previews the scope; selecting one layer keeps its original screen position and full-screen canvas.

Optional groups start collapsed. Pictures contains Include background layer and Include placeholder pictures. Their heading shows what is included even when collapsed. CSV and DXF offer only a background rectangle, with no picture controls. Canvas Pilot settings contains the optional editable snapshot; its heading also shows whether inclusion is enabled. For everyday geometry exchange, leave both groups at their defaults.

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. 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; placeholder images each count as one layer. draw.io files saved with compression are supported. SVG rendered by draw.io Desktop is recognized through its retained cell IDs; generated HTML labels and raster text fallbacks are ignored. Draw.io may crop and rebase that SVG unless the exported diagram includes the background layer. These exports round-trip whole-pixel visible-box geometry, not source/crop settings; the separate .pilot.json project format preserves the full project. See the geometry exchange contract and native draw.io checks and project save contract.

Visual crop mode also provides Reset crop beside Done adjusting crop in layer properties. It restores 100% content zoom and centered offsets, keeps the visible box and processed source dimensions unchanged, and leaves visual editing active. The reset is undoable.

The toolbar’s Viewport options cog contains Keep aspect ratio when resizing and Show source patterns on other layers while cropping. Both apply immediately and are preserved in saved projects. Crop editing always previews source content and keeps its proportions, independently of these layer/view preferences.

The toolbar’s Import button uses a downward arrow into a tray. Hover for its label; its dropdown contains SVG, clipboard values, and reference-image actions.

Choose a format, artwork options and which layers to export in one window. The header still uses the former Midra Layout name.

Choose layers inside import and export menus

You can choose layers without returning to the viewport:

  • Import → Choose destination layers…, and the same picker inside the geometry review, select the destinations. Paste and file import can open with nothing selected: map each detected rectangle directly to an available layer using its destination dropdown. When using a selection, there must be at least as many chosen destinations as imported rectangles after ignoring a background. Map to any subset of them; other layers stay unchanged. Duplicate mappings and empty imports remain invalid.
  • In Export layers, choose Selected layers and use Choose layers… to select the group. Specific layer remains available for individual layers, including hidden layers.
  • Midra send preparation has Choose editor layers to send…, followed by a device-destination dropdown for each chosen layer. It can open online with nothing selected. Sending requires explicit review and clicking Send mapped layers.
  • Midra import retains its independent per-device-layer destinations, including New layer and Do not import.

The shared pickers update the viewport selection. Hidden/locked layers are labeled and disabled in these pickers; choosing layers changes no geometry. Full project save/load and screen reference images are document-wide operations, so they have no layer mapping.

Midra mapping & transfer…, beside ONLINE/OFFLINE and in Export, opens the Midra export configuration without sending, even when layers already have saved links. Choose layers, destination mappings, Preview/Program and sizing, then click Send mapped layers to send. The action is disabled offline or during transfers. Sending writes geometry, pulses the WebRCS preset-update command, and verifies geometry readback. Only applied editor values are sent.

Layer rows use padlock and eye icon buttons for locking and visibility, with tooltips and highlighted locked/hidden states. Double-click a layer name in the right-hand list to rename it. Enter saves, Escape or Cancel discards the edit; names must contain 1–128 characters. Renaming preserves the layer ID and folder and supports Undo.

Hold Shift while moving or resizing layers to snap to a 10 px grid; Ctrl+Shift uses a 100 px grid. A matching selected grid tool is temporarily disabled instead; a different shortcut temporarily switches grid size. These grids override ordinary pixel/edge snapping, even when snapping is disabled in Settings. Alt overrides both grids and temporarily inverts ordinary snapping. The modifier state on release determines the final position. Grid coordinates are screen pixels measured from the screen’s top-left, independent of viewport zoom. Group movement snaps the selection’s bounding top-left and keeps relative spacing. Resize snapping keeps opposite anchors and group proportions; free corners snap both axes, while ratio-locked corners snap one driving axis. Cyan guides mark reached grid lines. Numeric entry, crop-content gestures and camera panning are unaffected. Shift-click still toggles selection; Shift-drag on a layer moves it on the grid, and Shift-drag on empty canvas adds a selection box. This replaces the previous Shift-to-invert-resize-snapping shortcut.

With snapping and layer-edge snapping enabled, resizing in Mirror mode snaps the two moving inner edges into exact contact, including unequal-sized layers. Opposite mode also supports vertical contact. A guide marks the meeting edge; anchors and aspect-ratio settings are preserved. Move beyond the snap radius to continue resizing, or hold Alt to temporarily invert snapping. Shift/Ctrl+Shift grid overrides remain.

Midra layer lists omit unassigned source slots (NONE or empty). Assigned inputs remain listed even if the layer is off. The exporter defaults to Preview and hides Program until Settings → Midra integration → Allow sending to Program is checked. This preference is saved automatically; turning it off returns the exporter and quick Apply action to Preview.

Destination choices in Midra mapping & transfer… now save immediately on the editor layer and support Undo. Save the project JSON to keep links across sessions. Links include screen and layer IDs and survive refreshes and selection changes. Choose the empty destination on the linked screen to unlink. The direct send button is available beside Midra mapping & transfer and in Export; in All layers scope it includes unselected, hidden and locked linked layers, grouped by screen. Its label changes to Send selected links or Send folder links in those scopes. Midra mapping & transfer… opens mapping configuration for the current scope. Preview/Program and sizing still use the current export options.

Every explicit layer-layout send includes WebRCS’s preset apply pulse (xUpdate false → true). This applies staged geometry when automatic updates are disabled, including a repeat send where WebRCS already shows the desired values.

Send all linked layers sends immediately using saved links and the current target and sizing settings, without opening the export window. The button shows progress and its tooltip reports completion. Invalid links or send failures open the export window with the error.

Load linked layers, beside the connection status and in Export, reads fresh Midra Preview geometry and crop framing into linked editor layers in the shared transfer scope. The default All layers ignores canvas selection; Only selected layers and Folder: … explicitly restrict the operation. The load button inside Midra mapping & transfer… uses that same scope and the saved links. Both actions are read-only on the device and always load Preview (independent of the send target). They do not recall device memories or presets. Loading is one atomic Undo step; links remain saved. Missing screens/layers, mismatched output resolutions, unsupported geometry, and hidden or locked editor destinations reject the complete import without changing the document. Unlock/show destinations before loading. Results appear in the transfer window or the load button’s status tooltip. No project or settings schema changes are involved.

Midra destinations are identified by the pair screen ID + layer ID: Screen 1 Layer 1 and Screen 2 Layer 1 are distinct links. Both IDs are already persisted in project version 5; no schema change is needed. Opening Midra mapping & transfer… or Midra mapping & transfer… restores the first scoped layer’s available linked screen. Destination choices display both IDs. Browsing another screen does not retarget existing links; choosing a destination there explicitly replaces that layer’s saved link. Direct send/load actions use each layer’s saved screen, independently of the screen currently displayed in the configuration window.

Recovery autosave and New project

Applied edits and reference images are checkpointed to last_project.json beside the application settings, at most every two seconds between gestures and again on normal exit. The last session resumes automatically on launch without an Open dialog. Unchanged snapshots are not rewritten. Named project files remain explicit saves (measurement-point autosave still updates its two fields).

Project → New project… starts the default layout after confirmation. The warning shows the last recorded manual-save age; autosave does not count. Choose Save and create new…, Discard and create new, or Cancel. Cancelling a save or a failed save keeps the current project. Opening another project also replaces the recovery copy, so save a named copy when you want to keep multiple projects.

Recovery contains applied project values, not undo history or unfinished text, Source/import drafts. A crash can lose edits since the last checkpoint; normal exit cancels unfinished canvas gestures. Successful restoration is silent. Recovery failures still display an actionable message. Project-menu status shows the recovery path and failures. A corrupt/unsupported recovery file is preserved with autosave paused; Retry recovery attempts to load it again. For a write failure, Retry attempts to save again. New project explicitly replaces the recovery copy.

See the recovery file contract.

Right-click a layer in the viewport for Rename layer… / Delete layer alongside the existing tools. Layer-list rows have a compact menu with just those two actions. Actions target the clicked layer; deletion supports Undo and requires a visible, unlocked layer with at least one other layer remaining.

In Layer properties → Crop, X/Y offsets are constrained to the valid range for the current zoom, input dimensions and visible box. Typing or dragging beyond an edge stops at that edge; reducing zoom clamps existing offsets to the new bounds. An axis with no spare content stays at zero. These adjustments apply immediately and support Undo without an offset-range error.

The tiled source pattern is hidden during normal layout editing, including when loading saved projects/settings with source-pattern display enabled. Double-click a layer or open its Crop properties to show its pattern and faded cropped overflow; leaving crop editing hides them again. Show source patterns on other layers while cropping optionally displays patterns on the other layers during that mode only (except outline-only layers).

What the project saves

Project JSON includes processed source formats, layer crops, geometry, layer ordering, folders, visibility/locking, pivots, Midra links, reference images, selection, viewport and positioning settings. It also saves snapping/grid settings, group resize mode, collapsed folders, capture input assignments, the last captured stills, guide opacity and refresh settings. Saved stills work offline; automatic refresh resumes when the matching device is connected and snapshots are available.

Connection history, startup connection, theme and Program permission remain in application preferences. Unsaved drafts, undo history, open menus, active editing gestures and pending device operations are temporary. Transfer scope, target bank, sizing strategy and shared input-window drafts remain session choices. Legacy input proposals and local pre-crops are no longer saved. See saved input corrections. See the complete persistence audit and versioned project contract.

Extra settings inside artwork exports

See which editing features survive for a comparison of project saves, plain geometry import and snapshot restoration.

In Export layers, expand Canvas Pilot settings and enable Include extra Canvas Pilot parameters (experimental) to store the exported layers’ source/crop settings, fit modes, masks, 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 Illustrator show why the option is unavailable with the current codecs.

Use Project → Restore parameters from export… to restore that original snapshot as an unsaved project. This replaces the current editor document after review, and never overwrites the artwork with a project file. To import changes made in another program, continue to use Import → Geometry file…: the embedded snapshot can be older than the artwork, so it is never applied automatically. Other programs may remove the extra data when resaving. Save project remains the complete save, including reference images and captured previews.

See the format-by-format audit and metadata contract.

Which editing features survive?

See the advanced feature matrix for complete project, snapshot and geometry-only preservation, including input corrections.

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. 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 Illustrator support. Installing a converter does not re-enable formats excluded from that build.

Obtain VectorCraft CLI from the VectorCraft project. Midra searches in this order:

  1. The executable path set in MIDRA_VECTORCRAFT_CLI.
  2. vectorcraft-cli beside the Canvas Pilot executable.
  3. vectorcraft-cli in the adjacent bin/ folder.
  4. vectorcraft-cli on PATH.

On Windows the executable is named vectorcraft-cli.exe. For an explicit location, start Midra from the same terminal in which you set the variable:

MIDRA_VECTORCRAFT_CLI=/absolute/path/to/vectorcraft-cli canvas-pilot
$env:MIDRA_VECTORCRAFT_CLI = 'C:\Tools\VectorCraft\vectorcraft-cli.exe'
.\canvas-pilot.exe

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. Illustrator choices appear only when VectorCraft was detected at startup. A converter that subsequently disappears or fails produces an error without changing the project. See Software integrations… for detection and setup. Use SVG if you do not want to install or configure the converter.

Illustrator exchanges layer geometry and optional artwork, not the complete editor project. Use a .pilot.json project to preserve all settings. See the Illustrator format contract and round-trip checks.

All manuals

Menus and preferences

Canvas Pilot · Guide contents · Starter files

Application menu

The header’s Menu brings the application’s commands together:

  • Open all settings…: the full preferences window.
  • Project: new/open/save projects and restore parameters from exports.
  • Export: device mapping/transfers and the file export window.
  • Import: SVG, clipboard layer values, and reference images.
  • Edit: undo/redo, copy values, select all editable layers, or deselect.
  • View: fit screen/selection, 1:1 pixels, output format, and reference settings.
  • Layers: selected-layer properties, crop/reset, alignment, shared resizing, lock/hide, and per-layer selection/visibility/lock controls.
  • Options: quick controls for snapping, backdrop, theme, outlines, toolbar captions, resize aspect ratio and the source-coordinate preview. The full settings shortcut stays at the top of Menu, rather than repeating here.

The toolbar, cog and right-click shortcuts use the same commands and preferences. The standalone cog also provides Open all settings… above its quick controls. Project no longer repeats Export or device transfers. Selected-layer actions in Menu contain layer editing only; workspace controls remain under View and Options. The canvas right-click menu keeps its Canvas group for access beside the pointer. Detailed numeric controls remain in their existing properties dialogs.

Enable Options → Show toolbar icon names (also available from the toolbar cog) to display captions beneath the icons. It is off by default and saved with the project; older projects open with captions off.

Interface language

Open Menu → Open all settings… and use Language / Langue at the top. Each language shows its native name followed by its name in the current interface language, for example English — Anglais in French. Choose System default, English, Français, 日本語, 简体中文, Español, Português (Portugal), नेपाली (Nepali), ไทย (Thai), हिन्दी (Hindi), toki pona, Ἑλληνικὴ ἀρχαία (Ancient Greek), or Esperanto. The change takes effect immediately as a preview. Choose Yes within 20 seconds to save it for future launches. The cancellation button uses your previous language; clicking it, pressing Escape or letting the countdown expire restores that language. Closing the app without confirming also leaves the previous saved choice intact. In French, the route is Menu → Ouvrir tous les réglages…; language names stay recognizable in either UI.

System default follows supported system languages, with English fallback. Chinese uses Simplified Chinese; Traditional Chinese system locales fall back to English. Portuguese uses European Portuguese; Brazilian system locales fall back to English. Toki Pona uses Latin spelling. English is the official reference language. French interface terminology has been accepted; the other translations remain unverified machine translations. Some explanatory text, advanced controls and technical diagnostics remain in English, as do device control names. Built-in open fonts cover Japanese, Chinese, Devanagari, Thai, Latin text and polytonic Greek without installing fonts separately. Files & settings → Font licenses contains their license.

Nepali and Hindi conjuncts and vowel placement, and Thai stacked marks, use native text shaping. These remain preview languages: Thai wrapping has no guaranteed dictionary-based word boundaries, and the End key can place the caret past the text for Thai characters such as ำ that expand into several glyphs. For those names, avoid relying on End followed by Backspace; select the whole field to replace it. This limitation concerns text editing, not interface labels.

Use Settings → Language packs to install/update ZIP packs, view their revisions and languages, or remove them. Newer revisions update immediately; equal or older revisions ask before overwriting. Removal asks for confirmation. See Add a language pack for the Ukrainian/Bhojpuri example and instructions for writing a translation. Installed languages appear below the built-in choices and use the same confirmation.

The book’s French quick start now follows the accepted French interface wording and uses French screenshots. It records its machine-translation origin and links to the English manual as the authoritative source.

Changing language preserves the open project, pending edits and device connections. It does not rename layers, change file contents or send device commands. Numeric fields continue to use a decimal point in every language. Projects do not carry language preferences to another workstation.

Interface size and high contrast

Open Menu → Open all settings… → Appearance:

  • Interface scale: resize the entire interface from 50% to 400%, on top of the operating system’s display scale. This also scales icons and hit targets.
  • Adjust text separately: optionally scale standard control text by an additional 50% to 200%. Canvas artwork and fixed-size labels follow interface scale only.
  • Use high contrast: select a black-based theme with white text, bright accents and stronger control borders. It also appears as High Contrast in the theme browser. Click it again while active to return to your previous theme. This also works in the recent-theme menu; if there is no previous theme, it returns to Midra Dark.

Scale values update while dragging, but resizing applies only after releasing the pointer. Typed values apply after finishing text entry. Preferences are remembered on this computer. Reset interface size, near the top of Settings, restores 100% and disables separate text scaling. Smaller scales free up space on low-resolution displays; larger scales support high-resolution monitors. These ranges do not depend on monitor resolution. The settings content scrolls at smaller window sizes. Larger windows provide more working space at high zoom. Project dimensions, exported artwork, clipboard data and device values stay unchanged; imported pictures retain their original colors.

Enlarged controls with High Contrast. Close and Reset interface size remain above the scrolling settings.

Application themes

Menu → Options → Theme (also in the toolbar cog) shows up to three recently used themes, newest first. More themes… opens the complete picker with color swatches: Midra Dark plus all 18 themes from the SOTV song-database theme folder. A fresh installation lists only Midra Dark until other themes are selected. Selecting a theme updates the UI and viewport immediately and saves the recent history across restarts. The picker stays open so you can try several themes; close it with its window close button when finished. Reusing a theme moves it to the top without duplicates. Closing the picker without choosing leaves the theme and history unchanged. Use Theme packs to install additional palettes; see Add a theme pack for Tokyo Night, Catppuccin, Detroit: Become Human and Vivid World examples.

The viewport, grid, layer boxes and source test patterns use the selected palette; selected layers use the palette’s selection accent. Imported reference images retain their colors. Theme and history survive opening projects and are not included in project JSON or geometry exports.

The SOTV palettes are bundled with the app from sotv/song_database/styles/themes/ in the sibling SOTV_Websites repository; Corporate Light uses styles/base/variables.css. No sibling repository is needed to build or run Canvas Pilot. See the theme catalog and settings contract for names, source files, stable IDs and palette adaptations.

Saved application options

Options save automatically when changed: theme, toolbar icon names, aspect-ratio lock and source-coordinate preview. No separate Apply or Save is needed. The directories crate selects the OS configuration directory. Canvas Pilot retains the former Midra Layout location so existing preferences and recovery remain available:

  • Linux: $XDG_CONFIG_HOME/midra-layout/settings.json, or ~/.config/midra-layout/settings.json when XDG_CONFIG_HOME is unset.
  • Windows: %APPDATA%\beffroi\midra-layout\config\settings.json.
  • macOS: ~/Library/Application Support/org.beffroi.midra-layout/settings.json.

Hover Options save automatically in Options to see the actual path. These are startup defaults. Existing project files still restore their saved aspect-ratio, caption and source-preview settings for the open document, without rewriting the application defaults. A subsequent explicit Options change saves the current set of options as the new defaults. Theme always remains an application preference.

Missing settings use defaults; the file is created on the first option change. Unreadable, malformed or unsupported settings use defaults and show an Options error; the original file is preserved and saving is disabled until the file is repaired or moved and the application restarted. Write failures keep options active in memory and offer Retry saving options. No project data, images or clipboard contents are stored here. The settings interface documents the file and compatibility rules.

Keep aspect ratio when resizing is also available below the position/size fields in the selected layer’s right panel and in the layer right-click menu (including multiple selections). These controls share the Options setting and save changes automatically. They do not apply or discard pending size/position edits. Crop zoom remains proportional.

Settings are grouped by purpose; appearance changes apply immediately. The header still uses the former Midra Layout name.

Settings window

Open Menu → Open all settings…, Options → Open all settings…, the toolbar cog’s Open all settings… entry, or Ctrl/Cmd+,. The window groups the available controls:

  • Appearance: themes, recent choices, icon captions and source-coordinate preview.
  • Theme packs: install/update ZIP palettes, try their themes and remove packs.
  • Editing: aspect-ratio lock, movement snapping and a keyboard/mouse reference.
  • Reference images: import and access to the current project’s image settings.
  • Files & settings: the settings-file path, copy-path action and restore defaults.
  • Midra integration: current offline status and compatibility limitations.

Changes apply and save immediately, sharing state with quick menus and inspector shortcuts. Close simply dismisses the window. Restore defaults resets preferences without altering geometry or pending position/size edits. Device controls are not presented as implemented until their mapping and transport are available.

Movement snapping

The viewport right-click menu and quick Options menu both include Snapping: enable movement/resizing snapping and choose pixel, screen or visible-layer edges. These are the same automatically saved controls as Settings → Editing.

Enable Settings → Editing → Snap movement & resizing and choose pixel, screen-edge and/or other-visible-layer-edge targets. Nearby edges show a guide; the proximity radius stays six logical pixels at any zoom. A selection moves as a rigid group. Hidden layers are ignored; visible locked layers can be targets. Hold Alt to temporarily invert snapping: off when enabled, on when disabled. Turning snapping on/off alone never moves layers. Exact numeric entry and nudges bypass proximity snapping; resize handles snap while preserving their anchors/ratios, and crop-content handles retain their existing behavior. One drag remains one undo step, with Escape to cancel.

All manuals

Add a language pack

Language packs add interface translations without rebuilding Canvas Pilot. English remains the reference language, and missing messages fall back to English. Packs do not translate project names, device responses or exported geometry.

Try the example

  1. Download language-pack.zip.
  2. In Canvas Pilot, open Menu → Open all settings….
  3. Choose Language packs, then click Install language pack… and select the ZIP. Leave it zipped.
  4. Open Language / Langue. The list now includes Українська — Ukrainian and भोजपुरी — Bhojpuri, below the built-in languages; scroll if needed.
  5. Select one and confirm within 20 seconds. Cancellation and the countdown still use your previous language. Confirmed choices survive restart.

The example provides 39 messages per language, including Settings, common controls, confirmation and a message with a substitution. It is an intentionally partial, unreviewed machine translation for teaching pack creation. The remaining interface stays English. Bhojpuri is identified as bho, separately from Hindi (hi), following the ISO language-code list. It demonstrates the same Devanagari font support used by Hindi.

These packs reuse the fonts already bundled with Canvas Pilot. Version 1 and 2 packs contain translations only: they neither install fonts nor reduce the current application download size. Ukrainian uses the existing Cyrillic coverage.

Installed packs appear in a compact, searchable list. Search by pack ID, language name, native name or locale code; Clear restores the full list. Each row shows the language count and revision, with a dot marking the pack currently in use. Only the selected pack’s contents are shown, beside the list on wide windows or below it on narrow windows. Both lists stay bounded and scroll independently.

Click a language in the selected pack to preview it with the same 20-second confirmation and rollback as the main language picker. Remove pack… stays above the contents and still asks for confirmation. Newly installed or updated packs are selected automatically. Search and selection remain separate from the theme manager and are remembered only during the session.

Make your own pack

Download these three editable example files into the same folder:

The manifest describes the pack and its languages:

{
  "version": 2,
  "id": "example-uk-bho",
  "revision": 1,
  "languages": [
    {"locale": "uk", "name": "Ukrainian", "native_name": "Українська"},
    {"locale": "bho", "name": "Bhojpuri", "native_name": "भोजपुरी"}
  ]
}

Each language has a UTF-8 JSON file named after its locale. Use a unique lowercase language identifier, such as uk, and a unique pack id. Display names are plain text; no markup is supported. For another language, change the identifiers, names and filenames together. New languages do not need a Rust enum entry or a rebuild.

Start with a few messages, then add more from the English source catalog. Copy keys exactly and translate only their values. Omit messages you have not translated. Do not copy the whole English catalog merely to appear complete.

{
  "ui.settings": "Налаштування",
  "ui.close": "Закрити",
  "theme.current": "Поточна тема: %{name}"
}

Keep placeholders such as %{name} and %{seconds} unchanged; their position in the sentence may change. JSON requires double quotes and no trailing commas. Save as UTF-8. The importer rejects unknown keys, empty values and mismatched placeholders. Built-in languages cannot be replaced by packs.

From the folder containing the three JSON files, create the ZIP with Python:

python3 -m zipfile -c language-pack.zip manifest.json uk.json bho.json

Or use an archive tool: select the files themselves, not their enclosing folder. The ZIP must contain only manifest.json and the declared language JSON files at its root. Install it through Settings, switch language, and check long labels, confirmation, fallback messages and text rendering. Ask fluent speakers to review translations before presenting a pack as ready for everyday use.

Storage, updates and removal

The installer copies the validated ZIP to language-packs/<pack-id>.zip beside settings.json. To find that directory, use Settings → Files & settings and the settings-file location displayed there. Keep installed packs there across app updates. You can also copy a ZIP into this directory while the app is closed; it is loaded on the next launch.

Use Settings → Language packs to see installed packs, their revisions and included languages. Remove pack… asks for confirmation and removes every language bundled in that pack immediately. Removing the active language switches to English and saves that choice. Built-in languages cannot be removed. Keep the source ZIP if you want to reinstall later; removal does not delete your original download.

To update, choose Install language pack… and select the new ZIP:

  • Keep the same pack id and increase revision for a newer release. A higher revision replaces the installed pack immediately, including the currently selected translations. No restart or manual file removal is needed.
  • An equal revision (a sidegrade, including the same ZIP) or lower revision asks before overwriting. Cancel leaves the installed pack unchanged.
  • Legacy format-1 packs have revision 0. A format-2 revision 1 pack updates them directly; installing a legacy pack over another installed pack requires confirmation.
  • Languages belonging to a different installed pack cannot be overwritten. Remove that pack explicitly first. An update can add/remove languages within its own pack; if it removes the active language, Canvas Pilot switches to English.

version describes the manifest format and stays 2; revision is a positive integer that you increase for each release (1, 2, 3, …). It is independent of the app version and file timestamps, so timezone or clock changes do not affect ordering.

If a pack is removed outside the app, the saved language remains marked unavailable and renders in English until reinstalled. System default continues to resolve built-in languages; select installed languages explicitly.

Invalid packs are rejected without installing any of their languages. Startup skips invalid packs and reports errors. Packs are limited to 2 MiB compressed, 4 MiB expanded and 16 languages each; at most 32 ZIPs are loaded. They do not execute code, load remote content, or change device settings. The full format is documented in the language-pack contract.

All manuals

Add a theme pack

Theme packs add palettes without rebuilding Canvas Pilot. They change the app, viewport and source-coordinate helper colors; they do not change projects, device transfers, imported pictures, fonts or interface size.

Install and try the collections

Download a ZIP, leave it zipped, then open Settings → Theme packs → Install theme pack…. Select a pack, then click one of its themes to try it immediately. It also appears in More themes… and recent themes. The picker stays open while you try alternatives. Selecting High Contrast twice returns to your last theme, including an installed one.

Choose either collection, or install both:

  • Video-game themes: 6 themes — Deep Rock Galactic, Detroit: Become Human, Dispatch, Helldivers, Ravenswatch and Vivid World.
  • Classic themes: 11 themes — Catppuccin Mocha, Dracula, GitHub Dark/Light, Gruvbox Dark, Monokai, Nord, One Dark, Solarized Dark/Light and Tokyo Night.

Each ZIP is one normal theme pack. Select video-game-themes or classic-themes in the manager to try its palettes. Removal or replacement applies to that whole collection. Individual downloads below remain available; installing both an individual pack and its collection keeps separate copies.

Video-game themes

PackPaletteEditable manifest
Detroit: Become HumanDeep blue, pale text and cyan android-inspired accentsmanifest.json
RavenswatchMidnight blue, ivory and crimsonmanifest.json
Vivid WorldMidnight navy, violet, pink and cyan crystal accentsmanifest.json
Deep Rock GalacticDark, gold/molten-orange accentsmanifest.json
DispatchDark, yellow/cyan accentsmanifest.json
HelldiversDarkmanifest.json

Classic themes

Tokyo Night adapts the upstream palette, and Catppuccin uses Mocha colors. Their license notices travel inside the ZIP and can be viewed under Attribution and licenses. The Detroit, Vivid World, Ravenswatch, Dispatch, Helldivers and Deep Rock Galactic themes are original, unofficial color interpretations; they include no game artwork, fonts or code and are not endorsed by the games’ owners.

Moving from the old combined pack

The two collections replace the former extra-themes.zip download and have new pack IDs. Install the desired collections, select a theme from one of them, then remove extra-themes in Settings if you no longer need its duplicate entries. Existing installations and saved choices are not renamed or deleted automatically. Removing a pack while its theme is active falls back to Midra Dark. Standalone packs, including older Minecraft installations, remain user-managed.

Manage packs

The manager uses a compact, searchable pack list and shows the contents of only one selected pack. Search by pack ID or theme name; Clear restores the full list. Rows show the theme count and revision, with a dot marking packs currently in use. Large collections scroll within the list instead of stretching Settings.

Select a pack to see its theme names, swatches, attribution and Remove pack… action. The contents and license text scroll independently; removal stays above them. On narrower windows, details appear below the list. Newly installed or updated packs are selected automatically. Search and selection are remembered during the session, separately from language packs. Theme changes save immediately and survive restart.

Install a newer revision of the same pack to update it immediately. Equal or older revisions ask before replacing the installed copy. Updating an active theme refreshes its colors. Removing a pack asks for confirmation; if it contains the active theme, Canvas Pilot returns to Midra Dark. The downloaded ZIP is kept for reinstalling.

If a pack disappears outside the app, Canvas Pilot keeps your saved choice but uses Midra Dark and marks the theme unavailable. Reinstalling that pack restores its colors. Invalid packs are reported and skipped; they do not prevent startup.

Make your own

Start with one of the editable manifests above. Change the pack id, each theme’s id and name, and its colors; keep the required fields. Choose light: true for a light palette or false for a dark one. Every color is opaque #RRGGBB. Put the file at the ZIP root as manifest.json, with no folder or other files. A pack may contain up to 16 themes. Increase its positive revision for updates.

Use your own pack ID when distributing a variant. Retain relevant upstream notices when adapting licensed palettes. Check primary and secondary text on every surface, selection fills and both checkerboard tile colors. Light/dark mode does not fix poorly contrasted colors automatically.

The theme-pack contract lists all palette roles, validation limits, settings compatibility and round-trip behavior. Repository contributors regenerate the individual ZIPs and both collections with python3 scripts/build-theme-packs.py.

All manuals

Device connection and transfers

Canvas Pilot · Guide contents · Starter files

Connect a device or emulator

Enter an IP address in Device IP / port, optionally followed by a TCP port: 192.168.10.146:3000. Without a port, the app uses port 80. IPv6 addresses with a port use brackets, for example [::1]:3000. A pasted root HTTP URL, for example http://192.168.10.142/, also works. Omit credentials, queries, fragments and page paths; HTTPS and hostnames are not supported. The address is saved in preferences and used for identity, input snapshots, automatic reconnect and WebSocket sends. Aquilon also requires AWJ TCP port 10606 on the same IP for its targeted geometry reads; Midra reads use the HTTP port.

Use Recent machines… to switch to one of the last four successful connections. Choosing an entry connects immediately to read its state; it does not send layers. History survives restarts, retains custom ports and excludes failed attempts.

The adapter accepts Eikos 4K, Pulse 4K, QuickVu 4K and QuickMatrix 4K and reads screen sizes and allocated layer counts from the device instead of assuming Eikos’s configuration. This covers the Midra 4K family, not earlier Midra products or Alta. Aquilon / LivePremier has its own adapter, described below. Required firmware fields are still validated. Eikos 4K hardware and a Pulse 4K 3.3.7 emulator have been read successfully; QuickVu/QuickMatrix have parser regression coverage but still need individual emulator/hardware acceptance.

Review resolution conversions

When a linked transfer cannot be prepared, its review offers explicit conversions. The mapping window also has Review conversions / send valid layers…. Choices apply to this transfer only: the project, saved links and source routing are unchanged unless an input change was already explicitly selected.

  • Require matching resolution is the default.
  • Keep pixel coordinates sends the same positions and box sizes to a different canvas. A 500-pixel box remains 500 pixels on a larger screen.
  • Scale to destination canvas scales positions and box sizes independently on each axis. A 1920 × 1080 layout sent to 3840 × 2160 doubles both. A different canvas ratio changes box proportions; normal cropping follows the resized box, while explicit fit retains its meaning.
  • Adapt source dimensions to the destination input preserves the box and reframes crop for the reported input dimensions. It does not change the physical input signal or its shared settings. Unsupported input processing still blocks that destination.

Review the listed conversions and exact changes before sending. Invalid destinations remain explicitly listed, and conversions do not bypass freshness checks.

Transfer discrepancy logs

Subpixel and exactly one-pixel conversion differences produce no discrepancy warning or log. Larger calculated visible-size or Aquilon mask-bound differences are recorded when a send is attempted, rather than blocking otherwise valid geometry. Impossible sizes, exhausted crops and unexpected device readback still fail validation.

Logs are stored in logs/device-transfers.jsonl beside the existing settings file (see Preferences). One previous file is retained; each file is at most 1 MiB. Records contain requested/calculated pixel values, destination, timestamp, application version and whether readback verified the send. They do not measure physical output. Opening a review does not write a log. A log-write failure does not stop a device transfer. The log contract describes the fields.

Use folders as local device layouts

The Apply to selector is shared by the status bar, Export menu, and send/import windows. It starts at All layers, regardless of canvas selection. Choose Only selected layers for an explicit selection filter, or Folder: … for a complete folder. The choice lasts for the session; it is not a project setting. It affects device transfers, not clipboard/file import or geometry export scopes.

To prepare several layouts that reuse the same device layers:

  1. Put each layout in a folder and configure its saved screen/layer links through Midra mapping & transfer…. Every row can still be remapped or unlinked.
  2. Choose Folder: … in the status selector, or right-click a folder and choose Use folder for Midra transfers.
  3. Click Send folder links. Then click another folder name and send again: Folder mode follows the clicked folder. Clicking a folder never sends by itself.
  4. Load folder links reads fresh Preview geometry/cropping into that folder. Loading requires visible, unlocked destinations and supports Undo.

Multiple editor layers may link to the same device destination, within or across folders. Mapping shows a warning listing the other linked layers and their folders. A linked send with invalid or overlapping screen + layer destinations opens Review device transfer. It lists every included and skipped layer, its destination and the reason for skipping. All layers competing for one destination are skipped; none wins automatically. Send valid layers sends only the listed valid destinations. Cancel to repair mappings or choose a different scope. No send is possible when all destinations are invalid. Links outside the chosen scope do not block it. Linked send/load skip unlinked layers. An empty selection or missing folder never falls back to All. Transfers already started retain the links captured at click time. These are local geometry layouts, not device preset recalls or source-routing memories.

Import layers from Midra proposes unambiguous saved links within the scope. Each row offers Skip or a scoped existing layer; All/Folder scopes also allow New layer. Use saved links restores those suggestions; Import unmapped as new layers fills unused rows. New layers join the chosen folder, and importing saves their reviewed screen/layer links with the geometry as one Undo step. Existing layers keep their folder. Multiple local copies of the same device layer can be updated together with linked Load; the manual import dialog requires one unambiguous destination per device row.

Midra connection and sending

Open Midra connection… in the main menu (also in Settings → Midra integration), enter the device IP, then Connect. The address saves automatically in the application config and survives project loads and restarts; startup connects automatically only if Try autoconnecting at startup is enabled in Settings → Midra integration.

Open Import → Midra layers… for the separate layer import window. Refresh layers reads a fresh snapshot; Connection settings… opens the connection window. Choose a destination beside each device layer: existing layer, new layer, or skip. Explicit Midra modes import container bounds, crop, fit and mask; unsupported inherited crop cases are explained in the review. Imports are one undoable edit.

Open Export → Midra mapping & transfer… even while offline, then use Connection settings… to connect. Mapping and transfer controls appear once device data is available. When more rows or controls extend below the window, a solid scrollbar stays visible even while the pointer is elsewhere. Scroll to review all layers; the import list uses the same visible scrollbar behavior. Choose editor layers, map each to a Midra layer, select Preview or Program, and select a container strategy: Output-sized or Source aspect. Expand Exact device changes to review sizes, centers, crop values and aspect, then click Send mapped layers. The final row groups Load linked layers (down arrow, device to editor) and Send mapped layers (up arrow, editor to device); the Load label follows the selected transfer scope. The button is disabled while a send is in progress. Matching stored values can still be sent to apply staged geometry to hardware. The source’s native dimensions must match the destination’s current content.

The target bank is fixed when configured. Sending checks for changed source, framing and destination state before writing. Writes are sequential. A rejected or failed send refreshes the device read-only: if it responds, the connection stays available with updated state and the send error remains visible. Check the updated layers before sending again. Failed refreshes mark the device unavailable; there is no automatic send retry or rollback after partial failures. Success means all changed fields matched device readback. There are no automatic sends from edits, imports or undo. Closing the connection window does not cancel a send already started; wait for its result before loading another project.

See hardware checks and limitations and the device exchange contract. The footer’s ONLINE status reflects the last successful read, not continuous polling.

Reference picture for offline cropping

In a layer’s Preview controls, choose Load reference picture… and select a PNG, JPEG or BMP. The picture replaces that layer’s captured preview and follows its crop, zoom, fit and mask, just like an input preview. It is local only: Canvas Pilot never sends the picture to a switcher or changes device input routing.

The picture represents the full source frame using the layer’s configured source format. Set that format to match the intended input; loading a picture does not change source dimensions or geometry automatically. Capture auto-refresh and Follow input are disabled when loading it. Choosing a physical input again replaces the local picture with a device capture.

Input reference pictures, beneath the fixed reference pictures in the layer list, lists both local pictures and captured layer previews. Click a row to select its layer; use the checkbox to hide/show its preview or × to remove it. Fixed reference pictures remain independent canvas overlays.

Save a .pilot.json project to retain pictures and preview visibility offline. As with captured previews, geometry-only exports do not retain these pictures.

Capture an input still from Midra

For a layer, open Layer properties → Preview (or right-click → Configure capture…):

When a connection or layer load completes, linked layers preselect their assigned physical input if available. This does not enable previews or request an image, and existing capture choices are preserved. Click Capture still when ready, or explicitly enable auto-refresh. Inputs without signal can still be preselected.

  1. Check Enable input preview.
  2. Choose the physical input to preview. Inputs without signal are hidden by default; Show inputs without signal inside the dropdown reveals them with a No signal label. The same filter applies to the snapshot-import picker. Signal indicators reflect the last connection refresh. This only chooses an image source; it does not change Midra input routing or the editor’s source-format identity.
  3. Selecting an input captures a first still automatically and loads it straight into this layer. It waits only for the shared five-second request throttle, not the auto-refresh interval. Click Capture still, directly below the input selector, to replace the still. Selecting a different input queues its first capture too; rapid changes keep only the latest choice. The snapshot-import picker also captures on selection, but still requires an explicit import.
  4. Alternatively, enable Auto-refresh this preview below Capture. It fetches the first image automatically and then updates it on the timer.

Auto-refresh is per layer. Request interval is shared across automatic previews, defaults to 10 seconds and accepts 5–300 seconds. Visible automatic previews refresh one input at a time; automatic previews sharing an input share one fetched image. First captures queued for that same input also share the result, even when selected while a request is running. One fetch serves all waiting layers; existing stills with auto-refresh off remain unchanged. Requests are serialized with a minimum five-second gap, including manual captures. A failed refresh retains the last image; changing the input clears the previous input’s image. Disabling the preview hides it and pauses its refreshes.

Crop guide opacity defaults to 35% with an image; without an enabled image, guides remain fully opaque and the slider is disabled. Selection handles stay fully visible. Layer previews, captured stills and timer settings are saved in the project. Saved auto-refresh resumes when the matching device is connected and input snapshots are available. Opening a project does not start a connection; saved images remain visible offline. The timer pauses offline and while the separate capture/import dialog is open. Reduced snapshot resolution and freshness are controlled by the device. If snapshots are disabled for an input, enable them in WebRCS and refresh the connection.

Import → Import input snapshot… opens a capture/import window (also available from the reference-images context menu). Choose the physical input and a Destination: any editor layer, or Reference image. No layer selection is required. Capture and inspect the still, then click Import into layer or Add as reference. Layer destinations offer Keep refreshing this layer and the shared refresh interval. This starts timed updates after import; leaving it off imports a fixed layer still. Selection and layer geometry are unchanged.

Reference images never offer auto-refresh: they are fixed screen guides embedded in the project, with the usual size/aspect warnings. Cancel/close discards a pending dialog capture; another request waits for completion or the 20-second timeout. No capture action changes device settings or routing. See the input preview contract.

Opening a project or restoring recovery now reads, validates and decodes embedded references in a worker. The current editor stays intact until the whole project is ready. Manual loading has a Cancel button; errors keep the old project. Recovery autosave pauses while loading, including on exit.

Layer properties → Source opens the shared Input settings window. Physical input preprocessing affects all consumers; it is not part of a layer send or a saved project. Reload affected layers after changing it to refresh processed source dimensions. Layer source relationships remain stored but do not route inputs.

Aquilon / LivePremier

Aquilon recognizes all standalone models: RS alpha, RS1–RS6, Cmini, C, C+ and Cmax. All firmware versions may connect; versions outside 6.2.x display a warning that backward compatibility is not guaranteed. The adapter requires compatible protocol fields and stops with an explicit error when they differ. Older firmware, especially before 4.x, may therefore fail to connect. Linked systems remain unsupported. Cmax 6.2.79 has emulator acceptance; RS1 6.2.79 mask testing is recorded in the acceptance record. Other models/firmware have synthetic test coverage, and physical-output acceptance remains outstanding. Connect using the same Device connection window. The device identifies its family automatically. Screens use S1, S2, …; auxiliaries use A1, A2, … and stay distinct in saved mappings. Only enabled screens and allocated numbered layers appear; empty/unrouted layers remain available.

Load, selection/folder scopes, mapping review, Preview/Program sends and input previews use the same controls as Midra. The Program preference still applies. The adapter resolves each screen’s current transition group; an active transition or a changed bank/source before Send requires a refresh, without writing.

Centered live-input framing supports layer crop and zoom. Fractional geometry is retained in projects; sends round device sizes/centers to whole pixels for WebRCS compatibility. Calculated visible-box errors above one pixel are logged without blocking the transfer; smaller discrepancies remain silent. Rectangular masks load and send without resizing the image. Both editor mask origins are supported; device loads return a Layer-relative mask. A zero mask explicitly clears destination blanking during a reviewed send. Fully blanked axes are allowed. Non-centered fit modes, malformed masks and shared input aspect/crop corrections are reported explicitly when their visible bounds cannot be imported. Shared input correction controls remain managed in WebRCS for this adapter. Ordinary sends do not TAKE or change shared input processing; routing requires Change input.

Aquilon reads only the required properties through AWJ TCP 10606, in batches, including a consistency check. The tested emulator now downloads about 197 KB per refresh instead of 124 MB, with direct reads around 0.30 seconds. Preflight and verification use the same targeted reader. If the AWJ port is disabled or blocked, the connection reports an error instead of falling back to the full store. Connect, load and send remain background operations. Input snapshots retain pooled, throttled, opt-in behavior, including inputs above 16. Older firmware, linked units and other Aquilon models remain unverified. See the adapter contract for tested scope and limits.

Shared device input drafts are session-only; projects omit them. Opening a file never changes an input.

When device state changes before sending

Device state has changed lists the changed fields before any screen is sent:

  • Cancel send keeps your local edits and sends nothing.
  • Send my layout anyway rebuilds the original mapped send against the refreshed device state. It overwrites the mapped layout fields and any explicitly staged input selection. Range, input compatibility and fresh-state checks still apply. A changed device family or Preview/Program bank requires checking the mapping again instead.
  • Discard local changes and reload uses a warning color because it replaces the mapped local layers’ geometry, crop, fit and masks with the device Preview snapshot shown in the dialog. Other layers stay unchanged; Undo restores your edits. This action is unavailable for Program or ambiguous multiple destinations belonging to the same local layer.

If the device changes again before an explicit overwrite, sending can be stopped again. Changes or failures occurring during a send remain reported as partial-send errors, with the completed-screen count; they never trigger an automatic retry.

Select the input to send or preview

In Layer properties → Source, select a Device input. Enable Change input to route the mapped destination layer to that input on the next explicit Send. Selecting an input alone does not change the device. Leave the checkbox off to send geometry without changing its source.

In Preview, Follow input is enabled by default for new controls and captures the input selected in Source. Enable input preview as usual; automatic refresh remains a separate option. Following an input does not route it, and changing the selection clears the old picture before requesting a new capture.

An independently selected preview with a different processed resolution shows an amber notice in both Source (input selection) and Preview properties. The canvas and Preview tab show Not displaying selected layer input when the picture comes from another input. The overlay is blue for a different input, amber when its resolution differs, and red when its ratio differs. The text also identifies resolution or ratio mismatches; color is not the only indication. Enable Follow input to match the selected source. These notices do not alter crop, fit or device routing. Reduced-resolution capture thumbnails do not trigger size warnings; intentional differences between the layer box and its source are not mismatches.

Discarding local changes in the send conflict dialog also clears these choices for the reloaded layers. These selections are session-only and reset when a project or connection is replaced; they are not saved in projects or exchange files. Input switching requires a valid signal. Midra inputs with applied crop are supported; framing adapts to the processed input dimensions using the layer’s fit settings. Input aspect correction and Aquilon shared input crop remain unsupported. Sending to Program can visibly change the live source.

Live picture in the input crop editor

In Input settings, Capture input (live) places the captured picture inside its applied device crop. Unknown areas keep the sizing grid. Midra returns an already-cropped picture; Aquilon retains the full frame with blanked edges. Canvas Pilot handles these separately so the crop is not applied twice.

Moving the draft crop does not move the captured picture. After Send changes, the preview refreshes against device readback. A missing signal or inconsistent capture geometry keeps the grid until a matching capture arrives. Disable Crop Finder in WebRCS when using this preview.

All manuals

Source dimensions, resolutions and cropping

The local layer model uses processed source dimensions, layer crop edges, fit, masks and final visible bounds. Input preprocessing belongs to the shared Input settings window. There is no additional local input crop. After changing input preprocessing on the switcher, reload affected layers to refresh their source dimensions.

Names and coordinate spaces

NameMeaning
Source/input resolutionDimensions of the processed picture consumed by layers
Output resolutionScreen dimensions; changing these does not resize layers
Layer resolutionFinal visible box, or container for an explicit fit mode
Layer cropEdges removed from the processed source before layer fitting
Content zoom / offsetsDerived controls for layer crop; not another saved transform
View zoomCamera magnification only; never changes layout pixels

For example, if the device reports processed content as 1920 × 1000, use that as the layer input. Do not also subtract a local 40-pixel top and bottom crop. Physical source cropping and content ratio remain separate device settings.

Implementation limits are 1–16384 pixels per source/output side, positive finite layer sizes up to 1,000,000 pixels and normal content zoom of 100–10000%. These are editor limits, not a promise of hardware capability.

Layer resolution: advanced cropping

The visible layer box Bw × Bh is fixed while its content is reframed, just like an avatar crop. Cropping followed by proportional fitting produces the apparent zoom. There is no independent image-zoom transform to export to WebRCS.

The baseline uses cover geometry: scale proportionally until both box dimensions are covered, then remove overflow. It is not sufficient to choose the numerically largest side; compare both scale ratios. This avoids blank bars for landscape, portrait and unusually wide boxes.

Let the usable input be Iw × Ih, content zoom be z ≥ 1, and offsets ox, oy be in final output pixels. At 100%, z = 1; viewport camera zoom is unrelated.

k0 = max(Bw / Iw, Bh / Ih)       # minimum proportional scale that covers box
k  = k0 * z                    # output pixels per usable-input pixel
Rw = Bw / k                    # retained source region width
Rh = Bh / k                    # retained source region height

L = (Iw - Rw) / 2 - ox / k
R = (Iw - Rw) / 2 + ox / k
T = (Ih - Rh) / 2 - oy / k
B = (Ih - Rh) / 2 + oy / k

These four advanced crop edges are in processed-source pixels, not screen pixels or percentages. The retained region starts at (L, T). It has aspect Bw / Bh, so proportional fitting reproduces the final box exactly.

The source-to-box mapping makes the offset sign explicit:

box_x = k * (input_x - L)
box_y = k * (input_y - T)
screen_x = visible_box_left + box_x
screen_y = visible_box_top  + box_y

Valid content offsets keep every crop nonnegative:

abs(ox) <= (k * Iw - Bw) / 2
abs(oy) <= (k * Ih - Bh) / 2

At baseline, one axis usually has no panning range. Increased zoom creates more room to pan. Dragging stops at these explicit limits; invalid typed values show an error rather than silently changing. Never reveal pixels removed by the input crop. Actual firmware crop limits may impose stricter bounds or maximum zoom.

Authoritative state and inverse controls

Store processed source metadata, layer advanced crops, final visible size and visible position. The crops are authoritative; do not persist a second, independent zoom/offset transform that can disagree with them. The UI derives:

Rw = Iw - L - R
Rh = Ih - T - B
k  = Bw / Rw                    # must also equal Bh / Rh
z  = k / max(Bw / Iw, Bh / Ih)
ox = k * (R - L) / 2
oy = k * (B - T) / 2

Reject imported crop tuples that do not satisfy positive remaining area, matching aspect and supported precision. Do not silently stretch mismatched crops. Preserve exact/rational values where practical; never round the intermediate 444.444… width to 445 before computing a crop.

Retained bounds in processed-source coordinates are (L, T, Iw - R, Ih - B). Input preprocessing has already occurred; never add its crop to the layer crop.

Device mapping and explicit fit

The adapter converts layer crop to the device’s units using processed dimensions. Input edits have their own reviewed send and readback; layer sends do not contain input-setting writes. Firmware rasterization and quantization can still differ from the mathematical editor preview.

Explicit 1:1, Fullscreen, Centered and Cropped fit modes operate after layer crop. Their container and image bounds differ from the normal cover model above; see fit modes and masking. Source-relative masks follow the processed picture; layer-relative masks follow the visible container.

Persistence and recovery

Projects and supported export snapshots retain processed dimensions, source relationships, layer crops, fit and masks. Schema 20 removes old local pre-crops and inactive input proposals. Best-effort Open project reports discarded legacy settings and opens repaired files as unsaved copies. Shared device input drafts remain session-only.

All manuals

Canvas Pilot changelog

All changelogs

Unreleased

v0.10.10

  • Disclose the project’s MIT license, LLM-generated or LLM-assisted development, human review and professional use in the public README.
  • The pinned mdBook build passes, validating 25 HTML pages and 1,660 local links/assets.

v0.10.9

  • Add optional forced whole-pixel snapping for moves, resizes and pivots, with a temporary Shift+Space modifier. The existing soft pixel magnet remains the default.

v0.10.8

  • Remove inspector Copy/Paste buttons, including the multi-selection Copy button, while retaining clipboard shortcuts and context-menu actions.

v0.10.7

  • Pre-map geometry imports by exact included-item count: selected layers, their shared folder, then all available layers. Manual scope and mapping remain available.

v0.10.6

  • Keep the alignment menu open while choosing its target, making Selected layers and individual layer targets usable from both the toolbar and canvas context menu.

v0.10.5

  • Place Size presets before Output format and Viewport options in the canvas toolbar, including when toolbar groups wrap onto another row.

v0.10.4

  • Make the selected layer’s resolution row toggle its Layer properties window: click once to open it and again to close it, preserving the existing review prompt when the window contains unapplied edits.

v0.10.3

  • Tighten the selected-layer inspector spacing around crop, measurement, geometry and ratio controls, keeping the same controls visible in less vertical space.

v0.10.2

  • Store Keep aspect ratio when resizing on each layer, so layers can use different resize behavior. The choice is undoable, survives reordering and project round trips, and old project-wide choices migrate to every layer.

v0.10.1

  • Size the right inspector to its visible empty/reference message when no layer is selected, removing the long blank scroll range while retaining scrolling for layer properties and long layer/reference lists. Remove the duplicated read-only Visible box / center position block and pull the copy/paste actions upward.

v0.10.0-rc.18 — 2026-11-19

Published release candidate collecting the extreme-zoom performance fix and soft whole-pixel canvas placement below. See the release notes for downloads, pack contents and validation limits.

v0.10.0-rc.18

  • Make Pixel edges a soft whole-pixel preference for mouse movement and resizing. Coordinates within one quarter pixel settle on the integer after stronger screen, layer and grid snaps; farther fractional placement remains available for precise work at high canvas zoom.
  • Refresh three yanked transitive packages to their compatible patch releases so local Cargo installation and release builds resolve without yanked-package warnings.

v0.10.0-rc.17

  • Keep extreme scroll zoom responsive by omitting camera-scaled decorative canvas text before it would request oversized glyphs from egui’s shared font atlas. Layer geometry, fixed-size layer labels, pixel guides and the existing 256× camera range remain available for precise placement.

v0.10.0-rc.16 — 2026-11-19

Published release candidate collecting the crop, preview, input adaptation and transfer-recovery changes below. See the release notes for highlights, pack downloads, compatibility and validation limits.

v0.10.0-rc.16

  • Keep Convert to Smart crop and Convert to Edge crop on one line in the layer context menu, allowing the menu to grow to the action label width.

v0.10.0-rc.15

  • Add the inverse Convert to Edge crop action to the layer context menu and Crop properties. Preserve the Smart crop’s picture, crop, container and mask, enter the green edge helper immediately, and return to Smart crop with Undo.

v0.10.0-rc.14

  • Enabling an input preview from the right-click menu or Preview properties queues its first still immediately, without requiring auto-refresh. Keep capture cooldown, single-request scheduling and local-picture behavior. UI regression coverage checks one-shot scheduling, disabling and the cooldown.

v0.10.0-rc.13

  • Tolerate up to one output pixel of device rounding when importing Centered/Cropped fits. Normalize to an exact Smart crop without moving the container or source center; preserve larger mismatches and stretched/native modes. Regression tests include the observed Midra crop fractions that left a 0.036-pixel width gap.

  • Import exact device fits as normal Smart crop. Preserve advanced modes for letterboxing, overflow and stretching, and preserve saved project choices.

  • Add green advanced edge-crop handles with a frozen image during dragging and refitting on release. Add explicit, undoable Convert to Smart crop actions in Crop properties and the context menu. Geometry/interaction regression tests cover exact-fit selection, staged edits, source limits and undo/cancel.

v0.10.0-rc.12

  • Double-click and Enter open Crop properties for Centered/Cropped layers instead of silently doing nothing. Preserve automatic fitting, geometry and crop; normal crop and 1:1 still use their interactive helper. Regression tests cover both shortcuts across all explicit fit modes.

v0.10.0-rc.11

  • Review problematic transfers with explicit included/skipped layer lists and Send valid layers. Conflicting mappings never select an arbitrary winner.
  • Offer send-only canvas conversion (keep pixels or scale to destination) and source-dimension adaptation. Projects and saved mappings remain unchanged.
  • Record conversion discrepancies above one output pixel in bounded local JSONL logs instead of blocking valid geometry. Subpixel and one-pixel discrepancies remain silent; invalid ranges, exhausted crops and readback mismatches still fail. Logs describe calculated geometry and verification, not physical-output accuracy.

v0.10.0-rc.10

  • Recover from temporary send-readback failures using up to three read attempts, without repeating writes or apply pulses. Stop starting retries after five seconds; an in-flight read retains its existing timeout. Report uncertain outcomes when verification remains unavailable.
  • Accept pasted root HTTP device URLs as well as IP addresses, and disable linked Send while a shared-input send is active. Socket-write counts no longer imply device acknowledgement. Regression tests cover recovery and address validation.

v0.10.0-rc.9

  • Enabling Follow input now adapts the layer to the selected input’s processed dimensions, using the same undoable crop/fit path as manual preview selection.

  • Avoid a transient mismatch warning in Follow input mode: hide the previous capture while its input binding catches up with a changed source selection.

  • New preview controls default to Follow input. Independent preview inputs show resolution warnings and stronger ratio warnings in both Source and Preview properties, including a canvas/preview overlay. Compare processed signal dimensions, not reduced capture thumbnails; existing image framing and explicit reference-picture choices are preserved.

  • Picture overlays identify previews that are not the selected layer input: blue for a different input, amber for differing resolution, red for differing ratio. Text states the reason as well, and wraps inside the picture.

v0.10.0-rc.8

  • Support switching to cropped Midra inputs using their processed image dimensions, without applying input crop twice. Verify crop controls against signal readback and retain freshness checks. Preview source adaptation uses the same validation.
  • Aquilon shared-crop and input aspect-correction restrictions remain unchanged.

v0.10.0-rc.7

  • Stabilize input-preview GUI tests under CI load with a controlled capture clock. Check cooldown boundaries without real-time delays; production capture intervals and device behavior remain unchanged.

v0.10.0-rc.6

  • Allow Crop & fit paste across different input dimensions. Crop edges transfer proportionally without changing source assignments or input preprocessing. The destination’s Advanced fit is preserved; normal crops that no longer match the box use Centered (fit), retaining ratio rather than stretching or refusing paste.

v0.10.0-rc.5

  • Adapt a layer to the selected input resolution instead of requiring a manual source-size match. Preserve its outer box and normal zoom/focus; advanced fit retains proportional crop edges. Shared editor sources are detached per layer.
  • Preview input selection uses the same undoable adaptation. Explicit input-switch plans adapt a temporary layout too, retaining device freshness validation.

v0.10.0-rc.4

  • Fix Midra layer input switching reading the wrong input crop path. Validate Midra crop controls rather than Aquilon crop status; missing or malformed data still blocks switching, as do active crop and aspect correction.

v0.10.0-rc.3

  • Use stable selectable rows and a subtle background hover in device input pickers, avoiding border-driven shifts when moving between inputs.

v0.10.0-rc.2

  • Tighten input reference picture rows from 44 to 32 pixels apart while retaining the existing button size. Reclaim the space below the list as well.

v0.10.0-rc.1 — 2026-11-18

First release candidate for the 0.10 minor release, collecting the changes below. See the release candidate notes for highlights, compatibility changes and validation limits.

v0.9.76

  • Preserve the actual picture ratio when fitting input captures and local reference pictures into source space. Midra cropped captures no longer stretch back to the declared source ratio before layer crop, zoom, fit and mask are applied.

v0.9.75

  • Highlight Send changes when an input has pending edits. Keep view zoom, panning and Fit view available while Keep device values protects the input crop.

v0.9.74

  • Reorganize Input settings around a larger crop workspace, with crop protection and live capture next to the preview. Numeric crop values/presets are collapsible.
  • Keep input selection, Send changes and the pending-change count above the scrolling editor. Advanced processing uses a category picker with aligned fields; narrow windows stack the panels. Device write and draft rules are unchanged.

v0.9.73

  • Add Cancel to Apply/Discard close confirmations for layer properties, renaming, batch names/folders, clipboard import and device import review. Cancel returns to editing with the draft intact and cancels deferred layer-list actions.

v0.9.72

  • Fix input-crop capture on Midra: its PNG contains only the retained crop, unlike Aquilon’s full-frame snapshot. Place it in the applied crop rectangle without cropping twice, leaving unknown pixels as the sizing grid.
  • Validate capture dimensions and before/after device state; read-only checks on Eikos 4K 3.3.10 covered uncropped, portrait-cropped and asymmetrically cropped input.

v0.9.71

  • Load a local reference picture into a layer’s input preview for offline crop, zoom, fit and mask preparation. Pictures never upload to a switcher.
  • List input reference pictures separately beneath fixed reference pictures. Local pictures save with projects and disable capture refresh/follow for that layer.

v0.9.70

  • Stop treating unrecognized clipboard text as draw.io XML. Unsupported text now explains the supported text formats and PowerPoint’s .pptx file-import route.
  • Well-formed HTML supplied as clipboard text can fall back from a rejected embedded draw.io document to embedded SVG. Rejected candidates are reported in the review; ambiguous multiple documents and invalid explicit Canvas Pilot versions remain errors. Native binary clipboard support is unchanged.

v0.9.69

  • Enter now opens crop edit for the selected editable layer using the same rules as double-click, and finishes an active crop/mask edit. Text fields, dialogs, active drags and held-key repeats retain their existing safeguards.

v0.9.68

  • Moved Send changes, validation feedback and status above the input editor.
  • Keep the captured picture and sizing-grid composite at full opacity while Keep device values disables crop editing. Verified capture geometry is still required; draft crop changes never reposition or stretch the captured pixels.

v0.9.67

  • Input editor categories now start with Keep device values enabled.
  • Crop zoom uses a 100–500% slider with manual entry beyond its range, subject to device limits. Selecting 100% clears both crop axes exactly, avoiding a residual crop after asymmetric edits.

v0.9.66

  • Reopening a project now resumes saved preview auto-refresh when its matching device is connected and snapshots are available. Offline stills remain visible; loading does not connect to a saved address. Disabled and still-only previews remain idle. Project format is unchanged.

v0.9.65

  • Added per-destination Send options to the mapping window mockup: Position, Size, Crop, Fit mode, Mask and opt-in Input. This is a visual proposal only; application transfer behavior and save formats are unchanged.

v0.9.64

  • Source properties can stage a physical input with Change input, applied only on explicit Send. Fresh-state checks and readback include the selected source.
  • Preview Follow input follows that selection without routing the device. These choices are session-only; project/export schemas are unchanged.
  • Switching currently requires a valid, uncorrected input matching the editor source dimensions. Unsupported input processing is rejected before writes.

v0.9.63

  • Added a device-state conflict dialog with changed fields, Cancel send, Send my layout anyway, and a warning-colored Discard local changes and reload action. All screens are checked before the first write. Explicit overwrite rebuilds plans against fresh state without bypassing validation; scoped Preview reload is undoable and refuses ambiguous multi-destination layers.

v0.9.62

  • A rejected or failed layer send now refreshes device state read-only and keeps the connection available when that refresh succeeds. The send error remains visible and sending is never retried automatically. A failed refresh still marks the device unavailable.

v0.9.61

  • Removed Crop Finder from shared input settings and replaced the review step with a direct Send changes button. Fresh device validation, category protection and verified readback remain in place.

v0.9.60

  • Input capture is now a live toggle while Input settings is open, sharing the existing refresh interval and pooled requests with layer previews.
  • Show captures directly in their verified device-crop region, with the sizing grid elsewhere. Sending invalidates the image until a new verified capture arrives; local crop edits never stretch the preview.

v0.9.59

  • Added “Keep device values” per input-settings category. Protected categories discard draft edits, disable editing and never contribute device writes, including after Undo. Crop protection also disables the visual crop editor.

v0.9.58

  • Made shared input crop handles easier to grab, with larger targets, resize cursors and drag tracking from the original press position.
  • Added a percentage crop-zoom slider between − and +, using the selected pivot.
  • Input option labels now show readable names and ratios (for example 16:9 and Keep input ratio); device enum values remain unchanged.

v0.9.57

  • Removed the legacy local source/pre-crop editor and inactive input proposals. Shared Input settings owns device preprocessing; layer rendering/sends use the processed source dimensions without adding another input crop. Aquilon’s existing refusal of framing transfers with active shared crop/aspect correction remains.
  • Project schema 20 no longer stores either retired setting. Open project recovers usable content from supported JSON, reports skipped/reset data, and opens repaired documents as unsaved copies. Invalid JSON, unknown versions and documents with no usable layers remain errors. Source files are never rewritten during loading.
  • Updated snapshots/clipboard round-trip coverage and added partial-load tests for damaged geometry, optional settings, images and original-file protection.

v0.9.56

  • Removed legacy input proposal controls and the input-setting additions to layer sends. Native device edits now use the shared Input settings window exclusively. Local source geometry has its own editor-only permission. Existing saved proposals remain preserved and inactive without changing project/export schemas.

v0.9.55

  • Added a shared Input settings window, independent of layer selection, with native input crop edges, move, pivot-based crop zoom, view zoom, Undo and explicit reviewed input-only sends. Aspect, color and processing controls follow the connected adapter; supported keying/LUT controls are capability-dependent.
  • Aquilon reads only the selected input’s additional controls. Sends preflight fresh state, use each adapter’s input apply command, verify readback and never send layer geometry or pulse preset apply. Existing local source geometry and saved input proposals retain a compatibility path.
  • Created the local pre-input-settings-refactor checkpoint. Pulse 4K 3.3.7 and Aquilon Cmax 6.2.79 emulator crop tests verified restoration and unchanged screen settings. Aquilon captures show cropped edges blanked; raw capture is unconfirmed. The input crop editor reuses the sizing artwork for unavailable pixels and anchors verified Aquilon capture pixels to their original source region. An unchanged capture remains available below the editor.

v0.9.54

  • Expanded the adapter candidate survey with vMix Layers and a focused ATEM SuperSource assessment, including readback, Linux integration and test-target gates. Research only; neither adapter is implemented or validated.

v0.9.53

  • Crop borders to ratio now restores uncropped bounds before each preset. Added an optional “Crop within existing crop” toggle for cumulative trimming, with regression coverage for switching ratios, restoration and Undo.

v0.9.52

  • Closed localization for its accepted scope and Midra rendering precision for now; retained technical limitations and reference notes. Videos remain in progress; additional adapters, mapping GUI and multiple project screens stay open.

v0.9.51

  • Added a standalone mapping-window visual study with one load source, grouped send destinations and a proposed “Follow load source” shortcut. Sample controls have no application or device logic; production UI and behavior are unchanged.

v0.9.50

  • Added a stretch goal for independent load/send mapping controls, multiple send destinations and eventual named connections, retaining the synchronized workflow as the default. Implementation remains deferred.

v0.9.49

  • Split load sources from send destination collections internally, keeping existing controls synchronized with one destination and unchanged visuals. Send destinations explicitly name the current connection scope; both adapters can prepare fan-out to distinct layers while retaining collision checks. Project v19 migrates old mappings into both directions; recovery and embedded snapshots retain the split. Added routing, undo, migration and exchange round-trip regression checks.

v0.9.48

  • Keep the four layer-header buttons inside the sidebar content area so their icons are no longer clipped along the top edge.

v0.9.47

  • Detect optional software at startup and use the same executable paths for conversion. Hide unavailable artwork modes and Illustrator format choices; retain built-in geometry and layout-box workflows. Added Software integrations to the application menu, listing detected/missing tools, paths, setup and enabled functions. Discovery checks executable files without launching applications. Added executable-search precedence, capability and UI regression checks. Required Rust checks and manual build passed; whole-app coverage is 92.06%.

v0.9.46

  • Added PDF/document reference import with page selection, resolution control and preview before adding. PDF/SVG and Figma artwork render locally; JSON/HTML retain embedded pictures. PPTX and draw.io artwork use optional local converters, AI uses VectorCraft, and all geometry formats offer labelled layout-box pictures. Rendered PNGs preserve proportions and reopen without the source/converter. PDF remains reference-only; complex rendering and external converters have the documented limits. Added page/crop/rotation, artwork, cancellation and save/load regression checks; checked the showcase PDFs and LibreOffice slide conversion. Required Rust checks and the manual build passed; whole-app coverage is 91.99%. External draw.io/VectorCraft rendering was not exercised (tools unavailable).

v0.9.45

  • Split bundled themes into video-game-themes (6, including Ravenswatch) and classic-themes (11). Retired the combined extra-themes download; standalone palettes are unchanged. New pack IDs coexist with old installations, with explicit selection/removal instructions. Checked partitioning, notices, reproducible archives, simultaneous installation, restart and contrast.

v0.9.44

  • Added a separate, reproducible Lumen Forum showcase kit: polished PIP infodecor, synthetic speaker media, an editable three-slide deck, raster-only/editable handoffs, three layouts in five exchange formats, projects and silent demo loops. Generated assets stay local and Git-ignored. Verified native geometry imports, LibreOffice rendering and video dimensions/durations; no device activity.

v0.9.43

  • Added a standalone Ravenswatch palette with midnight-blue surfaces, aged ivory text and crimson accents inspired by the supplied reference. Kept the existing 16-theme collection unchanged at the version-1 limit; packaging now lists its members explicitly. Added import/contrast and collection membership checks.

v0.9.42

  • Replaced the distributed Minecraft palette with Vivid World: midnight navy, violet, pink and cyan crystal accents inspired by the supplied reference. Added its standalone pack and updated extra-themes to revision 4. Existing standalone Minecraft installs remain user-managed; an active removed collection theme falls back to Midra Dark. Updated downloads, docs and contrast coverage.

v0.9.41

  • Retuned Deep Rock Galactic to gold and molten-orange accents on dark rock/brown surfaces, following the supplied title-art reference. Updated its standalone pack to revision 2 and extra-themes to revision 3; regenerated downloads and checked text contrast.

v0.9.40

  • Retuned Dispatch to vivid yellow and cyan accents on charcoal/olive surfaces, with off-white text, following the supplied title-art reference. Updated both Dispatch and the extra-themes collection to revision 2 for existing installs; regenerated downloads and checked text contrast.

v0.9.39

  • Removed the secondary Dark/Light/In use lines from theme choices and locale-code lines from language choices in installed packs, leaving compact named buttons with theme swatches and selected-state highlighting.

v0.9.38

  • Keep resize, crop and mask handles visible above overlapping layers. Covered guide edges are dashed; exposed portions remain solid, respecting hidden layers, masks and fitted picture bounds. Rendering is clipped before generating dashes to remain bounded at high zoom. No geometry, stacking or save-format changes.

v0.9.37

  • Grouped size presets under one toolbar icon and separated tiling labels from bordered numeric fields. Added a session-only Keep proportions toggle for fullscreen, quarters, halves and tiling: each layer fits centered inside its region without changing aspect ratio. Portrait/Landscape remain explicit swaps. Geometry and UI regression tests cover fitting, placement and Undo/Redo.

v0.9.36

  • Fixed theme-pack reproducibility checks across build hosts by using stored ZIP entries and fixed Unix metadata, avoiding zlib-dependent compressed bytes. Regenerated all 17 downloads without changing manifests; regression coverage rebuilds them without zlib and with simulated Windows platform metadata.
  • Added extra-themes.zip: one import installs all 16 themes, with individual ZIPs still available. Added Dracula, Nord, Gruvbox Dark, Solarized Dark/Light, One Dark, GitHub Dark/Light, Monokai and original Dispatch, Helldivers and Deep Rock Galactic palettes. Included upstream notices, deterministic packaging and regression checks for full-collection import, restart, selection and text contrast. Uses the existing version-1 multi-theme format.

v0.9.35

  • Replaced expanding theme/language pack stacks with a searchable pack browser: bounded collection list, one selected pack’s details, in-use indicators, counts and revisions. Search includes pack contents; narrow windows stack the panes.
  • Kept live theme switching, language confirmation, overwrite review and removal safeguards. Pack browsing is session-only and changes no archive/settings schema.

Release v0.9.34 — 2026-11-17

v0.9.34

  • Renamed Visible layer edges to Layer borders and made disabling it exclude moving outer borders as well as stationary border targets. Mask edges & centers remains independently selectable, with both choices preserved in preferences/projects. Center alignment and direct resize-handle snapping retain their existing behavior.

v0.9.33

  • Device mapping/transfer and import now use wider solid scrollbars whenever their content overflows. Bars remain visible with the pointer elsewhere so additional layer rows and controls are discoverable, without changing mappings or transfers.

v0.9.32

  • Made dragging layers out of folders easier: doubled the child-row gutter and made it a root drop target, including row gaps. Enlarged the No folder strip and added cyan drag feedback with an explicit release hint. Folder membership changes preserve geometry and stacking and remain undoable.

v0.9.31

  • Extended Mask edges snapping to include visible masked-area centers as movement anchors and move/resize/pivot targets. Centers use the clipped visible picture, including source-relative masks and explicit fit modes; hidden or fully blanked targets stay excluded. Existing preferences, group movement and Undo are preserved.

v0.9.30

  • Replaced the toolbar Import tray with an inward-arrow box and added a matching outward-arrow Export icon beside it. Both open the existing reviewed workflows; export supports the same layer files and device-transfer options as the menu.

v0.9.29

  • Added 4:3, 16:9 and 16:10 crop presets in Crop properties and the selected-layer context menu. Trim symmetric embedded borders and shrink the layer around its center together; matching ratios are no-ops. Multi-layer changes undo atomically, preserve existing source/input settings and fit modes, and send no device writes.

v0.9.28

  • Added a toolbar icon box for selected-layer Fullscreen, Quarter, X/Y Tiling, Portrait and Landscape presets. Quarter offers nine positions for one layer, halves for two and four quarters for larger selections. Overflow repeats cells with an explanation; placement follows the layer list, including folder members.
  • Presets retain fractional geometry, preserve source/link/mask identity and commit atomically with crop adjustment in one Undo step. Orientation keeps top-left positions; explicit preset sizes override manual aspect-ratio locking.

v0.9.27

  • Enter now finishes viewport crop/mask editing, including clean Crop/Mask properties, while retaining live changes and Undo history. Numeric fields keep their Enter-to-commit behavior; pending properties receive Apply/Discard review. Held Enter and active pointer drags do not accidentally finish the helper.

v0.9.26

  • Added offline theme ZIP packs with bounded validation, live installation/update, reviewed overwrites/removal and collapsible management with swatches and notices. Packed themes appear in the persistent picker/recent history and work with the High Contrast return toggle. Missing packs retain their saved choice with a Midra Dark fallback; removing an active theme saves Midra Dark.
  • Added downloadable Tokyo Night, Catppuccin Mocha, Detroit: Become Human and Minecraft Overworld examples, editable manifests and reproducible ZIP tooling. Upstream notices are included; game-inspired palettes contain no game assets.
  • Settings v15 migrates versions 1–14 and documents namespaced theme references. Project, recovery, geometry and device formats are unchanged.
  • All required Rust/Python checks, reproducible example ZIP checks, native palette rendering and the pinned manual build pass. Whole-application coverage: 91.92%.

v0.9.25

  • Fix Load collapsing Device mapping & transfer to its title bar: the shared control now closes only menus, not the window’s internal collapsible body. Mapping/import windows also recover previously saved collapsed states.
  • Regression checks reproduce the Load click and cover recovery with a connection error visible; no physical device is needed for these UI checks.

v0.9.24

  • Group installed language packs under bold, collapsible ID/revision headings, with languages and the removal action indented beneath their pack. Packs start expanded and retain their open/closed state while browsing settings.

v0.9.23

  • Clicking High Contrast again restores the previous theme in the theme browser, recent-theme menus and Appearance settings. The saved theme history supplies the previous choice, with Midra Dark as the fallback.

v0.9.22

  • Fix High Contrast source-helper coordinates disappearing on white checkerboard tiles: labels now use black on white tiles and white on black tiles.

v0.9.21

  • Keep the More themes picker open after each selection so multiple themes can be previewed before closing it. Each choice still applies and saves immediately.

v0.9.20

  • Added a full-width No folder drop area and widened the heading drop target to make dragging layers out of folders easier. Layer/folder context menus offer Move up/down, preserving folder membership and whole-folder stacking blocks.
  • Added an Add layer icon and viewport/empty-list context-menu action, selecting the new layer without opening the manager. The 256-layer limit still applies.
  • Formatting, both Clippy configurations, all required Rust test suites, rustdoc, native rendering and the pinned manual build pass. Whole-application line coverage: 91.79%.

v0.9.19

  • Added Aquilon rectangular-mask import and reviewed sends for Layer/Source origins, both sizing strategies, fully blanked axes and explicit reset-to-zero. Container/visible-image conversion preserves crop and image scale; malformed masks and excessive quantization error fail explicitly. Opposite-edge releases precede increases, with existing preflight, apply and readback safeguards.
  • Expanded the explicit Aquilon diagnostic to preserve a temporary recovery baseline and verify masks as well as geometry/crop in Preview and Program. The RS1 6.2.79 simulator passed the 96-case mask matrix across runs and a WebRCS rendering check. Baselines were restored and verified, including recovery after an interrupted run. A sanitized RS1 readback fixture guards the round trip. Cut & Fill, explicit fit modes and physical-output acceptance remain separate.
  • Formatting, both Clippy configurations, rustdoc, 467 default/461 restricted tests and the pinned manual build pass. Whole-application line coverage: 91.72%.

v0.9.18 — 2026-11-17

Published with four-platform portable bundles, cargo-binstall archives and raw binaries, plus the Ukrainian/Bhojpuri language pack and reproducibility files. See the release notes.

v0.9.18

  • Recognize all eleven standalone Aquilon models with exact HTTP/AWJ model checks and dynamically discovered capacities. Accept all numeric firmware versions, showing a backward-compatibility warning outside validated 6.2.x in connection and transfer review. Incompatible protocol fields still stop transfers explicitly; legacy protocol implementations and linked systems are outside this change.
  • Added synthetic model/firmware, mismatch and Preview/Program planning regressions. Cmax 6.2.79 remains the only model/firmware with recorded emulator acceptance; physical-output acceptance remains outstanding.
  • Default/restricted Rust suites, formatting, Clippy, rustdoc and pinned manual build passed; whole-application line coverage is 91.70%.

v0.9.17

  • Added isolated feature-recording recipes, a shot-by-shot capture guide and a Git-ignored local video gallery with captions, contact sheets and fresh profiles. Recorded 21 clips covering editing, crop/mask, exchange, language packs and simulator transfers. Offline imagery and simulator footage are labelled.
  • The simulator Preview send passed device readback; baseline restoration verified all captured S1 layer fields in both banks. Python tests and the pinned manual build pass; this is not physical-output acceptance.
  • Added the requested backlog item to validate every Aquilon and Midra model, starting with AQL C+; existing support claims and adapter checks are unchanged.

v0.9.16

  • Added language-pack management in Settings: installed revisions/languages, confirmed removal and immediate refresh without restarting. Removing the active language selects and saves English.
  • Format-2 ZIP packs carry a positive revision number. Higher revisions update atomically; equal/older revisions require overwrite confirmation. Legacy packs remain readable as revision 0; cross-pack locale collisions remain errors. Updated the Ukrainian/Bhojpuri teaching ZIP and authoring contract.
  • Native manager/removal checks, update/overwrite UI regressions and all required validation passed; whole-application line coverage is 91.68%.

v0.9.15

  • Removed nested Export and duplicate device mapping/transfer entries from Project; use Menu → Export or the bottom transfer controls. Project keeps file lifecycle and recovery actions.
  • Removed workspace Canvas controls from Menu → Layers → Selected-layer actions, where View and Options already provide them. Right-click Canvas controls remain. Reviewed toolbar, main, layer, reference and device menus; retained direct toolbar shortcuts and contextual duplicates that save navigation.
  • Native Project, Export, selected-layer and right-click menus verified. Required validation passed; whole-application line coverage is 91.60%.

v0.9.14

  • Removed the duplicate Open all settings entry from Menu → Options. Full settings remain directly in Menu and in the standalone toolbar cog; Options keeps the quick controls. No saved preferences or shortcuts changed.
  • Verified the native menus and settings shortcut; required checks passed, with whole-application line coverage at 91.54%.

v0.9.13

  • Added optional Mask edges snapping for movement, resize targets and pivots, using layer/source mask bounds clipped to the layer aperture. Moving mask edges can align alongside outer layer edges; hidden and fully masked targets are ignored. Resize handles and mirrored contact retain outer-edge geometry.
  • Project v18 and settings v14 persist the option; older files migrate with it disabled. Added regression coverage for masked targets, strict migrations and the saved UI toggle. Whole-application line coverage: 91.54%.

v0.9.12

  • Added Reset mask to the layer context menu, preserving mask origin, crop, fit and geometry with Undo support. Crop & mask groups both adjust/reset pairs; Canvas groups workspace-wide snapping, references and output format. The layer menu has four fewer top-level entries, and the empty-canvas menu remains shallow.
  • Native menu/reset checks and required validation passed; whole-application line coverage is 91.51%.

v0.9.11

  • Added a 25%-opacity source guide with sparse diagonal hatching over masked areas while editing the selected layer’s crop or mask. Hidden content stays readable; leaving editing restores normal transparent blanking. Exports/device data are unchanged.
  • Kept source-mask and 1:1 context guides from stacking opacity inside masked areas. Hatching uses fixed screen spacing and clips to the viewport, including at high zoom.
  • Verified native crop/Tab-mask rendering, both mask origins and all fit modes. Required checks passed with 91.46% whole-application line coverage.

v0.9.10

  • Restored faded content outside the layer during crop editing and outside the retained image in the 1:1 helper. Source-mask clipping had inadvertently hidden both preview textures and pattern guides there, even with no mask applied.
  • Actual layer rendering remains clipped to its layer and mask. Regression checks cover translucent guides on all four sides and both mask origins. Native double-click rendering was checked; required gates passed with 91.42% line coverage.

v0.9.9

  • Added a subtle background shift to shared hover styling, including borderless menus and toolbar menus. The colour adapts to each theme without animation, extra drawing passes or changes to control sizes. Native dark/light screenshots confirmed stationary rows; required checks passed with 91.38% line coverage.

v0.9.8

  • Fixed hover/focus outlines changing selectable-row widths and moving surrounding controls. Language choices and shared selectors now reserve the same space in idle, hovered and selected states, retaining their existing visual feedback.
  • Added layout regression coverage across all themes, including High Contrast and borderless menu styling. Native screenshots confirm the hover outline stays within its row, with no popup movement. Required checks passed; application line coverage is 91.38%.

v0.9.7

  • Added runtime ZIP language-pack installation in Settings, dynamic language choices, English fallback and settings v13 migration. Confirmed installed languages persist across restart; missing packs preserve the choice and fall back to English.
  • Added a downloadable Ukrainian/Bhojpuri example and a manual authoring walkthrough. Both are partial, unreviewed translations using existing bundled fonts. Packs do not yet supply fonts or reduce application download size.
  • Bounded ZIP/catalog validation rejects malformed packs and placeholder mismatches; installation preserves source archives and never overwrites installed packs.
  • Rust gates and manual validation passed, with 91.38% whole-application coverage. Native clicks verified installed-language selection and confirmation; automated tests cover installation, restart, removal and rejected packs.

v0.9.6

  • Added European Portuguese, Nepali, Thai, Hindi and Latin-script Toki Pona UI previews, for twelve language choices plus System default. English remains authoritative; some explanations and advanced controls retain English fallback.
  • Updated egui/eframe to 0.35 for native shaping and embedded full Noto Devanagari and Thai fonts. Preserved menu toggles and bounded file imports through the API migration. Settings v12 adds the locales and migrates prior preferences.
  • Fixed project opening/recovery resetting the language selector and saved display scales; pending language confirmation still rolls back correctly after opening.
  • Added an offline typography probe and shaping/editing regression checks. Native samples were compared with Pango. Thai End-key behavior for expanded glyphs and dictionary-based wrapping remain limitations; translations need linguistic review.
  • Rust gates and the manual build passed; whole-application line coverage is 91.41%. Native scripted clicks verified language selection, confirmation and persistence.

v0.9.5

  • Tab toggles crop/mask in double-click canvas editing, avoiding desktop Alt-mouse interception. Alt remains available for temporary masking. Text fields, property windows and other controls retain Tab navigation; repeats and active drags do not switch modes. Updated guide hints and added interaction/focus regression tests.

v0.9.4

  • Added five practical conversion-loss examples for Figma, draw.io, SVG and Canvas Pilot, distinguishing artwork, editable geometry and embedded snapshots. Linked vendor documentation and separated documented behavior from untested re-save risks.

v0.9.3

  • Added Layer/Source mask references. Source masks follow the usable source before layer crop/zoom, with an external magenta guide, source-pixel fields and the same drag, nudge, alignment and undo controls. Existing masks stay layer-relative.
  • Project v17 and clipboard v3 preserve the reference, with strict legacy migration. Recovery, embedded export snapshots and optional preview artwork retain both modes. Midra sends convert either mode to blanking; device loads remain layer-relative. Aquilon’s existing nonzero-mask limitation remains unchanged. Automated checks cover both references across all fit modes, supported snapshot codecs, clipboard, recovery and Midra state readback. Native UI inspected offline; no live-device or physical-output acceptance is claimed.

v0.9.2

  • Language choices show the native name followed by its name in the current interface language, for example English — Anglais in French.

v0.9.1

  • Added Appearance controls for 50–400% interface zoom and optional 50–200% standard-widget text scaling, with a readily accessible size reset. Added a High Contrast theme with measured text contrast and stronger widget borders. Scaling sliders keep the interface still while dragging and apply on release; typed values apply after finishing text entry. Settings v11 migrates older preferences without changing projects or exports. Fixed-size artwork/labels follow interface zoom, not the additional text scale.

v0.9.0

This minor version brings interface localization, French quick-start screenshots, safer language selection and easier access to mask editing. It is not yet published. Future completed subjects receive one patch-version bump for bookkeeping.

  • Holding Alt/Option in crop mode temporarily shows and edits the mask guide; releasing it returns to crop without opening a properties window. Active drags keep their mode until finished. This replaces Alt + double-click; regression tests cover mask edits, mode restoration, locked layers and Zoom/Pan behavior.

  • Added the missing Mask properties entry to the layer right-click Properties submenu, opening the existing mask controls. The context-menu regression test now covers this entry.

  • Language changes now preview for 20 seconds and require confirmation. The cancellation button stays in the previous language; cancellation, Escape or timeout restores it. Unconfirmed choices are never saved. Regression tests cover confirmation, cancellation, timeout, restart safety and unchanged project data.

  • Updated the French quick start to the accepted French interface terminology, with new offline workspace, layer-properties and crop screenshots. English remains the authoritative manual; English screenshots and project names are preserved. The chapter records its machine-translation origin.

  • Fixed raw crop.adjust / crop.done translation keys in the layer context menu. A rendered-menu regression test covers both editing states in every language.

  • Added Japanese, Simplified Chinese, Spanish, Ancient Greek and Esperanto software translations with immediate language switching. All are unverified machine translations; device terminology and document/clipboard content stay unchanged. Embedded open Noto fonts cover mixed Latin, CJK and polytonic Greek text, including language names in the selector. Settings v10 preserves older preferences while adding the new language values. Glyph coverage, settings migration, language-switch data preservation and minimum-window checks pass; native Linux rendering was inspected. Whole-application coverage: 91.01%. The manuals are not translated into these languages.

  • Refined French ratio wording and documented English MIDRA/WebRCS terminology preservation. Localization remains cosmetic, including unchanged new-project names, default values, export artwork and clipboard content.

  • Added embedded English/French UI catalogs using rust-i18n, with an immediate System default / English / Français selector at the top of Settings. Settings v9 migrates older preferences; projects and device operations retain their semantics. French is a preview, with some advanced controls and diagnostics still in English. Regression tests cover locale fallback, catalog consistency and switching without changing project data or pending numeric edits. Settings content scrolls at small window sizes while the language selector and Close button remain visible.

  • Added a French quick-start pilot with English fallback links and an explicit unverified machine-translation notice. Screenshots and application labels remain English; the source revision and update workflow are recorded for maintenance.

  • Recorded the multi-screen design task, including shared layers, alignment and automatic/custom proportional scaling. Existing-feature testing and a visual-only prototype precede implementation; application behavior is unchanged.

  • Clarified rename behavior in the format matrix: project names are always restored, and clipboard rename instructions use superscript “how to” links.

  • Fixed format-tier pills in the book: labels now wrap horizontally instead of stacking as illustrations. Separate tier headings clarify project backups, optional snapshots and geometry exchange; download-table pills use the same sizing.

v0.8.0 — 2026-11-16

  • Published Windows, Linux, Apple Silicon and Intel macOS binaries and portable bundles, with templates, an offline manual, checksums and build provenance. macOS uses the documented Rust 1.100 compiler-image recipe because the original pinned image is too old for the locked CAD dependencies. Linux startup was checked; native Windows/macOS runtime acceptance remains separate.

Standalone Canvas Pilot and advanced exchange milestone. See the release notes for highlights, compatibility and remaining release validation. See the release page for published downloads and platform validation.

  • Import/paste can optionally rename destination layers from supplied editor names, with proposed names shown before applying and a name-only mode. Folders and IDs stay unchanged; renames undo with geometry/appearance in one step. Clipboard v2 stores actual names and still reads v1. Added name round trips across supported codecs (Illustrator conversion remains conditional on the external converter).

  • Copy layer values now includes an exact, versioned clipboard payload for crop edges/offsets, all fit modes and blanking. Paste reviews Crop & fit and Blanking separately, keeps source/device mappings unchanged, and rejects incompatible dimensions atomically. Legacy normal-crop/zoom text remains readable.

  • Prepared issue drafts for all untracked stretch goals and linked the existing adapter issue. Gitea publication awaits a token with issue permissions.

  • Clarified that Gold ranks preservation within Canvas Pilot: .pilot.json is application-specific, not an industry-standard format for other editors.

  • Moved format tiers and pills above the feature matrix, restoring plain format names in the comparison table.

  • Simplified export to a layer-scope dropdown and one Export button. Pictures and editable snapshots live in collapsed groups with visible inclusion summaries. Import shows crop zoom and outline options only when supported by the data.

  • Name the format Illustrator throughout the interface and documentation, avoiding the ambiguous former abbreviation while retaining .ai files and codec compatibility.

  • Added opt-in saved input correction proposals (project v16), restored inactive until mapping/input review and explicit staging; older projects migrate safely.

  • Added FigCraft embedded snapshots and full-state round-trip coverage across all snapshot codecs, including fit modes, blanking, shared inputs and mappings.

  • Ranked file formats and starter downloads by preservation tier, with compact format pills and a separate advanced feature matrix. FIG, DWG and Illustrator still require a companion project for editable settings.

  • Classified book and application localization as a stretch goal, retaining its detailed roadmap and acceptance checklist.

  • Added a localization roadmap: translate and publish the book first, then localize the application, with a shared glossary, compatibility requirements and separate acceptance checklists. Translation implementation has not started.

  • Put portable release downloads first in installation help, with exact archive patterns by platform and optional command-line methods below. Added seven real offline screenshots to advanced guide chapters, with captions and capture recipes.

  • Reworded conversational test attributions as manual reviews across the catalog, guides and acceptance records, preserving dates and validation boundaries.

  • Made the template catalog’s format-choice link more visible with a compact callout and bold introduction, shared by the Markdown page and book.

  • Ordered the file feature matrix by preservation support, starting with Canvas Pilot projects, and explained capability ties and the Illustrator converter requirement.

  • Placed native-codec note 3 beside format names and extra-settings note 4 in each supporting row’s Extra settings cell in the feature matrix.

  • Moved the detailed editing-state preservation comparison from the format matrix to the import/export guide beside snapshot restoration, retaining a link.

  • Moved the extra-settings note reference beside each supporting format name in the feature matrix.

  • Shortened the feature matrix’s Pictures note to the export option names.

  • Removed the project-format note from the feature matrix and renumbered the remaining note references.

  • Switched the format matrix to ✅ / ❌ emoji, replaced ambiguous asterisks with linked numbered notes, and linked the comparison from the introduction, first layout, clipboard import and snapshot-restoration guidance.

  • Added prominent README format recommendations and paired Markdown/book links for the format matrix and template catalog. Added a short client handoff workflow to the shared catalog; downloads and detailed capabilities keep one source.

  • Restored the illustrated main README with a workspace preview, feature overview and layout workflow. Kept status badges at the top, detailed instructions in the book and task lists behind the Development link.

  • New project saves suggest .pilot.json (Canvas Pilot). Open project accepts any .json filename and validates its contents, including legacy .midra.json projects. Files are not renamed automatically. Updated the manual and checked read/write and overwrite protection for preferred, generic and legacy filenames; JSON contents and schema version are unchanged.

  • Added user-guide feature matrices for all eleven exchange formats, project saves and separate clipboard workflows. Distinguished geometry, names, visual crop/mask pictures and editable snapshot restoration, checked against the codec behavior.

  • Simplified READMEs to navigation and kept user instructions in the book’s source chapters. Moved task-list discovery behind Development and indexed contracts, research and handoffs in AGENT_DOCUMENTATION.md; removed internal records from the user book’s navigation while preserving their files and evidence.

  • Added an installation/help chapter covering release downloads, tagged-manifest cargo-binstall without compile fallback, cargo install from a release tag, platform launchers, updates and troubleshooting. Linked it from the README, book, guides and portable quick start; noted the pending first release.

  • Restored build-status badges to the top of the README. Checked release readiness without compilation or publication, added required cargo-binstall metadata and replaced the portable archive’s repository README with standalone instructions.

  • Saved a conversation handoff for reopening the standalone project, including pending input-ratio scope, planned videos, device-test context and publication state. Linked it from agent/developer guidance and retained pending plans in the task list without changing completed acceptance status. Added the approved showcase, video walkthrough and optional chapter clips as a stretch goal.

  • Redesigned the repository README with an illustrated introduction, layout workflow, feature overview, format/device guidance and direct setup, template and help links. Existing screenshots are identified as captures from before the rename.

  • Audited all 165 migrated project files; task lists, stretch goals, advanced guide, screenshots, templates and fixtures were retained. Expanded agent guidance and documentation navigation, and included the transferred checklists/research in the book. Recorded the comparison against the exact pre-migration commit.

  • Moved Canvas Pilot, its device probe, templates, tests and manual into the standalone idle-org/canvas-pilot repository. Builds and documentation no longer require beffroi-tools; project/settings compatibility and the public manual URL are unchanged. CI publishes only this book and its own badges. The coverage command also initializes its output directory when run directly from a fresh checkout.

  • Fix stale format-acceptance links after the backlog reorganization, restoring generated manual and print-page anchor validation.

  • Document the manual-verified distinction between input Content ratio and Transform to, their existing advanced device controls, and the limits of local preview modeling. No geometry, device writes or save format changes.

  • Add independent layer masking: magenta handles, whole-window drag, arrows, numeric pixel edges, alignment, center/reset and Undo/Escape, without resizing content. Midra imports and reviewed sends preserve masks; Aquilon rejects unsupported masking. Project v15 migrates older files with zero masks; recovery, embedded snapshots and export artwork preserve blanking. Tests cover pixel preservation, gestures, migration and device round trips. Physical mask-edge rasterization remains an engineering follow-up. Workspace tests (539 passed, one ignored), lint/docs and coverage (90.63%) passed; visual mask drag/resize checked. The Aquilon emulator at 192.168.10.146:3000 passed Preview/Program regression with both sizing strategies; original state restored and read back.

  • Allow moving the whole 1:1 crop by dragging anywhere inside the layer, including empty margins, or using arrow keys (Shift for ten pixels). Opposite crop edges move together, preserving crop size, pixel scale and the container; stop at source bounds, with one-step Undo and Escape cancellation. No schema or device-protocol changes.

  • Disable the crop helper button, context-menu action and double-click shortcut for Centered/Cropped: those modes fit automatically. Keep numeric crop fields available in Crop properties; normal crop and the 1:1 helper are unchanged.

  • Add the double-click crop helper for advanced 1:1 fit: independent side/corner handles trim or restore source pixels while preserving pixel scale and the layer container. Show a faded source guide, synchronize crop fields, and keep one-step Undo/Escape cancellation. Centering follows Midra’s 1:1 semantics; no project schema or device protocol changes. Regression tests cover edge limits, every handle, double-click interaction and undo/cancel.

  • Add opt-in advanced Midra layer fit: centered 1:1, Centered, Fullscreen and Cropped, with crop-first previews/export artwork, container resizing, device load/send and undo. Normal zoom/crop remains the default; input inheritance is excluded and Aquilon rejects unsupported explicit modes. Project v14 persists fit with migrations from v1–13. Automated math, UI and mock-device round trips cover the modes; physical raster precision remains unverified. Replace impractical operator measurements with an engineer-ready stretch goal.

  • Narrow Midra aspect work to explicit layer Crop-menu modes following operator findings: 1:1 keeps pixel scale during resizing, and explicit layer modes override input fill. Retire input-inheritance/correction tests from this task; keep advanced input controls separate. Runtime behavior is unchanged.

  • Add an ordered feature demonstration checklist covering project creation, editing, geometry exchange, device transfers and input previews.

  • Add an operator checklist and results template for Midra fill/aspect tests, covering scaling, inheritance, crop order, input correction and rounding.

  • Prioritize Midra input layer-fill and layer aspect support. Review the official V3.2 user manual, AWJ v3.2 and REST v3.0.13 guides; record the remaining inheritance, scaling, cropping and physical-output checks in the test list. This is research/planning only; mode conversion behavior is unchanged.

  • Split the backlog into a to-do list (including stretch goals) and a test list. Move Inkscape clipboard acceptance to testing and remove standalone captured input image saving from planned work following scope review.

  • Register standalone Aquilon AQL Cmax 6.2.x as first-class supported, based on the recorded 6.2.79 emulator acceptance. Replace the stale implementation handoff with completed milestones and explicit scope boundaries; physical output, other models/firmware and unsupported modes remain unverified.

  • Record manually reviewed clipboard workflows for Illustrator, draw.io and Figma. Narrow remaining clipboard acceptance to Inkscape; QCAD and PowerPoint remain file-exchange workflows for this scope.

  • Validate the supplied Illustrator SVG clipboard sample with regression coverage for fractional coordinates and optional centered-stroke bounds. Record QCAD as a file-exchange workflow following workflow review; no clipboard adapter is planned. Existing SVG parsing handles the sample; live clipboard delivery remains unverified.

  • Mark export/workflow cleanup solved following user confirmation; move it from the remaining backlog to completed implementation.

  • Preserve the supplied Figma SVG clipboard sample as a regression fixture for ordered rectangular paths and matrix translations through the paste parser. Existing SVG parsing handles it; native Figma clipboard formats and live clipboard delivery remain unverified.

  • Add a sourced presentation-switcher adapter survey, ranked by public control documentation with separate geometry feasibility assessments, and a stretch goal to consider selected families. Research only; no new support is enabled.

  • Compact Measure position from into a dropdown with side-by-side From screen and To layer pickers and a summary of both points. Preserve linked/independent point selection and project autosave; regression checks exercise the popup.

  • Record a distant-future stretch goal for multiple editor screens in one project, selected through a dropdown with one screen displayed at a time.

  • Add vector send/load arrows to the bottom transfer buttons, matching the mapping controls without relying on symbol-font glyphs. Visually checked at 1440 and 1000 pixels wide.

  • Replace Aquilon full-store downloads with batched AWJ reads on TCP 10606, retaining fresh preflight and verified sends. Emulator reads fell from 124 MB to about 197 KB and took about 0.30 seconds directly. Twelve transfer cases passed with restoration; malformed/incomplete responses and changing snapshots fail explicitly. HTTP/WebSocket custom ports remain supported; AWJ must be reachable on the same IP.

  • Replace unsupported arrow glyphs in transfer labels and help text with plain text so they render with the bundled UI font.

  • Add a separate Aquilon / LivePremier 6.2 adapter around a shared screen/layer model, with bounded cancellable state reads, allocated-slot discovery, explicit bank roles, fractional geometry and centered crop/zoom transfer, and input previews above 16. Sends preflight conversion inputs and bank roles, apply the correct family pulse and verify readback. Twelve emulator Preview/Program geometry/crop cases passed with baseline restoration; device writes round sizes/centers to whole pixels because WebRCS rejects fractional fields despite firmware accepting them. The initial profile targets standalone AQL Cmax; linked systems, other firmware/models and unsupported fit/input-correction modes remain explicit limitations.

  • Save project version 13 with family-aware device_link destinations; migrate versions 1–12 and retain old recovery/embedded-project compatibility. Use device-neutral connection and mapping controls while preserving Midra behavior.

  • Rename Midra Layout to Canvas Pilot across the application, Rust package, manuals and starter-file catalog. Existing project formats, settings and recovery locations remain compatible; Midra device names remain unchanged. Workspace Rust gates and 62 Python tests pass; full coverage is 90.55%. Illustrator starter contents retain legacy metadata because VectorCraft CLI was unavailable.

Changes since v0.7.0; these are not yet part of a new release. Current project schema: v13; application settings: v8.

  • Audit against all 21 commits from v0.7.0 through a7b51cb: no missing change entries. Reconcile superseded capture-menu wording, project-version progression and template counts; preserve the released history below.

  • Add an Aquilon implementation handoff covering the observed emulator, bounded state loading, family-specific geometry/transfers, saved links, crop, capture and staged acceptance checks. No device support is enabled by this task.

  • Recommend SVG for Illustrator exchange in the README, manual and template catalog. Keep Illustrator as an optional compatibility target requiring external VectorCraft CLI, with executable discovery and setup documented.

  • Group viewport context-menu property windows under Properties and capture under Input preview & crop guides, with quick preview/opacity controls. Keep common editing actions direct, move Delete after Lock/Hide, and group canvas options at the bottom. UI tests exercise property submenus and multi-selection actions.

  • Allow Midra mapping & transfer to open while offline, with Connection settings available and scope/mapping controls hidden until connected. UI regression coverage verifies offline opening does not start a read or send.

  • Validate device identity before downloading state. Aquilon now reports its unimplemented adapter instead of a misleading 32 MiB limit error. A read-only AQL Cmax 6.2.79 emulator probe measured a 118 MiB store; Aquilon connectivity remains pending. Mock HTTP coverage checks that no state request is made.

  • Record user acceptance of Figma FIG, FigCraft FIGCRAFT, DXF and DWG import/export; mark these format issues solved in the plan and compatibility notes.

  • Add native FigCraft (.figcraft) geometry import/export, file drops and page/frame selection using the existing crate. Include background/artwork options and both starter sizes in the combined ZIP. Test native resaving and geometry/artwork round trips; no_proprietary builds keep this codec disabled.

  • Offer Download all templates as ZIP first in the README and starter catalog, replacing the Illustrator-only archive. With the FigCraft addition above, it contains 22 Full HD/UHD starter files across 11 formats. Tests check every archived filename and byte against the individual templates.

  • Clear layer selection when clicking empty space in the Layers list, including gaps between rows and the gutter beside folder contents. Regression tests cover blank clicks and normal folder/layer selection.

  • Make the folder icon create an empty folder without moving selected layers; use one tooltip. Both layer-list and viewport Move to folder menus move all selected layers when invoked on a selected layer. Empty folders support rename/delete, undo and save/load in project v12, with v1–v11 migration. Added folder lifecycle and context-menu selection regression tests.

  • Add opt-in extra Midra parameters to SVG, draw.io, geometry JSON/CSV, ASCII DXF, HTML and PPTX, using metadata/custom fields or comments. Geometry remains editable; explicit Restore parameters from export recovers the original snapshot into an unsaved project. JSON/CSV v2 carries metadata; plain v1 exports are unchanged. Document all formats, including unsupported DWG/FIG/FIGCRAFT/Illustrator metadata embedding. Round-trip tests cover settings and geometry; installed draw.io exported the metadata-bearing diagram to SVG, and librsvg rendered both SVG variants.

  • Audit project persistence: version 11 introduced saved snapping/grid setup, group resize mode, collapsed folders, capture assignments/stills, guide opacity and refresh settings. Saved auto-refresh reopens paused. Versions 1–10 migrate explicitly; invalid previews leave current work intact. Added round-trip/migration and preview restoration regression tests; documented project/application/session ownership in the persistence audit. Project v12 subsequently adds persistent empty folders, as noted above.

  • Preselect linked Midra input sources in untouched capture controls after connection or layer import/load, without enabling previews or requesting images. Preserve operator selections and leave unassigned/non-input sources unselected; regression coverage checks the scheduler stays idle.

  • Move input selection into the layer properties Preview window to avoid nested dropdowns closing when long input lists extend outside the menu. The current entry point is Input preview & crop guides → Configure capture…; quick preview/opacity controls remain in that submenu.

  • Group Load and Send mapped layers on the final row of Midra mapping & transfer, with vector down/up arrows and direction tooltips. Keep send preparation separate from the explicit Send click and retain scope-aware loading.

  • Round fractional device-reported content dimensions to whole pixels for centered crop import/readback and send compatibility, with nonblocking before/after warnings. Preserve raw state and fractional box geometry; invalid ranges and genuine source mismatches still fail. Regression tests cover cropped import, warning behavior, both send sizing strategies and invalid ranges.

  • Restore recovery sessions silently instead of opening a “Recovery restored” message. Keep recovery failures and retry information visible; regression coverage checks restored edits and absence of the success popup.

  • Investigate Aquilon/LivePremier compatibility against the upstream web-control implementation; document firmware-specific geometry, bank and apply paths, saved-link constraints, and the staged adapter/acceptance plan. Research only: no Aquilon support or hardware verification claimed.

  • Add a Recent machines picker for the last four successful connections, saved across restarts with distinct ports and most-recent-first ordering. Selecting an entry reads the device immediately; failed attempts do not displace history. Settings v8 migrates v1–v7 with empty history; tests cover ordering, deduplication, failures, persistence and validation.

  • Support optional device ports for HTTP state reads, input captures and WebSocket sends, preserving the address in preferences/autoconnect. Accept all four Midra 4K identities (Eikos, Pulse, QuickVu, QuickMatrix) with device-reported allocation. Read-checked Pulse 4K 3.3.7 at port 3000 (four layers); add address, model, capture and WebSocket port regressions. Other model hardware acceptance remains outstanding.

  • Replace the layer-header Folder, Add image and Manage text buttons with compact vector icons, grouped on the right, with tooltips and accessible action names.

v0.7.0 — 2026-11-14

  • Split the Midra mdBook into Quick start and Advanced sections, with a first-layout walkthrough and nested workflow/contract chapters. Keep the existing detailed chapters and screenshot capture notes linked.

  • Update the shared Rust application version to 0.7.0; see the release notes.

  • Add direct links to the published mdBook manual from the project README, tool guide and documentation indexes.

  • Mark PPTX, draw.io and SVG format acceptance as solved following manual review confirming all three work (2026-11-14).

  • Replace the incomplete DXF skeleton with the official shared Craft DXF document writer/reader; add optional Craft DWG exchange with the same pixel geometry and canvas limits. Refresh CAD starter files and cover document structure, binary DXF and DWG round trips. Add a byte-preserving ZIP of the Illustrator templates to bypass Gitea/browser PDF preview downloads.

  • Place insufficient import-destination warnings directly below the destination scope selector instead of repeating them near the Import button.

  • Simplify geometry/clipboard import into a shared review without repeated acquisition controls. Collapse clipboard and before/after details, emphasize destination mapping, and add independent All / Selected / Folder scopes plus per-item exclusion. Preserve compatible mappings and canvas selection; regression tests cover scope filtering, atomic import and review visibility.

  • Route supported geometry file drops through the regular asynchronous import/mapping review, including SVG/draw.io and native formats when available. Keep raster drops as references; support path/data drops and multiple documents through the file/page chooser, with a combined 16 MiB limit and atomic failure. Regression tests cover codecs, case-insensitive names, batches and invalid/oversized inputs.

  • Add an mdBook manual built from the existing guides, with local assets and downloads. Jenkins publishes successful main builds under /mnt/books/manuals/; staging, link validation and scoped publication have regression coverage.

  • Replace the long overview with a visual quick start, move detailed workflows into topic guides, and centralize all nine starter-file formats in one catalog. Add real application screenshots with reproducible capture notes; retain the existing template files and validation contracts.

  • Clarify shared Midra links: warn with other linked layer/folder names while allowing link edits; disable conflicting scoped sends and list all overlapping destinations. Preserve conflict-free folder/selection sends and remapping. Remove nested-folder/additional-codec backlog items and replace the extra-links proposal with this shared-destination workflow. Regression tests cover warning text, send blocking and scope isolation.

  • Remove duplicate overlay-grid controls from snapping menus; keep them in the adjacent Grid toolbar menu and a separate section in Editing preferences.

  • Move the background grid out of the sample artwork into a full-output overlay above reference images. Add a Grid toolbar menu, independent visibility/snapping, and 1–64 columns/rows (default 8 × 6). Persist these preferences in settings v7 with migration from v1–v6; share fractional grid positions across movement, resizing and pivot snapping. Regression tests cover rendering order, toggles, snapping and settings compatibility.

  • Keep the screen name and output resolution visible with reference images, reserving their fit-screen margin. Viewport tests check label visibility and clipping with and without imported images.

  • Double-click again in visual crop mode to finish editing; preserve selection and framing. Viewport regression coverage checks entering, exiting and reopening without geometry changes.

  • Pool input captures across matching queued layers and automatic previews, including requests queued during a fetch. Share one decoded texture and consume matching requests on failure to avoid per-layer retries; preserve existing manual stills. Regression tests cover direct, automatic and import captures, failure handling and different-input isolation.

  • Capture a first still automatically when selecting a preview input, in both pickers. Queue the latest choice behind the shared five-second throttle and active request, without waiting the auto-refresh cycle; retain explicit recapture/import. Regression tests cover throttling, coalescing and cancelling stale targets.

  • Hide no-signal inputs by default in both preview pickers; add a shared session-only Show inputs without signal toggle and explicit No signal labels. Preserve existing choices when filtering or signal loss occurs, and leave initial selection empty when no input has signal. UI tests cover both pickers and the empty state.

  • Add Import input snapshot… with an explicit destination picker for any editor layer or a fixed reference image. Layer imports optionally keep refreshing; references never auto-refresh. Preserve selection/geometry and existing snapshot limits; regression tests cover both destinations without a selection.

  • Simplify layer previews to Enable → Input → Capture still → Auto-refresh. Capture directly replaces that layer’s image; auto-refresh is per layer and can fetch the first image. Preserve serialized low-rate requests, bind manual results to their original target, and keep manual stills unchanged by other layers’ refreshes. Regression tests cover control order, recapture, stale results and automatic first capture.

  • Move captured-input controls and the image preview into a dedicated Preview properties tab, with a matching right-click entry. Crop keeps its geometry controls; the existing preview context submenu remains available. Tab-switch regression checks include Preview.

  • Keep Mapping limited to Midra screen/layer links; move editor input identity into the opt-in Advanced Source section. Offer editor Inputs 1–8 independently of layer count, with New editor input for additional local identities. Apply creates missing slots and assigns the source atomically with Undo; project round-trip tests cover shared Input 8, expansion and limits. Midra layer links and physical routing remain separate.

  • Filter Midra destinations by each screen’s CURRENT allocated layer count, not the eight firmware storage slots or physical inputs. Keep allocated layers available without assigned sources; exclude unallocated slots from import, mapping and sends, including saved links. Regression checks cover active versus staged allocation and Preview/Program sends.

  • Keep existing Midra layers available for mapping, import and send regardless of input assignment or OFF state. Uncropped layers without content dimensions import their container; sends use editor dimensions when hardware content dimensions are unavailable, preserving routing. Regression tests cover unassigned layers and both send strategies/targets.

  • Use absolute Gitea main-branch URLs for repository file links in the root README; verify linked files exist.

v0.6.0 — 2026-11-14

  • Synchronize the shared Cargo package version with the v0.6.0 milestone tag; see the release notes.

  • Add opt-in input-preview auto-refresh with a 5–300 second request interval (default 10). Visible previews refresh round-robin with shared input textures, one background request at a time; pause offline/manual capture, retain images on failures and keep fixed references unchanged. Timer controls and assignments remain session-only. Regression checks cover scheduling, throttling and response handling.

  • Use captured input stills as toggleable layer previews, with crop guides composited above them and a 0–100% opacity slider in Crop properties and the layer context menu. Guides return to full opacity without an enabled preview; source/input/dynamic crop and ghost overflow share the same mapping. Layer-preview assignments/settings are session-only; capture is throttled, with optional auto-refresh added above.

  • Group the guide and supporting documentation in this tool’s folder; update portal, cross-document and packaging links for the new paths.

  • Add manual Midra input-still capture through the verified WebRCS PNG endpoint, with preview/Add as reference, one request at a time and a five-second minimum interval. Device-setting writes are not involved; active-input 512 × 288 and inactive blank-image responses checked on the Eikos.

  • Load project/recovery files and decode embedded references in a background worker, install atomically, preserve work on errors/cancel and pause recovery autosave while loading. Reconcile the historical plan into completed implementation, remaining features and separate hardware/platform acceptance checks.

  • Add README-linked two-layer PPTX, Figma FIG and Illustrator templates in Full HD and UHD 4K. Extend the template generator with format selection and import verification; test native fixture geometry, with Illustrator checked through VectorCraft 0.24.1.

  • Remove the redundant Copy coordinates button from the title header and right-align the device label. Existing copy commands remain available.

  • Move Menu from the title header to the toolbar immediately before Project, within the same wrapping group.

  • Place Load before Send in the status bar.

  • Align status-bar connection, mapping, send/load and scope controls in one vertically centered row with consistent spacing and button heights; let labels determine positions instead of fixed offsets.

  • Rename Apply changes and Configure Midra export to “Midra mapping & transfer…” so the action clearly opens layer mapping and send/load settings; actual sending remains a separate button.

  • Keep multiple reference images in a purple section of the layer list, with add, eye, remove, settings and Show only actions; references remain fixed and excluded from layer/device operations. Add removal to Import and viewport/reference context menus. Queue multi-file imports in order, composite visible guides in viewport/artwork exports, and save all images in project v10 with tested v1–v9/recovery migration. Corrupt additions or project images preserve existing work.

  • Add Paste layer values beside Copy layer values in the layer context menu, using the existing clipboard import and mapping review before applying changes.

  • Make Source an advanced, opt-in section with explanations of input aspect correction and pre-layer input crop. Show the linked device input’s actual WebRCS aspect/crop controls separately from the local geometry model. Stage only edited fields, include them in scoped sends only while enabled, and pulse input crop updates. The opt-in and staged device edits are session-only and clear on disconnect, address/project change or uncheck. Verified field names/ranges against the connected Eikos WebRCS; regression tests use mock devices, without hardware writes.

  • Add a Mapping properties tab and right-click entry with selectable Midra screen/layer links and Unmap. Unmapped layers are excluded from linked sends/loads; link edits are local, saved with projects and undoable. Move the separate editor input identity selector into Mapping.

  • Draw the snapping dropdown chevron and layer order arrows as vector icons, avoiding missing font glyphs while preserving tooltips, disabled states and button accessibility.

  • Default Midra transfers to All layers with a shared All/Selected/Folder selector. Folder mode follows clicked folders for quick alternate-layout sends/loads; links remain editable and out-of-scope links are preserved. Import suggests saved links and saves remapped/new-layer links and folder membership atomically with geometry. Tests cover scope isolation, reused destinations, in-flight reads and Undo; no hardware writes were needed.

  • Organize the flat layer sidebar into collapsible folder groups: select contents, double-click rename, group eye/lock controls, drag layers between folders/root, and reorder folders as blocks. Add new-folder and right-click actions, with atomic Undo and existing project compatibility; empty groups disappear and nesting is not introduced.

  • Reorder the viewport toolbar into shared bordered groups: Project/Import, Undo/Redo, Select/Move, view controls, Align/Snap/Pivot, and Output/Options. Groups wrap together on narrow windows and preserve optional icon captions.

  • Snap moving layers, resize handles and pivots to screen center and quarter guides on both axes. Moving layer centers also snap to these interior guides; the existing screen snapping option controls all screen guides.

  • Use a crisp, theme-aware magnet icon for the snapping dropdown; preserve snapping controls and active grid indicators.

  • Unify file exchange around shared geometry preparation, byte-oriented codecs and one Export layers window. Add optional native PPTX/FIG import/export with slide/frame selection and embedded artwork, plus local VectorCraft Illustrator conversion. File conversions run off the UI thread. Document and test --no-default-features --features no_proprietary; CI covers both configurations and production coverage includes the codecs.

  • Add versioned geometry JSON, RFC-style CSV, DXF and HTML/CSS import/export alongside SVG and draw.io. All six formats have two-layer Full HD/UHD templates and round-trip tests; artwork support is explicit per format.

  • Add README-linked two-layer SVG and draw.io templates for Full HD and UHD 4K, generated by the application exporter and checked byte-for-byte in regression tests.

  • Import SVG rendered by draw.io Desktop, including its SVG 1.1 DOCTYPE, nested cell wrappers, symbol/image layers and generated label fallbacks. A background-preserved native 31.7.0 round trip was checked; draw.io’s cropped SVG exports necessarily retain their rebased coordinates.

  • Add current-layer SVG and draw.io exports with optional embedded backgrounds and source-pattern placeholders; import native/compressed draw.io files. Round-trip tests cover scopes/artwork and whole-pixel geometry; draw.io Desktop 31.7.0 rendering and XML re-save were checked. Use JSON for full source/crop fidelity.

  • Hide tiled source patterns outside crop editing, even with saved pattern display enabled. Double-click/Crop properties reveals the selected layer’s pattern; the existing preference now shows other layers’ patterns only while cropping.

  • Constrain Crop-tab X/Y offsets to the valid content bounds, including after zoom decreases; typed and dragged edits clamp to the edge instead of producing offset-range errors. Undo remains available.

  • Remove redundant position/size and output Apply buttons and their close prompts; names/folders commit on Enter or focus loss with Undo. Rename staged source and clipboard/SVG actions to “Apply source changes” and “Import mapped values”; Midra sends remain explicit.

  • Add ImageGen application artwork in PNG, Windows ICO and macOS ICNS formats. Embed native icons and support Linux/BSD desktop entries and macOS app launchers; native Windows/macOS visual checks remain required. Include artwork for the Python device probe.

  • Fix the crop-alignment regression test’s Clippy range-loop warning so CI passes with warnings denied; retain both offset assertions.

  • Rename the positioning toggle to “Use a different measure point”.

  • Keep the example presentation visible for every output format, adapting its title, grid, tagline and screen labels to the new dimensions.

  • Right-click a layer in the viewport or layer list to rename/delete it; list menus stay compact. Delete supports Undo and respects locked/hidden/last-layer protection.

  • Swap new-project default labels: top layer is 01 / Presenter, lower layer is 02 / Slides. Geometry, draw order and existing projects are unchanged.

  • Recover the last session automatically from a separate two-second autosave; named saves stay explicit. New project offers Save/Discard/Cancel and shows the last manual-save age. Failed/corrupt recovery is reported and preserved.

  • Measurement-point choices and the independent-point toggle autosave to the current project file; other unsaved edits remain untouched. New projects need a first Save.

  • Separate Select (V, previous behavior) from Move (M), which drags the existing selection without selecting, deselecting or resizing.

  • Layer properties’ Layer tab applies size/locked-ratio changes immediately; remove its Apply button. Drag edits undo together; Source edits remain explicit.

  • Layer properties’ Crop tab automatically enables visual crop editing and disables it on leaving/closing; remove its redundant toggle button.

  • Ctrl/Pivot now works on crop/zoom handles, keeping the source pixel under the saved gravity point fixed; crop limits prevent empty borders.

  • Group grid snapping tools and snapping options in a toolbar dropdown; the label shows the active grid. Pivot remains independently accessible.

  • Save gravity points per layer across selection changes and reopening; placement/reset supports Undo. Project v9 migrates older files to centered pivots.

  • Pivot dragging snaps to corners, side midpoints and center even with snapping off; also honors grid/pixel/screen/layer options. Alt bypasses built-in anchors; guides and linked pivots follow the result.

  • Optional “Use a different layer point” exposes independent screen/layer measurement points (e.g. screen top-left → layer center). Numeric sizing preserves the endpoint. Project v8 saves the choice; v1–7 retain matched points.

  • Hide bottom interaction hints when viewport space is tight, reclaiming their 40 px footer. Off-view layer warnings remain visible.

  • Fit screen now includes the example backdrop’s Screen 1/resolution labels, preventing clipping in shorter/wider viewports.

  • Move the reference drag/drop/import hint into the example artwork footer and reclaim its separate viewport status row. Image details and warnings remain above the view.

  • Default backdrop title is “Example Conference Name”; edit/reset it in Options → Example backdrop or Settings → Reference images. Project v7 saves the title and migrates v1–6.

  • Add persistent Move/Pan/Zoom icons (V/H/Z). Zoom supports click, Alt-click out and horizontal drag; Space/middle-drag pans from any tool. Escape cancels camera drags; grid/pivot choices stay independent.

  • Layer lists now show the topmost layer first; drag/drop and arrows match. Selection no longer raises layers temporarily. Saved project/SVG stacking stays compatible.

  • Show current aspect ratios beside dimensions and the ratio lock. Accept manual W:H, W/H or decimal ratios; locked edits keep width/reference and adjust height, unlocked edits wait for the lock. Layer properties initially remained Apply-based; subsequent automatic application is recorded above.

  • Add persistent 10 px/100 px grid and Pivot toolbar icons with shortcut tooltips. Grids exclude each other; Pivot combines with either. Matching modifiers temporarily invert toggles; choices last for the session.

  • Ctrl shows a movable resize pivot; Ctrl-resize keeps it fixed. Same/Mirror/Opposite modes share or reflect relative pivots. Double-click resets; Ctrl+Shift keeps the 100 px grid. Session-only, with snapping and Undo.

  • Hold Alt to temporarily invert movement/resize snapping (on ↔ off), overriding Shift grids without changing saved settings.

  • Add Snapping controls to viewport right-click and quick Options menus; share and automatically save the same editing settings.

  • In Adjust layer crop mode, alignment buttons move zoomed content within the fixed layer box; preserve zoom and support Undo.

  • Snap mirrored/opposite resizing to exact edge contact between both moving layers, including unequal sizes; preserve anchors/ratios, Alt bypass and Undo.

  • Distinguish completely out-of-view layers from partial/complete output-screen overflow; give navigation versus positioning advice. Rename Fit selected to Zoom to selection.

  • Give the canvas more space: compact reference hint/status, tighter viewport margins and footer. Warnings still wrap. Fix resize edge snapping at fractional viewport scales.

  • Add center to “Measure position from”; numeric resizing preserves center offsets. Project v6 saves the reference and migrates v1–5 corners.

  • Rename Preferences to Settings; menu actions now read “Open all settings…”.

  • Shift-drag moves/resizes on a 10 px grid; Ctrl+Shift uses 100 px, Alt bypasses. Replaces resize snap inversion; Shift-click and empty-canvas additive selection remain.

  • Add a subtle “Double-click to edit” reminder in the layer-list header.

  • Completed the input-preview backlog in this release: verified snapshot access, manual capture and optional timed refresh (see above).

  • Reject negative/non-finite crop entries; crop-edge dragging stops at zero and zoom stays within 100–10000%. Signed content offsets remain supported.

  • Keep the chosen resize mode through selection changes, Escape, Undo/Redo and project loads in the current session; single-layer resizing still works normally.

  • “Options save automatically” is non-selectable informational text.

  • Reorder layers with manager ↑/↓ buttons or drag-and-drop in the inspector. One-step Undo; IDs, links, crops and pending names follow the layer. Test save/reload and SVG order.

  • b251798: Crop zoom/offsets and output resolution apply on edit; position/size applies when leaving a field. Pending drafts prompt Apply/Discard on close; Apply buttons highlight changes. Device sends remain explicit.

  • Early apply-on-edit validation: workspace tests, fmt, Clippy and rustdoc passed; LLVM tools were unavailable then. Subsequent milestone checks include passing coverage (89.99%); see release notes for hardware/platform limitations.

v0.5.0 — 2026-11-14

  • 8322eab: Tagged baseline before the apply-on-edit changes. Editor, saved screen/layer links, Preview loading and explicit device sends.