Add PPTX Figma and Illustrator layout templates
Beffroi/beffroi-tools/pipeline/head This commit looks good
Details
Beffroi/beffroi-tools/pipeline/head This commit looks good
Details
This commit is contained in:
parent
94b1053823
commit
3eccae3b80
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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(),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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]);
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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.
Loading…
Reference in New Issue