Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions docs/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -2776,6 +2776,31 @@ in-place tests' world, rows given back; two models in a shared pose posed again
(tests/render/data/arm.glb, a skinned strip of two materials); `geometry/emitter-model-live` (a model's emitting
section that is not its first, the model a unit under software traversal).

**A posed rigid model is edited in place (2026-11-20).** As a mesh and a still model are. Hidden, its parts are
instances no ray sees, their emitters at no weight, and it is posed and moved on; shown, it is placed where it
stands (`show_meshes`, `repose_rigid`). Removed, its instances are no object's (`edit_geometry`). One the scene has
is placed again as an instance of each of its parts' meshes (`Retained::rigid_meshes`), a part a record of the room,
in a run. Its pose update goes through what is above the instances under either traversal (the TLAS,
or the units' top tree): under software traversal a new pose or a move was a rebuild's.
An edit places an instance by one function now (`place_instance`: its rows, its emitters, its record, its place
above the triangles), for a mesh, a still model and a rigid model's part alike. With it a still model whose mesh
emits is placed again in place, where that was a rebuild's.
Its parts are the nodes any clip of the file moves, not those of the clip it plays (`skin::Model::moving_nodes`),
and the nodes its pose names: another clip is posed in place. Until now the parts were the playing clip's, and a
model given another clip, or a pose that named another node, was posed in place with the wrong parts (the nodes
the new pose moves stayed in the part merged for the old one). A pose that names other nodes is a rebuild's
(`RigidModel::pose`).
Still a rebuild: one with triangles flattened beside its parts (`flatten_coincident`'s) hidden, removed or placed
again; a pose that names other nodes than the last; a model hidden when the scene was built, shown; a skinned model
added, hidden or removed; a model the scene has not, added.
Measured, software traversal, an interior of 7,300 nodes whose clip plays (4,181 units): every frame rebuilt the
scene, 2.9 s a frame; now none does, a frame's commit is 1.2 ms and the frame 19 ms (1280 x 720 at half scale).
Tests, natively and under software traversal, each against a build's light list and picture: a posed rigid model
hidden, posed and moved while hidden, shown, removed; a still and a posed rigid model with emitters placed again,
the latter then posed, moved, hidden, shown and removed, its records and rows the room's again and the next one's;
one with flattened triangles hidden and removed by a rebuild; one given another clip of its file, in place
(`tests/render/data/two-clips.glb`); one whose pose names a node no clip moves, by a rebuild.

**A posed rigid model is its parts' instances (2026-11-20).** A model posed by a clip that moves nodes, without
skins, was built in two ways at once: the nodes the clip leaves alone flattened into world-space triangles a
placement, each node it moves an instance of a mesh made a placement. Now the model is parts (`scene::RigidModel`),
Expand Down
8 changes: 4 additions & 4 deletions docs/RUNTIME.md
Original file line number Diff line number Diff line change
Expand Up @@ -1193,9 +1193,9 @@ its BLASes, or the units), so the engine's path is the same under both traversal
| a mesh is removed | its record cleared, its tree given back and filled, the top tree |

The scene is rebuilt, as before this step, by: the first instanced mesh of a scene that has none (its kernel has no
unit walk: one rebuild, as hardware traversal's first instance is); an edit of a procedural object; a posed model's
pose (its triangles are in the still tree) and a rigid group's (its parts are units, placed again by a rebuild
still); an instance of a mesh that deforms; **room that is
unit walk: one rebuild, as hardware traversal's first instance is); an edit of a procedural object; a skinned
model's pose (its triangles are in the still tree; a rigid group's parts are units, posed in place); an instance of
a mesh that deforms; **room that is
full** (the edit room and the tree ranges are sized at the build, a quarter of the scene and at least 65,536
triangles and 1,024 records, and do not grow under software traversal: under hardware traversal they do; what an
edit replaces stays behind until the next rebuild, under both; a scene with units and no geometry of its own to
Expand Down Expand Up @@ -1407,7 +1407,7 @@ guard's 1.2 ms there is not its form). In Chrome (`tools/web-hello.ts --frames`)
| `instancing` (1,000, all moving) | 3.39 / 7.89; flat rebuilds the scene every frame (276 ms of CPU a frame; units 6.5) | offline at one instant, 64 spp: ΔE 0.37, SSIM 0.995 |
| `bistro` (1 unit of 2.83 M triangles) | 23.1 / 22.2 | ΔE 0.69, SSIM 0.990 |
| `zero-day` (1 unit of 5.87 M) | 14.5 / 12.8 | ΔE 1.20, SSIM 0.963: the scene's own spread, see below |
| `zero-day-animated` (3,991) | every frame rebuilds the scene (2.6 s), with units as flat: a rigid group's pose, as before step 7b | – |
| `zero-day-animated` (4,181) | posed in place since 2026-11-20: 16.3 ms at 1280 × 720, half scale, a frame's commit 1.2 ms (before: every frame rebuilt the scene, 2.9 s) | – |

`zero-day`'s picture: two runs of the flat kernel are ΔE 0.11 apart, so units' 1.20 is not noise of one kernel.
Offline at 1,024 spp the three traversals are as far from one another: units against flat ΔE 0.97, hardware
Expand Down
3 changes: 2 additions & 1 deletion packages/scene/src/core.ts
Original file line number Diff line number Diff line change
Expand Up @@ -1253,7 +1253,8 @@ export interface AnimationPose {
* Local transforms of nodes (joints) by name, over the clip's: 4 numbers, a rotation (quaternion x, y, z, w), or 7,
* a translation (x, y, z, in the node's parent's space) and then the rotation. A skinned mesh follows its joints
* (aim, look, procedural steps). Each model posed this way is skinned on its own; set a new object (or change these
* numbers and set it again) for a new pose.
* numbers and set it again) for a new pose. A model without skins is drawn in parts by the nodes that move: name the
* same nodes in every pose (one that names others rebuilds the scene).
*/
nodes?: Record<string, ArrayLike<number>>;
}
Expand Down
Loading