tosijs-3d 0.12.5 → 0.13.0

package/CHANGELOG.md

@@ -12,9 +12,9 @@ Upgrading across a minor? Start with [Migration](/Migration/).
 
 ## Unreleased
 
-## 0.12.5
+## 0.13.0
 
-The latest release. Exported bodies carry clips, garments and held items; the cast's rigs are engine-free; the Babylon peers are optional (install them yourself); the character builder gets a Character menu, a hair manipulator and sub-sections. See [0.12.5](/v0.12.5/).
+The latest release. Biped gunplay aims where you look, crowds move figure by figure, system-bar menus cascade flat and in VR, and headset panels, presses and the chase camera behave. Garment exports bake their look only when given the baker. See [0.13.0](/v0.13.0/).
 
 ## Every version
 

package/Migration.md

@@ -9,6 +9,24 @@ This file ships **inside the package**, because a migration table you can only
 read on GitHub does not exist for someone who has already installed the thing
 and is staring at an error.
 
+## 0.12.x → 0.13.0
+
+The peer ranges are unchanged. Four things change under you:
+
+1. **`riggedBodyGlb` no longer recolours garment pictures by default.** Its
+   `bake` option is now the baker itself: pass `bake: bakeClothLook` (from
+   `tosijs-3d/cloth-bake`) to keep the baked look. Without it the pictures
+   are written as they are, and it warns once. `bake: false` still means no
+   bake; `bake: true` no longer means anything. `exportBody` passes the baker
+   for you.
+2. **The settings panel's Slow motion button is gone.** Set `timeScale` on
+   the `<tosi-b3d>` from your own control if you want one.
+3. **`barMenu` submenus cascade** beside the list, all on one surface,
+   instead of replacing it with a way back. A press opens one; a press on its
+   row again closes it.
+4. **`viewMenu` leaves the system bar during a headset session**, since in VR
+   the camera is your head. It comes back when the session ends.
+
 ## 0.11.x → 0.12.0
 
 The peer ranges are unchanged. Four things change under you:

package/README.md

