beffroi-tools/docs/midra-layout
Dandaedre 89697bd1a2 Restore recovery sessions without a success popup 2026-11-15 11:41:42 +01:00
..
design Organize documentation by tool and update references 2026-11-14 17:57:06 +01:00
guide Restore recovery sessions without a success popup 2026-11-15 11:41:42 +01:00
images Create visual Midra quick start and topic guides 2026-11-14 20:32:30 +01:00
README.md Separate Midra manual quick start and advanced guides 2026-11-14 22:29:16 +01:00
aquilon-compatibility.md Document Aquilon protocol differences and adapter implementation plan 2026-11-15 11:40:45 +01:00
changelog.md Restore recovery sessions without a success popup 2026-11-15 11:41:42 +01:00
device-check.md Restrict Midra mappings to actively allocated layers 2026-11-14 18:24:09 +01:00
plan.md Document Aquilon protocol differences and adapter implementation plan 2026-11-15 11:40:45 +01:00
resolutions.md Organize documentation by tool and update references 2026-11-14 17:57:06 +01:00

README.md

Midra Layout

Read the full manual →

Midra Layout icon

Midra Layout 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 an Analog Way Eikos 4K 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 midra-layout

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.

Midra Layout 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 and Illustrator AI. It also lists format dependencies.
  • Use an Eikos 4K: 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