beffroi-tools/docs/templates/midra-layout/README.md

47 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Midra Layout starter files
[Midra Layout](../../midra-layout/README.md) · [User guide](../../midra-layout/guide/README.md) · [Geometry format contract](../../interfaces/midra-layout-exchange.md)
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 Midra Layout.
Review the detected rectangles and their destination layers before applying.
| Format | Full HD · 1920 × 1080 | UHD 4K · 3840 × 2160 | Use with |
| --- | --- | --- | --- |
| SVG | [Download .svg](midra-layout-1080p-2-layers.svg) | [Download .svg](midra-layout-4k-2-layers.svg) | Vector editors and browsers |
| draw.io | [Download .drawio](midra-layout-1080p-2-layers.drawio) | [Download .drawio](midra-layout-4k-2-layers.drawio) | diagrams.net / draw.io |
| Geometry JSON | [Download .json](midra-layout-1080p-2-layers.json) | [Download .json](midra-layout-4k-2-layers.json) | Scripts and geometry exchange |
| Geometry CSV | [Download .csv](midra-layout-1080p-2-layers.csv) | [Download .csv](midra-layout-4k-2-layers.csv) | Spreadsheets and data tools |
| DXF | [Download .dxf](midra-layout-1080p-2-layers.dxf) | [Download .dxf](midra-layout-4k-2-layers.dxf) | CAD tools |
| HTML | [Download .html](midra-layout-1080p-2-layers.html) | [Download .html](midra-layout-4k-2-layers.html) | Browsers and web layouts |
| PowerPoint | [Download .pptx](midra-layout-1080p-2-layers.pptx) | [Download .pptx](midra-layout-4k-2-layers.pptx) | PowerPoint, LibreOffice Impress or DeckCraft |
| Figma FIG | [Download .fig](midra-layout-1080p-2-layers.fig) | [Download .fig](midra-layout-4k-2-layers.fig) | Figma or FigCraft |
| Illustrator AI | [Download .ai](midra-layout-1080p-2-layers.ai) | [Download .ai](midra-layout-4k-2-layers.ai) | Illustrator or VectorCraft |
## 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 Midra project. Use **Project →
Save project…** for a full `.midra.json` project; see the
[project format](../../interfaces/midra-layout.md). Versioned schema and migration
examples stay beside their [interface contracts](../../interfaces/README.md).
PPTX and FIG support uses the optional native codecs included in the default
build. Illustrator AI import/export requires a separately installed VectorCraft
CLI. See [dependencies and licensing builds](../../interfaces/midra-layout-exchange.md#optional-native-document-codecs-and-licensing-builds).
## Maintaining the base files
Keep all formats here and link to this catalog instead of copying files or
maintaining separate download lists. The [generation and verification commands](../../interfaces/midra-layout-exchange.md)
rebuild both canvas sizes with the application exporter and verify their geometry.
Text and native PPTX/FIG fixtures are covered by regression tests; the AI check
requires VectorCraft and is opt-in. The AI samples were checked with VectorCraft
0.24.1, not Adobe Illustrator.