Skip to content

armgit / viz3d

Public Imported from GitHub
0

An AI agent skill that turns any subject into a 3D film or app

Film: planning, holds, cutaways and frame checks from the metro test build

Nguyen Xuan Anbff147d036aa
diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.md b/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.md
index e613cfc..79ac6f2 100644
--- a/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.md
+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.md
@@ -41,7 +41,8 @@ UVs, PBR materials (small procedurally baked textures are fine), emissive where
material per state, so the app can toggle it. Two to four variants of anything that repeats more than about five
times (vehicles, people, trees, buildings); one model is fine for unique structures. Moving parts are separate named objects or bones with their pivot at the
origin (wheels, doors, fans, lifts, booms, bridges, character limbs); characters and animals get an armature with
-named clips (vertex groups per bone, an Armature modifier, clips on NLA strips); render one posed frame of each clip
+named clips (the app plays clips per figure, or for crowds uses a few baked pose meshes per clip, since three.js
+instancing does not skin) (vertex groups per bone, an Armature modifier, clips on NLA strips); render one posed frame of each clip
to check the bone axes. Build repeating structures (track, platforms, sheds) on one module length that fits the real
thing, and write it into ASSETS.md. Keep the total under about 40 MB (10 MB is typical), one GLB per asset family so repeats can be instanced.
Set single-sided materials (backface culling on), so the exported glTF is not doubleSided.
diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.md b/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.md
index 0fbaecb..9db7924 100644
--- a/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.md
+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.md
@@ -62,6 +62,17 @@ leans on them most. Reading map: Pacing and text, Camera, Figures and places, Ma
then the script pre-rolls the simulation a whole number of seconds and captures one screenshot per 1/30 s step.
Encode the frames with ffmpeg afterwards.
- The simulation steps only from the virtual clock, never from wall time, so the same seed gives the same film.
+ Step CSS animations and transitions with the same clock (document.getAnimations(), set currentTime), and read the
+ simulation time at the first captured frame instead of assuming the pre-roll landed exactly.
+- Plan the film from the simulation: a small script runs the seed forward and picks the hero unit and the times, so
+ the unit you click is moving and on screen at that moment.
+- During a follow or a hold, keep a slow real drag-orbit or wheel going. A followed unit that stops (a train at a
+ platform) otherwise gives repeated frames. Find them with ffmpeg mpdecimate plus showinfo and fix every gap over
+ 0.2 s.
+- The subject must read at film size: the main moving unit fills at least a quarter of the frame width in the
+ opening and the follow beat. Context (a city, terrain) never outweighs the system the film is about.
+- When the system is hidden (underground, inside a building, behind a roof), cut it open: a clean section through
+ the ground or the walls, with the camera-side scenery removed or ghosted, and real materials on every cut face.
- Each beat's hero event (a unit reaching a booth, a truck under a gantry) must happen inside its beat. Spawn the hero
at a fixed simulation time so it lands 2 to 3 s into the beat, and check it on the sheet.
- A plain-words strip carries one short line at a time, on the caption timer above.
diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.sh b/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.sh
index cd23056..f79069f 100755
--- a/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.sh
+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.sh
@@ -28,5 +28,5 @@ ffmpeg -v error -i "$video" \
-vf "fps=${frames_per_second},scale=${scale},drawtext=text='%{pts\:hms}':x=8:y=8:fontsize=18:fontcolor=white:box=1:[email protected],tile=5x4:padding=4:color=black" \
-q:v 3 "$output_folder/sheet_%02d.jpg"
-echo "Sheets in $output_folder (newer than $video: check before trusting them)"
+echo "Sheets in $output_folder"
ls -l "$output_folder"/sheet_*.jpg