SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.
Docs: refresh every UI screenshot, GIF and video from the current UI (#6763)
bherbruck8071096a9954
diff --git a/ATTRIBUTION.md b/ATTRIBUTION.mdindex e86ab07739..0f16a9726f 100644--- a/ATTRIBUTION.md+++ b/ATTRIBUTION.md@@ -51,10 +51,10 @@ Editable drawing code, native projects and shipped exports are collected under `| assets/icons/app/macos/exports/icon.icns | SolidCraft contributors | macOS fallback compiled by Apple's actool from the approved assets/icons/app/macos/source/SolidCraft.icon composition | MIT OR Apache-2.0 || assets/models/test_boat.bin | 3DBenchy.com | 3DBenchy.com | Public Domain || assets/models/make_test_boat.py | SolidCraft contributors | original script that packs a model into the compact file above | MIT OR Apache-2.0 |-| docs/screenshots/class-a-blend.png | SolidCraft contributors | screenshot of SolidCraft itself: two boxes bridged by `surface.blend` (a 40x10 sheet, `solidcraft-cli snapshot` of plan/evidence script ev_blend) | MIT OR Apache-2.0 |-| docs/screenshots/class-a-crown.png | SolidCraft contributors | screenshot of SolidCraft itself: a patch crowned with `surface.patch crown=0.3` over a saddle rim (`solidcraft-cli snapshot`) | MIT OR Apache-2.0 |-| docs/screenshots/class-a-boundary.png | SolidCraft contributors | screenshot of SolidCraft itself: a patch through two sketch lines built by `surface.boundary` with `crown: 0.4` (`solidcraft-cli snapshot`) | MIT OR Apache-2.0 |-| docs/screenshots/sample-plate.png | SolidCraft contributors | screenshot of SolidCraft itself (`solidcraft --sample`) | MIT OR Apache-2.0 |+| docs/screenshots/class-a-blend.png | SolidCraft contributors | screenshot of SolidCraft itself: a 24 mm and a 10 mm box bridged by a `surface.blend` sheet (G1 at both edges), rendered by the app's `ui.render` in the dark theme with examples/demo/class_a_shots.py | MIT OR Apache-2.0 |+| docs/screenshots/class-a-crown.png | SolidCraft contributors | screenshot of SolidCraft itself: a patch crowned with `surface.patch crown=0.3` over a skew four-line rim, rendered by the app's `ui.render` in the dark theme with examples/demo/class_a_shots.py | MIT OR Apache-2.0 |+| docs/screenshots/class-a-boundary.png | SolidCraft contributors | screenshot of SolidCraft itself: a surface through two 3D sketch splines built by `surface.boundary`, rendered by the app's `ui.render` in the dark theme with examples/demo/class_a_shots.py | MIT OR Apache-2.0 |+| docs/screenshots/sample-plate.png | SolidCraft contributors | screenshot of SolidCraft 0.22.1 itself (`solidcraft --sample`, default dark theme, 1600x1000) | MIT OR Apache-2.0 || assets/samples/exports/0.png | SolidCraft contributors | original Sample Plate from `crates/engine/src/sample.rs`, exported by the SolidCraft thumbnail renderer | MIT OR Apache-2.0 || assets/samples/exports/1.png | SolidCraft contributors | original Sheet Metal Bracket from `crates/engine/src/sample.rs`, exported by the SolidCraft thumbnail renderer | MIT OR Apache-2.0 || assets/samples/exports/2.png | SolidCraft contributors | original Hinge Assembly from `crates/engine/src/sample.rs`, exported by the SolidCraft thumbnail renderer | MIT OR Apache-2.0 |@@ -62,10 +62,10 @@ Editable drawing code, native projects and shipped exports are collected under `| assets/samples/exports/4.png | SolidCraft contributors | original Bolted Flange from `crates/engine/src/sample.rs`, exported by the SolidCraft thumbnail renderer | MIT OR Apache-2.0 || assets/samples/exports/5.png | SolidCraft contributors | original Vent Plate from `crates/engine/src/sample.rs`, exported by the SolidCraft thumbnail renderer | MIT OR Apache-2.0 || assets/samples/exports/scripts.json | SolidCraft contributors | SHA-256 fingerprints of the original sample scripts, generated with the shipped thumbnails | MIT OR Apache-2.0 |-| docs/screenshots/demo-0.8.gif | SolidCraft contributors | original screen recording of the actual SolidCraft 0.8 English desktop UI modelling an original Raspberry Pi 4 case (no logos or branding; the engraved text is set in the system's DejaVu Sans Bold), generated with examples/demo/record_ui.sh and its original animated pointer overlay (9× playback) | MIT OR Apache-2.0 |-| docs/screenshots/demo-0.8.mp4 | SolidCraft contributors | original screen recording of the actual SolidCraft 0.8 English desktop UI modelling an original Raspberry Pi 4 case (no logos or branding; the engraved text is set in the system's DejaVu Sans Bold), generated with examples/demo/record_ui.sh and its original animated pointer overlay (9× playback) | MIT OR Apache-2.0 |-| docs/screenshots/rover-build.gif | 0xlillith (model); SolidCraft contributors (recording) | screen recording of the actual SolidCraft desktop UI replaying the timeline of the SELENE rover (`Rover-recorded.solidcraft` from https://github.com/0xlillith/solidcraft-rover, an original model by 0xlillith built through SolidCraft MCP); the model's lettering follows Ubuntu Light outlines (Canonical Ltd., Ubuntu Font Licence 1.0, as noted in that repository); the emblem is the SolidCraft project icon (2× playback) | MIT OR Apache-2.0 |-| docs/screenshots/rover-build.mp4 | 0xlillith (model); SolidCraft contributors (recording) | screen recording of the actual SolidCraft desktop UI replaying the timeline of the SELENE rover (`Rover-recorded.solidcraft` from https://github.com/0xlillith/solidcraft-rover, an original model by 0xlillith built through SolidCraft MCP); the model's lettering follows Ubuntu Light outlines (Canonical Ltd., Ubuntu Font Licence 1.0, as noted in that repository); the emblem is the SolidCraft project icon | MIT OR Apache-2.0 |+| docs/screenshots/demo.gif | SolidCraft contributors | original screen recording of the actual SolidCraft 0.22.1 English desktop UI (default dark theme, software renderer) modelling an original Raspberry Pi 4 case (no logos or branding; the engraved text is set in the system's DejaVu Sans Bold), generated with examples/demo/record_ui.sh and its original animated pointer overlay (6× playback, idle pauses cut) | MIT OR Apache-2.0 |+| docs/screenshots/demo.mp4 | SolidCraft contributors | original screen recording of the actual SolidCraft 0.22.1 English desktop UI (default dark theme, software renderer) modelling an original Raspberry Pi 4 case (no logos or branding; the engraved text is set in the system's DejaVu Sans Bold), generated with examples/demo/record_ui.sh and its original animated pointer overlay (6× playback, idle pauses cut) | MIT OR Apache-2.0 |+| docs/screenshots/rover-build.gif | 0xlillith (model); SolidCraft contributors (recording) | screen recording of the actual SolidCraft 0.22.1 desktop UI (default dark theme, software renderer) replaying the timeline of the SELENE rover (`Rover-recorded.solidcraft` from https://github.com/0xlillith/solidcraft-rover, an original model by 0xlillith built through SolidCraft MCP); the model's lettering follows Ubuntu Light outlines (Canonical Ltd., Ubuntu Font Licence 1.0, as noted in that repository); the emblem is the SolidCraft project icon (15× playback, idle pauses cut, constant-rate camera orbit) | MIT OR Apache-2.0 |+| docs/screenshots/rover-build.mp4 | 0xlillith (model); SolidCraft contributors (recording) | screen recording of the actual SolidCraft 0.22.1 desktop UI (default dark theme, software renderer) replaying the timeline of the SELENE rover (`Rover-recorded.solidcraft` from https://github.com/0xlillith/solidcraft-rover, an original model by 0xlillith built through SolidCraft MCP); the model's lettering follows Ubuntu Light outlines (Canonical Ltd., Ubuntu Font Licence 1.0, as noted in that repository); the emblem is the SolidCraft project icon | MIT OR Apache-2.0 || docs/design/ux-redesign/model-floating.png | SolidCraft contributors | original UX mockup (Model tab, floating layout) rendered from an HTML mockup that uses the original Technical Accent icon set; no third-party artwork, and not a screenshot of any other CAD product | MIT OR Apache-2.0 || docs/design/ux-redesign/model-compact.png | SolidCraft contributors | original UX mockup (Model tab, compact docked layout) rendered from an HTML mockup that uses the original Technical Accent icon set; no third-party artwork, and not a screenshot of any other CAD product | MIT OR Apache-2.0 || docs/design/ux-redesign/sketch.png | SolidCraft contributors | original UX mockup (Sketch tab) rendered from an HTML mockup that uses the original Technical Accent icon set; no third-party artwork, and not a screenshot of any other CAD product | MIT OR Apache-2.0 |diff --git a/README.md b/README.mdindex 1aecd17682..8c073bafa8 100644--- a/README.md+++ b/README.md@@ -46,9 +46,9 @@<a href="https://trendshift.io/repositories/296178?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-296178" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/296178/daily?language=Rust" alt="tangency-labs%2Fsolidcraft | Trendshift (Rust)" width="250" height="55"/></a></p>-+-*A Raspberry Pi 4 case from an empty design: a sketch dimensioned with the board's parameters, extrude, fillet, shell, the rim rounded in one pick, an M2.5 standoff patterned on the 58 × 49 mm hole rectangle, port cut-outs, vent slots, "Pi 4" engraved in DejaVu Sans Bold and a PETG material defined in the design, with its mass in Properties, then height 24 → 32 mm in Parameters and it all rebuilds. 9× playback. [Full video](https://github.com/tangency-labs/solidcraft/raw/refs/heads/main/docs/screenshots/demo-0.8.mp4), recorded with the [demo script](examples/demo/record_ui.sh).*+*A Raspberry Pi 4 case from an empty design: a sketch dimensioned with the board's parameters, extrude, fillet, shell, the rim rounded in one pick, an M2.5 standoff patterned on the 58 × 49 mm hole rectangle, port cut-outs, vent slots, "Pi 4" engraved in DejaVu Sans Bold and a PETG material defined in the design, with its mass in Properties, then height 24 → 32 mm in Parameters and it all rebuilds. 6× playback with the idle pauses cut. [Full video](https://github.com/tangency-labs/solidcraft/raw/refs/heads/main/docs/screenshots/demo.mp4), recorded with the [demo script](examples/demo/record_ui.sh).*## Downloaddiff --git a/docs/screenshots/class-a-blend.png b/docs/screenshots/class-a-blend.pngindex 59991f0ed4..c894465694 100644Binary files a/docs/screenshots/class-a-blend.png and b/docs/screenshots/class-a-blend.png differdiff --git a/docs/screenshots/class-a-boundary.png b/docs/screenshots/class-a-boundary.pngindex e5f436e963..6f7074ec74 100644Binary files a/docs/screenshots/class-a-boundary.png and b/docs/screenshots/class-a-boundary.png differdiff --git a/docs/screenshots/class-a-crown.png b/docs/screenshots/class-a-crown.pngindex f38d6edd36..0d7db067fd 100644Binary files a/docs/screenshots/class-a-crown.png and b/docs/screenshots/class-a-crown.png differdiff --git a/docs/screenshots/demo-0.8.gif b/docs/screenshots/demo.gifsimilarity index 53%rename from docs/screenshots/demo-0.8.gifrename to docs/screenshots/demo.gifindex af80e2c433..dea3ee1ae1 100644Binary files a/docs/screenshots/demo-0.8.gif and b/docs/screenshots/demo.gif differdiff --git a/docs/screenshots/demo-0.8.mp4 b/docs/screenshots/demo.mp4similarity index 54%rename from docs/screenshots/demo-0.8.mp4rename to docs/screenshots/demo.mp4index bae7646345..a9a42197d5 100644Binary files a/docs/screenshots/demo-0.8.mp4 and b/docs/screenshots/demo.mp4 differdiff --git a/docs/screenshots/rover-build.gif b/docs/screenshots/rover-build.gifindex b37fba451b..3118b46a5d 100644Binary files a/docs/screenshots/rover-build.gif and b/docs/screenshots/rover-build.gif differdiff --git a/docs/screenshots/rover-build.mp4 b/docs/screenshots/rover-build.mp4index 5bf3d18362..d0b30c761c 100644Binary files a/docs/screenshots/rover-build.mp4 and b/docs/screenshots/rover-build.mp4 differdiff --git a/docs/screenshots/sample-plate.png b/docs/screenshots/sample-plate.pngindex d35c51cee5..b8200ea7c0 100644Binary files a/docs/screenshots/sample-plate.png and b/docs/screenshots/sample-plate.png differdiff --git a/docs/showcase.md b/docs/showcase.mdindex 95907585ad..df8db6acfa 100644--- a/docs/showcase.md+++ b/docs/showcase.md@@ -4,6 +4,6 @@*SELENE, a scientific rover built entirely through SolidCraft's MCP server by[@0xlillith](https://github.com/0xlillith/solidcraft-rover): 3,323 editable timeline steps that-rebuild with no errors, replayed here at 2× speed.-[Full video](https://github.com/tangency-labs/solidcraft/raw/refs/heads/main/screenshots/rover-build.mp4)+rebuild with no errors, replayed here at 15× speed with the idle moments cut.+[Full video](https://github.com/tangency-labs/solidcraft/raw/refs/heads/main/docs/screenshots/rover-build.mp4)· [download the editable model](https://github.com/0xlillith/solidcraft-rover/releases/tag/v1.0.0).*diff --git a/examples/demo/class_a_shots.py b/examples/demo/class_a_shots.pynew file mode 100755index 0000000000..f4d1cf0727--- /dev/null+++ b/examples/demo/class_a_shots.py@@ -0,0 +1,84 @@+#!/usr/bin/env python3+"""Render the three class-A surfacing pictures of docs/screenshots with the running app.++ solidcraft --control 7878 &+ python3 examples/demo/class_a_shots.py --port 7878 OUTDIR++Each picture is built from commands on a new design and drawn by the control channel's+`ui.render` (1280 x 800, the window's theme, no origin axes):+ class-a-blend.png a 24 mm box and a 10 mm box, 20 mm apart, bridged by `surface.blend` (G1 at both edges);+ class-a-boundary.png `surface.boundary` through two 3D sketch splines;+ class-a-crown.png `surface.patch crown=0.3` over the four straight edges of a skew rim+ (the rim's own surface is hidden).+"""+import argparse+import os+import sys+import time++sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))+from enclosure_mcp import control # noqa: E402+++def main():+ ap = argparse.ArgumentParser()+ ap.add_argument("outdir")+ ap.add_argument("--port", type=int, default=7878)+ a = ap.parse_args()++ def ui(method, params=None):+ r = control(a.port, method, params)+ if not r.get("ok", False):+ raise RuntimeError(f"{method} {params}: {r.get('error')}")+ return r.get("result")++ def ex(command, params):+ return ui("engine.execute", {"command": command, "params": params})++ def fresh():+ ui("ui.documents", {"action": "new"})+ time.sleep(1)+ ui("ui.home", {"open": False})+ ui("ui.set", {"showOrigin": False, "showSketches": False})++ def shoot(name):+ ui("ui.view", {"view": "iso"})+ ui("ui.camera", {"fit": True})+ time.sleep(1.5)+ ui("ui.render", {"path": os.path.join(os.path.abspath(a.outdir), name), "width": 1280, "height": 800})++ ui("ui.prefs", {"theme": "dark", "button": "apply"})+ ui("ui.resize", {"width": 1920, "height": 1080})++ fresh()+ ex("solid.box", {"length": 40, "width": 40, "height": 24, "corner": [0, 0, 0], "body_name": "A"})+ ex("solid.box", {"length": 40, "width": 40, "height": 10, "corner": [60, 0, 0], "body_name": "B"})+ ex("surface.blend", {"from": {"body": "A", "edges": [[40, 20, 24]]}, "to": {"body": "B", "edges": [[60, 20, 10]]}, "continuity": ["g1", "g1"], "body_name": "Blend"})+ shoot("class-a-blend.png")++ fresh()+ ex("sketch.create", {"plane": "XY", "name": "Rails"})+ ex("sketch.options", {"sketch_3d": True})+ u = [ex("sketch.spline3d", {"points": p})["curves"][0] for p in ([[0, 0, 0], [20, 0, 14], [40, 0, 0]], [[0, 30, 8], [20, 30, 0], [40, 30, 8]])]+ ex("sketch.finish", {})+ ex("surface.boundary", {"sketch": "Rails", "u": u, "body_name": "Patch"})+ shoot("class-a-boundary.png")++ fresh()+ ex("sketch.create", {"plane": "XY", "name": "Rim"})+ ex("sketch.options", {"sketch_3d": True})+ p = [[0, 0, 0], [40, 0, 8], [40, 40, 0], [0, 40, 8]]+ w = [ex("sketch.line3d", {"points": [p[i], p[j]]})["curves"][0] for i, j in ((0, 1), (0, 3), (3, 2), (1, 2))]+ ex("sketch.finish", {})+ ex("surface.boundary", {"sketch": "Rim", "u": [w[0], w[2]], "v": [w[1], w[3]], "body_name": "Rim surface"})++ def mid(i, j):+ return [(p[i][k] + p[j][k]) / 2 for k in range(3)]++ ex("surface.patch", {"body": "Rim surface", "edges": [mid(0, 1), mid(0, 3), mid(3, 2), mid(1, 2)], "crown": 0.3, "body_name": "Crown"})+ ui("ui.set", {"hiddenBodies": ["Rim surface"]})+ shoot("class-a-crown.png")+++if __name__ == "__main__":+ main()diff --git a/examples/demo/enclosure_ui_mcp.py b/examples/demo/enclosure_ui_mcp.pyindex 370be2e912..465e87ff6c 100644--- a/examples/demo/enclosure_ui_mcp.py+++ b/examples/demo/enclosure_ui_mcp.py@@ -682,7 +682,7 @@ def run_pi(d, release="0.8"):d.tool("sketch.create")d.click(d.at(world=[-5, 18, 2]), settle=0.9)d.settle_camera()- loop = rectangle(d, [-8, -14, 2], [14, 1.5, 0])+ loop = rectangle(d, [-8, -14, 2], [-14, 2.5, 0])d.tool("sketch.finish")d.view("home", 0.4)extrude(d, [loop], "-wall")@@ -717,6 +717,9 @@ def run_pi(d, release="0.8"):d.orbit(-260, 10, steps=110, around=[0, 0, 10])d.glide(away, 0.3)d.settle_camera()+ # Frame the finished 32 mm case whole, in the same three-quarter direction.+ d.ui("ui.view", {"view": "fit", "animate": True})+ d.settle_camera()d.wait(1.0)@@ -733,7 +736,11 @@ def main():a = ap.parse_args()if not math.isfinite(a.speed) or a.speed <= 0 or not math.isfinite(a.minimum_caption) or a.minimum_caption < 0:ap.error("pause scale must be positive and caption duration nonnegative")- mcp = Mcp([a.cli, "mcp", "--connect", f"127.0.0.1:{a.port}"])+ argv = [a.cli, "mcp", "--connect", f"127.0.0.1:{a.port}"]+ if a.save:+ # MCP file access is limited to the open design's folder and the recovery folder.+ argv += ["--allow-path", os.path.dirname(os.path.abspath(a.save))]+ mcp = Mcp(argv)mcp.send("initialize", {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "enclosure-demo-v2", "version": "2"}})mcp.send("notifications/initialized", notify=True)d = Demo(a.port, mcp, open(a.log, "w") if a.log else None, a.speed, a.minimum_caption)diff --git a/examples/demo/record_rover.sh b/examples/demo/record_rover.shnew file mode 100755index 0000000000..5cc4bb2d59--- /dev/null+++ b/examples/demo/record_rover.sh@@ -0,0 +1,29 @@+#!/bin/bash+# record_rover.sh DISPLAY PORT DESIGN OUTDIR [PLAYBACK_RATE]: record rover_replay.py replaying DESIGN's+# timeline in the app on X display DISPLAY (1920x1080, started with --control PORT) to+# OUTDIR/rover-build.mp4 (H.264) and .gif, accelerated PLAYBACK_RATE times (default 15) with the idle+# stretches cut (trim_idle.py).+# SOLIDCRAFT_DEMO_GIF_WIDTH and SOLIDCRAFT_DEMO_GIF_FPS size the GIF (default 800 px, 10 fps).+set -e+DISP=${1:-:0}; PORT=${2:-7878}; DESIGN=$3; OUT=$(cd "${4:-.}" && pwd); RATE=${5:-15}+HERE=$(cd "$(dirname "$0")" && pwd)+NAME=${SOLIDCRAFT_DEMO_NAME:-rover-build}+GIF_WIDTH=${SOLIDCRAFT_DEMO_GIF_WIDTH:-800}+GIF_FPS=${SOLIDCRAFT_DEMO_GIF_FPS:-10}+ffmpeg -loglevel info -nostats -y -f x11grab -draw_mouse 0 -video_size 1920x1080 -framerate 30 -i "$DISP" \+ -c:v libx264 -preset veryfast -crf 16 -pix_fmt yuv420p "$OUT/raw.mp4" 2> "$OUT/ffmpeg.log" &+FF=$!+trap 'kill -INT $FF 2>/dev/null || true; wait $FF 2>/dev/null || true' EXIT+sleep 1+python3 "$HERE/rover_replay.py" --port "$PORT" "$DESIGN" | tee "$OUT/replay.log"+sleep 3+kill -INT $FF; wait $FF || true+FSTART=$(grep -o "start: [0-9.]*" "$OUT/ffmpeg.log" | head -1 | cut -d" " -f2)+A=$(awk '/^start/{print $2}' "$OUT/replay.log"); B=$(awk '/^end/{print $2}' "$OUT/replay.log")+SS=$(python3 -c "print(max(0,$A-$FSTART-0.5))"); TO=$(python3 -c "print($B-$FSTART+1.5)")+ffmpeg -loglevel error -y -ss "$SS" -to "$TO" -i "$OUT/raw.mp4" -an -c:v libx264 -preset veryfast -crf 14 -pix_fmt yuv420p "$OUT/real-time.mp4"+python3 "$HERE/trim_idle.py" "$OUT/real-time.mp4" "$OUT/$NAME.mp4" --rate "$RATE" --crf 23+ffmpeg -loglevel error -y -i "$OUT/$NAME.mp4" \+ -vf "fps=$GIF_FPS,scale=$GIF_WIDTH:-1:flags=lanczos,split[a][b];[a]palettegen=max_colors=96:stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle" \+ "$OUT/$NAME.gif"+ls -la "$OUT/$NAME.mp4" "$OUT/$NAME.gif"diff --git a/examples/demo/record_ui.sh b/examples/demo/record_ui.shindex 5606eea9c2..62f107a9c1 100755--- a/examples/demo/record_ui.sh+++ b/examples/demo/record_ui.sh@@ -4,12 +4,13 @@# OUTDIR/enclosure-demo-STORY.mp4 (H.264) and .gif, with captions and a drawn pointer (the app# gets synthetic pointer events, so the screen's own pointer never moves). Needs ffmpeg with# x11grab and libass.-# PLAYBACK_RATE defaults to 1; label accelerated previews with their rate when publishing.+# PLAYBACK_RATE defaults to 1; label accelerated previews with their rate when publishing. Idle stretches+# (nothing on screen changes) are cut by trim_idle.py.# SOLIDCRAFT_DEMO_NAME overrides the filename stem; PAUSE scales UI pauses, CAPTION is the# minimum real-time caption duration, and HOLD keeps the live completed model on screen.# For a readable 4x preview use SOLIDCRAFT_DEMO_CAPTION=4 and SOLIDCRAFT_DEMO_HOLD=8.# SOLIDCRAFT_DEMO_GIF_WIDTH and SOLIDCRAFT_DEMO_GIF_FPS size the README GIF (default 800 px, 10 fps).-# The README demo (0.8): SOLIDCRAFT_DEMO_NAME=demo-0.8 SOLIDCRAFT_DEMO_PAUSE=0.4 SOLIDCRAFT_DEMO_CAPTION=9+# The README demo: SOLIDCRAFT_DEMO_NAME=demo SOLIDCRAFT_DEMO_PAUSE=0.4 SOLIDCRAFT_DEMO_CAPTION=9# SOLIDCRAFT_DEMO_HOLD=10 record_ui.sh :74 7974 OUT pi 9set -eDISP=${1:-:0}; PORT=${2:-7878}; OUT=$(cd "${3:-.}" && pwd); STORY=${4:-pi}; RATE=${5:-1}@@ -78,9 +79,14 @@ else:select="" # Partial rehearsals have no health/save/reopen interval.pathlib.Path(destination).write_text(select+f"setpts=N/(FRAME_RATE*TB*{rate})")PY-# Accelerate the public composite: cursor, ripples and captions stay aligned with the UI.-ffmpeg -loglevel error -y -i "$OUT/real-time.mp4" -vf "$(cat "$OUT/public.filter")" -an \- -c:v libx264 -preset slow -crf 20 -pix_fmt yuv420p -movflags +faststart "$OUT/$NAME.mp4"+# Speed the public composite up RATE times and cut the idle stretches (cursor, ripples and captions+# stay aligned with the UI). A take with a private proof interval drops it first.+SRC="$OUT/real-time.mp4"+if grep -q select "$OUT/public.filter"; then+ ffmpeg -loglevel error -y -i "$SRC" -vf "$(sed 's/,setpts.*//' "$OUT/public.filter"),setpts=N/(FRAME_RATE*TB)" -an -c:v libx264 -preset slow -crf 16 -pix_fmt yuv420p "$OUT/public-source.mp4"+ SRC="$OUT/public-source.mp4"+fi+python3 "$HERE/trim_idle.py" "$SRC" "$OUT/$NAME.mp4" --rate "$RATE"ffmpeg -loglevel error -y -i "$OUT/$NAME.mp4" \-vf "fps=$GIF_FPS,scale=$GIF_WIDTH:-1:flags=lanczos,split[a][b];[a]palettegen=max_colors=96:stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle" \"$OUT/$NAME.gif"diff --git a/examples/demo/rover_replay.py b/examples/demo/rover_replay.pynew file mode 100755index 0000000000..38c1b329cd--- /dev/null+++ b/examples/demo/rover_replay.py@@ -0,0 +1,87 @@+#!/usr/bin/env python3+"""Replay a design's timeline in a running SolidCraft, for a screen recording (record_rover.sh).++ solidcraft --control 7878 &+ python3 examples/demo/rover_replay.py --port 7878 Rover-recorded.solidcraft++Opens the design, frames the finished model, rolls the timeline back to its start and then+forward in even steps (the History bar's roll-to, as `timeline.roll_to` over the control+channel) while the camera orbits the model at a constant rate; it ends a few seconds after the last step. Prints "start" and "end" lines with epoch times so the recorder can trim.+"""+import argparse+import math+import os+import sys+import threading+import time++sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))+from enclosure_mcp import control # noqa: E402+++def main():+ ap = argparse.ArgumentParser()+ ap.add_argument("design")+ ap.add_argument("--port", type=int, default=7878)+ ap.add_argument("--rate", type=float, default=0.0133, help="orbit speed in radians per second of real time")+ ap.add_argument("--turn", type=float, default=4, help="seconds the orbit goes on after the last step")+ a = ap.parse_args()++ def ui(method, params=None):+ r = control(a.port, method, params)+ if not r.get("ok", False):+ raise RuntimeError(f"{method} {params}: {r.get('error')}")+ return r.get("result")++ ui("ui.prefs", {"language": "en", "theme": "dark", "button": "apply"})+ ui("ui.resize", {"width": 1920, "height": 1080})+ ui("ui.home", {"open": False})+ ui("ui.file", {"path": os.path.abspath(a.design)})+ time.sleep(1)+ while ui("ui.inspect").get("file_busy"):+ time.sleep(0.5)+ ui("ui.home", {"open": False})+ n = ui("engine.execute", {"command": "timeline.roll_to", "params": {}})["features"]+ joints = control(a.port, "engine.execute", {"command": "joint.inspect", "params": {}}).get("result", {}).get("joints", [])+ ui("ui.set", {"showSketches": False, "showOrigin": False, "hiddenJoints": [j["id"] for j in joints if "id" in j]})+ ui("ui.view", {"view": "iso"})+ ui("ui.camera", {"fit": True})+ time.sleep(1.5)+ cam = ui("ui.inspect")["camera"]+ yaw0 = cam["yaw"]+ # Keep the finished model in frame all through the turn.+ ui("ui.camera", {"distance": cam["distance"] * 0.82})+ time.sleep(0.5)++ def execute(params):+ r = control(a.port, "engine.execute", {"command": "timeline.roll_to", "params": params})+ if not r.get("ok", False):+ raise RuntimeError(r)++ execute({"position": 0})+ time.sleep(1.0)+ print("start", time.time(), flush=True)+ # The camera orbits at a constant rate for the whole replay (a thread, so it does not wait+ # for the timeline steps): yaw = yaw0 + rate * seconds since the start.+ t0 = time.time()+ stop = threading.Event()++ def orbit():+ while not stop.is_set():+ ui("ui.camera", {"yaw": yaw0 + a.rate * (time.time() - t0)})+ time.sleep(0.03)++ spin = threading.Thread(target=orbit, daemon=True)+ spin.start()+ steps = 90+ for i in range(1, steps + 1):+ pos = round(n * i / steps)+ execute({"position": pos} if pos < n else {})+ time.sleep(a.turn)+ stop.set()+ spin.join()+ print("end", time.time(), flush=True)+++if __name__ == "__main__":+ main()diff --git a/examples/demo/trim_idle.py b/examples/demo/trim_idle.pynew file mode 100755index 0000000000..b71129c104--- /dev/null+++ b/examples/demo/trim_idle.py@@ -0,0 +1,69 @@+#!/usr/bin/env python3+"""trim_idle.py IN OUT [--rate R] [--crf N]: speed a real-time screen recording up R times and cut+the idle stretches (nothing on screen changes: the pointer is still and the app is waiting).++A run of near-identical frames that would play for more than 0.15 s at the new speed is cut down+to 0.1 s; the last run (the held finished model) is kept for 0.5 s. Frames are compared at 320 px+wide, so a moving pointer, a drifting camera or a changing caption all count as activity.+Then every R-th remaining frame is kept at 30 fps and the result is encoded like the other+recordings (H.264 CRF 20, yuv420p, faststart). Pure Python and ffmpeg; no other dependencies."""+import argparse+import json+import subprocess++ap = argparse.ArgumentParser()+ap.add_argument("inp")+ap.add_argument("out")+ap.add_argument("--rate", type=float, default=1.0)+ap.add_argument("--crf", default="20")+ap.add_argument("--threshold", type=int, default=4, help="grey levels a pixel must change by")+a = ap.parse_args()+FPS = 30+info = json.loads(subprocess.check_output(["ffprobe", "-v", "error", "-select_streams", "v", "-show_entries", "stream=width,height", "-of", "json", a.inp]))["streams"][0]+W, H = info["width"], info["height"]+AW = 320+AH = int(AW * H / W) // 2 * 2+++def frames(vf, size):+ cmd = ["ffmpeg", "-v", "error", "-i", a.inp] + (["-vf", vf] if vf else []) + ["-f", "rawvideo", "-pix_fmt", "gray" if vf else "rgb24", "-"]+ p = subprocess.Popen(cmd, stdout=subprocess.PIPE)+ while True:+ b = p.stdout.read(size)+ if len(b) < size:+ break+ yield b+++active, prev = [], None+for f in frames(f"fps={FPS},scale={AW}:{AH}", AW * AH):+ active.append(True if prev is None else sum(1 for x, y in zip(f, prev) if abs(x - y) > a.threshold) >= 2)+ prev = f+n = len(active)+longest, keep_run, end_keep = int(0.15 * a.rate * FPS), int(0.1 * a.rate * FPS), int(0.5 * a.rate * FPS)+keep = [True] * n+i = cut = 0+while i < n:+ if active[i]:+ i += 1+ continue+ j = i+ while j < n and not active[j]:+ j += 1+ k = end_keep if j == n else keep_run+ if j - i > max(longest, k):+ for t in range(i + k, j):+ keep[t] = False+ cut += j - i - k+ i = j+kept = sum(keep)+print(f"{a.inp}: {n / FPS:.1f}s real time, {cut / FPS:.1f}s idle cut, {kept / FPS / a.rate:.1f}s at {a.rate}x")+enc = subprocess.Popen(["ffmpeg", "-v", "error", "-y", "-f", "rawvideo", "-pix_fmt", "rgb24", "-s", f"{W}x{H}", "-r", str(FPS), "-i", "-", "-an", "-c:v", "libx264", "-preset", "slow", "-crf", a.crf, "-pix_fmt", "yuv420p", "-movflags", "+faststart", a.out], stdin=subprocess.PIPE)+j = 0+for idx, f in enumerate(frames(None, W * H * 3)):+ if idx < n and keep[idx]:+ if int(j / a.rate) != int((j - 1) / a.rate) or j == 0:+ enc.stdin.write(f)+ j += 1+enc.stdin.close()+enc.wait()