3.6 KiB
Quick start: your first layout
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
Launch Midra Layout. To run from source, use this command from the repository root:
cargo run --locked -p midra-layout
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
- Click Presenter in the Layers list or on the canvas.
- Drag the layer to position it. Drag a corner handle to resize it; keep Keep aspect ratio when resizing checked to preserve its proportions.
- 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.
- 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.midra.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 Project → Export → Export layers…, select SVG and All layers…, and save the export. For plain layer boxes, leave the background and placeholder pictures disabled. The SVG can be opened in a vector editor.
Keep the .midra.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:
- Organize and align layers, including folders and multiple selections.
- Add reference images and adjust the canvas view.
- Control source formats and cropping.
- Import existing geometry or choose export scopes.
- Connect an Eikos 4K and review layer transfers. Device sends are explicit actions; ordinary local editing does not send changes.
The advanced guide also links to settings, compatibility contracts and hardware-verification details.