@@ -130,7 +130,10 @@ tubes bored through them, arches, caverns.
 
 **Biped control** — a [character controller](https://3d.tosijs.net/b3d-biped/)
 with an animation state machine and follow/XR cameras, from a GLB: walk, run
-and sprint, jump, swim, climb ledges.
+and sprint, jump, swim, climb ledges, and hold a gun that
+[points where you aim](https://3d.tosijs.net/aim-ik/), crouched or standing.
+[Crowds](https://3d.tosijs.net/b3d-crowd/) of thousands are drawn on the GPU,
+and each figure can be moved, turned and re-clipped.
 
 **Any character on one animation library** — [retargeting](https://3d.tosijs.net/retarget/)
 plays the Universal Animation Library's clips on a Mixamo, Kenney or
@@ -167,6 +170,9 @@ renders as a DOM overlay, as a texture on a surface in the scene, and as a
 floating panel in a headset, from the same declaration. Includes a
 [flowing box model](https://3d.tosijs.net/box/), [menus and panels](https://3d.tosijs.net/surface/),
 a data table, and an on-screen keyboard — because a headset has nowhere to type.
+A [system bar](https://3d.tosijs.net/system-bar/) of buttons and
+[cascading menus](https://3d.tosijs.net/bar-menu/) sits in the corner flat and
+up ahead in VR.
 
 **SVG textures** — [draw with SVG](https://3d.tosijs.net/svg-texture/), use it as
 a live texture. Designer artwork becomes a HUD, a gauge, or a control surface
@@ -196,7 +202,7 @@ or a server imports them without Babylon.
 
 **Pure models, actually tested** — the flight model, ballistics, guidance, biome
 classification, layout and text editing are engine-free and unit-tested (about
-3,000 tests, run in seconds with no GPU). If it can be a function of its inputs,
+3,900 tests, run in about a minute with no GPU). If it can be a function of its inputs,
 it is.
 
 ## Development

package/changelog/v0.12.6.md

@@ -0,0 +1,46 @@
+# 0.12.6
+
+<!--{ "parent": "CHANGELOG", "order": 9987994 }-->
+
+For the character builder and the rig tool: clips from motion capture (BVH) kept in the browser and carried in character files, exports of MakeHuman's body in its clothes, hair, skin, eyes and lashes, a tailor's garment that fits any body, and retargeted feet that stay on the ground. Rigs from markers place the pelvis, neck and the AI cast's knees as UAL's mannequins have them.
+
+Size: barrel (min, packages external) 1698.6 KB raw / 591.0 KB gz, up 43.5 KB / 17.5 KB gz (+2.6%) on 0.12.5.
+
+### Added
+
+- Rig tool: drag a marker forward or back in a side view to set its joint's depth (the fit puts each at the middle of the body's thickness, and the mannequin's pelvis is well behind it). Kept in the rig recipe as `binding.depths`, an offset per marker from the fit's depth; `fitSkeleton`'s `depths`, `bodyFromMarkers`'s `depths` and `rigFromMarkers`'s sixth argument take it too.
+- Rig tool: a **floor** slider (Motion) moves the body up or down from where its soles stand, for one that floats or sinks; kept in the rig recipe as `floor` (metres), and the character builder stands the body the same way. At rest the soles, not the mesh's lowest point, are put on the floor.
+- Character builder: exporting MakeHuman's body writes the clothes it wears (MakeHuman's own and garments of your own made on it), fitted as drawn, with their pictures and looks. `character.exportGarments()` gives them for `riggedBodyGlb`'s `garments` on either kind of body; `onSkin` (`garment-proxy`) binds a piece made for MakeHuman's pack to the skin a body draws, and `packGarmentMaterial` gives a pack piece's material as data.
+- The export of MakeHuman's body carries its eyelashes, drawn and faded as in the builder, following the head. The fade is a small ramp picture, so it needs no vertex alpha (`shortenLashes`, `lashAlpha`, `lashUvs`, `lashPicture` in `eye-art`).
+- The export of MakeHuman's body carries its hair, beard, moustache and brows: Quaternius' pieces placed as the builder places them (scalp hair following the head, tucked under a hat), MakeHuman's own hair and brows bound like clothes, each picture coloured as the builder colours hair (`recolourHair`, `cloth-bake`). A garment may `follow` one joint wholly; `riggedBodyGlb` tucks the skin under clothes only. `readHairLibrary` now gives each part's uvs and material, and `readHairMaterials` the library's pictures.
+- The export of MakeHuman's body carries its skin (its tone as the material, lips and stubble as vertex colours: `skinSurface`, `skin-paint`) and its eyes with Tonio's eye art in its iris colour (`riggedBodyGlb`'s `eyeTexture`, laid on by `gltfEyeUvs`). `character.exportCharacter()` gives the body, garments and eye picture together.
+- Export (rig tool, character builder): **animation** puts the clip playing in the GLB, retargeted onto the skeleton as written, whether it is UAL's, a GLB of your own or a BVH capture. A host passes it as `clip` on the export target (`ExportClip`: the file and the clip's name); `exportClip` reads one into `riggedBodyGlb`'s `clips`.
+- A character file carries the clip it plays when that is one of your own (`clips`: the BVH or GLB file, by name), so it plays on a page that has never seen the file; the builder reads and keeps it on load. `characterStore` keeps the bytes once, as it does garments.
+- A garment's look goes out in its picture: `riggedBodyGlb` writes a recoloured cloth's texture recoloured, so any engine shows what the builder does (`bake: false` keeps the pictures as they came). `bakeClothLook(picture, look)` (`cloth-bake`) is the step on its own.
+- `jpegDecode` and `decodeImage` (`tosijs-3d/jpeg`): JPEGs read with no engine or canvas (baseline and progressive, grey or colour, any chroma subsampling), as `pngDecode`'s `RgbaImage`; `decodeImage` reads either. `pngDecode` now reads grey PNGs too.
+- Character builder: **clips from a file…** takes BVH motion captures as well as GLBs, and keeps them in this browser (`clipStore`, IndexedDB `tosijs-clips`), so they come back next visit; **forget** drops one. `retargetSourceClip` plays a clip held as data (a BVH, or a GLB read with `readGlbClips`) on a loaded skeleton, as `retargetClip` does a loaded one.
+- `readBvh` and `writeBvh` (`tosijs-3d/bvh`): BVH motion capture files read as clips (any skeleton, any Euler order, units guessed or given) that `bakeClip` and `retargetClip` play on any body, and any clip written out as BVH.
+- A tailor's garment fits any body (`tailor-recipe`): a cut records the joints of the body it was drawn on (`TailorCut.on`), and `recutGarment(body, cut)` makes it on another rigged body, its outlines carried by the joints so a hem drawn at the knee stays at the knee. In the tailor, outlines now follow the body when it is reshaped. `fitCut`, `warpOutline`, `outlineLandmarks` and `tailorBody` are the parts.
+- `heldParts(joints, held, bases)` (`tosijs-3d/rigged-body-glb`): a held item for any skeleton at rest, as `riggedBodyGlb` writes one: the socket joint under the hand (local transform and inverse bind), and the item's mesh skinned to it with its materials and pictures. For a GLB writer whose skeleton `riggedBodyGlb` did not make; `riggedBodyGlb` now uses the same code.
+- `loftGarment` (`body-sweep`): a garment lofted along a chain of bones, as rings round the hull of the body's slice plus thickness and an `ease` curve, with mitred or rounded (`steps`) bends and open, sealed or capped ends. It returns a `GarmentCut` binding, so it fits and bends like a tailor's cut. The first piece of the sweep core; no tool uses it yet.
+
+### Changed
+
+- Rigs bound from markers put the pelvis behind the thigh joints by 0.028 of the body's height and below them by 0.008, as UAL's mannequins have it, not above them at the middle of the hips' thickness (a seat, a belly or armour moved it). Every marker rig changes, saved ones too: look at yours in a crouch. `fitSkeleton`'s `pelvis: 'middle'` gives the old placement.
+- Rigs bound from markers put the neck joint at the top of the shoulders, an eighth of the way down from the head joint to the pelvis as on UAL's mannequins; on a body with its arms down it sat in the upper chest (5 to 9 cm low on the AI cast), so the head turned from there.
+- Tailor: a new garment, or one with nothing drawn yet, is cut from the body's own triangles (**cloth mesh: as the body**), not draped: the cheapest and surest way. Saved garments keep how they were made.
+- `loadCharacterAssets` no longer fetches Quaternius' hair library (13.9 MB) at start: a character fetches it the first time it wears one of its pieces, and offers the pieces by name before then (`QUATERNIUS_HAIR`). `CharacterAssets.hair` is null until then; `assets.loadHair()` loads it, and `loadCharacterAssets(scene, { hair: 'now' })` keeps the old behaviour.
+- Character builder: the panel runs from the most basic, least changeable choices to the most: tabs Body, Skin, Eyes, Face, Hair, Clothes, Hold, Motion, Export; in the Body tab, shape (gender, age, height) then ancestry then figure (weight, muscle and the rest); in Hair, brows and the style before beard, moustache and stubble. Control paths that moved: `Body/figure/weight`, `Body/figure/muscle`.
+
+### Fixed
+
+- Retargeted clips keep the feet on the ground on bodies whose thigh and shin are proportioned differently from the clip's (the rig tool's AI characters crouched with one foot in the air): a foot near the ground goes where the source's went and the leg bends to reach it; a foot in the air keeps the copied angles. On by default in `retargeter`, `retargetClip` and `bakeClip`; `footIk: false` turns it off.
+- Rig tool: a recipe handed over through `api.recipe` with new markers now binds the mesh again (it kept the old binding).
+- The African American female's and Eurasian male's knee joints sit higher (2.5 and 4.4 cm), at the hollow behind the knee rather than below it.
+- Tailor: switching to a slot that wears something the body shown cannot (MakeHuman's shoes while another body is on show) opened as "(new garment)" but said there was no outline; it now starts a new garment.
+- Tailor: undo and redo work while an outline is being clicked out, a point at a time (they did nothing until it was closed). `outlineField3d` gains `undoPoint`/`redoPoint`. A panel's tooltips stay inside its padding, so the undo button's is no longer cut off at the edge.
+- `riggedBodyGlb` wrote a garment's uvs upside down (ours run up the image, glTF's down), so a textured garment's picture landed flipped on it in other engines.
+- The tailor could not cut a large garment ("Maximum call stack size exceeded"): a big cut's triangle list was spread into a call. The same pattern is gone from `remesh` and `loadRigTriangles`.
+- A body opened from the builder's own export GLB (`riggedBodyGlb`) is its skin and eyes only: `glbRigTriangles`, `loadRigTriangles` and `loadSkinnedBody` leave out the garments and the held item it also carries, which were merged into the body.
+- A menu opened from a scene panel (a select's list) closes on a press anywhere else: outside it, or on its panel anywhere but the control that opened it, which still toggles it. `showLayer` takes `dismissOutside`, and `showPopup` (every menu) asks for it.
+- A popup dropped with its title band off screen comes back on release until the band is reachable (its top on screen, 48 px of it across), as a frame panel's screen drag already does. It may still be slid partly off to see past it.

package/changelog/v0.13.0.md

@@ -0,0 +1,48 @@
+# 0.13.0
+
+<!--{ "parent": "CHANGELOG", "order": 9987000 }-->
+
+Biped gunplay that aims where you look, crowds you can move figure by figure, cascading system-bar menus that work flat and in a headset (the character builder's Animation menu among them), and a round of headset fixes: panels that keep their place under the bar, presses from either hand, a chase camera that keeps its seat. Garment exports bake their cloth look only when given the baker.
+
+Size: barrel (min, packages external) 1707.6 KB raw / 594.0 KB gz, up 9.2 KB / 3.0 KB gz (+0.5%) on 0.12.6.
+
+### ⚠️ Breaking
+
+- `riggedBodyGlb` bakes a garment's cloth look only when given the baker: pass `bake: bakeClothLook` (from `tosijs-3d/cloth-bake`). Without it the pictures are written as they are, and a bundle that imports `tosijs-3d/rigged-body-glb` alone no longer carries an image decoder (about 11 KiB gzip less; the barrel still exports both). It warns once when a garment has a look and no baker. `exportBody` passes it. `bake: false` still means no bake.
+
+See [Migration](/Migration/) for the other changes that need attention (Slow motion removed, cascading `barMenu` submenus, `viewMenu` in a headset).
+
+### Added
+
+- `<tosi-b3d-crowd>`: `setFigure(i, { x, y, z, yaw, clip, speed })` moves, turns or re-clips a figure; changes are uploaded once per frame however many figures moved. `clipNames` lists the clips. The doc page has a demo of walkers crossing a field.
+- `aimSpine(chain, held, target)` turns a spine after the clips have posed it so a held item points along an aim.
+- `<tosi-b3d-cloud-deck sky-clock="off">`: the deck drifts in world time, not the sky's, so a fast day passes under clouds that move at their own pace. City Drive and Cross Country use it.
+- `<tosi-b3d-panel bar-button="off">`: a system panel with no button of its own on the bar, for one something else opens (`el.show()` from a menu entry).
+
+### Changed
+
+- `<tosi-b3d-biped>` holding a weapon in `gunplay` points it along its aim: the spine is turned after the animations. Crouched, the gun used to point about 45° low, and standing 11° low.
+- `viewMenu` leaves the system bar during a headset session; in VR the camera is your head.
+- A trackpad pinch on an orbit camera zooms three times as far (`PINCH_GAIN`), and pinching works in Safari, which sends gesture events rather than a ctrl-wheel.
+- The character builder has an **Animation** menu on the system bar (play/pause and the clip); its **Playback controls** entry opens a small panel for scrubbing and speed. The page is titled **Character Builder**. While rigging, Play goes to the perspective view and Pause back to the face view last held.
+- `barMenu` submenus open beside the list (cascading, all on one surface) instead of replacing it with a way back. A submenu opens on a press, and a press on its row again closes it.
+- A system panel's button on the system bar stays lit while its panel is open (its HTML button carries `aria-pressed`).
+- Nothing is heard before the scene is shown: the effect voices (traffic, street lights, effects) and Babylon's own sounds stay silent until the loading spinner gives way. `holdEffectAudio()` (from `tosijs-3d/effect-audio`) holds them for a page's own reasons.
+- The settings panel no longer has a Slow motion button. Set `timeScale` from a page that wants one.
+
+### Fixed
+
+- In a headset, a system panel whose content grows after it opens (the rig tool once a body is rigged, the tailor) grows downward from under the system bar. It used to grow about its centre, up over the bar. `attachFramePanel` takes `keepTop: true` for this.
+- A trackpad pinch sent as ctrl-wheel notches (many Windows trackpad drivers) zooms one wheel step a notch; each notch used to move the camera about twenty times as far.
+- `<tosi-b3d-launcher>`'s `reloadModel()` no longer disposes the library's materials with the old model: after the first weapon swap, every weapon from that library was drawn white (the Biped Playground's loadout). `<tosi-b3d-crowd>`'s actors had the same fault when removed.
+- `<tosi-b3d-hud>`: changing `size` resizes the HUD straight away; it used to wait for the next window resize. Any `handleResize()` call made after setting it can go.
+- `<tosi-b3d-sound>` removed while its file loads no longer throws an unhandled rejection ("No volume subnode"); it is disposed once Babylon has finished loading it, and never starts playing.
+- Removing a `<tosi-b3d>` no longer warns "WebGL context LOST": the teardown loses the context on purpose. An unexpected loss still warns.
+- A skybox with its own `<tosi-b3d-moon>`s takes its night light from the brightest moon above the horizon. A moon that has set no longer lights the ground from below, and with every moon set the night has only ambient light.
+- In a headset, a press on the hand that is not pointing now counts on every way into VR (`enterXR` and the biped's own XR camera), not only `<tosi-b3d>`'s.
+- A popup whose content changes shape after it opens follows the new shape. It used to be drawn stretched or squashed until it was closed and opened again.
+- The tailor: an outline that lies past the outline field (one carried over from another body) is clipped to the field, and its points are drawn at the field's edge so you can drag them back. It used to draw over the panel's buttons.
+- In a headset, the system bar follows its panels during the session: a menu that leaves the bar (`viewMenu`) or a panel added late now does so in VR too. It used to keep the buttons it had when you entered.
+- A select (or other popup) in a system panel opens on its own surface in front of the panel instead of being cropped inside it.
+- The biped's aim reticle and the shadow blob under characters and vehicles are never culled. They used to vanish when the spot where they were created went out of view (in a headset, sometimes from one eye only).
+- In a headset, the vehicle chase camera keeps its seat through a brief moment with nothing piloted. It used to take wherever you were looking as forward again, a re-seat you did not ask for.

package/dist/aim-ik.d.ts

@@ -0,0 +1,13 @@
+import * as BABYLON from '@babylonjs/core';
+export interface AimSpineOptions {
+    /** 0..1: how much of the correction to apply. Default 1. */
+    weight?: number;
+    /** The largest turn, degrees, over the whole chain. Default 70. */
+    maxDeg?: number;
+}
+/**
+ * Turn `chain` so `held` points along `target`. Returns the angle, degrees,
+ * left between them afterwards (0 when it got there).
+ */
+export declare function aimSpine(chain: BABYLON.TransformNode[], held: BABYLON.TransformNode, target: BABYLON.Vector3, options?: AimSpineOptions): number;
+//# sourceMappingURL=aim-ik.d.ts.map

package/dist/aim-ik.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-ik.d.ts","sourceRoot":"","sources":["../src/aim-ik.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAE1C,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAyBD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,EAC9B,IAAI,EAAE,OAAO,CAAC,aAAa,EAC3B,MAAM,EAAE,OAAO,CAAC,OAAO,EACvB,OAAO,GAAE,eAAoB,GAC5B,MAAM,CA0DR"}

package/dist/aim-ik.js

@@ -0,0 +1,111 @@
+/*#
+# aim IK
+
+**Point what is held where the aim goes**, by turning the spine after the
+clips have posed the body. An aim pose is drawn standing; laid over a crouch it
+leans with the crouch's hips, and the gun points at the floor. This measures
+where the held thing actually points and turns the spine bones, a share each,
+until it points along the aim.
+
+```javascript
+import { aimSpine } from 'tosijs-3d'
+
+// Each frame, after the animations (scene.onAfterAnimationsObservable):
+aimSpine([spine01, spine02, spine03], gun, aimDirection, { weight: 1, maxDeg: 70 })
+```
+
+- `chain`: the bones to turn, root first (their TransformNodes, which a glTF
+  skeleton's bones are linked to)
+- `held`: a node below the chain whose `forward` (its +Z) is the barrel
+- `target`: the world direction to point along
+- `weight` 0..1 eases it in and out; `maxDeg` caps the turn, so a target
+  behind the body turns the spine only so far
+
+It works on directions in each bone's parent's frame, so a glTF root's
+handedness mirror and a uniform scale make no difference. `<tosi-b3d-biped>`
+runs it on its spine while it holds a weapon in `gunplay`.
+*/
+/*{ "parent": "aim" }*/
+import * as BABYLON from '@babylonjs/core';
+/** The nodes from `node` up to (not including) `top`, top first. */
+function pathBelow(top, node) {
+    const path = [];
+    let n = node;
+    while (n != null && n !== top) {
+        path.unshift(n);
+        n = n.parent;
+    }
+    return n === top ? path : null;
+}
+function refresh(nodes) {
+    for (const n of nodes)
+        n.computeWorldMatrix(true);
+}
+const unit = (v) => {
+    const l = v.length();
+    return l > 1e-9 ? v.scale(1 / l) : null;
+};
+/**
+ * Turn `chain` so `held` points along `target`. Returns the angle, degrees,
+ * left between them afterwards (0 when it got there).
+ */
+export function aimSpine(chain, held, target, options = {}) {
+    const weight = Math.max(0, Math.min(1, options.weight ?? 1));
+    const maxRad = ((options.maxDeg ?? 70) * Math.PI) / 180;
+    const want = unit(target);
+    if (want == null || chain.length === 0)
+        return 0;
+    const top = chain[0].parent;
+    const below = top != null ? pathBelow(top, held) : null;
+    if (top == null || below == null)
+        return 0;
+    const all = [top, ...below];
+    refresh(all);
+    const pointing = () => unit(held.getWorldMatrix().getRow(2).toVector3());
+    const now = pointing();
+    if (now == null)
+        return 0;
+    const total = Math.acos(Math.max(-1, Math.min(1, BABYLON.Vector3.Dot(now, want))));
+    // The whole correction, capped and weighted, shared down the chain.
+    let left = Math.min(total, maxRad) * weight;
+    for (let k = 0; k < chain.length && left > 1e-5; k++) {
+        const bone = chain[k];
+        const parent = bone.parent;
+        if (parent == null || bone.rotationQuaternion == null)
+            continue;
+        const from = pointing();
+        if (from == null)
+            break;
+        // The two directions in the bone's PARENT's frame: a turn there is a turn
+        // of this bone's local rotation, whatever mirror sits above.
+        const inv = parent.getWorldMatrix().clone().invert();
+        const a = unit(BABYLON.Vector3.TransformNormal(from, inv));
+        const b = unit(BABYLON.Vector3.TransformNormal(want, inv));
+        if (a == null || b == null)
+            break;
+        const axis = unit(BABYLON.Vector3.Cross(a, b));
+        const between = Math.acos(Math.max(-1, Math.min(1, BABYLON.Vector3.Dot(a, b))));
+        if (axis == null || between < 1e-5)
+            break;
+        const share = Math.min(between, left / (chain.length - k));
+        // Which way round Babylon's axis-angle turns is checked, not assumed.
+        let turn = BABYLON.Matrix.RotationAxis(axis, share);
+        const test = BABYLON.Vector3.TransformNormal(a, turn);
+        if (BABYLON.Vector3.Dot(test, b) < Math.cos(between - share) - 1e-4) {
+            turn = BABYLON.Matrix.RotationAxis(axis, -share);
+        }
+        // Row vectors: the local rotation, then the turn in the parent's frame.
+        const local = new BABYLON.Matrix();
+        bone.rotationQuaternion.toRotationMatrix(local);
+        BABYLON.Quaternion.FromRotationMatrixToRef(local.multiply(turn), bone.rotationQuaternion);
+        left -= share;
+        refresh(all.slice(all.indexOf(bone)));
+    }
+    const after = pointing();
+    return after == null
+        ? 0
+        : (Math.acos(Math.max(-1, Math.min(1, BABYLON.Vector3.Dot(after, want)))) *
+            180) /
+            Math.PI;
+}
+//# sourceMappingURL=aim-ik.js.map

package/dist/aim-ik.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-ik.js","sourceRoot":"","sources":["../src/aim-ik.ts"],"names":[],"mappings":"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"}

package/dist/b3d-biped.d.ts

@@ -655,6 +655,11 @@ export declare class B3dBiped extends B3dControllable {
     private _aimLayer;
     private _aimLayerKey;
     private _updateAimLayer;
+    private _aimIkObs;
+    private _aimIkWeight;
+    private _aimIkChain;
+    private _aimIkOf;
+    private _aimIk;
     /** Seconds left of the one-shot fire pose. */
     private _shootFor;
     private _eased;

package/dist/b3d-biped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"b3d-biped.d.ts","sourceRoot":"","sources":["../src/b3d-biped.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"b3d-biped.d.ts","sourceRoot":"","sources":["../src/b3d-biped.ts"],"names":[],"mappings":"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"}

package/dist/b3d-biped.js

@@ -306,13 +306,14 @@ on: under when you swim under, above otherwise.
 */
 /*{ "parent": "characters-and-vehicles", "order": 10 }*/
 import * as BABYLON from '@babylonjs/core';
-import { collidable, isOff, markUiMesh, refuseOwnAncestor, } from './b3d-utils.js';
+import { collidable, isOff, markUiMesh, pressWithEitherHand, refuseOwnAncestor, sceneDelta, } from './b3d-utils.js';
 import { CLIMB_PHASE, canMantle, mantleClip, mantlePath, defaultMantleLimits, } from './mantle.js';
 import { buoyantStep, diveBuoyancy, submergedFraction, isSwimming, swimBuoyancy, } from './buoyancy.js';
 import { aimFromLook, clampAim, easeAim, aimTarget, surfaceAimLimit, } from './swim-aim.js';
 import { iceSide } from './water-shore.js';
 import { fitChase } from './camera-fit.js';
 import { DEFAULT_AIM_LIMITS, aimDirection as aimToDirection, aimPoseWeights, bodyCatchUp, relaxAim, stepAim, wrapDeg, } from './aim.js';
+import { aimSpine } from './aim-ik.js';
 import { xrControllers } from './gamepad.js';
 import { B3dControllable } from './b3d-controllable.js';
 import { CompositeInputProvider } from './control-input.js';
@@ -1067,7 +1068,11 @@ export class B3dBiped extends B3dControllable {
             mat.zOffset = -8;
             this._reticle.material = mat;
             this._reticle.isPickable = false;
+            // It moves every frame and its bounds are never synced, so it is never
+            // culled: the bounds stayed where it was made, and the sight vanished
+            // whenever that spot was out of view (in a headset, out of one eye's).
             this._reticle.doNotSyncBoundingInfo = true;
+            this._reticle.alwaysSelectAsActiveMesh = true;
             markUiMesh(this._reticle);
         }
         const origin = this.aimOrigin;
@@ -1770,6 +1775,50 @@ export class B3dBiped extends B3dControllable {
         this._aimLayer = layerOnUpperBody(scene, skeleton, baseGroup, layerGroup);
         this._aimLayer?.play(layerClip !== 'Pistol_Shoot');
     }
+    /*
+    THE GUN POINTS WHERE THE AIM GOES, whatever the legs are doing. The aim
+    poses are drawn standing; over a crouch they lean with its hips (the gun
+    pointed 56° down at a level aim) and even standing it sat 11° low. So after
+    the clips have posed the body, `aimSpine` turns the spine until the held
+    weapon points along `aimDirection`. Eased in and out over `blendSeconds`.
+    */
+    _aimIkObs = null;
+    _aimIkWeight = 0;
+    _aimIkChain = null;
+    _aimIkOf = null;
+    _aimIk(scene) {
+        const skeleton = this.entries?.skeletons?.[0] ?? null;
+        const held = this._weapons().find((w) => w.socketed === true)?.mesh;
+        const want = this.gunplay && held != null && !this._swimming ? 1 : 0;
+        const blend = Math.max(0, this.blendSeconds ?? 0.25);
+        const dt = sceneDelta(scene);
+        this._aimIkWeight =
+            blend > 0
+                ? want > this._aimIkWeight
+                    ? Math.min(want, this._aimIkWeight + dt / blend)
+                    : Math.max(want, this._aimIkWeight - dt / blend)
+                : want;
+        if (this._aimIkWeight <= 0 || skeleton == null || held == null)
+            return;
+        if (this._aimIkOf !== skeleton) {
+            this._aimIkOf = skeleton;
+            const node = (names) => {
+                const bone = skeleton.bones.find((b) => names.includes(b.name));
+                return bone?.getTransformNode() ?? null;
+            };
+            const chain = [
+                node(['spine_01', 'mixamorig:Spine', 'Spine']),
+                node(['spine_02', 'mixamorig:Spine1', 'Spine1']),
+                node(['spine_03', 'mixamorig:Spine2', 'Spine2']),
+            ].filter((n) => n != null);
+            this._aimIkChain = chain.length > 0 ? chain : null;
+        }
+        if (this._aimIkChain == null)
+            return;
+        aimSpine(this._aimIkChain, held, this.aimDirection, {
+            weight: this._aimIkWeight,
+        });
+    }
     /** Seconds left of the one-shot fire pose. */
     _shootFor = 0;
     /*
@@ -3108,6 +3157,8 @@ export class B3dBiped extends B3dControllable {
             // The right hand points first (see tosi-b3d: otherwise a first press is lost).
             pointerSelectionOptions: { preferredHandedness: 'right' },
         });
+        if (xr.pointerSelection != null)
+            pressWithEitherHand(xr, scene);
         // Register controller observables BEFORE entering XR so we catch controller connect events
         this.setupXRInput(xr);
         // Now enter XR
@@ -3387,6 +3438,7 @@ export class B3dBiped extends B3dControllable {
     figure = null;
     sceneReady(owner, scene) {
         super.sceneReady(owner, scene);
+        this._aimIkObs = scene.onAfterAnimationsObservable.add(() => this._aimIk(scene));
         const attrs = this;
         if ((attrs.character !== '' || this.characterDoc != null) &&
             !this.entries) {
@@ -3608,6 +3660,12 @@ export class B3dBiped extends B3dControllable {
         this.queueRender();
     }
     sceneDispose() {
+        if (this._aimIkObs != null) {
+            this.owner?.scene.onAfterAnimationsObservable.remove(this._aimIkObs);
+            this._aimIkObs = null;
+        }
+        this._aimIkOf = null;
+        this._aimIkChain = null;
         this._reticle?.dispose();
         this._reticle = null;
         // The layer owns AnimationGroups it built; the source clips are the GLB's