@automovie/human 0.0.0 → 0.2.0

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.
Files changed (233) hide show
  1. package/README.md +29 -16
  2. package/lib/generation/AutoMovieHumanDigitJoints.d.ts +8 -26
  3. package/lib/generation/AutoMovieHumanDigitJoints.js +9 -37
  4. package/lib/generation/AutoMovieHumanDigitJoints.js.map +1 -1
  5. package/lib/generation/{AutoMovieHumanLegSection.d.ts → AutoMovieHumanLegSectionProportion.d.ts} +1 -1
  6. package/lib/generation/{AutoMovieHumanLegSection.js → AutoMovieHumanLegSectionProportion.js} +17 -14
  7. package/lib/generation/AutoMovieHumanLegSectionProportion.js.map +1 -0
  8. package/lib/generation/arm/AutoMovieHumanArmFrame.js +2 -2
  9. package/lib/generation/arm/AutoMovieHumanArmFrame.js.map +1 -1
  10. package/lib/generation/arm/index.d.ts +28 -0
  11. package/lib/generation/arm/index.js +45 -0
  12. package/lib/generation/arm/index.js.map +1 -0
  13. package/lib/generation/conic/AutoMovieHumanConicLoft.d.ts +154 -0
  14. package/lib/generation/conic/AutoMovieHumanConicLoft.js +430 -0
  15. package/lib/generation/conic/AutoMovieHumanConicLoft.js.map +1 -0
  16. package/lib/generation/conic/AutoMovieHumanConicPose.d.ts +92 -0
  17. package/lib/generation/conic/AutoMovieHumanConicPose.js +202 -0
  18. package/lib/generation/conic/AutoMovieHumanConicPose.js.map +1 -0
  19. package/lib/generation/conic/AutoMovieHumanConicRelief.d.ts +52 -0
  20. package/lib/generation/conic/AutoMovieHumanConicRelief.js +88 -0
  21. package/lib/generation/conic/AutoMovieHumanConicRelief.js.map +1 -0
  22. package/lib/generation/conic/AutoMovieHumanConicSection.d.ts +252 -0
  23. package/lib/generation/conic/AutoMovieHumanConicSection.js +567 -0
  24. package/lib/generation/conic/AutoMovieHumanConicSection.js.map +1 -0
  25. package/lib/generation/f1/AutoMovieHumanF1.d.ts +265 -0
  26. package/lib/generation/f1/AutoMovieHumanF1.js +1254 -0
  27. package/lib/generation/f1/AutoMovieHumanF1.js.map +1 -0
  28. package/lib/generation/f1/AutoMovieHumanF1Antihelix.d.ts +23 -0
  29. package/lib/generation/f1/AutoMovieHumanF1Antihelix.js +65 -0
  30. package/lib/generation/f1/AutoMovieHumanF1Antihelix.js.map +1 -0
  31. package/lib/generation/f1/AutoMovieHumanF1Arm.d.ts +18 -0
  32. package/lib/generation/f1/AutoMovieHumanF1Arm.js +82 -0
  33. package/lib/generation/f1/AutoMovieHumanF1Arm.js.map +1 -0
  34. package/lib/generation/f1/AutoMovieHumanF1Axilla.d.ts +18 -0
  35. package/lib/generation/f1/AutoMovieHumanF1Axilla.js +91 -0
  36. package/lib/generation/f1/AutoMovieHumanF1Axilla.js.map +1 -0
  37. package/lib/generation/f1/AutoMovieHumanF1Breast.d.ts +18 -0
  38. package/lib/generation/f1/AutoMovieHumanF1Breast.js +75 -0
  39. package/lib/generation/f1/AutoMovieHumanF1Breast.js.map +1 -0
  40. package/lib/generation/f1/AutoMovieHumanF1Concha.d.ts +40 -0
  41. package/lib/generation/f1/AutoMovieHumanF1Concha.js +81 -0
  42. package/lib/generation/f1/AutoMovieHumanF1Concha.js.map +1 -0
  43. package/lib/generation/f1/AutoMovieHumanF1FingerIndex.d.ts +18 -0
  44. package/lib/generation/f1/AutoMovieHumanF1FingerIndex.js +59 -0
  45. package/lib/generation/f1/AutoMovieHumanF1FingerIndex.js.map +1 -0
  46. package/lib/generation/f1/AutoMovieHumanF1FingerMiddle.d.ts +18 -0
  47. package/lib/generation/f1/AutoMovieHumanF1FingerMiddle.js +59 -0
  48. package/lib/generation/f1/AutoMovieHumanF1FingerMiddle.js.map +1 -0
  49. package/lib/generation/f1/AutoMovieHumanF1FingerPinky.d.ts +18 -0
  50. package/lib/generation/f1/AutoMovieHumanF1FingerPinky.js +75 -0
  51. package/lib/generation/f1/AutoMovieHumanF1FingerPinky.js.map +1 -0
  52. package/lib/generation/f1/AutoMovieHumanF1FingerRing.d.ts +18 -0
  53. package/lib/generation/f1/AutoMovieHumanF1FingerRing.js +75 -0
  54. package/lib/generation/f1/AutoMovieHumanF1FingerRing.js.map +1 -0
  55. package/lib/generation/f1/AutoMovieHumanF1FingerThumb.d.ts +18 -0
  56. package/lib/generation/f1/AutoMovieHumanF1FingerThumb.js +59 -0
  57. package/lib/generation/f1/AutoMovieHumanF1FingerThumb.js.map +1 -0
  58. package/lib/generation/f1/AutoMovieHumanF1Frames.d.ts +97 -0
  59. package/lib/generation/f1/AutoMovieHumanF1Frames.js +160 -0
  60. package/lib/generation/f1/AutoMovieHumanF1Frames.js.map +1 -0
  61. package/lib/generation/f1/AutoMovieHumanF1Hand.d.ts +18 -0
  62. package/lib/generation/f1/AutoMovieHumanF1Hand.js +81 -0
  63. package/lib/generation/f1/AutoMovieHumanF1Hand.js.map +1 -0
  64. package/lib/generation/f1/AutoMovieHumanF1Helix.d.ts +20 -0
  65. package/lib/generation/f1/AutoMovieHumanF1Helix.js +64 -0
  66. package/lib/generation/f1/AutoMovieHumanF1Helix.js.map +1 -0
  67. package/lib/generation/f1/AutoMovieHumanF1Joints.d.ts +231 -0
  68. package/lib/generation/f1/AutoMovieHumanF1Joints.js +249 -0
  69. package/lib/generation/f1/AutoMovieHumanF1Joints.js.map +1 -0
  70. package/lib/generation/f1/AutoMovieHumanF1Landmarks.d.ts +86 -0
  71. package/lib/generation/f1/AutoMovieHumanF1Landmarks.js +89 -0
  72. package/lib/generation/f1/AutoMovieHumanF1Landmarks.js.map +1 -0
  73. package/lib/generation/f1/AutoMovieHumanF1Leg.d.ts +18 -0
  74. package/lib/generation/f1/AutoMovieHumanF1Leg.js +82 -0
  75. package/lib/generation/f1/AutoMovieHumanF1Leg.js.map +1 -0
  76. package/lib/generation/f1/AutoMovieHumanF1Nose.d.ts +18 -0
  77. package/lib/generation/f1/AutoMovieHumanF1Nose.js +82 -0
  78. package/lib/generation/f1/AutoMovieHumanF1Nose.js.map +1 -0
  79. package/lib/generation/f1/AutoMovieHumanF1Nostril.d.ts +18 -0
  80. package/lib/generation/f1/AutoMovieHumanF1Nostril.js +59 -0
  81. package/lib/generation/f1/AutoMovieHumanF1Nostril.js.map +1 -0
  82. package/lib/generation/f1/AutoMovieHumanF1Placement.d.ts +75 -0
  83. package/lib/generation/f1/AutoMovieHumanF1Placement.js +151 -0
  84. package/lib/generation/f1/AutoMovieHumanF1Placement.js.map +1 -0
  85. package/lib/generation/f1/AutoMovieHumanF1Placing.d.ts +45 -0
  86. package/lib/generation/f1/AutoMovieHumanF1Placing.js +301 -0
  87. package/lib/generation/f1/AutoMovieHumanF1Placing.js.map +1 -0
  88. package/lib/generation/f1/AutoMovieHumanF1Plate.d.ts +18 -0
  89. package/lib/generation/f1/AutoMovieHumanF1Plate.js +59 -0
  90. package/lib/generation/f1/AutoMovieHumanF1Plate.js.map +1 -0
  91. package/lib/generation/f1/AutoMovieHumanF1ToeBig.d.ts +18 -0
  92. package/lib/generation/f1/AutoMovieHumanF1ToeBig.js +59 -0
  93. package/lib/generation/f1/AutoMovieHumanF1ToeBig.js.map +1 -0
  94. package/lib/generation/f1/AutoMovieHumanF1ToeIndex.d.ts +18 -0
  95. package/lib/generation/f1/AutoMovieHumanF1ToeIndex.js +59 -0
  96. package/lib/generation/f1/AutoMovieHumanF1ToeIndex.js.map +1 -0
  97. package/lib/generation/f1/AutoMovieHumanF1ToeLittle.d.ts +18 -0
  98. package/lib/generation/f1/AutoMovieHumanF1ToeLittle.js +75 -0
  99. package/lib/generation/f1/AutoMovieHumanF1ToeLittle.js.map +1 -0
  100. package/lib/generation/f1/AutoMovieHumanF1ToeMiddle.d.ts +18 -0
  101. package/lib/generation/f1/AutoMovieHumanF1ToeMiddle.js +75 -0
  102. package/lib/generation/f1/AutoMovieHumanF1ToeMiddle.js.map +1 -0
  103. package/lib/generation/f1/AutoMovieHumanF1ToeRing.d.ts +18 -0
  104. package/lib/generation/f1/AutoMovieHumanF1ToeRing.js +75 -0
  105. package/lib/generation/f1/AutoMovieHumanF1ToeRing.js.map +1 -0
  106. package/lib/generation/f1/AutoMovieHumanF1Trunk.d.ts +18 -0
  107. package/lib/generation/f1/AutoMovieHumanF1Trunk.js +79 -0
  108. package/lib/generation/f1/AutoMovieHumanF1Trunk.js.map +1 -0
  109. package/lib/generation/f1/AutoMovieHumanF1Vault.d.ts +18 -0
  110. package/lib/generation/f1/AutoMovieHumanF1Vault.js +75 -0
  111. package/lib/generation/f1/AutoMovieHumanF1Vault.js.map +1 -0
  112. package/lib/generation/foot/index.d.ts +51 -0
  113. package/lib/generation/foot/index.js +68 -0
  114. package/lib/generation/foot/index.js.map +1 -0
  115. package/lib/generation/frame/AutoMovieHumanSegmentFrame.d.ts +149 -0
  116. package/lib/generation/frame/AutoMovieHumanSegmentFrame.js +290 -0
  117. package/lib/generation/frame/AutoMovieHumanSegmentFrame.js.map +1 -0
  118. package/lib/generation/hand/index.d.ts +53 -0
  119. package/lib/generation/hand/index.js +70 -0
  120. package/lib/generation/hand/index.js.map +1 -0
  121. package/lib/generation/head/index.d.ts +37 -0
  122. package/lib/generation/head/index.js +54 -0
  123. package/lib/generation/head/index.js.map +1 -0
  124. package/lib/generation/index.d.ts +176 -0
  125. package/lib/generation/index.js +193 -0
  126. package/lib/generation/index.js.map +1 -0
  127. package/lib/generation/leg/AutoMovieHumanLegLaws.d.ts +1 -1
  128. package/lib/generation/leg/AutoMovieHumanLegLaws.js +23 -11
  129. package/lib/generation/leg/AutoMovieHumanLegLaws.js.map +1 -1
  130. package/lib/generation/leg/index.d.ts +34 -0
  131. package/lib/generation/leg/index.js +51 -0
  132. package/lib/generation/leg/index.js.map +1 -0
  133. package/lib/generation/limb/{AutoMovieHumanJointTurn.d.ts → AutoMovieHumanBendArc.d.ts} +1 -1
  134. package/lib/generation/limb/{AutoMovieHumanJointTurn.js → AutoMovieHumanBendArc.js} +12 -8
  135. package/lib/generation/limb/AutoMovieHumanBendArc.js.map +1 -0
  136. package/lib/generation/limb/AutoMovieHumanDigitWalk.js +2 -2
  137. package/lib/generation/limb/AutoMovieHumanDigitWalk.js.map +1 -1
  138. package/lib/generation/limb/AutoMovieHumanWalkPart.js +72 -17
  139. package/lib/generation/limb/AutoMovieHumanWalkPart.js.map +1 -1
  140. package/lib/generation/limb/index.d.ts +12 -0
  141. package/lib/generation/limb/index.js +29 -0
  142. package/lib/generation/limb/index.js.map +1 -0
  143. package/lib/generation/trunk/index.d.ts +17 -0
  144. package/lib/generation/trunk/index.js +34 -0
  145. package/lib/generation/trunk/index.js.map +1 -0
  146. package/lib/generation/web/index.d.ts +14 -0
  147. package/lib/generation/web/index.js +31 -0
  148. package/lib/generation/web/index.js.map +1 -0
  149. package/lib/index.d.ts +14 -4
  150. package/lib/index.js +14 -9
  151. package/lib/index.js.map +1 -1
  152. package/lib/lofting/index.d.ts +14 -0
  153. package/lib/lofting/index.js +31 -0
  154. package/lib/lofting/index.js.map +1 -0
  155. package/lib/skeleton/AutoMovieHumanCanonicalBody.d.ts +7 -3
  156. package/lib/skeleton/AutoMovieHumanCanonicalBody.js +31 -3
  157. package/lib/skeleton/AutoMovieHumanCanonicalBody.js.map +1 -1
  158. package/lib/skeleton/AutoMovieHumanCanonicalProfile.d.ts +22 -31
  159. package/lib/skeleton/AutoMovieHumanCanonicalProfile.js +112 -172
  160. package/lib/skeleton/AutoMovieHumanCanonicalProfile.js.map +1 -1
  161. package/lib/skeleton/AutoMovieHumanCanonicalSolids.d.ts +65 -0
  162. package/lib/skeleton/AutoMovieHumanCanonicalSolids.js +105 -0
  163. package/lib/skeleton/AutoMovieHumanCanonicalSolids.js.map +1 -0
  164. package/lib/skeleton/index.d.ts +29 -0
  165. package/lib/skeleton/index.js +46 -0
  166. package/lib/skeleton/index.js.map +1 -0
  167. package/lib/structures/index.d.ts +2 -2
  168. package/lib/structures/index.js +2 -2
  169. package/lib/structures/index.js.map +1 -1
  170. package/lib/typings/index.d.ts +1 -1
  171. package/lib/typings/index.js +1 -1
  172. package/lib/typings/index.js.map +1 -1
  173. package/package.json +21 -13
  174. package/src/generation/AutoMovieHumanDigitJoints.ts +12 -47
  175. package/src/generation/{AutoMovieHumanLegSection.ts → AutoMovieHumanLegSectionProportion.ts} +15 -6
  176. package/src/generation/arm/AutoMovieHumanArmFrame.ts +2 -2
  177. package/src/generation/arm/index.ts +28 -0
  178. package/src/generation/conic/AutoMovieHumanConicLoft.ts +566 -0
  179. package/src/generation/conic/AutoMovieHumanConicPose.ts +213 -0
  180. package/src/generation/conic/AutoMovieHumanConicRelief.ts +94 -0
  181. package/src/generation/conic/AutoMovieHumanConicSection.ts +609 -0
  182. package/src/generation/f1/AutoMovieHumanF1.ts +1448 -0
  183. package/src/generation/f1/AutoMovieHumanF1Antihelix.ts +64 -0
  184. package/src/generation/f1/AutoMovieHumanF1Arm.ts +82 -0
  185. package/src/generation/f1/AutoMovieHumanF1Axilla.ts +90 -0
  186. package/src/generation/f1/AutoMovieHumanF1Breast.ts +74 -0
  187. package/src/generation/f1/AutoMovieHumanF1Concha.ts +80 -0
  188. package/src/generation/f1/AutoMovieHumanF1FingerIndex.ts +58 -0
  189. package/src/generation/f1/AutoMovieHumanF1FingerMiddle.ts +58 -0
  190. package/src/generation/f1/AutoMovieHumanF1FingerPinky.ts +74 -0
  191. package/src/generation/f1/AutoMovieHumanF1FingerRing.ts +74 -0
  192. package/src/generation/f1/AutoMovieHumanF1FingerThumb.ts +58 -0
  193. package/src/generation/f1/AutoMovieHumanF1Frames.ts +191 -0
  194. package/src/generation/f1/AutoMovieHumanF1Hand.ts +81 -0
  195. package/src/generation/f1/AutoMovieHumanF1Helix.ts +63 -0
  196. package/src/generation/f1/AutoMovieHumanF1Joints.ts +319 -0
  197. package/src/generation/f1/AutoMovieHumanF1Landmarks.ts +101 -0
  198. package/src/generation/f1/AutoMovieHumanF1Leg.ts +82 -0
  199. package/src/generation/f1/AutoMovieHumanF1Nose.ts +82 -0
  200. package/src/generation/f1/AutoMovieHumanF1Nostril.ts +58 -0
  201. package/src/generation/f1/AutoMovieHumanF1Placement.ts +148 -0
  202. package/src/generation/f1/AutoMovieHumanF1Placing.ts +313 -0
  203. package/src/generation/f1/AutoMovieHumanF1Plate.ts +59 -0
  204. package/src/generation/f1/AutoMovieHumanF1ToeBig.ts +58 -0
  205. package/src/generation/f1/AutoMovieHumanF1ToeIndex.ts +58 -0
  206. package/src/generation/f1/AutoMovieHumanF1ToeLittle.ts +74 -0
  207. package/src/generation/f1/AutoMovieHumanF1ToeMiddle.ts +74 -0
  208. package/src/generation/f1/AutoMovieHumanF1ToeRing.ts +74 -0
  209. package/src/generation/f1/AutoMovieHumanF1Trunk.ts +79 -0
  210. package/src/generation/f1/AutoMovieHumanF1Vault.ts +74 -0
  211. package/src/generation/foot/index.ts +51 -0
  212. package/src/generation/frame/AutoMovieHumanSegmentFrame.ts +309 -0
  213. package/src/generation/hand/index.ts +53 -0
  214. package/src/generation/head/index.ts +37 -0
  215. package/src/generation/index.ts +176 -0
  216. package/src/generation/leg/AutoMovieHumanLegLaws.ts +80 -25
  217. package/src/generation/leg/index.ts +34 -0
  218. package/src/generation/limb/{AutoMovieHumanJointTurn.ts → AutoMovieHumanBendArc.ts} +39 -11
  219. package/src/generation/limb/AutoMovieHumanDigitWalk.ts +2 -2
  220. package/src/generation/limb/AutoMovieHumanWalkPart.ts +163 -41
  221. package/src/generation/limb/index.ts +12 -0
  222. package/src/generation/trunk/index.ts +17 -0
  223. package/src/generation/web/index.ts +14 -0
  224. package/src/index.ts +14 -4
  225. package/src/lofting/index.ts +14 -0
  226. package/src/skeleton/AutoMovieHumanCanonicalBody.ts +53 -3
  227. package/src/skeleton/AutoMovieHumanCanonicalProfile.ts +153 -358
  228. package/src/skeleton/AutoMovieHumanCanonicalSolids.ts +175 -0
  229. package/src/skeleton/index.ts +29 -0
  230. package/src/structures/index.ts +2 -2
  231. package/src/typings/index.ts +1 -1
  232. package/lib/generation/AutoMovieHumanLegSection.js.map +0 -1
  233. package/lib/generation/limb/AutoMovieHumanJointTurn.js.map +0 -1
