@automovie/engine 0.1.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 (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,142 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.fitDigitDescent = fitDigitDescent;
4
+ const AutoMovieSolidVector_1 = require("../geometry/construction/AutoMovieSolidVector");
5
+ /**
6
+ * One prioritized descent of a digit's fit: a primary residual (where the
7
+ * point goes) met first, and a secondary one (how it is turned, how its
8
+ * joints couple) bettered only in what the primary leaves free, inside the
9
+ * range the projection keeps.
10
+ *
11
+ * Each step is the damped least-squares step of the primary task, h1 =
12
+ * -(J1'J1 + mu I)^-1 J1'r1, plus the secondary task's damped step taken in
13
+ * the primary's damped null space, N = I - (J1'J1 + mu I)^-1 J1'J1, so the
14
+ * secondary moves only what leaves the primary where it is to first order:
15
+ * the task-priority inverse kinematics of Nakamura, Hanafusa and Yoshikawa
16
+ * 1987 ("Task-priority based redundancy control of robot manipulators",
17
+ * IJRR 6(2):3-15) in the damped form of Chiaverini 1997 ("Singularity-robust
18
+ * task-priority redundancy resolution", IEEE TRA 13(3):398-410). A variable
19
+ * standing on a bound its descent pushes against (the projection undoes a
20
+ * resolution's move along the negative gradient) is held for the step, the
21
+ * active set of a projected Newton method (Bertsekas 1982); the gradient is
22
+ * the primary's while the primary is unmet, so the secondary never holds a
23
+ * joint the primary needs.
24
+ *
25
+ * A trial is accepted lexicographically: while the primary is unmet, only
26
+ * when it lowers the primary; once met (within the effector's motion for one
27
+ * resolution step of every joint, `tolerance`), when it keeps the primary met
28
+ * and lowers the secondary. The damping follows Levenberg-Marquardt with
29
+ * Nielsen's update at its bounds (Madsen, Nielsen and Tingleff 2004,
30
+ * Algorithm 3.16, tau = 1e-3): a third on an accepted step, a doubling growth
31
+ * on a rejected one, so the steps shrink until the descent stops, when the
32
+ * step it would take moves no variable by more than `step`.
33
+ *
34
+ * @param props The start, the residuals, the projection, the resolution and the primary's tolerance.
35
+ * @returns The variables where the descent stops, projected.
36
+ *
37
+ * @evidence contracts/development/common.md#meaningful-documentation States the two tasks, the step's form and its sources, the active set, the lexicographic acceptance, the damping and the stop.
38
+ * @evidence contracts/development/implementation.md#principled-implementation Damped task-priority least squares (Nakamura et al. 1987, Chiaverini 1997) with a projected Newton active set (Bertsekas 1982) and Levenberg-Marquardt damping (Madsen, Nielsen and Tingleff 2004).
39
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One loop: Jacobians, active set, primary step, null-space secondary step, acceptance.
40
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No iteration count and no weight between the tasks: the primary is never traded for the secondary, and the descent stops at the resolution.
41
+ * @evidence contracts/development/implementation.md#efficient-algorithms Two residual evaluations per variable per Jacobian and two small dense solves per step, the variables at most a digit's nine.
42
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; the caller keeps the result.
43
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
44
+ */
45
+ function fitDigitDescent(props) {
46
+ const { primary, secondary, project, step } = props;
47
+ const n = props.start.length;
48
+ const jacobian = (f, x) => {
49
+ const columns = x.map((_v, i) => {
50
+ const up = [...x];
51
+ const down = [...x];
52
+ up[i] = up[i] + step;
53
+ down[i] = down[i] - step;
54
+ const a = f(up);
55
+ const b = f(down);
56
+ return a.map((v, k) => (v - b[k]) / (2 * step));
57
+ });
58
+ return columns[0].map((_r, k) => columns.map((c) => c[k]));
59
+ };
60
+ const squared = (r) => r.reduce((sum, v) => sum + v * v, 0);
61
+ const gram = (J, at) => at.map((i) => at.map((j) => J.reduce((s, row) => s + row[i] * row[j], 0)));
62
+ const times = (J, at, r) => at.map((i) => J.reduce((s, row, k) => s + row[i] * r[k], 0));
63
+ const damped = (A, mu) => A.map((row, i) => row.map((v, j) => (i === j ? v + mu : v)));
64
+ let x = project(props.start);
65
+ let r1 = primary(x);
66
+ let r2 = secondary(x);
67
+ let J1 = jacobian(primary, x);
68
+ let J2 = r2.length === 0 ? [] : jacobian(secondary, x);
69
+ const all = Array.from({ length: n }, (_, i) => i);
70
+ let mu = TAU *
71
+ Math.max(...all.map((i) => gram(J1, [i])[0][0] + (J2.length === 0 ? 0 : gram(J2, [i])[0][0])));
72
+ let nu = 2;
73
+ for (;;) {
74
+ // The active set, by the gradient of the task being served: the
75
+ // primary's while it is unmet, so a bound the secondary pushes against
76
+ // never holds a joint the primary needs; the whole residual's once met.
77
+ const met = props.tolerance(x, J1);
78
+ const served = Math.sqrt(squared(r1)) <= met;
79
+ const g = all.map((i) => times(J1, [i], r1)[0] +
80
+ (J2.length === 0 || !served ? 0 : times(J2, [i], r2)[0]));
81
+ const free = all.filter((i) => {
82
+ if (g[i] === 0)
83
+ return true;
84
+ const probe = [...x];
85
+ probe[i] = x[i] - Math.sign(g[i]) * step;
86
+ return Math.abs(project(probe)[i] - x[i]) >= step / 2;
87
+ });
88
+ if (free.length === 0)
89
+ break;
90
+ // The primary's damped step and its damped null space.
91
+ const A1 = damped(gram(J1, free), mu);
92
+ const h1 = AutoMovieSolidVector_1.AutoMovieSolidVector.solve(A1, times(J1, free, r1).map((v) => -v));
93
+ if (h1 === null)
94
+ break;
95
+ let h = h1;
96
+ if (J2.length !== 0) {
97
+ const G = gram(J1, free);
98
+ const P = free.map((_c, c) => AutoMovieSolidVector_1.AutoMovieSolidVector.solve(A1, G.map((row) => row[c])));
99
+ if (P.some((col) => col === null))
100
+ break;
101
+ // N = I - P, P's columns solved above.
102
+ const N = free.map((_r, a) => free.map((_c, c) => (a === c ? 1 : 0) - P[c][a]));
103
+ const J2f = J2.map((row) => free.map((i) => row[i]));
104
+ const M = J2f.map((row) => free.map((_c, c) => row.reduce((s, v, a) => s + v * N[a][c], 0)));
105
+ const b = J2f.map((row, k) => r2[k] +
106
+ row.reduce((s, v, a) => s + v * h1[a], 0));
107
+ const local = free.map((_v, a) => a);
108
+ const z = AutoMovieSolidVector_1.AutoMovieSolidVector.solve(damped(gram(M, local), mu), times(M, local, b).map((v) => -v));
109
+ if (z !== null)
110
+ h = h1.map((v, a) => v +
111
+ N[a].reduce((s, w, c) => s + w * z[c], 0));
112
+ }
113
+ if (Math.max(...h.map((v) => Math.abs(v))) <= step)
114
+ break;
115
+ const trial = project(x.map((v, i) => {
116
+ const a = free.indexOf(i);
117
+ return a < 0 ? v : v + h[a];
118
+ }));
119
+ const t1 = primary(trial);
120
+ const t2 = secondary(trial);
121
+ const accepted = !served
122
+ ? squared(t1) < squared(r1)
123
+ : Math.sqrt(squared(t1)) <= met && squared(t2) < squared(r2);
124
+ if (accepted) {
125
+ x = trial;
126
+ r1 = t1;
127
+ r2 = t2;
128
+ J1 = jacobian(primary, x);
129
+ J2 = r2.length === 0 ? [] : jacobian(secondary, x);
130
+ mu /= 3;
131
+ nu = 2;
132
+ }
133
+ else {
134
+ mu *= nu;
135
+ nu *= 2;
136
+ }
137
+ }
138
+ return x;
139
+ }
140
+ /** The damping start of Levenberg-Marquardt relative to the largest diagonal entry of the normal matrix (Madsen, Nielsen and Tingleff 2004, section 3.2, tau = 1e-3 for a start believed close). */
141
+ const TAU = 1e-3;
142
+ //# sourceMappingURL=fitDigitDescent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fitDigitDescent.js","sourceRoot":"","sources":["../../src/kinematics/fitDigitDescent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,125 @@
1
+ import type { AutoMovieHumanoidBone, IAutoMovieJointAxes, IAutoMovieJointPose, IAutoMoviePose, IAutoMovieSkeleton, IAutoMovieVector3 } from "@automovie/interface";
2
+ import type { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
3
+ import type { IAutoMovieSkeletonTopology } from "./IAutoMovieSkeletonTopology";
4
+ /**
5
+ * Put a point of a digit (its tip or its pad, a frame on its distal phalanx)
6
+ * on a world point, with the digit's own joints alone, inside their range of
7
+ * motion: the inverse kinematics of one finger or the thumb with the hand
8
+ * where the pose has placed it.
9
+ *
10
+ * Every free axis of every joint of the digit (an axis its constraint does
11
+ * not hold immobile) is a variable, in clinical degrees. The fit has two
12
+ * tasks in priority order. The first puts the effector on the target: its
13
+ * residual is the distance between them. The second, bettered only in what
14
+ * the first leaves free, turns the effector's normal onto the target normal
15
+ * when one is given (the misalignment scaled by the effector's distance from
16
+ * its joint, an arc length, so a degree of tilt counts as the millimetres it
17
+ * swings the phalanx) and keeps a finger's interphalangeal coupling, the
18
+ * distal joint following the middle one at the ratio `coupling` (the
19
+ * coupling of hand animation, DIP = 2/3 PIP, Rijpkema and Girard 1991,
20
+ * SIGGRAPH 25(4):339-348, as relayed by the hand-animation literature;
21
+ * provisional until read at the source), its residual likewise that distance
22
+ * times the angle by which the distal joint misses the ratio. The point
23
+ * goal, optionally eased by soft IK as described below, is never traded
24
+ * against a normal or a coupling it does not allow.
25
+ *
26
+ * Each descent is `fitDigitDescent`: damped task-priority least squares
27
+ * (Nakamura, Hanafusa and Yoshikawa 1987; Chiaverini 1997) with the active
28
+ * set of a projected Newton method (Bertsekas 1982) for the joints on a
29
+ * bound, and Levenberg-Marquardt damping (Madsen, Nielsen and Tingleff 2004).
30
+ * The Jacobians are read by central differences on the engine's own forward
31
+ * kinematics, so the angles mean what `resolvePose` displays, and every
32
+ * trial is projected into the range (`clampJointToSkeleton`) before it is
33
+ * measured. The point counts as reached within the effector's motion for one
34
+ * resolution step of every joint, and a descent stops when its step moves no
35
+ * joint by more than `ROM_TOLERANCE`, the resolution to which the engine
36
+ * resolves a joint's angle.
37
+ * The fit is a continuation: it descends from the pose's own angles for the
38
+ * digit, so a caller that seeds each fit from the one before follows a
39
+ * moving target in one basin, its joints moving continuously. Only when that
40
+ * fit cannot reach the target (the tip farther from it than one joint
41
+ * resolution of every joint would move it) does it restart from the middle
42
+ * of every range, where a digit folded the wrong way round its target is not
43
+ * trapped, keeping the restart only if it comes nearer; it never takes the
44
+ * better of two starts for a target the continued fit reaches, an argmin
45
+ * that would switch basins between neighbouring targets. A caller's `rate`
46
+ * softens the target near full extension, where the exact inverse has an
47
+ * unbounded derivative: the exponential soft IK of Andy Nicholas (2006),
48
+ * demonstrated in Jeremie Passerin's "Control Rig: 5.3: Soft IK" (2024,
49
+ * https://dev.epicgames.com/community/learning/tutorials/y4Ll/unreal-engine-control-rig-5-3-soft-ik).
50
+ * Below the soft band the target is unchanged; within it, some reach is
51
+ * traded for a bounded radial extension rate. The band's width comes from
52
+ * the chain's lengths and the requested rate, not the seed's posture.
53
+ * This controls the full-extension singularity, not every possible change
54
+ * of basin of a constrained digit. The result is
55
+ * deterministic for its input: fixed starts, a fixed order of variables and
56
+ * no random draw. A target outside the digit's workspace is fitted as
57
+ * nearly as this constrained local solve reaches it. With `rate` it fits
58
+ * the eased target instead, so its constrained minimum may differ from
59
+ * the original target's. In either case `residual` reports distance to the
60
+ * original target, including any reach traded away, so a caller refuses
61
+ * or accepts by its own bound.
62
+ *
63
+ * @param input The rig, the posed body, the digit's joints and the effector and target.
64
+ * @returns The digit's fitted joints, the effector's world point and the residual.
65
+ * @throws {Error} When the digit names no joint, a bone cannot be resolved, or `rate` is not finite and positive.
66
+ *
67
+ * @evidence contracts/development/common.md#meaningful-documentation States the variables, the two tasks and their units and order, the coupling's source and status, the method and its sources, the reach and stop rules and their owner, the continuation, determinism and the out-of-reach behaviour.
68
+ * @evidence contracts/development/implementation.md#principled-implementation Damped task-priority least squares (Nakamura et al. 1987, Chiaverini 1997) through `fitDigitDescent` on the engine's forward kinematics, every trial measured after the range clamp, stopping at the engine's joint-angle resolution; continuation from the caller's seed. Optional exponential soft IK eases only the target's radial distance in a band derived from the full-extension curvature.
69
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Two residual functions over the digit's variables, one continued descent and a restart only when it cannot reach.
70
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No iteration count and no weight between the tasks: the fit ends at the joint-angle resolution and reports distance from the original target, including any reach soft IK trades away. The width is derived from the chain lengths and `rate`; it does not penalise departure from an arbitrary seed.
71
+ * @evidence contracts/development/implementation.md#efficient-algorithms Each evaluation is one forward kinematics of the rig, linear in its bones; a Jacobian costs two per variable (at most 9 for a digit of three joints) and the active set's probe one clamp per variable; a step solves two small systems of the free variables; a restart, run only for a target the continued fit cannot reach, doubles the work.
72
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; a caller keeps the result by its own plan.
73
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the returned joints belong to the caller.
74
+ */
75
+ export declare function fitDigitToTarget(input: fitDigitToTarget.IInput): fitDigitToTarget.IResult;
76
+ /**
77
+ * Companion types of {@link fitDigitToTarget}.
78
+ *
79
+ * @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame and unit.
80
+ * @evidence contracts/development/design.md#principled-representation A posed rig, the digit's joints proximal to distal, a bone-local effector frame and a world target point with an optional normal.
81
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What the fit reads and what its caller needs back: the joints, where the effector ended and how far from the target.
82
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the interface's poses, bones and vectors; the effector is the region frame `resolveAutoMovieHumanoidSurfaces` already gives.
83
+ */
84
+ export declare namespace fitDigitToTarget {
85
+ /** What a digit fit reads. */
86
+ interface IInput {
87
+ /** The rig. */
88
+ skeleton: IAutoMovieSkeleton;
89
+ /** The posed body: its root, arm and hand place the digit's base; its own entries for the digit's joints are the fit's start. */
90
+ pose: IAutoMoviePose;
91
+ /** The digit's joints, proximal to distal: a finger's three, or the thumb's metacarpal, proximal and distal. */
92
+ bones: readonly AutoMovieHumanoidBone[];
93
+ /** The point brought to the target, in its bone's rest frame relative to the bone's joint, metres, with the outward unit normal there: a region frame of the digit's tip or pad. */
94
+ effector: {
95
+ bone: AutoMovieHumanoidBone;
96
+ point: IAutoMovieVector3;
97
+ normal: IAutoMovieVector3;
98
+ };
99
+ /** The target, world metres. */
100
+ target: IAutoMovieVector3;
101
+ /** The world direction the effector's normal is turned onto, when the contact needs one (a pad laid on a key faces against the key's normal); none when absent. */
102
+ normal?: IAutoMovieVector3;
103
+ /** The ratio of the distal joint's flexion to the middle joint's that a finger keeps as its second task, after the point; no coupling when absent (the thumb). */
104
+ coupling?: number;
105
+ /** The joint axes the pose is read with, as `resolvePose` takes them; the skeleton's own when absent. */
106
+ jointAxes?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>>;
107
+ /** The rest frames the pose's clinical angles are lifted by, as `resolvePose` takes them; none when absent. */
108
+ restFrames?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieRestFrame>>;
109
+ /** The rig's topology, when the caller has it. */
110
+ topology?: IAutoMovieSkeletonTopology;
111
+ /** Desired radial extension rate near full reach, positive finite degrees per metre. Derives a soft-IK band from the chain's smallest full-extension hinge curvature; targets in that band are eased short of full reach, and `residual` still measures the original target. Other constrained-IK basin changes are not bounded by this value. No softening when absent. */
112
+ rate?: number;
113
+ }
114
+ /** What a digit fit returns. */
115
+ interface IResult {
116
+ /** The digit's joints, inside their range, clinical degrees. */
117
+ joints: IAutoMovieJointPose[];
118
+ /** Where the effector ended, world metres. */
119
+ point: IAutoMovieVector3;
120
+ /** The effector's outward unit normal there, world frame. */
121
+ normal: IAutoMovieVector3;
122
+ /** The distance from the effector to the target, metres; zero within rounding when the target is reached. */
123
+ residual: number;
124
+ }
125
+ }
@@ -0,0 +1,251 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.fitDigitToTarget = fitDigitToTarget;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ const clampJointToSkeleton_1 = require("../rom/clampJointToSkeleton");
7
+ const ROM_TOLERANCE_1 = require("../rom/constants/ROM_TOLERANCE");
8
+ const getConstraint_1 = require("../rom/getConstraint");
9
+ const fitDigitDescent_1 = require("./fitDigitDescent");
10
+ const indexSkeletonTopology_1 = require("./indexSkeletonTopology");
11
+ const resolvePose_1 = require("./resolvePose");
12
+ /**
13
+ * Put a point of a digit (its tip or its pad, a frame on its distal phalanx)
14
+ * on a world point, with the digit's own joints alone, inside their range of
15
+ * motion: the inverse kinematics of one finger or the thumb with the hand
16
+ * where the pose has placed it.
17
+ *
18
+ * Every free axis of every joint of the digit (an axis its constraint does
19
+ * not hold immobile) is a variable, in clinical degrees. The fit has two
20
+ * tasks in priority order. The first puts the effector on the target: its
21
+ * residual is the distance between them. The second, bettered only in what
22
+ * the first leaves free, turns the effector's normal onto the target normal
23
+ * when one is given (the misalignment scaled by the effector's distance from
24
+ * its joint, an arc length, so a degree of tilt counts as the millimetres it
25
+ * swings the phalanx) and keeps a finger's interphalangeal coupling, the
26
+ * distal joint following the middle one at the ratio `coupling` (the
27
+ * coupling of hand animation, DIP = 2/3 PIP, Rijpkema and Girard 1991,
28
+ * SIGGRAPH 25(4):339-348, as relayed by the hand-animation literature;
29
+ * provisional until read at the source), its residual likewise that distance
30
+ * times the angle by which the distal joint misses the ratio. The point
31
+ * goal, optionally eased by soft IK as described below, is never traded
32
+ * against a normal or a coupling it does not allow.
33
+ *
34
+ * Each descent is `fitDigitDescent`: damped task-priority least squares
35
+ * (Nakamura, Hanafusa and Yoshikawa 1987; Chiaverini 1997) with the active
36
+ * set of a projected Newton method (Bertsekas 1982) for the joints on a
37
+ * bound, and Levenberg-Marquardt damping (Madsen, Nielsen and Tingleff 2004).
38
+ * The Jacobians are read by central differences on the engine's own forward
39
+ * kinematics, so the angles mean what `resolvePose` displays, and every
40
+ * trial is projected into the range (`clampJointToSkeleton`) before it is
41
+ * measured. The point counts as reached within the effector's motion for one
42
+ * resolution step of every joint, and a descent stops when its step moves no
43
+ * joint by more than `ROM_TOLERANCE`, the resolution to which the engine
44
+ * resolves a joint's angle.
45
+ * The fit is a continuation: it descends from the pose's own angles for the
46
+ * digit, so a caller that seeds each fit from the one before follows a
47
+ * moving target in one basin, its joints moving continuously. Only when that
48
+ * fit cannot reach the target (the tip farther from it than one joint
49
+ * resolution of every joint would move it) does it restart from the middle
50
+ * of every range, where a digit folded the wrong way round its target is not
51
+ * trapped, keeping the restart only if it comes nearer; it never takes the
52
+ * better of two starts for a target the continued fit reaches, an argmin
53
+ * that would switch basins between neighbouring targets. A caller's `rate`
54
+ * softens the target near full extension, where the exact inverse has an
55
+ * unbounded derivative: the exponential soft IK of Andy Nicholas (2006),
56
+ * demonstrated in Jeremie Passerin's "Control Rig: 5.3: Soft IK" (2024,
57
+ * https://dev.epicgames.com/community/learning/tutorials/y4Ll/unreal-engine-control-rig-5-3-soft-ik).
58
+ * Below the soft band the target is unchanged; within it, some reach is
59
+ * traded for a bounded radial extension rate. The band's width comes from
60
+ * the chain's lengths and the requested rate, not the seed's posture.
61
+ * This controls the full-extension singularity, not every possible change
62
+ * of basin of a constrained digit. The result is
63
+ * deterministic for its input: fixed starts, a fixed order of variables and
64
+ * no random draw. A target outside the digit's workspace is fitted as
65
+ * nearly as this constrained local solve reaches it. With `rate` it fits
66
+ * the eased target instead, so its constrained minimum may differ from
67
+ * the original target's. In either case `residual` reports distance to the
68
+ * original target, including any reach traded away, so a caller refuses
69
+ * or accepts by its own bound.
70
+ *
71
+ * @param input The rig, the posed body, the digit's joints and the effector and target.
72
+ * @returns The digit's fitted joints, the effector's world point and the residual.
73
+ * @throws {Error} When the digit names no joint, a bone cannot be resolved, or `rate` is not finite and positive.
74
+ *
75
+ * @evidence contracts/development/common.md#meaningful-documentation States the variables, the two tasks and their units and order, the coupling's source and status, the method and its sources, the reach and stop rules and their owner, the continuation, determinism and the out-of-reach behaviour.
76
+ * @evidence contracts/development/implementation.md#principled-implementation Damped task-priority least squares (Nakamura et al. 1987, Chiaverini 1997) through `fitDigitDescent` on the engine's forward kinematics, every trial measured after the range clamp, stopping at the engine's joint-angle resolution; continuation from the caller's seed. Optional exponential soft IK eases only the target's radial distance in a band derived from the full-extension curvature.
77
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Two residual functions over the digit's variables, one continued descent and a restart only when it cannot reach.
78
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No iteration count and no weight between the tasks: the fit ends at the joint-angle resolution and reports distance from the original target, including any reach soft IK trades away. The width is derived from the chain lengths and `rate`; it does not penalise departure from an arbitrary seed.
79
+ * @evidence contracts/development/implementation.md#efficient-algorithms Each evaluation is one forward kinematics of the rig, linear in its bones; a Jacobian costs two per variable (at most 9 for a digit of three joints) and the active set's probe one clamp per variable; a step solves two small systems of the free variables; a restart, run only for a target the continued fit cannot reach, doubles the work.
80
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; a caller keeps the result by its own plan.
81
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the returned joints belong to the caller.
82
+ */
83
+ function fitDigitToTarget(input) {
84
+ if (input.bones.length === 0)
85
+ throw new Error("A digit fit needs the digit's joints");
86
+ if (input.rate !== undefined &&
87
+ !(Number.isFinite(input.rate) && input.rate > 0))
88
+ throw new Error("A digit fit's rate must be finite and positive");
89
+ const topology = input.topology ?? (0, indexSkeletonTopology_1.indexSkeletonTopology)(input.skeleton);
90
+ const coupling = input.coupling ?? null;
91
+ const target = softTarget(input, topology);
92
+ // The digit's free axes, in the order of its joints.
93
+ const variables = [];
94
+ for (const bone of input.bones) {
95
+ const constraint = (0, getConstraint_1.getConstraint)(bone, input.skeleton.bones.find((b) => b.bone === bone)
96
+ ?.constraint ?? null);
97
+ for (const axis of AXES)
98
+ if (constraint === null || constraint[axis] !== null)
99
+ variables.push({ bone, axis, range: constraint?.[axis] ?? null });
100
+ }
101
+ const clamps = new Map(input.bones.map((bone) => [bone, clampJointToSkeleton_1.clampJointToSkeleton.of(bone, input.skeleton)]));
102
+ const others = input.pose.joints.filter((j) => !input.bones.includes(j.bone));
103
+ // The digit's joints for a vector of variables, projected into the range.
104
+ const joints = (x) => input.bones.map((bone) => {
105
+ const joint = {
106
+ bone,
107
+ flexion: null,
108
+ abduction: null,
109
+ twist: null,
110
+ };
111
+ variables.forEach((v, i) => {
112
+ if (v.bone === bone)
113
+ joint[v.axis] = x[i];
114
+ });
115
+ return clamps.get(bone)(joint);
116
+ });
117
+ const read = (list) => variables.map((v) => {
118
+ const joint = list.find((j) => j.bone === v.bone);
119
+ return joint?.[v.axis] ?? 0;
120
+ });
121
+ // The effector's world frame under the digit's joints.
122
+ const place = (list) => {
123
+ const pose = {
124
+ ...input.pose,
125
+ joints: [...others, ...list],
126
+ };
127
+ const resolved = (0, resolvePose_1.resolvePose)(pose, input.skeleton, input.jointAxes, input.restFrames, topology).find((r) => r.bone === input.effector.bone);
128
+ if (resolved === undefined)
129
+ throw new Error(`A digit fit cannot resolve ${input.effector.bone}`);
130
+ return {
131
+ point: Vector3_1.Vector3.add(resolved.worldPosition, Quaternion_1.Quaternion.rotateVector(resolved.worldRotation, input.effector.point)),
132
+ normal: Quaternion_1.Quaternion.rotateVector(resolved.worldRotation, input.effector.normal),
133
+ };
134
+ };
135
+ // The primary residual, metres: where the effector is less the target.
136
+ // The secondary, metres: the normal's misalignment and the coupling, each
137
+ // as an arc length on the distal phalanx.
138
+ const length = Vector3_1.Vector3.length(input.effector.point);
139
+ const primary = (x) => {
140
+ const at = place(joints(x));
141
+ return [
142
+ at.point.x - target.x,
143
+ at.point.y - target.y,
144
+ at.point.z - target.z,
145
+ ];
146
+ };
147
+ const secondary = (x) => {
148
+ const list = joints(x);
149
+ const r = [];
150
+ if (input.normal !== undefined) {
151
+ const miss = Vector3_1.Vector3.cross(place(list).normal, Vector3_1.Vector3.normalize(input.normal));
152
+ r.push(miss.x * length, miss.y * length, miss.z * length);
153
+ }
154
+ if (coupling !== null && input.bones.length >= 3) {
155
+ const middle = list[1].flexion ?? 0;
156
+ const distal = list[2].flexion ?? 0;
157
+ r.push(((distal - coupling * middle) * Math.PI * length) / 180);
158
+ }
159
+ return r;
160
+ };
161
+ // The effector's motion for one resolution step of every joint: the
162
+ // nearest the point can be put, so the primary counts as met within it.
163
+ const tolerance = (_x, J1) => variables.reduce((sum, _v, i) => sum + Math.hypot(J1[0][i], J1[1][i], J1[2][i]) * ROM_TOLERANCE_1.ROM_TOLERANCE, 0);
164
+ const jacobian = (x) => [0, 1, 2].map((k) => x.map((_v, i) => {
165
+ const up = [...x];
166
+ const down = [...x];
167
+ up[i] = up[i] + ROM_TOLERANCE_1.ROM_TOLERANCE;
168
+ down[i] = down[i] - ROM_TOLERANCE_1.ROM_TOLERANCE;
169
+ return (primary(up)[k] - primary(down)[k]) / (2 * ROM_TOLERANCE_1.ROM_TOLERANCE);
170
+ }));
171
+ const seed = read(input.pose.joints);
172
+ const descend = (start) => (0, fitDigitDescent_1.fitDigitDescent)({
173
+ start,
174
+ primary,
175
+ secondary,
176
+ project: (x) => read(joints(x)),
177
+ step: ROM_TOLERANCE_1.ROM_TOLERANCE,
178
+ tolerance,
179
+ });
180
+ // Continuation: the descent starts from the pose's own angles, so a
181
+ // caller that seeds each fit from the one before follows the target
182
+ // continuously in one basin. Only a continued fit that cannot reach (its
183
+ // point farther than `tolerance`) restarts from the middle of every range,
184
+ // where a digit folded the wrong way round its target is not trapped, and
185
+ // keeps that fit only when it comes nearer.
186
+ const reach = (x) => Math.hypot(...primary(x));
187
+ const continued = descend(seed);
188
+ let x = continued;
189
+ if (reach(continued) > tolerance(continued, jacobian(continued))) {
190
+ const restarted = descend(variables.map((v) => v.range === null ? 0 : (v.range.min + v.range.max) / 2));
191
+ if (reach(restarted) < reach(continued))
192
+ x = restarted;
193
+ }
194
+ const fitted = joints(x);
195
+ const at = place(fitted);
196
+ return {
197
+ joints: fitted,
198
+ point: at.point,
199
+ normal: at.normal,
200
+ residual: Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(at.point, input.target)),
201
+ };
202
+ }
203
+ /**
204
+ * Exponential soft IK in the radial coordinate: identity below L-s and
205
+ * L-s exp(-(d-(L-s))/s) above it. For a hinge dividing the straight chain
206
+ * into lengths a and b, the cosine rule gives L-d = k theta² + O(theta⁴),
207
+ * k = ab/(2L) (pi/180)² in metres per degree squared. In that leading-order
208
+ * model the inverse's radial rate at the band's start is 1/(2 sqrt(k s))
209
+ * and falls exponentially thereafter, giving s = 1/(4 k rate²), using the
210
+ * smallest hinge curvature. This local model is not a global rate proof
211
+ * for the nonlinear, range-constrained chain.
212
+ * The band is at most the chain's whole length; a chain with no positive
213
+ * internal hinge has no full-extension fold to soften. Link lengths are
214
+ * invariant under the pose; only the base's world place follows it.
215
+ */
216
+ const softTarget = (input, topology) => {
217
+ if (input.rate === undefined)
218
+ return input.target;
219
+ const posed = (0, resolvePose_1.resolvePose)(input.pose, input.skeleton, input.jointAxes, input.restFrames, topology);
220
+ const points = input.bones.map((bone) => {
221
+ const frame = posed.find((p) => p.bone === bone);
222
+ if (frame === undefined)
223
+ throw new Error(`A digit fit cannot resolve ${bone}`);
224
+ return frame.worldPosition;
225
+ });
226
+ const links = points
227
+ .slice(1)
228
+ .map((point, i) => Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(point, points[i])));
229
+ links.push(Vector3_1.Vector3.length(input.effector.point));
230
+ const reach = links.reduce((sum, link) => sum + link, 0);
231
+ let left = 0;
232
+ const curvatures = links
233
+ .slice(0, -1)
234
+ .map((link) => {
235
+ left += link;
236
+ return ((left * (reach - left)) / (2 * reach)) * (Math.PI / 180) ** 2;
237
+ })
238
+ .filter((k) => k > 0);
239
+ if (curvatures.length === 0)
240
+ return input.target;
241
+ const width = Math.min(reach, 1 / (4 * Math.min(...curvatures) * input.rate ** 2));
242
+ const delta = Vector3_1.Vector3.subtract(input.target, points[0]);
243
+ const distance = Vector3_1.Vector3.length(delta);
244
+ if (distance === 0 || distance <= reach - width)
245
+ return input.target;
246
+ const eased = reach - width * Math.exp(-(distance - (reach - width)) / width);
247
+ return Vector3_1.Vector3.add(points[0], Vector3_1.Vector3.scale(delta, eased / distance));
248
+ };
249
+ /** The clinical axes of a joint, in the order variables are read. */
250
+ const AXES = ["flexion", "abduction", "twist"];
251
+ //# sourceMappingURL=fitDigitToTarget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fitDigitToTarget.js","sourceRoot":"","sources":["../../src/kinematics/fitDigitToTarget.ts"],"names":[],"mappings":"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"}