beffroi-tools/docs/canvas-pilot/README.md

4.2 KiB
Raw Blame History

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.

Quick start · Advanced guide · Starter files for all formats · Changelog

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.

Canvas Pilot workspace with Slides and Presenter layers on a Full HD canvas

The canvas shows the layout; the inspector gives exact dimensions and positions.

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.

Layer properties showing width, height and aspect-ratio controls

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.

Visual crop editing with a source preview and content-framing controls

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

  • Save your work: use Project → Save project… for a .midra.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 Project → 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 AI. Prefer SVG for Illustrator exchange: AI requires a separately installed VectorCraft CLI for both import and export. See AI 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. File schemas and compatibility rules are in the interface reference.

Screenshot capture and update instructions