@@ -108,13 +108,17 @@ export namespace AutoMovieHumanCanonicalBody {
108
108
  * The joints then move onto the canonical rig: reflected from Human's
109
109
  * registered frame, each arm straightened along ±X by shortest arcs about
110
110
  * the shoulder, the elbow and the wrist and pronated until the palm faces
111
- * -Y, each thigh and shank straightened along -Y with the foot keeping its
111
+ * -Y, each finger straightened in the palm's plane along its own knuckle
112
+ * line and the thumb's two hinges along its metacarpal (the bind holds a
113
+ * relaxed hand, and a finger angle of zero is the extended finger, as in
114
+ * the VRM T-pose and the Neutral-0 position), each thigh and shank straightened along -Y with the foot keeping its
112
115
  * bind orientation, and the whole body raised or lowered so its lowest foot
113
116
  * joint sphere touches the floor. Every humanoid-named joint becomes a rig
114
117
  * bone with an identity rest rotation, the toes bone at the hallux's
115
118
  * metatarsophalangeal joint, and every other joint rides its nearest
116
119
  * humanoid ancestor. The contact profile is built from the same joints and
117
- * radii (`AutoMovieHumanCanonicalProfile`), so contacts meet what is drawn.
120
+ * radii (`AutoMovieHumanCanonicalProfile`), its colliders the convex hulls
121
+ * of the drawn ring points, so contacts meet what is drawn.
118
122
  *
