@lovelace_lol/loom3 1.0.37 → 1.0.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -33,14 +33,14 @@ These demo site links open the LoomLarge drawer on the matching tab. The demo si
33
33
 
34
34
  | Goal | Open in LoomLarge |
35
35
  |------|-------------------|
36
- | Start with the main runtime surface | [Animation tab](https://loomlarge.web.app/?drawer=open&tab=animation) |
37
- | Inspect preset and profile settings | [Properties tab](https://loomlarge.web.app/?drawer=open&tab=properties) |
38
- | Inspect AU, morph, and bone routing | [Mappings tab](https://loomlarge.web.app/?drawer=open&tab=mappings) |
39
- | Inspect meshes and material state | [Meshes tab](https://loomlarge.web.app/?drawer=open&tab=meshes) |
40
- | Inspect resolved bones | [Bones tab](https://loomlarge.web.app/?drawer=open&tab=bones) |
41
- | Tune expressions and continuum pairs | [Action Units tab](https://loomlarge.web.app/?drawer=open&tab=action-units) |
42
- | Inspect lip-sync views | [Visemes tab](https://loomlarge.web.app/?drawer=open&tab=visemes) and [Speech tab](https://loomlarge.web.app/?drawer=open&tab=speech) |
43
- | Tune hair behavior | [Hair tab](https://loomlarge.web.app/?drawer=open&tab=hair) |
36
+ | Start with the main runtime surface | [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation) |
37
+ | Inspect preset and profile settings | [Properties tab](https://www.characterloom.com/?drawer=open&tab=properties) |
38
+ | Inspect AU, morph, and bone routing | [Mappings tab](https://www.characterloom.com/?drawer=open&tab=mappings) |
39
+ | Inspect meshes and material state | [Meshes tab](https://www.characterloom.com/?drawer=open&tab=meshes) |
40
+ | Inspect resolved bones | [Bones tab](https://www.characterloom.com/?drawer=open&tab=bones) |
41
+ | Tune expressions and continuum pairs | [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units) |
42
+ | Inspect lip-sync views | [Visemes tab](https://www.characterloom.com/?drawer=open&tab=visemes) and [Speech tab](https://www.characterloom.com/?drawer=open&tab=speech) |
43
+ | Tune hair behavior | [Hair tab](https://www.characterloom.com/?drawer=open&tab=hair) |
44
44
 
45
45
  Most screenshots below were captured from LoomLarge with the matching tab open so the docs and the live product are easy to compare. The viseme grid image is the main exception: it still shows older labels from the captured UI, so the viseme table later in the README should be treated as the source of truth.
46
46
 
@@ -84,7 +84,7 @@ Additional:
84
84
 
85
85
  ## 1. Installation & Setup
86
86
 
87
- Open in LoomLarge: [Animation tab](https://loomlarge.web.app/?drawer=open&tab=animation)
87
+ Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
88
88
 
89
89
  ![Project structure with Loom3 installed](./assets/readme/project-structure.svg)
90
90
 
@@ -201,7 +201,7 @@ const meshes = collectMorphMeshes(gltf.scene);
201
201
 
202
202
  ## 2. Using Presets
203
203
 
204
- Open in LoomLarge: [Properties tab](https://loomlarge.web.app/?drawer=open&tab=properties) | [Mappings tab](https://loomlarge.web.app/?drawer=open&tab=mappings)
204
+ Open in LoomLarge: [Properties tab](https://www.characterloom.com/?drawer=open&tab=properties) | [Mappings tab](https://www.characterloom.com/?drawer=open&tab=mappings)
205
205
 
206
206
  ![Diagram showing how Loom3 presets connect AUs to morphs and bones](./assets/readme/preset-au-flow.svg)
207
207
 
@@ -376,7 +376,7 @@ see [ANNOTATION_CONFIGURATION.md](./ANNOTATION_CONFIGURATION.md).
376
376
 
377
377
  ## 3. Preset Selection & Validation
378
378
 
379
- Open in LoomLarge: [Properties tab](https://loomlarge.web.app/?drawer=open&tab=properties) | [Mappings tab](https://loomlarge.web.app/?drawer=open&tab=mappings) | [Bones tab](https://loomlarge.web.app/?drawer=open&tab=bones)
379
+ Open in LoomLarge: [Properties tab](https://www.characterloom.com/?drawer=open&tab=properties) | [Mappings tab](https://www.characterloom.com/?drawer=open&tab=mappings) | [Bones tab](https://www.characterloom.com/?drawer=open&tab=bones)
380
380
 
381
381
  Before you tune AUs or hand-edit a profile, confirm that you picked the right preset and that the model actually matches it. Loom3 exposes a full preset-selection and validation workflow, not just low-level control APIs.
382
382
 
@@ -477,7 +477,7 @@ Use this section when you need to:
477
477
 
478
478
  ## 4. Getting to Know Your Character
479
479
 
480
- Open in LoomLarge: [Meshes tab](https://loomlarge.web.app/?drawer=open&tab=meshes) | [Bones tab](https://loomlarge.web.app/?drawer=open&tab=bones) | [Mappings tab](https://loomlarge.web.app/?drawer=open&tab=mappings)
480
+ Open in LoomLarge: [Meshes tab](https://www.characterloom.com/?drawer=open&tab=meshes) | [Bones tab](https://www.characterloom.com/?drawer=open&tab=bones) | [Mappings tab](https://www.characterloom.com/?drawer=open&tab=mappings)
481
481
 
482
482
  ![Console-style diagram showing Loom3 mesh and morph target inspection output](./assets/readme/console-mesh-output.svg)
483
483
 
@@ -667,7 +667,7 @@ This is especially useful for:
667
667
 
668
668
  ## 5. Extending & Custom Presets
669
669
 
670
- Open in LoomLarge: [Properties tab](https://loomlarge.web.app/?drawer=open&tab=properties) | [Mappings tab](https://loomlarge.web.app/?drawer=open&tab=mappings)
670
+ Open in LoomLarge: [Properties tab](https://www.characterloom.com/?drawer=open&tab=properties) | [Mappings tab](https://www.characterloom.com/?drawer=open&tab=mappings)
671
671
 
672
672
  ![Diagram showing preset inheritance and profile override merging](./assets/readme/preset-inheritance.svg)
673
673
 
@@ -746,7 +746,7 @@ const current = loom.getProfile();
746
746
 
747
747
  ## 6. Creating Skeletal Animation Presets
748
748
 
749
- Open in LoomLarge: [Bones tab](https://loomlarge.web.app/?drawer=open&tab=bones) | [Action Units tab](https://loomlarge.web.app/?drawer=open&tab=action-units) | [Animation tab](https://loomlarge.web.app/?drawer=open&tab=animation)
749
+ Open in LoomLarge: [Bones tab](https://www.characterloom.com/?drawer=open&tab=bones) | [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units) | [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
750
750
 
751
751
  ![Betta fish model with bones panel visible](./assets/readme/fish-bones-ui.webp)
752
752
 
@@ -1029,7 +1029,7 @@ async function swimCycle() {
1029
1029
 
1030
1030
  ## 7. Action Unit Control
1031
1031
 
1032
- Open in LoomLarge: [Action Units tab](https://loomlarge.web.app/?drawer=open&tab=action-units)
1032
+ Open in LoomLarge: [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units)
1033
1033
 
1034
1034
  ![Grid of Loom3 Action Unit examples on a character](./assets/readme/au-values-grid.webp)
1035
1035
 
@@ -1107,7 +1107,7 @@ loom.setAU(12, 0.8, 1); // Right side only
1107
1107
 
1108
1108
  ## 8. Mix Weight System
1109
1109
 
1110
- Open in LoomLarge: [Action Units tab](https://loomlarge.web.app/?drawer=open&tab=action-units)
1110
+ Open in LoomLarge: [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units)
1111
1111
 
1112
1112
  ![Comparison of morph-only, mixed, and bone-only AU results](./assets/readme/mix-weight-comparison.webp)
1113
1113
 
@@ -1156,7 +1156,7 @@ if (isMixedAU(26)) {
1156
1156
 
1157
1157
  ## 9. Composite Rotation System
1158
1158
 
1159
- Open in LoomLarge: [Action Units tab](https://loomlarge.web.app/?drawer=open&tab=action-units) | [Bones tab](https://loomlarge.web.app/?drawer=open&tab=bones)
1159
+ Open in LoomLarge: [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units) | [Bones tab](https://www.characterloom.com/?drawer=open&tab=bones)
1160
1160
 
1161
1161
  ![Diagram showing pitch, yaw, and roll axes on the head](./assets/readme/head-axes-diagram.svg)
1162
1162
 
@@ -1218,7 +1218,7 @@ loom.setAU(64, 0.4);
1218
1218
 
1219
1219
  ## 10. Continuum Pairs
1220
1220
 
1221
- Open in LoomLarge: [Action Units tab](https://loomlarge.web.app/?drawer=open&tab=action-units)
1221
+ Open in LoomLarge: [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units)
1222
1222
 
1223
1223
  ![Continuum slider UI for paired Loom3 AUs](./assets/readme/continuum-slider-ui.webp)
1224
1224
 
@@ -1320,7 +1320,7 @@ const pair = CONTINUUM_PAIRS_MAP[51];
1320
1320
 
1321
1321
  ## 11. Direct Morph Control
1322
1322
 
1323
- Open in LoomLarge: [Meshes tab](https://loomlarge.web.app/?drawer=open&tab=meshes) | [Mappings tab](https://loomlarge.web.app/?drawer=open&tab=mappings)
1323
+ Open in LoomLarge: [Meshes tab](https://www.characterloom.com/?drawer=open&tab=meshes) | [Mappings tab](https://www.characterloom.com/?drawer=open&tab=mappings)
1324
1324
 
1325
1325
  ![Direct morph control screenshot with a live morph preview](./assets/readme/direct-morph-control.webp)
1326
1326
 
@@ -1364,7 +1364,7 @@ Loom3 caches morph target lookups for performance. The first time you access a m
1364
1364
 
1365
1365
  ## 12. Viseme System
1366
1366
 
1367
- Open in LoomLarge: [Visemes tab](https://loomlarge.web.app/?drawer=open&tab=visemes) | [Speech tab](https://loomlarge.web.app/?drawer=open&tab=speech)
1367
+ Open in LoomLarge: [Visemes tab](https://www.characterloom.com/?drawer=open&tab=visemes) | [Speech tab](https://www.characterloom.com/?drawer=open&tab=speech)
1368
1368
 
1369
1369
  ![Grid of all 15 Loom3 viseme mouth shapes](./assets/readme/viseme-grid.webp)
1370
1370
 
@@ -1450,7 +1450,7 @@ speak([5, 0, 10, 4]);
1450
1450
 
1451
1451
  ## 13. Transition System
1452
1452
 
1453
- Open in LoomLarge: [Animation tab](https://loomlarge.web.app/?drawer=open&tab=animation)
1453
+ Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
1454
1454
 
1455
1455
  ![Diagram showing a Loom3 transition timeline with easing and handle methods](./assets/readme/transition-timeline-easing.svg)
1456
1456
 
@@ -1534,7 +1534,7 @@ loom.clearTransitions();
1534
1534
 
1535
1535
  ## 14. Playback & State Control
1536
1536
 
1537
- Open in LoomLarge: [Animation tab](https://loomlarge.web.app/?drawer=open&tab=animation)
1537
+ Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
1538
1538
 
1539
1539
  ![Playback controls UI showing Loom3 pause and resume controls](./assets/readme/pause-resume-controls.webp)
1540
1540
 
@@ -1593,7 +1593,7 @@ loom.dispose();
1593
1593
 
1594
1594
  ## 15. Hair Physics
1595
1595
 
1596
- Open in LoomLarge: [Hair tab](https://loomlarge.web.app/?drawer=open&tab=hair)
1596
+ Open in LoomLarge: [Hair tab](https://www.characterloom.com/?drawer=open&tab=hair)
1597
1597
 
1598
1598
  ![Animated GIF showing Loom3 hair physics reacting to head motion](./assets/readme/hair-physics.gif)
1599
1599
 
@@ -1783,7 +1783,7 @@ loom.setMorphOnMeshes(
1783
1783
 
1784
1784
  ## 16. Baked Animations
1785
1785
 
1786
- Open in LoomLarge: [Animation tab](https://loomlarge.web.app/?drawer=open&tab=animation)
1786
+ Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
1787
1787
 
1788
1788
  Loom3 can play baked skeletal animations from your GLB/GLTF files using Three.js AnimationMixer. This allows you to combine pre-made animations (idle, walk, gestures) with real-time facial control.
1789
1789
 
@@ -2052,7 +2052,7 @@ loom.transitionAU(45, 1.0, 100); // Blink
2052
2052
 
2053
2053
  ## 17. Regions & Geometry Helpers
2054
2054
 
2055
- Open in LoomLarge: [Bones tab](https://loomlarge.web.app/?drawer=open&tab=bones) | [Mappings tab](https://loomlarge.web.app/?drawer=open&tab=mappings)
2055
+ Open in LoomLarge: [Bones tab](https://www.characterloom.com/?drawer=open&tab=bones) | [Mappings tab](https://www.characterloom.com/?drawer=open&tab=mappings)
2056
2056
 
2057
2057
  These helpers are for applications that need semantic face regions, marker anchors, or camera targets in addition to direct animation control.
2058
2058
 
@@ -2117,7 +2117,7 @@ Use these helpers when you need to:
2117
2117
 
2118
2118
  ## 18. API Reference
2119
2119
 
2120
- Open in LoomLarge: [Animation tab](https://loomlarge.web.app/?drawer=open&tab=animation)
2120
+ Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
2121
2121
 
2122
2122
  This is a compact reference for the public surface exported by `@lovelace_lol/loom3`.
2123
2123