rigs
Splat rigging API: animated, articulated bodies painted with Gaussian splats. `put(key, { limbs = { { a, b, r1, r2, color, tipColor } }, splats, blend })` paints a rig whose limbs are tapered capsules between world points — call it every frame with the current pose — and `remove(…
rigs
Splat rigging API: animated, articulated bodies painted with Gaussian splats.
put(key, { limbs = { { a, b, r1, r2, color, tipColor } }, splats, blend })
paints a rig whose limbs are tapered capsules between world points — call it
every frame with the current pose — and remove(key) stops it. All rigs are
one sdfSplats source painted by sdf_rig; each limb's share of splats is
fixed when the rig is first put, so moving bones never reshuffles strokes.
SplatSkeleton and SplatRig are built on it; rotate(q, v) helps place
limbs from bone rotations.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2module rigs Splat rigging: animated, articulated bodies painted with Gaussian splats. A rig is a list of limbs — tapered capsules between two world points, one per bone — smooth-unioned into one skin and re-surfaced with splats every frame by `sdf_rig`, so whatever moves the bones (an animation clip on a skeleton, rotating bone entities, a script) animates the splat body. `SplatSkeleton` builds a rig from any animated skinned character; `SplatRig` + `SplatLimb` build one from bone entities; any script can `put` a rig of its own, keyed by any id, every frame.
limbArea(l: Limb) → number
| arg | type | description |
|---|---|---|
| l | Limb |
distribute(rig: Rig, budget: number) → void
Split a rig's budget over its limbs in proportion to their area (every limb keeps at least a few strokes); the shares sum exactly to the budget.
| arg | type | description |
|---|---|---|
| rig | Rig | |
| budget | number |
sortedKeys( ) → void
generate(frame: any) → void
| arg | type | description |
|---|---|---|
| frame | any |
put(a: number, b: number, c: number, d: number) → void
| arg | type | description |
|---|---|---|
| a | number | |
| b | number | |
| c | number | |
| d | number |
sync( ) → void
Keep the source registered with the current total. Cheap when nothing changed; re-registers after the sdfSplats module reloads.
put(key: string, rig: Rig) → void
Paint (or update, every frame) one rig: its limbs at their current world pose. The splat split between limbs is fixed the first time a rig of this shape is put, so moving bones never reshuffles strokes. blend?, wobble?, opacity?, strokeSize?, seed? }`; points world-space, colours linear. { a = { 0, 1, 0 }, b = { 0.5, 1.2, 0 }, r1 = 0.15, r2 = 0.12, color = SdfSplats.hex("#c9566a"), tipColor = SdfSplats.hex("#f0a070") } } })
| arg | type | description |
|---|---|---|
| key | string | Stable id (a component instance id, or your own). |
| rig | Rig | `{ limbs = { { a, b, r1, r2, color, tipColor, glow? } }, splats, |
examples
rigs.put("worm", { splats = 12000, blend = 0.08, limbs = {remove(key: string) → void
Stop painting one rig.
| arg | type | description |
|---|---|---|
| key | string | The id it was put under. |
examples
rigs.remove("worm")get(key: string) →
The rig last put under `key` (its limbs at the current pose) and the splats each limb paints, or nil.
| arg | type | description |
|---|---|---|
| key | string | The id it was put under. |
examples
rigs.get("worm").rig.limbs[1].bkeys( ) →
Every rig key currently painted.
examples
rigs.keys()
count( ) →
How many rigs, limbs and splats are painted.
examples
rigs.count()
rotate(q: { number }, v: { number }) →
Rotate vector `v` by quaternion `q` (`{ x, y, z, w }`).
| arg | type | description |
|---|---|---|
| q | { number } | Unit quaternion. |
| v | { number } | Vector `{ x, y, z }`. |
examples
rigs.rotate({ 0, 0.7071, 0, 0.7071 }, { 0, 0, 1 })Limb = {Rig = {API for splat rigging: put animated limb rigs (tapered capsules per bone) that are painted as one smooth Gaussian splat body.Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Showing up to 3 levels deep. Open a part to see what it holds further down.
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
agent_score is exposed.+ quality × 0.35
+ performance × 0.25
± compat factor
Usability ratings
Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".
Scoped to this part · feeds back into the world's score.