119
123
  * @param params The Human's parameters.
120
124
  * @param options Body mass in kilograms and the skeleton id.
@@ -229,7 +233,7 @@ export namespace AutoMovieHumanCanonicalBody {
229
233
  * `(x, y, z) -> (z, y, x)`. The drawing's parent must carry that same
230
234
  * reflection (`REFLECTION`, a column-major 4x4) so the figure shows in the
231
235
  * canonical world; a reflected world matrix keeps faces outward because
232
- * three.js and the CPU rasterizer reverse winding for it.
236
+ * three.js reverses winding for it.
233
237
  *
234
238
  * @param body The canonical body.
235
239
  * @param pose A canonical pose; omitted, the T-pose rest.
@@ -349,6 +353,22 @@ function canonical(
349
353
  pivot,
350
354
  );
351
355
  };
356
+ const straighten = (
357
+ chain: readonly string[],
358
+ direction: IAutoMovieVector3,
359
+ ): void => {
360
+ chain.forEach((bone: string, i: number): void => {
361
+ const pivot: IAutoMovieVector3 = position.get(bone)!;
362
+ const end: IAutoMovieVector3 | null =
363
+ i + 1 < chain.length ? position.get(chain[i + 1]!)! : tip.get(bone)!;
364
+ if (end === null) return;
365
+ turn(
366
+ descendants(bone),
367
+ rotationBetween(Vector3.subtract(end, pivot), direction),
368
+ pivot,
369
+ );
370
+ });
371
+ };
352
372
  const down: IAutoMovieVector3 = Vector3.create(0, -1, 0);
