Browse docs
3D scenes
Inspect geometry and recorded motion with EpisodeRecon3d. This specimen loads
a ruler, toy, and hand meshes in their rest pose. Drag to orbit; no external
motion tracks are attached here.
Code BasicSpec.tsx
Load geometry and motion
Load glTF or GLB geometry, then join motion tracks by mesh node name. A
ruler track drives the ruler node; recognized suffixes such as ruler_pose
also match.
Give the parent a height. transforms supply translations and quaternions;
vertexTracks deform meshes. Embedded glTF animation runs when an external
transform track does not override it.
Convert timestamped point sets with pointTrackFromPose3d(name, payload).
A 21-point set gets the hand skeleton by default; provide edges for another
topology or [] for points alone. Set upVector to orient gravity upright.
Props
| Prop | Type | Default | Purpose |
|---|---|---|---|
scene | Scene3dInput | required | Geometry and tracks joined by node name. |
time | number | null | 0 | Playback time in seconds; null shows the first frame. |
duration | number | 0 | Clip length, used to time vertex tracks that do not supply fps. |
trail | { ahead?: number; behind?: number } | false | { ahead: 1, behind: 0 } | Seconds of future and past motion to draw. False hides trails. |
interactive | boolean | true | Enable orbit controls; false is useful for thumbnails. |
originMarker | 'camera' | 'axes' | 'camera' | Mark a camera-frame origin or show orientation axes for world-frame data. |
dataVersion | number | — | Increment after refilling track arrays in place so derived trails rebuild. |
className | string | — | Root CSS classes. |
When filling existing track arrays, retain scene identity and increment
dataVersion to refresh trails without resetting the camera. A .dreamrc
recon3d view receives time from the dataset's shared cursor.