@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 +26 -26
- package/dist/index.cjs +106 -60
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +19 -3
- package/dist/index.d.ts +19 -3
- package/dist/index.js +70 -25
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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://
|
|
37
|
-
| Inspect preset and profile settings | [Properties tab](https://
|
|
38
|
-
| Inspect AU, morph, and bone routing | [Mappings tab](https://
|
|
39
|
-
| Inspect meshes and material state | [Meshes tab](https://
|
|
40
|
-
| Inspect resolved bones | [Bones tab](https://
|
|
41
|
-
| Tune expressions and continuum pairs | [Action Units tab](https://
|
|
42
|
-
| Inspect lip-sync views | [Visemes tab](https://
|
|
43
|
-
| Tune hair behavior | [Hair tab](https://
|
|
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://
|
|
87
|
+
Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
|
|
88
88
|
|
|
89
89
|

|
|
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://
|
|
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
|

|
|
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://
|
|
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://
|
|
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
|

|
|
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://
|
|
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
|

|
|
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://
|
|
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
|

|
|
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://
|
|
1032
|
+
Open in LoomLarge: [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units)
|
|
1033
1033
|
|
|
1034
1034
|

|
|
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://
|
|
1110
|
+
Open in LoomLarge: [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units)
|
|
1111
1111
|
|
|
1112
1112
|

|
|
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://
|
|
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
|

|
|
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://
|
|
1221
|
+
Open in LoomLarge: [Action Units tab](https://www.characterloom.com/?drawer=open&tab=action-units)
|
|
1222
1222
|
|
|
1223
1223
|

|
|
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://
|
|
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
|

|
|
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://
|
|
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
|

|
|
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://
|
|
1453
|
+
Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
|
|
1454
1454
|
|
|
1455
1455
|

|
|
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://
|
|
1537
|
+
Open in LoomLarge: [Animation tab](https://www.characterloom.com/?drawer=open&tab=animation)
|
|
1538
1538
|
|
|
1539
1539
|

|
|
1540
1540
|
|
|
@@ -1593,7 +1593,7 @@ loom.dispose();
|
|
|
1593
1593
|
|
|
1594
1594
|
## 15. Hair Physics
|
|
1595
1595
|
|
|
1596
|
-
Open in LoomLarge: [Hair tab](https://
|
|
1596
|
+
Open in LoomLarge: [Hair tab](https://www.characterloom.com/?drawer=open&tab=hair)
|
|
1597
1597
|
|
|
1598
1598
|

|
|
1599
1599
|
|
|
@@ -1783,7 +1783,7 @@ loom.setMorphOnMeshes(
|
|
|
1783
1783
|
|
|
1784
1784
|
## 16. Baked Animations
|
|
1785
1785
|
|
|
1786
|
-
Open in LoomLarge: [Animation tab](https://
|
|
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://
|
|
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://
|
|
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
|
|