353
373
  for (const [side, sign] of [
354
374
  ["left", 1],
@@ -385,6 +405,34 @@ function canonical(
385
405
  position.get(`${side}LowerArm`)!,
386
406
  );
387
407
 
408
+ // Straight digits: the bind holds a relaxed hand, and a clinical zero is
409
+ // the extended one (Neutral-0), so each finger lies in the palm's plane
410
+ // along its own knuckle line and the thumb's two hinges continue its
411
+ // metacarpal.
412
+ for (const finger of ["Index", "Middle", "Ring", "Little"] as const) {
413
+ const line: IAutoMovieVector3 = Vector3.subtract(
414
+ position.get(`${side}${finger}Intermediate`)!,
415
+ position.get(`${side}${finger}Proximal`)!,
416
+ );
417
+ straighten(
418
+ [
419
+ `${side}${finger}Proximal`,
420
+ `${side}${finger}Intermediate`,
421
+ `${side}${finger}Distal`,
422
+ ],
423
+ Vector3.normalize(Vector3.create(line.x, 0, line.z)),
424
+ );
425
+ }
426
+ straighten(
427
+ [`${side}ThumbProximal`, `${side}ThumbDistal`],
428
+ Vector3.normalize(
429
+ Vector3.subtract(
430
+ position.get(`${side}ThumbProximal`)!,
431
+ position.get(`${side}ThumbMetacarpal`)!,
432
+ ),
433
+ ),
434
+ );
435
+
388
436
  // Straight legs; each foot turns back to its bind orientation.
389
437
  align(side, "UpperLeg", "LowerLeg", down);
390
438
  align(side, "LowerLeg", "Foot", down);
@@ -468,6 +516,8 @@ function canonical(
468
516
  bind.map((bone: IBind): [string, Profile.IJoint] => [
469
517
  bone.bone,
470
518
  {
519
+ parent: bone.parent,
520
+ carrier: carrier.get(bone.bone)!,
471
521
  position: position.get(bone.bone)!,
472
522
  tip: tip.get(bone.bone)!,
473
523
  radius: bone.radius,