tosijs-3d 0.11.5 → 0.11.6

package/CHANGELOG.md

@@ -12,13 +12,14 @@ Upgrading across a minor? Start with [Migration](/Migration/).
 
 ## Unreleased
 
-## 0.11.5
+## 0.11.6
 
-The latest release. The character creator gets dressed: MakeHuman's clothes on any body shape, the Tailor for cutting your own (skirts and robes too, out to Blender and back), faces that move, and hair, skin and cloth shading. [Read 0.11.5](/v0.11.5/).
+The latest release. The character leaves the builder: any body (MakeHuman's, Blender's, Quaternius' or your own mesh) rigged, dressed and tailored the same way; a character file that carries its body; `makeCharacter`, and `<tosi-b3d-biped character>` to walk it in a game; a material picker. [Read 0.11.6](/v0.11.6/).
 
 ## Every version
 
 <!-- toc -->
+- [0.11.6](/v0.11.6/)
 - [0.11.5](/v0.11.5/)
 - [0.11.4](/v0.11.4/)
 - [0.11.3](/v0.11.3/)

package/changelog/v0.11.6.md

@@ -0,0 +1,37 @@
+# 0.11.6
+
+<!--{ "parent": "CHANGELOG", "order": 9988994 }-->
+
+The character leaves the builder. Any body (MakeHuman's, Blender's, Quaternius', or a mesh of your own) is rigged, dressed and tailored the same way; a character is a file that carries its body, `makeCharacter` builds it anywhere, and `<tosi-b3d-biped character>` walks it in a game. The biped playground plays as a character you saved. Materials get a picker of their own.
+
+Size: barrel (min, packages external) 1430.1 KB raw / 493.3 KB gz, +5.74% on 0.11.5 (rigged bodies, characters, the tailor and rig tools as tools, the material picker).
+
+## Added
+
+- **`RiggedBody`** (rigged-body): one shape for a character's body whoever made it: the rest mesh, UAL's joints, skin weights, regions, and how it was made. Three producers: `bodyFromMarkers` (any mesh plus eight markers, guessed if absent), `humanBodyMaker(pack)` (MakeHuman's sliders) and `loadSkinnedBody` (a file already skinned to UAL's skeleton, as Quaternius' characters are, taken with its own joints and weights). `buildBody` makes a Babylon skeleton from any of them; `autoRig` and `loadRigTriangles` (rig-build) are the whole path in two calls. A body from a file carries its `uvs`, `colors` and `surfaces` (its materials), and its eyeballs (`body.eyes`, objects named as eyes), which take the iris dial and the gaze.
+- **`lidBlink(positions, eye)`**: a blink made from a body's shape, for bodies with eyeballs and no blink targets (Blender's Human Base Meshes). Bodies rigged from markers blink with it.
+- **`makeCharacter(scene, assets, { settings, garments, gaze })`** (character): the character builder's character from its settings, outside the builder. `set(changes)` applies only what changed; `skeleton`, `recipe` and `groundFor(clip)` are what playing clips on it needs. `loadCharacterAssets` loads MakeHuman's pack and the hair once per scene.
+- **Character files** (character-file): a character as one versioned JSON document: every setting, each slot's look and material, the tailor's outlines, its own garments and its body (`bodies`: a URL, or the file itself) embedded, so a file is whole on another machine. `readCharacter` reads it against the page's defaults (unknown settings listed in `warnings`, missing ones defaulted, older versions migrated, newer refused).
+- **`<tosi-b3d-biped character="…json">`** (or `characterDoc`): a biped made from a character file, with the clips its states name retargeted onto it (UAL1 by default), so `ualAnimationStates()` drives it. MakeHuman is imported only when a biped has a character.
+- **`characterStore()`** (character-store): the characters this browser keeps (IndexedDB), shared by the builder and any page. A mesh or garment shared by several saves is stored once. The biped playground's settings panel has a **character** menu: the mannequin or any saved character, swapped in where the hero stands.
+- **`mountTailorTool(b3d, { body, built, handleDone })`** (tailor-tool): the tailor as a tool, cutting a garment from any `RiggedBody`. Garments cut or imported on a mesh's body are bound to that body. `mountRigTool` takes `handleDone` / `handleCancel` and a host `panel`, and hands back `{ recipe, body }`.
+- **The rig tool's markers are on the body**, dragged onto the joints they place; every joint can be moved by hand (kept in the recipe as `binding.joints`), and a tail has markers at its base and tip.
+- **`materialPicker3d`** (material-picker): a material as one row, edited in a popup with rendered previews. `material-recipe` is the data (`{ type, inputs }`, schema, validator, collections such as the fabrics), `applyMaterial` puts it on a Babylon material. The character builder's garments use it.
+- `barMenu` options take an `icon`; when every option has one the menu is a row of icon buttons. A new icon kind, `stroked filled`. Icons: `svgIcons.biped`, the rig and the tailor's scissors.
+- `chooseFile(accept)`: the file picker as a promise, which keeps its input in the page until it answers.
+- An [Acknowledgements](/acknowledgements/) page: every source used, with its licence.
+
+## Changed
+
+- The character builder has a body **source**: MakeHuman's, Blender's realistic Human Base Meshes, Quaternius' superheroes, or a GLB/glTF you open. A body from a file wears its own materials (each "as made" or "skin"), gets clothes and the Tailor, and its rig recipe is saved with the character. Characters save and restore (autosaved as you work, named saves beside it, JSON export and import).
+- Feet and toes take the clip's turn by heading only, so feet stand flat on bodies whose ankle sits higher or lower than UAL's.
+- The rig tool grounds a clip on the body's soles, so a body whose legs differ from the mannequin's no longer floats or sinks.
+
+## Fixed
+
+- Every file picker (the builder, the rig tool, the effect tool) delivers the file picked; a detached input could lose it, silently on Safari.
+- The builder's Blender and Quaternius bodies load on a page that sets the asset base after import.
+- Auto-rig on A-posed bodies: shoulders, elbows, wrists, hands and feet are found on the body.
+- Turning a tail on brings its spring; its tip starts at the end of the mesh.
+- Cloth eased onto a coarse body stays on its skin.
+- A `b3d-launcher` moved to another holder shows its model, not the placeholder box.

package/dist/b3d-biped.d.ts

@@ -52,6 +52,8 @@ export declare class B3dBiped extends B3dControllable {
     blendSeconds: number;
     static initAttributes: {
         url: string;
+        character: string;
+        animations: string;
         skin: string;
         scale: number;
         player: boolean;
@@ -702,7 +704,13 @@ export declare class B3dBiped extends B3dControllable {
     equip(boneName: string, url: string): void;
     /** Remove whatever is equipped on a bone. */
     unequip(boneName: string): void;
+    /** A character file, parsed: set it to make the character without a fetch. */
+    characterDoc: unknown;
+    /** The character made (a `SceneCharacter`, see character.ts), when it was made from one. */
+    figure: any;
     sceneReady(owner: B3d, scene: BABYLON.Scene): void;
+    private _loadCharacter;
+    private _modelReady;
     sceneDispose(): void;
     render(): void;
 }

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

@@ -180,6 +180,8 @@ animation is doing with that hand.
 | Attribute | Default | Description |
 |-----------|---------|-------------|
 | `url` | `''` | GLB model URL |
+| `character` | `''` | A character file's URL (the [character builder](/character-builder/)'s **export JSON**), in place of `url`: the character is made from it ([character](/character/)) and UAL's clips are retargeted onto it, so use `ualAnimationStates()`. A mesh body comes from where the file says (its URL, or the mesh itself when it was opened from disk); a file that says neither falls back to MakeHuman's. Set `characterDoc` (the parsed file) instead to skip the fetch |
+| `animations` | UAL1 | Where a `character`'s clips come from: a GLB whose clips have UAL's names and skeleton |
 | `skin` | `''` | Optional albedo texture URL applied to the `skin` material (reskin) |
 | `scale` | `1` | Uniform scale applied to the loaded model |
 | `animation` | `''` | Current animation state name |
@@ -469,11 +471,29 @@ const LOCAL_FORWARD = new BABYLON.Vector3(0, 0, 1);
 const _fwdScratch = new BABYLON.Vector3();
 /** Scratch for the derived right axis, same reason. */
 const _rightScratch = new BABYLON.Vector3();
+/*
+MakeHuman's pack and the hair library, once per scene however many
+characters it has.
+*/
+const characterAssets = new WeakMap();
+function sharedAssets(scene, load) {
+    let p = characterAssets.get(scene);
+    if (p == null) {
+        p = load();
+        characterAssets.set(scene, p);
+    }
+    return p;
+}
 export class B3dBiped extends B3dControllable {
     static preferredTagName = 'tosi-b3d-biped';
     static initAttributes = {
         ...B3dControllable.initAttributes,
         url: '',
+        // A character file's URL (the character builder's export): the character
+        // is made from it, and UAL's clips (from `animations`) are retargeted onto it.
+        character: '',
+        // Where a character's clips come from: a GLB of UAL-named clips.
+        animations: '',
         // Optional skin texture URL applied to the model's `skin` material. Kenney
         // characters ship textureless with one `skin` material + separate skin PNGs,
         // so reskinning is just swapping this albedo texture.
@@ -3280,9 +3300,18 @@ export class B3dBiped extends B3dControllable {
             this._equipped.delete(boneName);
         }
     }
+    /** A character file, parsed: set it to make the character without a fetch. */
+    characterDoc = null;
+    /** The character made (a `SceneCharacter`, see character.ts), when it was made from one. */
+    figure = null;
     sceneReady(owner, scene) {
         super.sceneReady(owner, scene);
         const attrs = this;
+        if ((attrs.character !== '' || this.characterDoc != null) &&
+            !this.entries) {
+            this._loadCharacter(owner, scene).catch((e) => console.warn('<tosi-b3d-biped>: could not make the character', e));
+            return;
+        }
         if (attrs.url !== '' && !this.entries) {
             this.loadAssetContainer(scene, attrs.url, (container) => {
                 this._eased.clear();
@@ -3292,78 +3321,180 @@ export class B3dBiped extends B3dControllable {
                 if (this.entries.rootNodes.length !== 1) {
                     throw new Error('<tosi-b3d-biped> expects a container with exactly one root node');
                 }
-                const meshes = this.entries.rootNodes
-                    .map((node) => node.getChildMeshes())
-                    .flat();
-                this.mesh = this.entries.rootNodes[0];
-                if (attrs.scale !== 1)
-                    this.mesh.scaling.setAll(attrs.scale);
-                // Derive eye height from the model (after scaling, so it's the real size) so first-person sits at the head, not
-                // the origin (the feet). ~0.93 of total height ≈ eye level. Used as a
-                // fallback when there's no head node to anchor to.
-                const bounds = this.mesh.getHierarchyBoundingVectors();
-                const height = bounds.max.y - bounds.min.y;
-                this.eyeHeight = height * 0.93;
-                this.chaseHeight = height * 1.5;
-                this.chaseDistance = height * 2.0;
-                // Find the head BONE node (e.g. `mixamorig:Head`) so first-person anchors
-                // to the actual animated head — which moves forward when walking and down
-                // when crouching. Exclude meshes so we get the animated joint, not the
-                // (static) `head` mesh node.
-                this.headNode =
-                    this.mesh
-                        .getChildTransformNodes(false)
-                        .find((n) => /head/i.test(n.name) && !(n instanceof BABYLON.AbstractMesh)) ?? null;
-                /*
-                THE COLLISION BODY STARTS A STEP ABOVE THE FEET.
-        
-                Its bottom used to sit exactly ON the feet, which was survivable only
-                because the old ground check left the biped floating somewhere in a
-                15 cm dead band — that float WAS the clearance. Snapping the feet onto
-                the surface removed the float and, with it, the clearance: moving into
-                rising ground embedded the ellipsoid in the slope, Babylon refused the
-                move, and you stopped dead. Tonio: "you can get stuck on sloped
-                surfaces."
-        
-                Raising the offset by `STEP_OFFSET` is the standard fix (it is Unity's
-                Step Offset): the capsule ignores anything lower than a step, so a slope
-                rising under you is not an obstacle, and the ground probe puts the feet
-                on the surface afterwards. A wall is still a wall — the capsule above
-                the step height is unchanged.
-        
-                Kept below `STEP_UP` (the probe's reach), so anything the body walks over
-                is something the probe can then stand you on.
-                */
-                this.mesh.ellipsoid = new BABYLON.Vector3(0.3, STAND_HALF, 0.3);
-                this.mesh.ellipsoidOffset = new BABYLON.Vector3(0, STAND_HALF + STEP_OFFSET, 0);
-                this.mesh.checkCollisions = true;
-                owner.register({ meshes });
-                // Skin materials that export as alphaMode MASK + base-color alpha 0 (an FBX
-                // artifact) render the character fully invisible; they're opaque, so fix it
-                // whether or not a `skin` is applied.
-                for (const mm of meshes) {
-                    const mat = mm.material;
-                    if (mat instanceof BABYLON.PBRMaterial && /skin/i.test(mat.name)) {
-                        mat.transparencyMode = BABYLON.PBRMaterial.PBRMATERIAL_OPAQUE;
-                    }
-                }
-                this.setAnimationState(attrs.initialState);
-                if (attrs.skin)
-                    this.applySkin(attrs.skin);
-                // If inputFocus wired input before GLB loaded, it may have been
-                // cleared by a dispose/re-init cycle. Re-wire directly.
-                if (attrs.player && this.inputProvider == null) {
-                    const focusManager = this.closest('tosi-b3d-input-focus');
-                    if (focusManager?.inputMappedProvider) {
-                        this.inputProvider = new CompositeInputProvider(focusManager.inputMappedProvider);
-                    }
-                }
-                this.lastUpdate = realNow();
-                scene.registerBeforeRender(this._update);
-                this.queueRender();
+                this._modelReady(owner, scene);
             });
         }
     }
+    /*
+    A CHARACTER IN PLACE OF A MODEL: made from its file (character.ts, loaded
+    only here, so a biped without one does not carry MakeHuman), with the clips
+    its states name retargeted onto its skeleton and named as they were. The
+    result is shaped like a loaded model: one root node, its skeleton, its
+    clips, so everything after is the same.
+    */
+    async _loadCharacter(owner, scene) {
+        const attrs = this;
+        const [{ makeCharacter, loadCharacterAssets, DEFAULT_CHARACTER, CHARACTER_SOURCES, }, { readCharacter }, { readSkeleton, retargetClip }, { assetUrl },] = await Promise.all([
+            import('./character.js'),
+            import('./character-file.js'),
+            import('./retarget-babylon.js'),
+            import('./asset-url.js'),
+        ]);
+        const doc = this.characterDoc ?? (await (await fetch(attrs.character)).text());
+        const { character: c, warnings } = readCharacter(doc, {
+            settings: DEFAULT_CHARACTER,
+        });
+        // The builder keeps its own settings in the file too (the clip, the
+        // tailor's): those are expected, and skipped quietly.
+        const changes = warnings.filter((w) => !/not a setting here/.test(w));
+        if (changes.length)
+            console.warn('<tosi-b3d-biped>: the character file, read with changes', changes);
+        const settings = c.settings;
+        // A mesh body comes from the page's sources, or from where the file says
+        // (a URL, or the mesh itself inside the file).
+        const sources = { ...CHARACTER_SOURCES };
+        for (const [name, b] of Object.entries(c.bodies ?? {})) {
+            if (name in sources)
+                continue;
+            const pick = b.pick != null ? { pick: b.pick } : {};
+            if (b.file)
+                sources[name] = {
+                    file: new File([b.file.bytes], b.file.name),
+                    ...pick,
+                };
+            else if (b.url)
+                sources[name] = { url: b.url, ...pick };
+        }
+        if (settings.source !== 'MakeHuman' && !(settings.source in sources)) {
+            console.warn(`<tosi-b3d-biped>: the character file does not say where body ${settings.source} comes from; MakeHuman's shown`);
+            settings.source = 'MakeHuman';
+        }
+        const assets = await sharedAssets(scene, () => loadCharacterAssets(scene));
+        const ch = await makeCharacter(scene, assets, {
+            settings,
+            sources,
+            cloth: c.cloth,
+            garments: Object.values(c.garments),
+            handleMeshes: (meshes) => owner.register({ meshes }),
+        });
+        await ch.ready();
+        if (this.owner == null) {
+            ch.dispose();
+            return;
+        }
+        // The clips the states name, from the library, retargeted and named as they were.
+        const library = await BABYLON.LoadAssetContainerAsync(attrs.animations || assetUrl('quaternius/UAL1_core.glb', 2), scene);
+        library.addAllToScene();
+        for (const g of library.animationGroups)
+            g.stop();
+        const libRoot = library.meshes.find((m) => m.name === '__root__') ??
+            library.transformNodes[0];
+        const from = readSkeleton(library.skeletons[0], libRoot);
+        const wanted = new Set(this.animationStates.map((st) => st.animation ?? st.name));
+        const clips = [];
+        for (const g of library.animationGroups) {
+            if (!wanted.has(g.name))
+                continue;
+            clips.push(retargetClip(g, from, ch.skeleton, {
+                scene,
+                name: g.name,
+                armSpaceDeg: ch.recipe?.armSpaceDeg,
+            }));
+        }
+        library.dispose();
+        // The root the biped moves: the character stands on it, soles on y = 0.
+        const root = new BABYLON.Mesh('biped-character', scene);
+        ch.root.parent = root;
+        ch.groundFor(clips.find((g) => g.name === 'Idle_Loop') ?? null);
+        this.figure = ch;
+        this._eased.clear();
+        this.entries = {
+            rootNodes: [root],
+            skeletons: ch.shown ? [ch.shown.built.skeleton] : [],
+            animationGroups: clips,
+            dispose: () => {
+                for (const g of clips)
+                    g.dispose();
+                ch.dispose();
+                root.dispose();
+            },
+        };
+        this._modelReady(owner, scene);
+    }
+    _modelReady(owner, scene) {
+        const attrs = this;
+        if (this.entries == null)
+            return;
+        const meshes = this.entries.rootNodes
+            .map((node) => node.getChildMeshes())
+            .flat();
+        this.mesh = this.entries.rootNodes[0];
+        if (attrs.scale !== 1)
+            this.mesh.scaling.setAll(attrs.scale);
+        // Derive eye height from the model (after scaling, so it's the real size) so first-person sits at the head, not
+        // the origin (the feet). ~0.93 of total height ≈ eye level. Used as a
+        // fallback when there's no head node to anchor to.
+        const bounds = this.mesh.getHierarchyBoundingVectors();
+        const height = bounds.max.y - bounds.min.y;
+        this.eyeHeight = height * 0.93;
+        this.chaseHeight = height * 1.5;
+        this.chaseDistance = height * 2.0;
+        // Find the head BONE node (e.g. `mixamorig:Head`) so first-person anchors
+        // to the actual animated head — which moves forward when walking and down
+        // when crouching. Exclude meshes so we get the animated joint, not the
+        // (static) `head` mesh node.
+        this.headNode =
+            this.mesh
+                .getChildTransformNodes(false)
+                .find((n) => /head/i.test(n.name) && !(n instanceof BABYLON.AbstractMesh)) ?? null;
+        /*
+            THE COLLISION BODY STARTS A STEP ABOVE THE FEET.
+    
+            Its bottom used to sit exactly ON the feet, which was survivable only
+            because the old ground check left the biped floating somewhere in a
+            15 cm dead band — that float WAS the clearance. Snapping the feet onto
+            the surface removed the float and, with it, the clearance: moving into
+            rising ground embedded the ellipsoid in the slope, Babylon refused the
+            move, and you stopped dead. Tonio: "you can get stuck on sloped
+            surfaces."
+    
+            Raising the offset by `STEP_OFFSET` is the standard fix (it is Unity's
+            Step Offset): the capsule ignores anything lower than a step, so a slope
+            rising under you is not an obstacle, and the ground probe puts the feet
+            on the surface afterwards. A wall is still a wall — the capsule above
+            the step height is unchanged.
+    
+            Kept below `STEP_UP` (the probe's reach), so anything the body walks over
+            is something the probe can then stand you on.
+            */
+        this.mesh.ellipsoid = new BABYLON.Vector3(0.3, STAND_HALF, 0.3);
+        this.mesh.ellipsoidOffset = new BABYLON.Vector3(0, STAND_HALF + STEP_OFFSET, 0);
+        this.mesh.checkCollisions = true;
+        owner.register({ meshes });
+        // Skin materials that export as alphaMode MASK + base-color alpha 0 (an FBX
+        // artifact) render the character fully invisible; they're opaque, so fix it
+        // whether or not a `skin` is applied.
+        for (const mm of meshes) {
+            const mat = mm.material;
+            if (mat instanceof BABYLON.PBRMaterial && /skin/i.test(mat.name)) {
+                mat.transparencyMode = BABYLON.PBRMaterial.PBRMATERIAL_OPAQUE;
+            }
+        }
+        this.setAnimationState(attrs.initialState);
+        if (attrs.skin)
+            this.applySkin(attrs.skin);
+        // If inputFocus wired input before GLB loaded, it may have been
+        // cleared by a dispose/re-init cycle. Re-wire directly.
+        if (attrs.player && this.inputProvider == null) {
+            const focusManager = this.closest('tosi-b3d-input-focus');
+            if (focusManager?.inputMappedProvider) {
+                this.inputProvider = new CompositeInputProvider(focusManager.inputMappedProvider);
+            }
+        }
+        this.lastUpdate = realNow();
+        scene.registerBeforeRender(this._update);
+        this.queueRender();
+    }
     sceneDispose() {
         this._reticle?.dispose();
         this._reticle = null;
@@ -3378,6 +3509,13 @@ export class B3dBiped extends B3dControllable {
             this.fpvCamera = null;
         }
         this.hiddenBody = [];
+        if (this.owner != null && this.entries && this.figure) {
+            this.owner.scene.unregisterBeforeRender(this._update);
+            this.entries.dispose();
+            this.figure = null;
+            this.entries = undefined;
+            this._eased.clear();
+        }
         if (this.owner != null && this.entries) {
             this.owner.scene.unregisterBeforeRender(this._update);
             for (const node of this.entries.rootNodes) {