Add PPTX Figma and Illustrator layout templates
Beffroi/beffroi-tools/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-11-14 16:48:47 +01:00
parent 94b1053823
commit 3eccae3b80
11 changed files with 108 additions and 11 deletions

View File

@ -110,14 +110,15 @@ See [development setup](docs/development.md) for prerequisites and checks.
Ready-made canvases with two named 16:9 layers. Choose a size, then a format.
<details>
<summary><strong>Browse Full HD and UHD 4K templates</strong> — SVG, draw.io, JSON, CSV, DXF and HTML</summary>
<summary><strong>Browse Full HD and UHD 4K templates</strong> — SVG, draw.io, PPTX, FIG, AI, JSON, CSV, DXF and HTML</summary>
These starter files contain two named 16:9 layers on an exact pixel canvas.
- **Full HD — 1920 × 1080:** [SVG](docs/templates/midra-layout/midra-layout-1080p-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-1080p-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-1080p-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-1080p-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-1080p-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-1080p-2-layers.html)
- **UHD 4K — 3840 × 2160:** [SVG](docs/templates/midra-layout/midra-layout-4k-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-4k-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-4k-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-4k-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-4k-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-4k-2-layers.html)
- **Full HD — 1920 × 1080:** [SVG](docs/templates/midra-layout/midra-layout-1080p-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-1080p-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-1080p-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-1080p-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-1080p-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-1080p-2-layers.html) · [PPTX](docs/templates/midra-layout/midra-layout-1080p-2-layers.pptx) · [Figma FIG](docs/templates/midra-layout/midra-layout-1080p-2-layers.fig) · [Illustrator AI](docs/templates/midra-layout/midra-layout-1080p-2-layers.ai)
- **UHD 4K — 3840 × 2160:** [SVG](docs/templates/midra-layout/midra-layout-4k-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-4k-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-4k-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-4k-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-4k-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-4k-2-layers.html) · [PPTX](docs/templates/midra-layout/midra-layout-4k-2-layers.pptx) · [Figma FIG](docs/templates/midra-layout/midra-layout-4k-2-layers.fig) · [Illustrator AI](docs/templates/midra-layout/midra-layout-4k-2-layers.ai)
Midra also imports/exports native PPTX and Figma FIG; Illustrator AI uses an optional
PPTX and FIG samples contain an editable slide/frame; AI samples were generated with
VectorCraft 0.24.1. Midra imports/exports Illustrator AI using an optional
local VectorCraft CLI. See [formats, dependencies and licensing builds](docs/interfaces/midra-layout-exchange.md#optional-native-document-codecs-and-licensing-builds).
</details>

View File

@ -123,7 +123,24 @@ fn main() -> Result<(), String> {
println!("Verified {} layer boxes: {path}", shapes.len());
}
}
[command, directory] if command == "templates" => {
[command, directory, extensions @ ..] if command == "templates" => {
use midra_layout::interchange::{self, Codec};
let codecs = if extensions.is_empty() {
Codec::available()
.into_iter()
.filter(|c| !matches!(c, Codec::Pptx | Codec::Figma | Codec::Illustrator))
.collect::<Vec<_>>()
} else {
extensions
.iter()
.map(|extension| {
Codec::available()
.into_iter()
.find(|c| c.extension() == extension)
.ok_or_else(|| format!("Unsupported format in this build: {extension}"))
})
.collect::<Result<Vec<_>, _>>()?
};
let directory = std::path::Path::new(directory);
std::fs::create_dir_all(directory).map_err(|e| e.to_string())?;
for (label, resolution) in [("1080p", [1920, 1080]), ("4k", [3840, 2160])] {
@ -133,14 +150,27 @@ fn main() -> Result<(), String> {
.iter()
.map(|layer| layer.id)
.collect::<Vec<_>>();
for format in Format::ALL {
let contents = exchange::export(&project, &ids, format, Options::default())?;
for &format in &codecs {
let contents = interchange::export(&project, &ids, format, Options::default())?;
let filename = format!("midra-layout-{label}-2-layers.{}", format.extension());
let pages = interchange::import(&contents, &filename)?;
if pages.len() != 1
|| pages[0]
.document
.shapes
.iter()
.map(|s| s.geometry)
.collect::<Vec<_>>()
!= project.layers.iter().map(|l| l.bounds).collect::<Vec<_>>()
{
return Err(format!("Template round-trip mismatch: {filename}"));
}
write_file(
&directory.join(format!(
"midra-layout-{label}-2-layers.{}",
format.extension()
)),
contents.as_bytes(),
&contents,
true,
)?;
}
@ -148,7 +178,7 @@ fn main() -> Result<(), String> {
}
_ => {
return Err(
"Usage: check_geometry_exchange generate DIRECTORY | templates DIRECTORY | verify FILE...".into(),
"Usage: check_geometry_exchange generate DIRECTORY | templates DIRECTORY [EXTENSION...] | native DIRECTORY EXTENSION... | verify FILE...".into(),
);
}
}

View File

@ -449,3 +449,51 @@ fn exported_background_composites_visible_references_in_order() {
assert_eq!(shapes.len(), 2); // one flattened background and one real layer
assert!(shapes[0].background_only);
}
#[cfg(all(feature = "vendor_formats", not(feature = "no_proprietary")))]
fn check_native_templates(codecs: &[midra_layout::interchange::Codec]) {
use midra_layout::interchange;
for (label, resolution) in [("1080p", [1920, 1080]), ("4k", [3840, 2160])] {
let project = template(resolution);
let expected: Vec<_> = project.layers.iter().map(|l| l.bounds).collect();
let ids: Vec<_> = project.layers.iter().map(|l| l.id).collect();
for &codec in codecs {
let filename = format!("midra-layout-{label}-2-layers.{}", codec.extension());
let path = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
.join("../../docs/templates/midra-layout")
.join(&filename);
let saved = std::fs::read(path).unwrap();
let fresh = interchange::export(&project, &ids, codec, Options::default()).unwrap();
// Native encoders may vary ZIP metadata or document IDs; compare imported geometry.
for bytes in [saved, fresh] {
let pages = interchange::import(&bytes, &filename).unwrap();
assert_eq!(pages.len(), 1, "{filename}");
assert!(pages[0].document.shapes.iter().all(|s| !s.background_only));
assert_eq!(
pages[0]
.document
.shapes
.iter()
.map(|s| s.geometry)
.collect::<Vec<_>>(),
expected,
"{filename}"
);
}
}
}
}
#[cfg(all(feature = "vendor_formats", not(feature = "no_proprietary")))]
#[test]
fn native_readme_templates_preserve_two_layer_geometry() {
use midra_layout::interchange::Codec;
check_native_templates(&[Codec::Pptx, Codec::Figma]);
}
#[cfg(all(feature = "vendor_formats", not(feature = "no_proprietary")))]
#[test]
#[ignore = "Requires a real VectorCraft CLI; set MIDRA_VECTORCRAFT_CLI"]
fn illustrator_readme_templates_preserve_two_layer_geometry() {
check_native_templates(&[midra_layout::interchange::Codec::Illustrator]);
}

View File

@ -10,11 +10,27 @@ cropping; importing a picture does not reconstruct its crop or source settings.
Ready-to-open two-layer templates are published under
`docs/templates/midra-layout/` for Full HD (1920 × 1080) and UHD 4K
(3840 × 2160), in the six text exchange formats. The 4K geometry is an exact
(3840 × 2160), in all nine exchange formats (including PPTX, FIG and AI). The 4K geometry is an exact
2× scale of the Full HD layout. Regenerate them with:
```sh
cargo run --locked -p midra-layout --example check_geometry_exchange -- templates docs/templates/midra-layout
# Optional native codecs (default build); AI requires VectorCraft CLI:
MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo run --locked -p midra-layout --example check_geometry_exchange -- templates docs/templates/midra-layout pptx fig ai
```
The generator verifies imported geometry before writing each template and replaces
existing templates in the explicitly supplied directory. Samples contain only two
editable layer boxes, with no background or placeholder images. PPTX uses one slide,
FIG one frame, and AI one artboard. Their canvas sizes are pixels (PPTX uses the
documented 96 pixels/inch conversion). These files are geometry examples, not
full-fidelity project saves. AI samples were generated and round-trip checked with
VectorCraft CLI 0.24.1; Adobe Illustrator itself was not used for validation.
Native fixtures are checked semantically rather than byte-for-byte because encoder
metadata can vary. The AI regression check is opt-in and requires the real CLI:
```sh
MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo test --locked -p midra-layout --test exchange illustrator_readme_templates -- --ignored
```
## Application and format matrix
@ -297,7 +313,7 @@ the only positions present in that SVG. Include Midra Layout's background layer
before exporting through draw.io when the full output-screen origin must survive
the round trip.
Tests cover each format/artwork combination, all twelve published templates,
Tests cover each format/artwork combination, the twelve text templates and four native PPTX/FIG templates (plus two AI templates in the opt-in CLI check),
full-screen layers vs backgrounds,
negative/fractional coordinates, repeat round trips, compressed clipboard/files,
embedded references, invalid IDs/versions and no-overwrite file handling.

View File

@ -4,6 +4,8 @@
## Unreleased
- Add README-linked two-layer PPTX, Figma FIG and Illustrator AI templates in Full HD and UHD 4K. Extend the template generator with format selection and import verification; test native fixture geometry, with AI 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.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.