SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.
File menu: Export STL… and Export 3MF… open the mesh dialog with that format; command search finds mesh export by format (#3873)
bherbruck41a62d210c70
diff --git a/crates/ui-egui/src/dialogs_save_mesh.rs b/crates/ui-egui/src/dialogs_save_mesh.rsindex dbd1646105..3e158ce0a2 100644--- a/crates/ui-egui/src/dialogs_save_mesh.rs+++ b/crates/ui-egui/src/dialogs_save_mesh.rs@@ -1,7 +1,7 @@//! The Save as mesh dialog (`file.save_mesh`): which bodies, the mesh format, and optionally a//! slicer to open the saved file in.//!-//! Every place that saves a mesh opens this dialog: File › Save as mesh, the Mesh tab, and the+//! Every place that saves a mesh opens this dialog: File › Export STL / Export 3MF, the Mesh tab, and the//! Save As Mesh item of the body menus. The slicer list holds the programs the user added (kept//! between runs, newest first), then the slicers found on this machine, then "Custom…", which asks//! for a program and adds it at the top; "Custom…" itself is never the selection. Pressing Delete@@ -39,6 +39,14 @@ pub struct SaveMesh {stale: bool,}+impl SaveMesh {+ /// The chosen format, as `file.save_mesh` names it (`stl`, `3mf`, `3mf-tagged`).+ #[cfg(test)]+ pub(crate) fn format_name(&self) -> &'static str {+ FORMATS.get(self.format).map_or("stl", |f| f.1)+ }+}+/// One line of the slicer list.struct Entry {key: String,@@ -87,6 +95,17 @@ pub fn start(app: &SolveApp, id: &str) -> Option<(Kind, Vec<SelInput>)> {Some((kind, vec![SelInput::new("Bodies", BODIES, true)]))}+/// Open the dialog with `format` (`stl`, `3mf` or `3mf-tagged`) chosen, whatever was used last:+/// File › Export STL… and Export 3MF…. The user can still change it in the dialog.+pub fn start_with_format(app: &mut SolveApp, format: &str) {+ app.start("file.save_mesh");+ if let Some(index) = FORMATS.iter().position(|f| f.1 == format)+ && let Some(Kind::SaveMesh(k)) = app.dialog.as_mut().map(|d| &mut d.kind)+ {+ k.format = index;+ }+}+/// A popup with the slicer list is open (Delete belongs to it, not to the design's selection).pub fn popup_open(ctx: &egui::Context) -> bool {let frame = ctx.cumulative_frame_nr();diff --git a/crates/ui-egui/src/shortcut_box.rs b/crates/ui-egui/src/shortcut_box.rsindex 3b6d9e0dc9..1bf014ca13 100644--- a/crates/ui-egui/src/shortcut_box.rs+++ b/crates/ui-egui/src/shortcut_box.rs@@ -105,6 +105,24 @@ pub fn score(q: &str, s: &str) -> u32 {300u32.saturating_sub(gaps * 20).max(10)}+/// Words people look for a command by that its name doesn't hold (file formats, what it is for).+fn keywords(id: &str) -> &'static str {+ match id {+ "file.save_mesh" => "export stl 3mf mesh 3d print printing slicer",+ "file.export" => "export stl 3mf obj step urdf mesh 3d print",+ _ => "",+ }+}++/// How well `q` matches a command's `keywords`: every word of the query starts a keyword.+fn keyword_score(q: &str, keywords: &str) -> u32 {+ if keywords.is_empty() || q.is_empty() {+ return 0;+ }+ let words = || keywords.split_whitespace();+ if q.split_whitespace().all(|w| words().any(|k| k.starts_with(w))) { 700 } else { 0 }+}+/// A row of the box: the command id, its label, its icon, and where it lives on the toolbar/// (tab, panel; `None` off the toolbar), in the current language.pub type Row = (&'static str, &'static str, &'static str, Option<(&'static str, &'static str)>);@@ -125,6 +143,7 @@ pub fn search(app: &SolveApp, q: &str) -> Vec<Row> {let s = score(&q, label).max(score(&q, c.label)).max(score(&q, c.id) * 9 / 10)+ .max(keyword_score(&q, keywords(c.id))).max(score(&q, tab).max(score(&q, home_tab)) / 3).max(score(&q, panel).max(score(&q, home_panel)) / 3);let recent = app.sbox.recent.iter().position(|r| r == c.id).map_or(0, |i| 2000u32.saturating_sub(i.min(2000) as u32));diff --git a/crates/ui-egui/src/toolbar.rs b/crates/ui-egui/src/toolbar.rsindex 6cd97f5166..5b728e65b8 100644--- a/crates/ui-egui/src/toolbar.rs+++ b/crates/ui-egui/src/toolbar.rs@@ -555,8 +555,12 @@ fn file_menu(app: &mut SolveApp, ctx: &egui::Context) {close = true;}ui.separator();- if item_if(ui, "Save as mesh…", "", "mesh_export", shown) {- app.start("file.save_mesh");+ if item_if(ui, "Export STL…", "", "mesh_export", shown) {+ crate::dialogs_save_mesh::start_with_format(app, "stl");+ close = true;+ }+ if item_if(ui, "Export 3MF…", "", "mesh_export", shown) {+ crate::dialogs_save_mesh::start_with_format(app, "3mf");close = true;}if item_if(ui, "Export STEP…", "", "export", shown) {@@ -1893,6 +1897,27 @@ mod header_report_tests {assert!(!solidcraft_engine::io::is_design_container(&std::fs::read(saved).unwrap()), "subsequent Save keeps a .json choice");}+ /// File › Export STL… and Export 3MF… both open the Save as mesh dialog with their format+ /// chosen (whatever was used last), and command search finds the export by format or purpose.+ #[test]+ fn file_menu_has_export_stl_and_3mf_that_open_the_mesh_dialog_with_that_format() {+ let mut h = crate::scenario::Harness::new();+ h.app.run("solid.box", json!({"length":2,"width":3,"height":4})).unwrap();+ h.app.preferences.save_mesh_format = "3mf".into();+ for (item, format) in [("Export STL…", "stl"), ("Export 3MF…", "3mf")] {+ h.frames(3);+ h.step(&json!({"click":{"handle":"appbar:file"}})).unwrap();+ h.step(&json!({"widget": item})).unwrap();+ let Some(crate::dialogs::Kind::SaveMesh(k)) = h.app.dialog.as_ref().map(|d| &d.kind) else { panic!("{item}: no Save as mesh dialog") };+ assert_eq!(k.format_name(), format, "{item}");+ crate::dialogs::cancel(&mut h.app);+ }+ for q in ["3mf", "stl", "export 3mf", "print"] {+ let found = crate::shortcut_box::search(&h.app, q);+ assert!(found.iter().any(|r| r.0 == "file.save_mesh"), "{q}: {:?}", found.iter().map(|r| r.0).collect::<Vec<_>>());+ }+ }+/// The browser build's File > Download design hands the open design to the host as a/// `.solidcraft` container named after it; a host that saves real files shows no such item.#[test]diff --git a/crates/ui-egui/tests/scenarios/s14_appearance_export.json b/crates/ui-egui/tests/scenarios/s14_appearance_export.jsonindex ebeb2e1e31..a7f1af1950 100644--- a/crates/ui-egui/tests/scenarios/s14_appearance_export.json+++ b/crates/ui-egui/tests/scenarios/s14_appearance_export.json@@ -95,7 +95,7 @@"click": {"handle": "appbar:file"}},{- "widget": "Save as mesh\u2026"+ "widget": "Export STL\u2026"},{"expect": {diff --git a/docs/book/src/guide/files.md b/docs/book/src/guide/files.mdindex 7a05dd98cf..01ad7c13a9 100644--- a/docs/book/src/guide/files.md+++ b/docs/book/src/guide/files.md@@ -38,8 +38,9 @@ A 3MF project saved by a slicer comes in too, also when it keeps its objects intheir own inside the file (the 3MF Production extension): each object on the build plate becomesa mesh body, with its parts where the slicer placed them.-**File → Save as mesh…** (also on the Mesh tab under Modify, and in the right-click menu of a-body) saves the selected bodies as STL, 3MF or 3MF with face tags (below). With **Send to slicer** ticked, it writes the file to+**File → Export STL…** and **File → Export 3MF…** (also on the Mesh tab under Modify as Save as+mesh, and in the right-click menu of a body) open the same dialog with that format chosen; it saves+the selected bodies as STL, 3MF or 3MF with face tags (below), and you can change the format there. With **Send to slicer** ticked, it writes the file toa temporary folder and opens it in the chosen slicer instead of asking for a file name. The slicerlist shows the slicers found on the computer with their icons; **Custom…** adds any other programto the top of the list (kept between runs; hover an entry you added and press Delete to remove it).@@ -47,7 +48,7 @@ to the top of the list (kept between runs; hover an entry you added and press DeClosed mechanical meshes with a constant cross-section can be rebuilt as solids with the`mesh.convert` command (command palette, scripts and the control channel).-**File → Save as mesh…** with the format **3MF with face tags** (`file.export` or `file.save_mesh` with `format: "3mf-tagged"`) writes an+**File → Export 3MF…** with the format changed to **3MF with face tags** (`file.export` or `file.save_mesh` with `format: "3mf-tagged"`) writes anordinary 3MF in which every triangle also names the B-rep face it lies on and every coordinateis the tessellation's own double-precision value. Meshing and analysis tools can use the tags tokeep a model's faces (for loads, boundary conditions or feature edges); other 3MF readers ignorediff --git a/docs/formats/3mf-face-tags.md b/docs/formats/3mf-face-tags.mdindex 27581f2db4..de729c1131 100644--- a/docs/formats/3mf-face-tags.md+++ b/docs/formats/3mf-face-tags.md@@ -7,7 +7,7 @@ A tessellated body loses its faces: a plain mesh says where the surface is, noteach triangle came from. Downstream tools that mesh or analyse a part need that back. They applyloads and boundary conditions to faces, keep face boundaries as feature edges, and groupresults by face. SolidCraft therefore exports a 3MF in which every triangle carries the index of-the B-rep face it lies on (**File → Save as mesh…** (format **3MF with face tags**), or `file.export` with+the B-rep face it lies on (**File → Export 3MF…**, then the format **3MF with face tags**, or `file.export` with`format: "3mf-tagged"`).## Why 3MF