@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
@@ -1,6 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.inertializePose = inertializePose;
4
+ const poseJointCodec_1 = require("../kinematics/poseJointCodec");
4
5
  const Quaternion_1 = require("../math/Quaternion");
5
6
  const inertializeOffset_1 = require("./inertializeOffset");
6
7
  const samplePoseVelocity_1 = require("./samplePoseVelocity");
@@ -9,13 +10,28 @@ const samplePoseVelocity_1 = require("./samplePoseVelocity");
9
10
  * the cut, and the source's offset from it decays to zero.
10
11
  *
11
12
  * At the cut the displayed pose was the source; from then on it is the target
12
- * plus an offset per channel. Every clinical angle's offset and offset
13
- * velocity decay independently by {@link inertializeOffset} (Bollo, GDC
14
- * 2018), so each channel is continuous in value and velocity at the cut,
15
- * reaches the target exactly at its own clamped decay time and never
16
- * overshoots it. The root translation decays per axis the same way. The root
17
- * rotation's offset `q_s q_t^-1` decays as its rotation vector, per axis, with
18
- * the angular velocity offset, and is applied before the target rotation.
13
+ * plus an offset. Every rotation's offset `q_s q_t^-1` (each joint's
14
+ * articulation and the root's rotation) decays as its rotation vector, per
15
+ * axis, with the angular velocity offset, by {@link inertializeOffset} (Bollo,
16
+ * GDC 2018), and is applied before the target rotation; the root translation
17
+ * decays per axis the same way. Each is therefore continuous in value and
18
+ * velocity at the cut, reaches the target exactly at its own clamped decay
19
+ * time and never overshoots it.
20
+ *
21
+ * A ball joint is blended as a rotation, never per clinical angle: its
22
+ * `[flexion, abduction, twist]` is an Euler chart, and at the chart's gimbal
23
+ * nearly equal rotations have far apart triples, whose per-angle blend swings
24
+ * the bone through poses neither side holds. The blended rotation is lowered
25
+ * to angles through the rig ({@link poseJointCodec}), in the chart its range
26
+ * of motion admits best. A joint with no offset left returns the target's own
27
+ * angles untouched.
28
+ *
29
+ * A hinge or a two-axis joint (`poseJointCodec.ICodec.ball` false) is blended
30
+ * per angle instead, each angle's offset decayed with its rate offset: the
31
+ * rotations its angles span are a lower-dimensional set, and an offset
32
+ * rotation applied to one of them leaves that set, which the lowering would
33
+ * answer with motion on an axis the joint does not have. Its angles have no
34
+ * gimbal inside their range, so the per-angle blend is the faithful one.
19
35
  *
20
36
  * The result is a pure function of the elapsed time and the target pose at
21
37
  * that time, so a caller can evaluate it on any grid. Contact corrections
@@ -25,69 +41,132 @@ const samplePoseVelocity_1 = require("./samplePoseVelocity");
25
41
  * @param source The displayed pose and its velocity at the cut.
26
42
  * @param target The target's pose and velocity at the cut.
27
43
  * @param duration Requested decay time, seconds; positive.
44
+ * @param through Whether an offset heading to its target faster than the
45
+ * decay absorbs passes through it and returns, as `inertializeOffset`
46
+ * bounds, instead of stopping short of it within milliseconds: the "never
47
+ * overshoots" above is then given up for a bounded acceleration at the cut.
48
+ * @param rig The rig the joints' angles are read through, the one both
49
+ * states' `spins` were sampled with; the default basis with rest-relative
50
+ * angles when omitted.
28
51
  * @returns The displayed pose for an elapsed time and the target pose at it.
29
52
  *
30
- * @evidence contracts/development/common.md#meaningful-documentation States the per-channel method, its continuity and no-overshoot guarantees, the root rotation's treatment and where contact correction goes.
31
- * @evidence contracts/development/implementation.md#principled-implementation Per-channel quintic inertialization (Bollo 2018) with the rotation offset decayed as a rotation vector, the standard treatment of orientation offsets.
32
- * @evidence contracts/development/implementation.md#clear-and-simple-structure Offsets are captured once; the returned function adds their decay to the target.
53
+ * @evidence contracts/development/common.md#meaningful-documentation States the rotation-space method and why angles are not blended, its continuity and no-overshoot guarantees and where contact correction goes.
54
+ * @evidence contracts/development/implementation.md#principled-implementation Quintic inertialization (Bollo 2018) with every orientation offset decayed as a rotation vector, the standard treatment of orientation offsets.
55
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Offsets are captured once; the returned function applies their decay before the target.
33
56
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Bones present on one side only take their clinical neutral, zero, on the other.
34
57
  * @evidence contracts/development/implementation.md#efficient-algorithms Capture is linear in joints; each evaluation is linear in joints.
35
- * @evidence contracts/development/implementation.md#reuse-equivalent-work The captured offsets are shared by every evaluation of one transition.
36
- * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The returned function retains only the captured offsets, bounded by the joint count.
58
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The captured offsets and the joint codec are shared by every evaluation of one transition.
59
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The returned function retains only the captured offsets and the codec, bounded by the joint count.
37
60
  */
38
- function inertializePose(source, target, duration) {
61
+ function inertializePose(source, target, duration, through = false, rig) {
62
+ const codec = (0, poseJointCodec_1.poseJointCodec)(rig);
39
63
  const angles = (p) => new Map(p.joints.map((j) => [
40
64
  j.bone,
41
65
  [j.flexion ?? 0, j.abduction ?? 0, j.twist ?? 0],
42
66
  ]));
67
+ const zero = { x: 0, y: 0, z: 0 };
68
+ const axes = ["x", "y", "z"];
69
+ // The offset rotation `exp(decayed vector)` at an elapsed time, or null
70
+ // once nothing of it is left.
71
+ const decayed = (x, v, elapsed) => {
72
+ const turn = { x: 0, y: 0, z: 0 };
73
+ for (const k of axes)
74
+ turn[k] = (0, inertializeOffset_1.inertializeOffset)(x[k], v[k], duration, elapsed, through).value;
75
+ const angle = Math.hypot(turn.x, turn.y, turn.z);
76
+ return angle < 1e-12
77
+ ? null
78
+ : Quaternion_1.Quaternion.fromAxisAngle({ x: turn.x / angle, y: turn.y / angle, z: turn.z / angle }, (angle * 180) / Math.PI);
79
+ };
43
80
  const sa = angles(source.pose);
44
81
  const ta = angles(target.pose);
82
+ const still = [0, 0, 0];
45
83
  const offsets = new Map();
84
+ // Angle offsets and their rates, for the joints that are not ball joints.
85
+ const hinged = new Map();
46
86
  for (const bone of new Set([...sa.keys(), ...ta.keys()])) {
47
- const s = sa.get(bone) ?? [0, 0, 0];
48
- const t = ta.get(bone) ?? [0, 0, 0];
49
- const vs = source.velocity.joints.get(bone) ?? [
50
- 0, 0, 0,
51
- ];
52
- const vt = target.velocity.joints.get(bone) ?? [
53
- 0, 0, 0,
54
- ];
55
- offsets.set(bone, {
56
- x: [0, 1, 2].map((k) => s[k] - t[k]),
57
- v: [0, 1, 2].map((k) => vs[k] - vt[k]),
58
- });
87
+ const s = sa.get(bone) ?? still;
88
+ const t = ta.get(bone) ?? still;
89
+ if (!codec.ball(bone)) {
90
+ const rs = source.velocity.joints.get(bone) ?? still;
91
+ const rt = target.velocity.joints.get(bone) ?? still;
92
+ const x = [
93
+ s[0] - t[0],
94
+ s[1] - t[1],
95
+ s[2] - t[2],
96
+ ];
97
+ const v = [
98
+ rs[0] - rt[0],
99
+ rs[1] - rt[1],
100
+ rs[2] - rt[2],
101
+ ];
102
+ if (x.some((k) => k !== 0) || v.some((k) => k !== 0))
103
+ hinged.set(bone, { x, v });
104
+ continue;
105
+ }
106
+ const vs = source.velocity.spins.get(bone) ?? zero;
107
+ const vt = target.velocity.spins.get(bone) ?? zero;
108
+ const same = s[0] === t[0] && s[1] === t[1] && s[2] === t[2];
109
+ const x = same
110
+ ? zero
111
+ : samplePoseVelocity_1.samplePoseVelocity.rotationVector(Quaternion_1.Quaternion.multiply(codec.rotation(bone, s), Quaternion_1.Quaternion.inverse(codec.rotation(bone, t))));
112
+ const v = {
113
+ x: vs.x - vt.x,
114
+ y: vs.y - vt.y,
115
+ z: vs.z - vt.z,
116
+ };
117
+ if (same && v.x === 0 && v.y === 0 && v.z === 0)
118
+ continue;
119
+ offsets.set(bone, { x, v });
59
120
  }
60
- const zero = { x: 0, y: 0, z: 0 };
61
121
  const st = source.pose.root?.translation ?? zero;
62
122
  const tt = target.pose.root?.translation ?? zero;
63
123
  const sr = source.pose.root?.rotation ?? Quaternion_1.Quaternion.identity();
64
124
  const tr = target.pose.root?.rotation ?? Quaternion_1.Quaternion.identity();
65
125
  const rotation0 = samplePoseVelocity_1.samplePoseVelocity.rotationVector(Quaternion_1.Quaternion.multiply(sr, Quaternion_1.Quaternion.inverse(tr)));
66
- const axes = ["x", "y", "z"];
126
+ const spin0 = {
127
+ x: source.velocity.angular.x - target.velocity.angular.x,
128
+ y: source.velocity.angular.y - target.velocity.angular.y,
129
+ z: source.velocity.angular.z - target.velocity.angular.z,
130
+ };
67
131
  return (elapsed, pose) => {
68
132
  const now = angles(pose);
69
133
  const joints = [];
70
- for (const bone of new Set([...now.keys(), ...offsets.keys()])) {
71
- const base = now.get(bone) ?? [0, 0, 0];
134
+ for (const bone of new Set([
135
+ ...now.keys(),
136
+ ...offsets.keys(),
137
+ ...hinged.keys(),
138
+ ])) {
139
+ const base = now.get(bone) ?? still;
140
+ const h = hinged.get(bone);
141
+ if (h !== undefined) {
142
+ const angle = (k) => base[k] +
143
+ (0, inertializeOffset_1.inertializeOffset)(h.x[k], h.v[k], duration, elapsed, through).value;
144
+ joints.push({
145
+ bone,
146
+ flexion: angle(0),
147
+ abduction: angle(1),
148
+ twist: angle(2),
149
+ });
150
+ continue;
151
+ }
72
152
  const o = offsets.get(bone);
73
- const at = (k) => base[k] +
74
- (o === undefined
75
- ? 0
76
- : (0, inertializeOffset_1.inertializeOffset)(o.x[k], o.v[k], duration, elapsed).value);
77
- joints.push({ bone, flexion: at(0), abduction: at(1), twist: at(2) });
153
+ const offset = o === undefined ? null : decayed(o.x, o.v, elapsed);
154
+ const shown = offset === null
155
+ ? base
156
+ : codec.angles(bone, Quaternion_1.Quaternion.normalize(Quaternion_1.Quaternion.multiply(offset, codec.rotation(bone, base))));
157
+ joints.push({
158
+ bone,
159
+ flexion: shown[0],
160
+ abduction: shown[1],
161
+ twist: shown[2],
162
+ });
78
163
  }
79
164
  const t = pose.root?.translation ?? zero;
80
165
  const r = pose.root?.rotation ?? Quaternion_1.Quaternion.identity();
81
166
  const translation = { ...t };
82
- const turn = { x: 0, y: 0, z: 0 };
83
- for (const k of axes) {
84
- translation[k] += (0, inertializeOffset_1.inertializeOffset)(st[k] - tt[k], source.velocity.linear[k] - target.velocity.linear[k], duration, elapsed).value;
85
- turn[k] = (0, inertializeOffset_1.inertializeOffset)(rotation0[k], source.velocity.angular[k] - target.velocity.angular[k], duration, elapsed).value;
86
- }
87
- const angle = Math.hypot(turn.x, turn.y, turn.z);
88
- const offset = angle < 1e-12
89
- ? Quaternion_1.Quaternion.identity()
90
- : Quaternion_1.Quaternion.fromAxisAngle({ x: turn.x / angle, y: turn.y / angle, z: turn.z / angle }, (angle * 180) / Math.PI);
167
+ for (const k of axes)
168
+ translation[k] += (0, inertializeOffset_1.inertializeOffset)(st[k] - tt[k], source.velocity.linear[k] - target.velocity.linear[k], duration, elapsed, through).value;
169
+ const offset = decayed(rotation0, spin0, elapsed) ?? Quaternion_1.Quaternion.identity();
91
170
  return {
92
171
  skeleton: pose.skeleton,
93
172
  root: {
@@ -1 +1 @@
1
- {"version":3,"file":"inertializePose.js","sourceRoot":"","sources":["../../src/motion/inertializePose.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"inertializePose.js","sourceRoot":"","sources":["../../src/motion/inertializePose.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,151 @@
1
+ import type { AutoMovieHumanoidBone, IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
2
+ import type { IAutoMovieResolvedBone } from "../kinematics/IAutoMovieResolvedBone";
3
+ import type { resolveAutoMovieCenterOfMass } from "../kinematics/resolveAutoMovieCenterOfMass";
4
+ import { resolveAutoMovieMomentum } from "../kinematics/resolveAutoMovieMomentum";
5
+ import { integrateMotionTrajectory } from "./integrateMotionTrajectory";
6
+ /**
7
+ * The root orientation of a body in flight, from its angular momentum about
8
+ * the centre of mass, constant while nothing touches it, and the shape the
9
+ * body takes at each instant (#3426).
10
+ *
11
+ * A multi-segment body in torque-free flight keeps its whole-body angular
12
+ * momentum `L` about the centre of mass. Split into the root's own rotation
13
+ * and the segments' motion relative to the root, `L = R (I_b w_b + h_b)`,
14
+ * with `R` the root's orientation, `I_b` the composite inertia about the
15
+ * centre in the root's frame, `w_b` the root's angular velocity in that frame
16
+ * and `h_b` the angular momentum of the segments' motion relative to the
17
+ * root, so the root turns at `w_b = I_b⁻¹ (Rᵀ L - h_b)`: the angular
18
+ * momentum balance of a multibody, the model #3416 attributes to Yeadon,
19
+ * Atha and Hales 1990 ("The simulation of aerial movement IV", J Biomech
20
+ * 23(1)) and Yeadon 1993 ("The biomechanics of twisting somersaults", J
21
+ * Sports Sci 11), neither yet read at the source. `I_b` and `h_b` come from the
22
+ * shape's history (`integrateAirborneRotation.history`), and the orientation
23
+ * is integrated by the engine's trajectory integrator on its quaternion block
24
+ * (`integrateMotionTrajectory`), so the result is a value read by time,
25
+ * independent of the times read.
26
+ *
27
+ * The centre of mass is not integrated: in flight it follows the parabola
28
+ * the take-off gives in closed form, and a caller places the root so the
29
+ * shape's centre, turned by `orientation`, lies on it. The shape's bones are
30
+ * in the root's own frame (root at the origin, unturned), so the result does
31
+ * not depend on where in the world or at which heading the flight happens.
32
+ * Requested momentum variations are integrated alongside it as body-frame
33
+ * rotation tangents: the forward sensitivity equations `s' = f_y s + f_p`
34
+ * (SUNDIALS CVODES, https://sundials.readthedocs.io/en/latest/cvodes/Mathematics_link.html).
35
+ *
36
+ * @param props The shape's history, the flight and the momentum.
37
+ * @returns The flight's orientation, read by time.
38
+ * @throws {Error} When the interval or the step is not positive, or the shape misses a segment's bone.
39
+ *
40
+ * @evidence contracts/development/common.md#meaningful-documentation States the conservation law, the decomposition into root and relative motion with its sources, where each term comes from, the frames, what is not integrated and why the result is translation and heading invariant.
41
+ * @evidence contracts/development/implementation.md#principled-implementation Conservation of angular momentum about the centre of mass of a torque-free multibody, with the root's angular velocity solved from the composite inertia; the inverse is applied through its principal frame, exact for a symmetric positive-definite tensor. Forward sensitivity differentiates this same ODE, with eta' = -w cross eta + I^-1((R^T L) cross eta + R^T dL), in the instantaneous body's frame.
42
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One right-hand side over the history, with the requested variations, handed to the existing trajectory integrator.
43
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No rate is clamped and no angle scripted: the orientation is whatever the momentum and the shape give.
44
+ * @evidence contracts/development/implementation.md#efficient-algorithms Four right-hand sides per fixed step or six new stages per adaptive attempt, each one history read and linear work in the requested variation directions; no separate flight is integrated for a derivative.
45
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The history keeps each exact instant's inertia and relative momentum, which depend on the shape alone. Repeated times reuse them across stages and shooting trials; different adaptive meshes generally require new instants.
46
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The returned trajectory retains accepted-step states and their dense-output coefficients for its lifetime, linear in accepted steps and requested variations. Adaptive step count has no fixed bound. The caller owns the history, whose caches also grow with distinct evaluated times, including rejected attempts.
47
+ */
48
+ export declare function integrateAirborneRotation(props: integrateAirborneRotation.IProps): integrateAirborneRotation.IFlight;
49
+ /**
50
+ * Companion types, constants, the shape's history and the rate of
51
+ * {@link integrateAirborneRotation}.
52
+ *
53
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its frame, unit and meaning.
54
+ * @evidence contracts/development/design.md#principled-representation The flight's inputs are the conserved momentum and a shape history in the root's frame; the output is an orientation read by time, as the integrator's.
55
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What the flight pass (#3427) and the take-off solver read: the inputs, the history, the read-back and the rate a test checks by closed form.
56
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The mass model is `resolveAutoMovieCenterOfMass`'s, the tensor and momenta `resolveAutoMovieMomentum`'s and the trajectory `integrateMotionTrajectory`'s, not restated.
57
+ */
58
+ export declare namespace integrateAirborneRotation {
59
+ /**
60
+ * The half-interval of the shape's central difference, seconds: a
61
+ * millisecond, whose second-order error is a millionth of the shape's third
62
+ * derivative, far under the integrator's own at its sixtieth-of-a-second
63
+ * step. The shape is read on `[t0 - DELTA, t1 + DELTA]`.
64
+ */
65
+ const DELTA: number;
66
+ /** What a flight is integrated from. */
67
+ interface IProps {
68
+ /** The shape's history (`history`). */
69
+ history: IHistory;
70
+ /** Take-off, seconds. */
71
+ t0: number;
72
+ /** Touchdown, seconds, after `t0`. */
73
+ t1: number;
74
+ /** The root's world orientation at take-off, unit. */
75
+ q0: IAutoMovieQuaternion;
76
+ /** The whole-body angular momentum about the centre of mass, world frame, kg m²/s; constant through the flight. */
77
+ momentum: IAutoMovieVector3;
78
+ /** The integrator's step, seconds; its default when absent. Under a `tolerance`, the first step tried. */
79
+ h?: number;
80
+ /** The integrator's error control (`integrateMotionTrajectory.ITolerance`); the fixed step when absent. */
81
+ tolerance?: integrateMotionTrajectory.ITolerance;
82
+ /** Momentum directions whose forward sensitivities are integrated with the orientation. Each returned tangent is in the instantaneous body's frame, radians per unit change of the corresponding direction. Absent, none are integrated. */
83
+ variations?: readonly IAutoMovieVector3[];
84
+ }
85
+ /**
86
+ * The shape's mass distribution at a second, in the root's own frame: its
87
+ * composite inertia's principal frame and the relative angular momentum of
88
+ * its segments' motion with respect to the root.
89
+ */
90
+ type IHistory = (seconds: number) => IInstant;
91
+ /** The shape's mass distribution at one instant, root frame. */
92
+ interface IInstant {
93
+ /** The composite inertia about the centre of mass, as its principal frame, kg m². */
94
+ inertia: resolveAutoMovieMomentum.IPrincipal;
95
+ /** The angular momentum of the segments' motion relative to the root, about the centre of mass, kg m²/s. */
96
+ relative: IAutoMovieVector3;
97
+ }
98
+ /** A flight's orientation, read by time. */
99
+ interface IFlight {
100
+ /** Take-off, seconds. */
101
+ t0: number;
102
+ /** Touchdown, seconds. */
103
+ t1: number;
104
+ /** The integrator's step, seconds; under a tolerance, its first step tried. */
105
+ h: number;
106
+ /** The integrator's knot count, the steps plus one; under a tolerance, its accepted steps plus one. */
107
+ knots: number;
108
+ /**
109
+ * The root's world orientation at a second, held at the ends outside the flight.
110
+ *
111
+ */
112
+ orientation: (seconds: number) => IAutoMovieQuaternion;
113
+ /** Body-frame rotation tangents with respect to the requested momentum directions, in their input order; an empty array when none were requested. */
114
+ variations: (seconds: number) => readonly IAutoMovieVector3[];
115
+ }
116
+ /**
117
+ * A shape's history: at each second, the composite inertia of the posed
118
+ * bones and the relative momentum from the bones `DELTA` either side,
119
+ * second order in `DELTA`, each instant computed once and kept by its exact
120
+ * second for the history's lifetime.
121
+ *
122
+ * Given the flight's span, the three-point stencil slides up to its
123
+ * boundary and then stays inside it. At a requested instant `t` away
124
+ * from the stencil's centre `s`, its central momentum is corrected by
125
+ * `(t-s)/δ` times the difference of its right and left half-interval
126
+ * momenta: the derivative of a quadratic interpolant, second order in
127
+ * `δ` (Fornberg 1988, Mathematics of Computation 51:699-706). Its weights
128
+ * and nodes are continuous when it becomes centred again, so an ODE
129
+ * reading the history sees no artificial stencil-switch discontinuity.
130
+ *
131
+ * @param model The body's mass model.
132
+ * @param shape The posed bones at a second, in the root's own frame (the root at the origin, unturned): the composed shape without the flight's rotation. Pure, and read up to `DELTA` outside the flight, or up to `2 DELTA` inside it at its ends when `span` is given.
133
+ * @param span The flight's take-off and touchdown, seconds; the shape is read across them when absent.
134
+ * @returns The history.
135
+ */
136
+ function history(model: resolveAutoMovieCenterOfMass.IModel, shape: (seconds: number) => ReadonlyMap<AutoMovieHumanoidBone, IAutoMovieResolvedBone>, span?: {
137
+ from: number;
138
+ to: number;
139
+ }): IHistory;
140
+ /**
141
+ * The root's angular velocity in its own frame, `I_b⁻¹ (L_b - h_b)`: the
142
+ * momentum the root's own turn must carry once the segments' relative
143
+ * motion has taken its share, divided by the composite inertia, applied
144
+ * through the tensor's principal frame.
145
+ *
146
+ * @param instant The shape's inertia and relative momentum at the instant, root frame.
147
+ * @param momentum The whole-body momentum `L_b`, root frame, kg m²/s.
148
+ * @returns The root's angular velocity in its own frame, radians per second.
149
+ */
150
+ function rate(instant: IInstant, momentum: IAutoMovieVector3): IAutoMovieVector3;
151
+ }
@@ -0,0 +1,204 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.integrateAirborneRotation = integrateAirborneRotation;
4
+ const resolveAutoMovieMomentum_1 = require("../kinematics/resolveAutoMovieMomentum");
5
+ const Quaternion_1 = require("../math/Quaternion");
6
+ const Vector3_1 = require("../math/Vector3");
7
+ const integrateMotionTrajectory_1 = require("./integrateMotionTrajectory");
8
+ /**
9
+ * The root orientation of a body in flight, from its angular momentum about
10
+ * the centre of mass, constant while nothing touches it, and the shape the
11
+ * body takes at each instant (#3426).
12
+ *
13
+ * A multi-segment body in torque-free flight keeps its whole-body angular
14
+ * momentum `L` about the centre of mass. Split into the root's own rotation
15
+ * and the segments' motion relative to the root, `L = R (I_b w_b + h_b)`,
16
+ * with `R` the root's orientation, `I_b` the composite inertia about the
17
+ * centre in the root's frame, `w_b` the root's angular velocity in that frame
18
+ * and `h_b` the angular momentum of the segments' motion relative to the
19
+ * root, so the root turns at `w_b = I_b⁻¹ (Rᵀ L - h_b)`: the angular
20
+ * momentum balance of a multibody, the model #3416 attributes to Yeadon,
21
+ * Atha and Hales 1990 ("The simulation of aerial movement IV", J Biomech
22
+ * 23(1)) and Yeadon 1993 ("The biomechanics of twisting somersaults", J
23
+ * Sports Sci 11), neither yet read at the source. `I_b` and `h_b` come from the
24
+ * shape's history (`integrateAirborneRotation.history`), and the orientation
25
+ * is integrated by the engine's trajectory integrator on its quaternion block
26
+ * (`integrateMotionTrajectory`), so the result is a value read by time,
27
+ * independent of the times read.
28
+ *
29
+ * The centre of mass is not integrated: in flight it follows the parabola
30
+ * the take-off gives in closed form, and a caller places the root so the
31
+ * shape's centre, turned by `orientation`, lies on it. The shape's bones are
32
+ * in the root's own frame (root at the origin, unturned), so the result does
33
+ * not depend on where in the world or at which heading the flight happens.
34
+ * Requested momentum variations are integrated alongside it as body-frame
35
+ * rotation tangents: the forward sensitivity equations `s' = f_y s + f_p`
36
+ * (SUNDIALS CVODES, https://sundials.readthedocs.io/en/latest/cvodes/Mathematics_link.html).
37
+ *
38
+ * @param props The shape's history, the flight and the momentum.
39
+ * @returns The flight's orientation, read by time.
40
+ * @throws {Error} When the interval or the step is not positive, or the shape misses a segment's bone.
41
+ *
42
+ * @evidence contracts/development/common.md#meaningful-documentation States the conservation law, the decomposition into root and relative motion with its sources, where each term comes from, the frames, what is not integrated and why the result is translation and heading invariant.
43
+ * @evidence contracts/development/implementation.md#principled-implementation Conservation of angular momentum about the centre of mass of a torque-free multibody, with the root's angular velocity solved from the composite inertia; the inverse is applied through its principal frame, exact for a symmetric positive-definite tensor. Forward sensitivity differentiates this same ODE, with eta' = -w cross eta + I^-1((R^T L) cross eta + R^T dL), in the instantaneous body's frame.
44
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One right-hand side over the history, with the requested variations, handed to the existing trajectory integrator.
45
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No rate is clamped and no angle scripted: the orientation is whatever the momentum and the shape give.
46
+ * @evidence contracts/development/implementation.md#efficient-algorithms Four right-hand sides per fixed step or six new stages per adaptive attempt, each one history read and linear work in the requested variation directions; no separate flight is integrated for a derivative.
47
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The history keeps each exact instant's inertia and relative momentum, which depend on the shape alone. Repeated times reuse them across stages and shooting trials; different adaptive meshes generally require new instants.
48
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The returned trajectory retains accepted-step states and their dense-output coefficients for its lifetime, linear in accepted steps and requested variations. Adaptive step count has no fixed bound. The caller owns the history, whose caches also grow with distinct evaluated times, including rejected attempts.
49
+ */
50
+ function integrateAirborneRotation(props) {
51
+ const { history, momentum } = props;
52
+ const variations = props.variations ?? [];
53
+ // The integrator averages squared error over all components. Dividing
54
+ // both tolerances by sqrt(1 + directions) keeps the orientation's old
55
+ // three-component RMS contribution unchanged when tangent states are added.
56
+ const errorScale = Math.sqrt(1 + variations.length);
57
+ const tolerance = props.tolerance === undefined
58
+ ? undefined
59
+ : {
60
+ relative: props.tolerance.relative / errorScale,
61
+ absolute: props.tolerance.absolute / errorScale,
62
+ };
63
+ const trajectory = (0, integrateMotionTrajectory_1.integrateMotionTrajectory)({
64
+ f: (t, x, q) => {
65
+ const instant = history(t);
66
+ const back = Quaternion_1.Quaternion.inverse(q);
67
+ const carried = Quaternion_1.Quaternion.rotateVector(back, momentum);
68
+ const w = integrateAirborneRotation.rate(instant, carried);
69
+ // Forward sensitivity, q(L + dL) = q(L) exp(eta / 2): differentiating
70
+ // q' = q w / 2 gives eta' = -w x eta + I^-1((R^T L) x eta + R^T dL).
71
+ const dx = variations.flatMap((direction, i) => {
72
+ const eta = {
73
+ x: x[3 * i],
74
+ y: x[3 * i + 1],
75
+ z: x[3 * i + 2],
76
+ };
77
+ const changed = inverse(instant.inertia, Vector3_1.Vector3.add(Vector3_1.Vector3.cross(carried, eta), Quaternion_1.Quaternion.rotateVector(back, direction)));
78
+ const rate = Vector3_1.Vector3.subtract(changed, Vector3_1.Vector3.cross(w, eta));
79
+ return [rate.x, rate.y, rate.z];
80
+ });
81
+ return { dx, w };
82
+ },
83
+ x0: Array.from({ length: 3 * variations.length }, () => 0),
84
+ q0: props.q0,
85
+ t0: props.t0,
86
+ t1: props.t1,
87
+ h: props.h,
88
+ tolerance,
89
+ });
90
+ return {
91
+ t0: trajectory.t0,
92
+ t1: trajectory.t1,
93
+ h: trajectory.h,
94
+ knots: trajectory.knots,
95
+ orientation: (seconds) => trajectory.at(seconds).q,
96
+ variations: (seconds) => {
97
+ const x = trajectory.at(seconds).x;
98
+ return variations.map((_, i) => ({
99
+ x: x[3 * i],
100
+ y: x[3 * i + 1],
101
+ z: x[3 * i + 2],
102
+ }));
103
+ },
104
+ };
105
+ }
106
+ /**
107
+ * Companion types, constants, the shape's history and the rate of
108
+ * {@link integrateAirborneRotation}.
109
+ *
110
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its frame, unit and meaning.
111
+ * @evidence contracts/development/design.md#principled-representation The flight's inputs are the conserved momentum and a shape history in the root's frame; the output is an orientation read by time, as the integrator's.
112
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What the flight pass (#3427) and the take-off solver read: the inputs, the history, the read-back and the rate a test checks by closed form.
113
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The mass model is `resolveAutoMovieCenterOfMass`'s, the tensor and momenta `resolveAutoMovieMomentum`'s and the trajectory `integrateMotionTrajectory`'s, not restated.
114
+ */
115
+ (function (integrateAirborneRotation) {
116
+ /**
117
+ * The half-interval of the shape's central difference, seconds: a
118
+ * millisecond, whose second-order error is a millionth of the shape's third
119
+ * derivative, far under the integrator's own at its sixtieth-of-a-second
120
+ * step. The shape is read on `[t0 - DELTA, t1 + DELTA]`.
121
+ */
122
+ integrateAirborneRotation.DELTA = 1e-3;
123
+ /**
124
+ * A shape's history: at each second, the composite inertia of the posed
125
+ * bones and the relative momentum from the bones `DELTA` either side,
126
+ * second order in `DELTA`, each instant computed once and kept by its exact
127
+ * second for the history's lifetime.
128
+ *
129
+ * Given the flight's span, the three-point stencil slides up to its
130
+ * boundary and then stays inside it. At a requested instant `t` away
131
+ * from the stencil's centre `s`, its central momentum is corrected by
132
+ * `(t-s)/δ` times the difference of its right and left half-interval
133
+ * momenta: the derivative of a quadratic interpolant, second order in
134
+ * `δ` (Fornberg 1988, Mathematics of Computation 51:699-706). Its weights
135
+ * and nodes are continuous when it becomes centred again, so an ODE
136
+ * reading the history sees no artificial stencil-switch discontinuity.
137
+ *
138
+ * @param model The body's mass model.
139
+ * @param shape The posed bones at a second, in the root's own frame (the root at the origin, unturned): the composed shape without the flight's rotation. Pure, and read up to `DELTA` outside the flight, or up to `2 DELTA` inside it at its ends when `span` is given.
140
+ * @param span The flight's take-off and touchdown, seconds; the shape is read across them when absent.
141
+ * @returns The history.
142
+ */
143
+ function history(model, shape, span) {
144
+ const bones = new Map();
145
+ const read = (seconds) => {
146
+ const known = bones.get(seconds);
147
+ if (known !== undefined)
148
+ return known;
149
+ const posed = shape(seconds);
150
+ bones.set(seconds, posed);
151
+ return posed;
152
+ };
153
+ const instants = new Map();
154
+ const momentum = (from, to) => (0, resolveAutoMovieMomentum_1.resolveAutoMovieMomentum)(model, read(from), read(to), to - from).angular;
155
+ const relative = (seconds) => {
156
+ if (span === undefined)
157
+ return momentum(seconds - integrateAirborneRotation.DELTA, seconds + integrateAirborneRotation.DELTA);
158
+ const delta = Math.min(integrateAirborneRotation.DELTA, (span.to - span.from) / 2);
159
+ const centre = Math.max(span.from + delta, Math.min(span.to - delta, seconds));
160
+ const a = Math.max(span.from, centre - delta);
161
+ const b = Math.min(span.to, centre + delta);
162
+ const central = momentum(a, b);
163
+ if (centre === seconds)
164
+ return central;
165
+ return Vector3_1.Vector3.add(central, Vector3_1.Vector3.scale(Vector3_1.Vector3.subtract(momentum(centre, b), momentum(a, centre)), (2 * (seconds - centre)) / (b - a)));
166
+ };
167
+ return (seconds) => {
168
+ const known = instants.get(seconds);
169
+ if (known !== undefined)
170
+ return known;
171
+ const instant = {
172
+ inertia: resolveAutoMovieMomentum_1.resolveAutoMovieMomentum.principal(resolveAutoMovieMomentum_1.resolveAutoMovieMomentum.inertia(model, read(seconds))),
173
+ relative: relative(seconds),
174
+ };
175
+ instants.set(seconds, instant);
176
+ return instant;
177
+ };
178
+ }
179
+ integrateAirborneRotation.history = history;
180
+ /**
181
+ * The root's angular velocity in its own frame, `I_b⁻¹ (L_b - h_b)`: the
182
+ * momentum the root's own turn must carry once the segments' relative
183
+ * motion has taken its share, divided by the composite inertia, applied
184
+ * through the tensor's principal frame.
185
+ *
186
+ * @param instant The shape's inertia and relative momentum at the instant, root frame.
187
+ * @param momentum The whole-body momentum `L_b`, root frame, kg m²/s.
188
+ * @returns The root's angular velocity in its own frame, radians per second.
189
+ */
190
+ function rate(instant, momentum) {
191
+ return inverse(instant.inertia, Vector3_1.Vector3.subtract(momentum, instant.relative));
192
+ }
193
+ integrateAirborneRotation.rate = rate;
194
+ })(integrateAirborneRotation || (exports.integrateAirborneRotation = integrateAirborneRotation = {}));
195
+ /** Apply the inverse composite tensor through its principal frame. */
196
+ function inverse(frame, vector) {
197
+ const local = Quaternion_1.Quaternion.rotateVector(Quaternion_1.Quaternion.inverse(frame.rotation), vector);
198
+ return Quaternion_1.Quaternion.rotateVector(frame.rotation, {
199
+ x: local.x / frame.moments.x,
200
+ y: local.y / frame.moments.y,
201
+ z: local.z / frame.moments.z,
202
+ });
203
+ }
204
+ //# sourceMappingURL=integrateAirborneRotation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integrateAirborneRotation.js","sourceRoot":"","sources":["../../src/motion/integrateAirborneRotation.ts"],"names":[],"mappings":"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"}