@automovie/engine 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (966) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/analysis/index.d.ts +5 -0
  4. package/lib/analysis/index.js +5 -0
  5. package/lib/analysis/index.js.map +1 -1
  6. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  7. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  8. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  9. package/lib/anthropometry/index.d.ts +1 -0
  10. package/lib/anthropometry/index.js +18 -0
  11. package/lib/anthropometry/index.js.map +1 -0
  12. package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
  13. package/lib/architecture/appendBuiltRegionDefects.js +3 -3
  14. package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
  15. package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
  16. package/lib/architecture/builtOutlineIsClosed.js +3 -3
  17. package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
  18. package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
  19. package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
  20. package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
  21. package/lib/architecture/constants/index.d.ts +1 -1
  22. package/lib/architecture/constants/index.js +1 -1
  23. package/lib/architecture/constants/index.js.map +1 -1
  24. package/lib/architecture/index.d.ts +157 -117
  25. package/lib/architecture/index.js +171 -158
  26. package/lib/architecture/index.js.map +1 -1
  27. package/lib/cache/index.d.ts +9 -0
  28. package/lib/cache/index.js +26 -0
  29. package/lib/cache/index.js.map +1 -0
  30. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  31. package/lib/composition/AutoMovieComposition.js +4 -3
  32. package/lib/composition/AutoMovieComposition.js.map +1 -1
  33. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  34. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  35. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  36. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  37. package/lib/composition/AutoMovieScheduleError.js +51 -0
  38. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  39. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  40. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  41. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  42. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  43. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  44. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  45. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  46. package/lib/composition/index.d.ts +12 -7
  47. package/lib/composition/index.js +12 -2
  48. package/lib/composition/index.js.map +1 -1
  49. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  50. package/lib/composition/markAutoMovieContacts.js +69 -0
  51. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  52. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  53. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  54. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  55. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  56. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  57. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  58. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  59. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  60. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  61. package/lib/constants/index.d.ts +2 -0
  62. package/lib/constants/index.js +2 -0
  63. package/lib/constants/index.js.map +1 -1
  64. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  65. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  66. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  67. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  68. package/lib/drawing/index.d.ts +12 -0
  69. package/lib/drawing/index.js +12 -0
  70. package/lib/drawing/index.js.map +1 -1
  71. package/lib/effectRuntime/index.d.ts +7 -0
  72. package/lib/effectRuntime/index.js +7 -0
  73. package/lib/effectRuntime/index.js.map +1 -1
  74. package/lib/film/compileAttach.js +2 -5
  75. package/lib/film/compileAttach.js.map +1 -1
  76. package/lib/film/compileLaunch.d.ts +2 -2
  77. package/lib/film/compileLaunch.js +4 -3
  78. package/lib/film/compileLaunch.js.map +1 -1
  79. package/lib/film/constants/index.d.ts +3 -0
  80. package/lib/film/constants/index.js +3 -0
  81. package/lib/film/constants/index.js.map +1 -1
  82. package/lib/film/index.d.ts +61 -6
  83. package/lib/film/index.js +61 -12
  84. package/lib/film/index.js.map +1 -1
  85. package/lib/film/propAnchorFrame.js +6 -9
  86. package/lib/film/propAnchorFrame.js.map +1 -1
  87. package/lib/film/stageScene.js +3 -10
  88. package/lib/film/stageScene.js.map +1 -1
  89. package/lib/film/staging/index.d.ts +11 -0
  90. package/lib/film/staging/index.js +28 -0
  91. package/lib/film/staging/index.js.map +1 -0
  92. package/lib/film/staging/lowerLightPlacement.js +4 -7
  93. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  94. package/lib/formationSlotPosition.d.ts +6 -1
  95. package/lib/formationSlotPosition.js +38 -3
  96. package/lib/formationSlotPosition.js.map +1 -1
  97. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  98. package/lib/geometry/IAutoMovieMark.js +3 -0
  99. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  100. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  101. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  102. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  103. package/lib/geometry/constants/index.d.ts +2 -0
  104. package/lib/geometry/constants/index.js +2 -0
  105. package/lib/geometry/constants/index.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  107. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  108. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  109. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  110. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  111. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  112. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  113. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  114. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  115. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  116. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  117. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  118. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  120. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  121. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  123. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  124. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  125. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  126. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  127. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  128. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  129. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  130. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  131. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  132. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  133. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  135. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  136. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  137. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  138. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  139. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  140. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  141. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  142. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  143. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  144. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  145. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  146. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  147. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  148. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  149. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  150. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  151. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  152. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  153. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  154. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  155. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  156. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  157. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  158. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  159. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  160. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  161. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  162. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  163. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  164. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  165. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  166. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  167. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  168. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  169. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  170. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  171. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  172. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  173. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  174. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  175. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  176. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  177. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  178. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  179. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  180. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  181. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  182. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  183. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  184. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  185. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  186. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  187. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  188. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  189. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  190. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  191. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  192. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  193. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  194. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  195. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  196. package/lib/geometry/construction/index.d.ts +82 -2
  197. package/lib/geometry/construction/index.js +82 -2
  198. package/lib/geometry/construction/index.js.map +1 -1
  199. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  200. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  201. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  202. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  203. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  204. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  205. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  206. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  207. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  208. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  209. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  210. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  211. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  212. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  213. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  214. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  215. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  216. package/lib/geometry/curve/index.d.ts +48 -25
  217. package/lib/geometry/curve/index.js +48 -25
  218. package/lib/geometry/curve/index.js.map +1 -1
  219. package/lib/geometry/extract/index.d.ts +0 -1
  220. package/lib/geometry/extract/index.js +0 -1
  221. package/lib/geometry/extract/index.js.map +1 -1
  222. package/lib/geometry/index.d.ts +87 -53
  223. package/lib/geometry/index.js +87 -50
  224. package/lib/geometry/index.js.map +1 -1
  225. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  226. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  227. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  228. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  229. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  230. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  231. package/lib/geometry/sweep/index.d.ts +54 -15
  232. package/lib/geometry/sweep/index.js +54 -1
  233. package/lib/geometry/sweep/index.js.map +1 -1
  234. package/lib/index.d.ts +41 -450
  235. package/lib/index.js +41 -660
  236. package/lib/index.js.map +1 -1
  237. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  238. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  239. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  240. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  241. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  242. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  243. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  244. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  245. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  246. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  247. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  248. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  249. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  250. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  251. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  252. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  253. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  254. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  255. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  256. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  257. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  258. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  259. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  260. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  261. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  262. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  263. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  264. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  265. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  266. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  267. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  268. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  269. package/lib/kinematics/curlChainUntilContact.js +45 -5
  270. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  271. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  272. package/lib/kinematics/decomposeJointRotation.js +10 -131
  273. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  274. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  275. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  276. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  277. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  278. package/lib/kinematics/fitDigitDescent.js +142 -0
  279. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  280. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  281. package/lib/kinematics/fitDigitToTarget.js +251 -0
  282. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  283. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  284. package/lib/kinematics/hingedArmArticulation.js +273 -84
  285. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  286. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  287. package/lib/kinematics/hingedArmSwivel.js +196 -0
  288. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  289. package/lib/kinematics/index.d.ts +30 -7
  290. package/lib/kinematics/index.js +30 -5
  291. package/lib/kinematics/index.js.map +1 -1
  292. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  293. package/lib/kinematics/jointRomOvershoot.js +21 -17
  294. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  295. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  296. package/lib/kinematics/jointToQuaternion.js +4 -19
  297. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  298. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  299. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  300. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  301. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  302. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  303. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  304. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  305. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  306. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  307. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  308. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  309. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  310. package/lib/kinematics/normalizeJointAxes.js +52 -12
  311. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  312. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  313. package/lib/kinematics/poseJointCodec.js +70 -0
  314. package/lib/kinematics/poseJointCodec.js.map +1 -0
  315. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  316. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  317. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  318. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  319. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  320. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  321. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  322. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  323. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  324. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  325. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  326. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  327. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  328. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  329. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  330. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  331. package/lib/kinematics/swingTwistBasis.js +116 -0
  332. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  333. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  334. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  335. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  336. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  337. package/lib/kinematics/swingTwistRange.js +322 -0
  338. package/lib/kinematics/swingTwistRange.js.map +1 -0
  339. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  340. package/lib/kinematics/swingTwistRegion.js +212 -0
  341. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  342. package/lib/kinematics/swivelArcs.d.ts +166 -0
  343. package/lib/kinematics/swivelArcs.js +200 -0
  344. package/lib/kinematics/swivelArcs.js.map +1 -0
  345. package/lib/math/Quaternion.d.ts +29 -2
  346. package/lib/math/Quaternion.js +33 -2
  347. package/lib/math/Quaternion.js.map +1 -1
  348. package/lib/math/Transform.d.ts +50 -0
  349. package/lib/math/Transform.js +58 -0
  350. package/lib/math/Transform.js.map +1 -0
  351. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  352. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  353. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  354. package/lib/math/bracketedBisection.d.ts +33 -0
  355. package/lib/math/bracketedBisection.js +52 -0
  356. package/lib/math/bracketedBisection.js.map +1 -0
  357. package/lib/math/bracketedRoot.d.ts +32 -0
  358. package/lib/math/bracketedRoot.js +76 -0
  359. package/lib/math/bracketedRoot.js.map +1 -0
  360. package/lib/math/constants/index.d.ts +1 -0
  361. package/lib/math/constants/index.js +18 -0
  362. package/lib/math/constants/index.js.map +1 -0
  363. package/lib/math/index.d.ts +64 -5
  364. package/lib/math/index.js +64 -5
  365. package/lib/math/index.js.map +1 -1
  366. package/lib/math/nearestAngleAlias.d.ts +27 -0
  367. package/lib/math/nearestAngleAlias.js +44 -0
  368. package/lib/math/nearestAngleAlias.js.map +1 -0
  369. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  370. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  371. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  372. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  373. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  374. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  375. package/lib/measureAutoMovieGeometryReach.js +2 -4
  376. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  377. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  378. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  379. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  380. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  381. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  382. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  383. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  384. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  385. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  386. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  387. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  388. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  389. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  390. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  391. package/lib/motion/basisOf.d.ts +18 -0
  392. package/lib/motion/basisOf.js +25 -0
  393. package/lib/motion/basisOf.js.map +1 -0
  394. package/lib/motion/carriedAcceleration.d.ts +43 -0
  395. package/lib/motion/carriedAcceleration.js +55 -0
  396. package/lib/motion/carriedAcceleration.js.map +1 -0
  397. package/lib/motion/carriedRate.d.ts +48 -0
  398. package/lib/motion/carriedRate.js +60 -0
  399. package/lib/motion/carriedRate.js.map +1 -0
  400. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  401. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  402. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  403. package/lib/motion/constants/index.d.ts +1 -0
  404. package/lib/motion/constants/index.js +1 -0
  405. package/lib/motion/constants/index.js.map +1 -1
  406. package/lib/motion/fitChainBend.d.ts +23 -0
  407. package/lib/motion/fitChainBend.js +293 -0
  408. package/lib/motion/fitChainBend.js.map +1 -0
  409. package/lib/motion/fitChainToTarget.d.ts +11 -13
  410. package/lib/motion/fitChainToTarget.js +12 -283
  411. package/lib/motion/fitChainToTarget.js.map +1 -1
  412. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  413. package/lib/motion/fitHingedChainCandidate.js +186 -76
  414. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  415. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  416. package/lib/motion/fitHingedRotationError.js +107 -0
  417. package/lib/motion/fitHingedRotationError.js.map +1 -0
  418. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  419. package/lib/motion/fitSeededChainToTarget.js +32 -0
  420. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  421. package/lib/motion/gaitMotion.js +7 -13
  422. package/lib/motion/gaitMotion.js.map +1 -1
  423. package/lib/motion/gestureMotion.js +2 -5
  424. package/lib/motion/gestureMotion.js.map +1 -1
  425. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  426. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  427. package/lib/motion/index.d.ts +40 -9
  428. package/lib/motion/index.js +40 -12
  429. package/lib/motion/index.js.map +1 -1
  430. package/lib/motion/inertializeOffset.d.ts +15 -2
  431. package/lib/motion/inertializeOffset.js +16 -3
  432. package/lib/motion/inertializeOffset.js.map +1 -1
  433. package/lib/motion/inertializePose.d.ts +36 -13
  434. package/lib/motion/inertializePose.js +122 -43
  435. package/lib/motion/inertializePose.js.map +1 -1
  436. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  437. package/lib/motion/integrateAirborneRotation.js +204 -0
  438. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  439. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  440. package/lib/motion/integrateMotionTrajectory.js +156 -0
  441. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  442. package/lib/motion/orientChainEffector.d.ts +1 -1
  443. package/lib/motion/orientChainEffector.js +15 -7
  444. package/lib/motion/orientChainEffector.js.map +1 -1
  445. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  446. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  447. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  448. package/lib/motion/sampleMotion.js +2 -5
  449. package/lib/motion/sampleMotion.js.map +1 -1
  450. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  451. package/lib/motion/samplePoseVelocity.js +126 -38
  452. package/lib/motion/samplePoseVelocity.js.map +1 -1
  453. package/lib/motion/smoothMinimum.d.ts +29 -0
  454. package/lib/motion/smoothMinimum.js +40 -0
  455. package/lib/motion/smoothMinimum.js.map +1 -0
  456. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  457. package/lib/motion/solveAirborneTakeoff.js +324 -0
  458. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  459. package/lib/motion/solveDistalTwist.d.ts +62 -0
  460. package/lib/motion/solveDistalTwist.js +152 -0
  461. package/lib/motion/solveDistalTwist.js.map +1 -0
  462. package/lib/motion/speedProfile.d.ts +175 -0
  463. package/lib/motion/speedProfile.js +261 -0
  464. package/lib/motion/speedProfile.js.map +1 -0
  465. package/lib/motion/splitDistalTwist.d.ts +12 -17
  466. package/lib/motion/splitDistalTwist.js +37 -40
  467. package/lib/motion/splitDistalTwist.js.map +1 -1
  468. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  469. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  470. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  471. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  472. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  473. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  474. package/lib/perform/index.d.ts +10 -0
  475. package/lib/perform/index.js +10 -0
  476. package/lib/perform/index.js.map +1 -1
  477. package/lib/physics/AutoMovieAir.d.ts +21 -0
  478. package/lib/physics/AutoMovieAir.js +26 -0
  479. package/lib/physics/AutoMovieAir.js.map +1 -0
  480. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  481. package/lib/physics/AutoMovieGravity.js +30 -0
  482. package/lib/physics/AutoMovieGravity.js.map +1 -0
  483. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  484. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  485. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  486. package/lib/physics/admitMotionGeometry.js +12 -0
  487. package/lib/physics/admitMotionGeometry.js.map +1 -1
  488. package/lib/physics/bindPhysicalWorld.js +16 -4
  489. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  490. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  491. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  492. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  493. package/lib/physics/deriveCenterOfMass.js +2 -5
  494. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  495. package/lib/physics/derivePhysicalProfile.js +7 -5
  496. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  497. package/lib/physics/index.d.ts +155 -2
  498. package/lib/physics/index.js +155 -2
  499. package/lib/physics/index.js.map +1 -1
  500. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  501. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  502. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  503. package/lib/physics/physicalHullErode.d.ts +25 -0
  504. package/lib/physics/physicalHullErode.js +54 -0
  505. package/lib/physics/physicalHullErode.js.map +1 -0
  506. package/lib/physics/physicalHullFaces.d.ts +56 -0
  507. package/lib/physics/physicalHullFaces.js +151 -0
  508. package/lib/physics/physicalHullFaces.js.map +1 -0
  509. package/lib/physics/physicalHullMass.d.ts +32 -0
  510. package/lib/physics/physicalHullMass.js +80 -0
  511. package/lib/physics/physicalHullMass.js.map +1 -0
  512. package/lib/physics/physicalHullNearest.d.ts +37 -0
  513. package/lib/physics/physicalHullNearest.js +178 -0
  514. package/lib/physics/physicalHullNearest.js.map +1 -0
  515. package/lib/physics/physicalHullSegment.d.ts +34 -0
  516. package/lib/physics/physicalHullSegment.js +276 -0
  517. package/lib/physics/physicalHullSegment.js.map +1 -0
  518. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  519. package/lib/physics/physicalInertiaTensor.js +58 -0
  520. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  521. package/lib/physics/physicalNativeShape.d.ts +1 -1
  522. package/lib/physics/physicalNativeShape.js +15 -4
  523. package/lib/physics/physicalNativeShape.js.map +1 -1
  524. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  525. package/lib/physics/physicalPrincipalAxes.js +96 -0
  526. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  527. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  528. package/lib/physics/physicalShapeBounds.js +26 -2
  529. package/lib/physics/physicalShapeBounds.js.map +1 -1
  530. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  531. package/lib/physics/physicalShapeNearest.js +201 -0
  532. package/lib/physics/physicalShapeNearest.js.map +1 -0
  533. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  534. package/lib/physics/physicalShapeNormal.js +70 -0
  535. package/lib/physics/physicalShapeNormal.js.map +1 -0
  536. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  537. package/lib/physics/physicalShapePairDistance.js +124 -0
  538. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  539. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  540. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  541. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  542. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  543. package/lib/physics/physicalShapeSpan.js +55 -0
  544. package/lib/physics/physicalShapeSpan.js.map +1 -0
  545. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  546. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  547. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  548. package/lib/physics/projectileAt.d.ts +14 -12
  549. package/lib/physics/projectileAt.js +46 -16
  550. package/lib/physics/projectileAt.js.map +1 -1
  551. package/lib/physics/projectileContinue.d.ts +114 -0
  552. package/lib/physics/projectileContinue.js +189 -0
  553. package/lib/physics/projectileContinue.js.map +1 -0
  554. package/lib/physics/projectileDragFlight.d.ts +72 -0
  555. package/lib/physics/projectileDragFlight.js +166 -0
  556. package/lib/physics/projectileDragFlight.js.map +1 -0
  557. package/lib/physics/projectileFirstContact.d.ts +105 -0
  558. package/lib/physics/projectileFirstContact.js +174 -0
  559. package/lib/physics/projectileFirstContact.js.map +1 -0
  560. package/lib/physics/projectileTrajectory.js +3 -2
  561. package/lib/physics/projectileTrajectory.js.map +1 -1
  562. package/lib/physics/solveBallisticLaunch.js +2 -1
  563. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  564. package/lib/physics/solveMovingLaunch.js +2 -1
  565. package/lib/physics/solveMovingLaunch.js.map +1 -1
  566. package/lib/physics/validatePhysicalProfile.js +18 -1
  567. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  568. package/lib/populationRuntime/index.d.ts +6 -0
  569. package/lib/populationRuntime/index.js +6 -0
  570. package/lib/populationRuntime/index.js.map +1 -1
  571. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  572. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  573. package/lib/random/index.d.ts +1 -1
  574. package/lib/random/index.js +1 -0
  575. package/lib/random/index.js.map +1 -1
  576. package/lib/render/index.d.ts +20 -11
  577. package/lib/render/index.js +20 -11
  578. package/lib/render/index.js.map +1 -1
  579. package/lib/resolve/index.d.ts +7 -2
  580. package/lib/resolve/index.js +7 -5
  581. package/lib/resolve/index.js.map +1 -1
  582. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  583. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  584. package/lib/rom/clampJointRom.d.ts +11 -3
  585. package/lib/rom/clampJointRom.js +43 -3
  586. package/lib/rom/clampJointRom.js.map +1 -1
  587. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  588. package/lib/rom/clampJointToSkeleton.js +39 -8
  589. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  590. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  591. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  592. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  593. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  594. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  595. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  596. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  597. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  598. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  599. package/lib/rom/constants/index.d.ts +2 -0
  600. package/lib/rom/constants/index.js +2 -0
  601. package/lib/rom/constants/index.js.map +1 -1
  602. package/lib/rom/index.d.ts +1 -0
  603. package/lib/rom/index.js +1 -0
  604. package/lib/rom/index.js.map +1 -1
  605. package/lib/rom/scanJointRom.d.ts +62 -0
  606. package/lib/rom/scanJointRom.js +117 -0
  607. package/lib/rom/scanJointRom.js.map +1 -0
  608. package/lib/rom/validateJointRom.d.ts +4 -2
  609. package/lib/rom/validateJointRom.js +23 -45
  610. package/lib/rom/validateJointRom.js.map +1 -1
  611. package/lib/service/index.d.ts +9 -0
  612. package/lib/service/index.js +9 -0
  613. package/lib/service/index.js.map +1 -1
  614. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  615. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  616. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  617. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  618. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  619. package/lib/soft/applySoftBodyFriction.js +52 -0
  620. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  621. package/lib/soft/index.d.ts +22 -0
  622. package/lib/soft/index.js +22 -0
  623. package/lib/soft/index.js.map +1 -1
  624. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  625. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  626. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  627. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  628. package/lib/soft/simulateSoftBodyCore.js +108 -16
  629. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  630. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  631. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  632. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  633. package/lib/soft/softBodyBudget.js +7 -0
  634. package/lib/soft/softBodyBudget.js.map +1 -1
  635. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  636. package/lib/soft/softBodyHeldLoads.js +69 -0
  637. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  638. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  639. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  640. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  641. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  642. package/lib/soft/validateSoftAnchors.js +74 -0
  643. package/lib/soft/validateSoftAnchors.js.map +1 -0
  644. package/lib/soft/validateSoftBodyDomain.js +6 -48
  645. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  646. package/lib/soft/validateSoftBounded.d.ts +20 -0
  647. package/lib/soft/validateSoftBounded.js +27 -0
  648. package/lib/soft/validateSoftBounded.js.map +1 -0
  649. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  650. package/lib/soft/validateSoftCompliance.js +54 -0
  651. package/lib/soft/validateSoftCompliance.js.map +1 -0
  652. package/lib/sound/index.d.ts +2 -0
  653. package/lib/sound/index.js +2 -0
  654. package/lib/sound/index.js.map +1 -1
  655. package/lib/text/index.d.ts +1 -0
  656. package/lib/text/index.js +1 -0
  657. package/lib/text/index.js.map +1 -1
  658. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  659. package/lib/validation/AffordanceArticulation.js +142 -0
  660. package/lib/validation/AffordanceArticulation.js.map +1 -0
  661. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  662. package/lib/validation/affordanceFollowedTravel.js +43 -0
  663. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  664. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  665. package/lib/validation/affordanceLeadingTravel.js +99 -0
  666. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  667. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  668. package/lib/validation/affordanceTravelRange.js +39 -0
  669. package/lib/validation/affordanceTravelRange.js.map +1 -0
  670. package/lib/validation/appendShotEventsArtifact.js +12 -0
  671. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  672. package/lib/validation/constants/index.d.ts +3 -3
  673. package/lib/validation/constants/index.js +3 -3
  674. package/lib/validation/constants/index.js.map +1 -1
  675. package/lib/validation/detectFreeFall.js +2 -1
  676. package/lib/validation/detectFreeFall.js.map +1 -1
  677. package/lib/validation/index.d.ts +52 -4
  678. package/lib/validation/index.js +52 -6
  679. package/lib/validation/index.js.map +1 -1
  680. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  681. package/lib/validation/markAutoMovieSlip.js +52 -0
  682. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  683. package/lib/validation/validateAffordance.d.ts +3 -3
  684. package/lib/validation/validateAffordance.js +21 -3
  685. package/lib/validation/validateAffordance.js.map +1 -1
  686. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  687. package/lib/validation/validateAffordanceArticulation.js +183 -0
  688. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  689. package/lib/validation/validateBalanceSupport.d.ts +1 -2
  690. package/lib/validation/validateBalanceSupport.js.map +1 -1
  691. package/lib/validation/validateBody.d.ts +2 -2
  692. package/lib/validation/validateBody.js +27 -3
  693. package/lib/validation/validateBody.js.map +1 -1
  694. package/lib/validation/validateFootSkate.d.ts +1 -2
  695. package/lib/validation/validateFootSkate.js.map +1 -1
  696. package/lib/validation/validateGroundContact.d.ts +1 -2
  697. package/lib/validation/validateGroundContact.js.map +1 -1
  698. package/lib/validation/validateJointConstraint.d.ts +1 -1
  699. package/lib/validation/validateJointConstraint.js +9 -1
  700. package/lib/validation/validateJointConstraint.js.map +1 -1
  701. package/lib/validation/validateModel.js +2 -0
  702. package/lib/validation/validateModel.js.map +1 -1
  703. package/lib/validation/validateSelfIntersection.d.ts +1 -2
  704. package/lib/validation/validateSelfIntersection.js.map +1 -1
  705. package/lib/worldBlock.js +6 -9
  706. package/lib/worldBlock.js.map +1 -1
  707. package/package.json +6 -6
  708. package/src/IAutoMovieFormationPlacement.ts +4 -3
  709. package/src/analysis/index.ts +5 -0
  710. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  711. package/src/anthropometry/index.ts +1 -0
  712. package/src/architecture/appendBuiltRegionDefects.ts +3 -3
  713. package/src/architecture/builtOutlineIsClosed.ts +3 -3
  714. package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
  715. package/src/architecture/constants/index.ts +1 -1
  716. package/src/architecture/index.ts +157 -117
  717. package/src/cache/index.ts +9 -0
  718. package/src/composition/AutoMovieComposition.ts +34 -7
  719. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  720. package/src/composition/AutoMovieScheduleError.ts +108 -0
  721. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  722. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  723. package/src/composition/IAutoMovieIntent.ts +9 -7
  724. package/src/composition/index.ts +12 -7
  725. package/src/composition/markAutoMovieContacts.ts +79 -0
  726. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  727. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  728. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  729. package/src/constants/index.ts +2 -0
  730. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  731. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  732. package/src/drawing/index.ts +12 -0
  733. package/src/effectRuntime/index.ts +7 -0
  734. package/src/film/compileAttach.ts +2 -5
  735. package/src/film/compileLaunch.ts +5 -4
  736. package/src/film/constants/index.ts +3 -0
  737. package/src/film/index.ts +61 -6
  738. package/src/film/propAnchorFrame.ts +3 -6
  739. package/src/film/stageScene.ts +3 -10
  740. package/src/film/staging/index.ts +11 -0
  741. package/src/film/staging/lowerLightPlacement.ts +3 -7
  742. package/src/formationSlotPosition.ts +54 -7
  743. package/src/geometry/IAutoMovieMark.ts +115 -0
  744. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  745. package/src/geometry/constants/index.ts +2 -0
  746. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  747. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  748. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  749. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  750. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  751. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  752. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  753. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  754. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  755. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  756. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  757. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  758. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  759. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  760. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  761. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  762. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  763. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  764. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  765. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  766. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  767. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  768. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  769. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  770. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  771. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  772. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  773. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  774. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  775. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  776. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  777. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  778. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  779. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  780. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  781. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  782. package/src/geometry/construction/index.ts +82 -2
  783. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  784. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  785. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  786. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  787. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  788. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  789. package/src/geometry/curve/index.ts +48 -25
  790. package/src/geometry/extract/index.ts +0 -1
  791. package/src/geometry/index.ts +87 -53
  792. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  793. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  794. package/src/geometry/sweep/index.ts +54 -15
  795. package/src/index.ts +41 -450
  796. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  797. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  798. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  799. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  800. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  801. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  802. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  803. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  804. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  805. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  806. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  807. package/src/kinematics/curlChainUntilContact.ts +35 -8
  808. package/src/kinematics/decomposeJointRotation.ts +15 -178
  809. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  810. package/src/kinematics/fitDigitDescent.ts +253 -0
  811. package/src/kinematics/fitDigitToTarget.ts +425 -0
  812. package/src/kinematics/hingedArmArticulation.ts +402 -116
  813. package/src/kinematics/hingedArmSwivel.ts +295 -0
  814. package/src/kinematics/index.ts +30 -12
  815. package/src/kinematics/jointRomOvershoot.ts +30 -19
  816. package/src/kinematics/jointToQuaternion.ts +8 -43
  817. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  818. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  819. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  820. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  821. package/src/kinematics/normalizeJointAxes.ts +66 -12
  822. package/src/kinematics/poseJointCodec.ts +148 -0
  823. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  824. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  825. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  826. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  827. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  828. package/src/kinematics/swingTwistBasis.ts +162 -0
  829. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  830. package/src/kinematics/swingTwistRange.ts +460 -0
  831. package/src/kinematics/swingTwistRegion.ts +298 -0
  832. package/src/kinematics/swivelArcs.ts +245 -0
  833. package/src/math/Quaternion.ts +42 -2
  834. package/src/math/Transform.ts +65 -0
  835. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  836. package/src/math/bracketedBisection.ts +51 -0
  837. package/src/math/bracketedRoot.ts +72 -0
  838. package/src/math/constants/index.ts +1 -0
  839. package/src/math/index.ts +64 -5
  840. package/src/math/nearestAngleAlias.ts +43 -0
  841. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  842. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  843. package/src/measureAutoMovieGeometryReach.ts +2 -4
  844. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  845. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  846. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  847. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  848. package/src/motion/IFitChainToTargetProps.ts +67 -0
  849. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  850. package/src/motion/basisOf.ts +29 -0
  851. package/src/motion/carriedAcceleration.ts +56 -0
  852. package/src/motion/carriedRate.ts +61 -0
  853. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  854. package/src/motion/constants/index.ts +1 -0
  855. package/src/motion/fitChainBend.ts +491 -0
  856. package/src/motion/fitChainToTarget.ts +13 -485
  857. package/src/motion/fitHingedChainCandidate.ts +281 -148
  858. package/src/motion/fitHingedRotationError.ts +164 -0
  859. package/src/motion/fitSeededChainToTarget.ts +34 -0
  860. package/src/motion/gaitMotion.ts +6 -10
  861. package/src/motion/gestureMotion.ts +2 -5
  862. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  863. package/src/motion/index.ts +40 -9
  864. package/src/motion/inertializeOffset.ts +16 -2
  865. package/src/motion/inertializePose.ts +158 -53
  866. package/src/motion/integrateAirborneRotation.ts +334 -0
  867. package/src/motion/integrateMotionTrajectory.ts +309 -0
  868. package/src/motion/orientChainEffector.ts +19 -13
  869. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  870. package/src/motion/sampleMotion.ts +2 -5
  871. package/src/motion/samplePoseVelocity.ts +168 -41
  872. package/src/motion/smoothMinimum.ts +36 -0
  873. package/src/motion/solveAirborneTakeoff.ts +471 -0
  874. package/src/motion/solveDistalTwist.ts +256 -0
  875. package/src/motion/speedProfile.ts +470 -0
  876. package/src/motion/splitDistalTwist.ts +55 -64
  877. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  878. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  879. package/src/perform/index.ts +10 -0
  880. package/src/physics/AutoMovieAir.ts +22 -0
  881. package/src/physics/AutoMovieGravity.ts +28 -0
  882. package/src/physics/IAutoMovieHit.ts +13 -7
  883. package/src/physics/IAutoMovieProjectile.ts +82 -6
  884. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  885. package/src/physics/admitMotionGeometry.ts +16 -0
  886. package/src/physics/bindPhysicalWorld.ts +22 -11
  887. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  888. package/src/physics/deriveCenterOfMass.ts +2 -5
  889. package/src/physics/derivePhysicalProfile.ts +3 -1
  890. package/src/physics/index.ts +155 -2
  891. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  892. package/src/physics/physicalHullErode.ts +72 -0
  893. package/src/physics/physicalHullFaces.ts +215 -0
  894. package/src/physics/physicalHullMass.ts +99 -0
  895. package/src/physics/physicalHullNearest.ts +210 -0
  896. package/src/physics/physicalHullSegment.ts +338 -0
  897. package/src/physics/physicalInertiaTensor.ts +75 -0
  898. package/src/physics/physicalNativeShape.ts +31 -9
  899. package/src/physics/physicalPrincipalAxes.ts +114 -0
  900. package/src/physics/physicalShapeBounds.ts +24 -2
  901. package/src/physics/physicalShapeNearest.ts +287 -0
  902. package/src/physics/physicalShapeNormal.ts +105 -0
  903. package/src/physics/physicalShapePairDistance.ts +153 -0
  904. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  905. package/src/physics/physicalShapeSpan.ts +75 -0
  906. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  907. package/src/physics/projectileAt.ts +61 -20
  908. package/src/physics/projectileContinue.ts +287 -0
  909. package/src/physics/projectileDragFlight.ts +208 -0
  910. package/src/physics/projectileFirstContact.ts +286 -0
  911. package/src/physics/projectileTrajectory.ts +6 -5
  912. package/src/physics/solveBallisticLaunch.ts +2 -1
  913. package/src/physics/solveMovingLaunch.ts +2 -1
  914. package/src/physics/validatePhysicalProfile.ts +20 -1
  915. package/src/populationRuntime/index.ts +6 -0
  916. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  917. package/src/random/index.ts +1 -1
  918. package/src/render/index.ts +20 -11
  919. package/src/resolve/index.ts +7 -2
  920. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  921. package/src/rom/clampJointRom.ts +59 -2
  922. package/src/rom/clampJointToSkeleton.ts +52 -15
  923. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  924. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  925. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  926. package/src/rom/constants/index.ts +2 -0
  927. package/src/rom/index.ts +1 -0
  928. package/src/rom/scanJointRom.ts +169 -0
  929. package/src/rom/validateJointRom.ts +69 -74
  930. package/src/service/index.ts +9 -0
  931. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  932. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  933. package/src/soft/applySoftBodyFriction.ts +65 -0
  934. package/src/soft/index.ts +22 -0
  935. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  936. package/src/soft/simulateSoftBodyCore.ts +127 -15
  937. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  938. package/src/soft/softBodyBudget.ts +11 -0
  939. package/src/soft/softBodyHeldLoads.ts +85 -0
  940. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  941. package/src/soft/validateSoftAnchors.ts +143 -0
  942. package/src/soft/validateSoftBodyDomain.ts +5 -124
  943. package/src/soft/validateSoftBounded.ts +42 -0
  944. package/src/soft/validateSoftCompliance.ts +102 -0
  945. package/src/sound/index.ts +2 -0
  946. package/src/text/index.ts +1 -0
  947. package/src/validation/AffordanceArticulation.ts +173 -0
  948. package/src/validation/affordanceFollowedTravel.ts +40 -0
  949. package/src/validation/affordanceLeadingTravel.ts +108 -0
  950. package/src/validation/affordanceTravelRange.ts +42 -0
  951. package/src/validation/appendShotEventsArtifact.ts +26 -0
  952. package/src/validation/constants/index.ts +3 -3
  953. package/src/validation/detectFreeFall.ts +3 -2
  954. package/src/validation/index.ts +52 -4
  955. package/src/validation/markAutoMovieSlip.ts +65 -0
  956. package/src/validation/validateAffordance.ts +38 -3
  957. package/src/validation/validateAffordanceArticulation.ts +311 -0
  958. package/src/validation/validateBalanceSupport.ts +2 -5
  959. package/src/validation/validateBody.ts +80 -3
  960. package/src/validation/validateFootSkate.ts +1 -1
  961. package/src/validation/validateGroundContact.ts +2 -5
  962. package/src/validation/validateJointConstraint.ts +19 -1
  963. package/src/validation/validateModel.ts +7 -0
  964. package/src/validation/validateSelfIntersection.ts +2 -5
  965. package/src/worldBlock.ts +3 -6
  966. package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
@@ -0,0 +1,112 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * What an impulse does to a standing body's balance (#3429): it absorbs it
4
+ * within its base, catches it with capture steps, or falls.
5
+ *
6
+ * The impulse `J` changes the centre of mass's velocity to `v + J / m` and
7
+ * its angular momentum about the centre by `(p - c) × J`. The body is a
8
+ * linear inverted pendulum of length `l` with eigenfrequency `ω0 = sqrt(g /
9
+ * l)`, whose extrapolated centre `ξ = x + v / ω0` must lie within the base
10
+ * of support for the body to stay (Hof, Gazendam and Sinke 2005, J Biomech
11
+ * 38:1-8): inside the support polygon, the body absorbs the push.
12
+ *
13
+ * Outside it, the body steps, the capture point `ξ` diverging from the
14
+ * centre of pressure as the pendulum does, `d(t) = d0 exp(ω0 t)` (the
15
+ * capture point of Pratt, Carff, Drakunov and Goswami 2006, as the stepping
16
+ * literature states it): until the first foot lands, `first` after the
17
+ * impulse, the centre of pressure is held at the base's edge along the lead,
18
+ * so `d0` is the capture point's distance beyond that edge. A foot lands at
19
+ * most `reach` (a leg length, as `stagger` reaches) beyond the last centre
20
+ * of pressure and catches the capture point within its half length,
21
+ * `margin`; one that falls short moves the centre of pressure to its front
22
+ * edge, `reach + margin` on, and leaves the rest to diverge over the next
23
+ * swing, `step`: `d_{k+1} = (d_k - reach - margin) exp(ω0 step)`. The
24
+ * recurrence shrinks to a catch exactly when the first landing's distance is
25
+ * below its fixed point `d* = (reach + margin) a / (a - 1)`, `a = exp(ω0
26
+ * step)`, the infinite-step capture distance in the framework of Koolen, de
27
+ * Boer, Rebula, Goswami and Pratt 2012 ("Capturability-based analysis and
28
+ * control of legged locomotion, Part 1", Int J Robot Res 31(9)); at or past
29
+ * it no number of steps catches the body and it falls. Both papers are
30
+ * located, not yet read at the source; the recurrence is derived here from
31
+ * the linear inverted pendulum's divergence. The steps are laid along the
32
+ * lead from the base's edge.
33
+ *
34
+ * The bounds are the impulse magnitudes along the push's horizontal
35
+ * direction at which the outcome changes: `m ω0 b` to leave the base, with
36
+ * `b` the distance from the current extrapolated centre to the base's edge
37
+ * along the push, and `m ω0 (e + d* exp(-ω0 first) - lead)` to leave the
38
+ * capture region, with `e` the centre's distance to the base's edge along
39
+ * the push and `lead` the current extrapolated centre's distance from the
40
+ * centre.
41
+ * * @param props The body's state, the impulse and the support.
42
+ * @returns The outcome, the steps and the bounds.
43
+ * @throws {Error} When the mass, the length, the reach or the step time is not positive, or there is no support point.
44
+ *
45
+ * @evidence contracts/development/common.md#meaningful-documentation States the impulse's effect, the pendulum, the absorb condition with its source, the capture point's divergence, the stepping recurrence with its sources and fixed point, where steps are laid and the bounds.
46
+ * @evidence contracts/development/implementation.md#principled-implementation Hof's extrapolated centre against the support polygon for absorption; the linear inverted pendulum's capture point diverging from a centre of pressure held at the base's edge until the first landing and at each landed foot's front edge between swings, the N-step capture of Koolen et al.'s framework (located, not yet read at the source), whose fixed point is the infinite-step capture distance.
47
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The state after the impulse, the absorb test, the stepping recurrence, the bounds.
48
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No count of steps is assumed: the recurrence itself ends in a catch or diverges, so the outcome follows from the impulse alone.
49
+ * @evidence contracts/development/implementation.md#efficient-algorithms One hull of the support and a recurrence whose length is the number of steps it lays.
50
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its inputs.
51
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
52
+ */
53
+ export declare function resolveAutoMovieBalanceOutcome(props: resolveAutoMovieBalanceOutcome.IProps): resolveAutoMovieBalanceOutcome.IOutcome;
54
+ /**
55
+ * Companion types of {@link resolveAutoMovieBalanceOutcome}.
56
+ *
57
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its frame, unit and meaning.
58
+ * @evidence contracts/development/design.md#principled-representation The body's state at the impulse as the pendulum sees it, and the outcome as a closed union with its steps and bounds.
59
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What the force input (#3429) and the perturbation law (#3430) read.
60
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The pendulum's frequency and extrapolation are `resolveAutoMovieCenterOfMass`'s.
61
+ */
62
+ export declare namespace resolveAutoMovieBalanceOutcome {
63
+ /** A body's state at an impulse. */
64
+ interface IProps {
65
+ /** The centre of mass, world metres. */
66
+ centre: IAutoMovieVector3;
67
+ /** Its velocity before the impulse, m/s. */
68
+ velocity: IAutoMovieVector3;
69
+ /** The body's mass, kilograms. */
70
+ mass: number;
71
+ /** The impulse, world N s. */
72
+ impulse: IAutoMovieVector3;
73
+ /** Where the impulse acts, world metres; the centre when absent. */
74
+ at?: IAutoMovieVector3;
75
+ /** The pendulum's length, metres (Hof's leg length, `resolveAutoMovieCenterOfMass.pendulum`). */
76
+ length: number;
77
+ /** The support points on the floor, world metres. */
78
+ support: readonly IAutoMovieVector3[];
79
+ /** The longest step from the centre, metres: a leg length. */
80
+ reach: number;
81
+ /** The margin a landed foot catches the extrapolated centre within, metres: half a foot's length. */
82
+ margin: number;
83
+ /** A capture step's swing time after the first, seconds. */
84
+ step: number;
85
+ /** The first capture step's landing after the impulse, seconds, the reaction and the weight shift included; `step` when absent. */
86
+ first?: number;
87
+ /** Gravitational acceleration, m/s²; standard when absent. */
88
+ gravity?: number;
89
+ }
90
+ /** The impulse magnitudes at which the outcome changes, N s. */
91
+ interface IBounds {
92
+ /** Past it, the extrapolated centre leaves the base. */
93
+ absorb: number;
94
+ /** Past it, no number of steps catches the body. */
95
+ step: number;
96
+ }
97
+ /** What the impulse does. */
98
+ interface IOutcome {
99
+ /** Absorbed within the base, caught by steps, or a fall. */
100
+ outcome: "absorb" | "step" | "fall";
101
+ /** The centre's velocity after the impulse, m/s. */
102
+ velocity: IAutoMovieVector3;
103
+ /** The change of angular momentum about the centre, kg m²/s. */
104
+ angular: IAutoMovieVector3;
105
+ /** The extrapolated centre after the impulse, world metres. */
106
+ extrapolated: IAutoMovieVector3;
107
+ /** The capture steps' landing points on the floor, in order; empty for an absorb or a fall. */
108
+ steps: IAutoMovieVector3[];
109
+ /** The impulse bounds along the push. */
110
+ bounds: IBounds;
111
+ }
112
+ }
@@ -0,0 +1,168 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.resolveAutoMovieBalanceOutcome = resolveAutoMovieBalanceOutcome;
4
+ const Vector3_1 = require("../math/Vector3");
5
+ const convexHull2D_1 = require("../math/convexHull2D");
6
+ const pointInHull_1 = require("../math/pointInHull");
7
+ const AutoMovieGravity_1 = require("../physics/AutoMovieGravity");
8
+ const resolveAutoMovieCenterOfMass_1 = require("./resolveAutoMovieCenterOfMass");
9
+ /**
10
+ * What an impulse does to a standing body's balance (#3429): it absorbs it
11
+ * within its base, catches it with capture steps, or falls.
12
+ *
13
+ * The impulse `J` changes the centre of mass's velocity to `v + J / m` and
14
+ * its angular momentum about the centre by `(p - c) × J`. The body is a
15
+ * linear inverted pendulum of length `l` with eigenfrequency `ω0 = sqrt(g /
16
+ * l)`, whose extrapolated centre `ξ = x + v / ω0` must lie within the base
17
+ * of support for the body to stay (Hof, Gazendam and Sinke 2005, J Biomech
18
+ * 38:1-8): inside the support polygon, the body absorbs the push.
19
+ *
20
+ * Outside it, the body steps, the capture point `ξ` diverging from the
21
+ * centre of pressure as the pendulum does, `d(t) = d0 exp(ω0 t)` (the
22
+ * capture point of Pratt, Carff, Drakunov and Goswami 2006, as the stepping
23
+ * literature states it): until the first foot lands, `first` after the
24
+ * impulse, the centre of pressure is held at the base's edge along the lead,
25
+ * so `d0` is the capture point's distance beyond that edge. A foot lands at
26
+ * most `reach` (a leg length, as `stagger` reaches) beyond the last centre
27
+ * of pressure and catches the capture point within its half length,
28
+ * `margin`; one that falls short moves the centre of pressure to its front
29
+ * edge, `reach + margin` on, and leaves the rest to diverge over the next
30
+ * swing, `step`: `d_{k+1} = (d_k - reach - margin) exp(ω0 step)`. The
31
+ * recurrence shrinks to a catch exactly when the first landing's distance is
32
+ * below its fixed point `d* = (reach + margin) a / (a - 1)`, `a = exp(ω0
33
+ * step)`, the infinite-step capture distance in the framework of Koolen, de
34
+ * Boer, Rebula, Goswami and Pratt 2012 ("Capturability-based analysis and
35
+ * control of legged locomotion, Part 1", Int J Robot Res 31(9)); at or past
36
+ * it no number of steps catches the body and it falls. Both papers are
37
+ * located, not yet read at the source; the recurrence is derived here from
38
+ * the linear inverted pendulum's divergence. The steps are laid along the
39
+ * lead from the base's edge.
40
+ *
41
+ * The bounds are the impulse magnitudes along the push's horizontal
42
+ * direction at which the outcome changes: `m ω0 b` to leave the base, with
43
+ * `b` the distance from the current extrapolated centre to the base's edge
44
+ * along the push, and `m ω0 (e + d* exp(-ω0 first) - lead)` to leave the
45
+ * capture region, with `e` the centre's distance to the base's edge along
46
+ * the push and `lead` the current extrapolated centre's distance from the
47
+ * centre.
48
+ * * @param props The body's state, the impulse and the support.
49
+ * @returns The outcome, the steps and the bounds.
50
+ * @throws {Error} When the mass, the length, the reach or the step time is not positive, or there is no support point.
51
+ *
52
+ * @evidence contracts/development/common.md#meaningful-documentation States the impulse's effect, the pendulum, the absorb condition with its source, the capture point's divergence, the stepping recurrence with its sources and fixed point, where steps are laid and the bounds.
53
+ * @evidence contracts/development/implementation.md#principled-implementation Hof's extrapolated centre against the support polygon for absorption; the linear inverted pendulum's capture point diverging from a centre of pressure held at the base's edge until the first landing and at each landed foot's front edge between swings, the N-step capture of Koolen et al.'s framework (located, not yet read at the source), whose fixed point is the infinite-step capture distance.
54
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The state after the impulse, the absorb test, the stepping recurrence, the bounds.
55
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No count of steps is assumed: the recurrence itself ends in a catch or diverges, so the outcome follows from the impulse alone.
56
+ * @evidence contracts/development/implementation.md#efficient-algorithms One hull of the support and a recurrence whose length is the number of steps it lays.
57
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its inputs.
58
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
59
+ */
60
+ function resolveAutoMovieBalanceOutcome(props) {
61
+ const { mass, length, reach, step } = props;
62
+ if (!(mass > 0 &&
63
+ length > 0 &&
64
+ reach > 0 &&
65
+ step > 0 &&
66
+ (props.first === undefined || props.first > 0)))
67
+ throw new Error("The balance outcome needs a positive mass, pendulum length, reach and step time");
68
+ if (props.support.length === 0)
69
+ throw new Error("The balance outcome needs a support point");
70
+ const gravity = props.gravity ?? AutoMovieGravity_1.AutoMovieGravity.STANDARD;
71
+ const w0 = resolveAutoMovieCenterOfMass_1.resolveAutoMovieCenterOfMass.frequency(length, gravity);
72
+ const velocity = Vector3_1.Vector3.add(props.velocity, Vector3_1.Vector3.scale(props.impulse, 1 / mass));
73
+ const angular = Vector3_1.Vector3.cross(Vector3_1.Vector3.subtract(props.at ?? props.centre, props.centre), props.impulse);
74
+ const extrapolated = resolveAutoMovieCenterOfMass_1.resolveAutoMovieCenterOfMass.extrapolate(props.centre, velocity, length, gravity);
75
+ const hull = (0, convexHull2D_1.convexHull2D)(props.support);
76
+ // The push's horizontal direction.
77
+ const flat = (v) => ({
78
+ x: v.x,
79
+ y: 0,
80
+ z: v.z,
81
+ });
82
+ const push = flat(props.impulse);
83
+ const pushed = Vector3_1.Vector3.length(push);
84
+ const direction = pushed > 0 ? Vector3_1.Vector3.scale(push, 1 / pushed) : { x: 0, y: 0, z: 0 };
85
+ const centre = flat(props.centre);
86
+ // The capture point beyond the base's edge diverges with the centre of
87
+ // pressure held at that edge, `d(t) = d0 exp(ω0 t)`, until the first foot
88
+ // lands; each foot catches it within its reach plus its half length, and
89
+ // one that falls short moves the centre of pressure to its front edge and
90
+ // leaves the rest to diverge over the next swing. The distance any number
91
+ // of steps can catch is the recurrence's fixed point.
92
+ const a = Math.exp(w0 * step);
93
+ const caught = reach + props.margin;
94
+ const capturable = (caught * a) / (a - 1);
95
+ const first = props.first ?? step;
96
+ // The bounds along the push: leaving the base, and leaving every capture.
97
+ const before = resolveAutoMovieCenterOfMass_1.resolveAutoMovieCenterOfMass.extrapolate(props.centre, props.velocity, length, gravity);
98
+ const lead = Vector3_1.Vector3.dot(flat(Vector3_1.Vector3.subtract(before, props.centre)), direction);
99
+ const edge = exit(hull, centre, direction);
100
+ const bounds = {
101
+ absorb: pushed > 0
102
+ ? mass * w0 * Math.max(0, exit(hull, before, direction))
103
+ : Number.POSITIVE_INFINITY,
104
+ step: pushed > 0
105
+ ? mass *
106
+ w0 *
107
+ Math.max(0, edge + capturable * Math.exp(-w0 * first) - lead)
108
+ : Number.POSITIVE_INFINITY,
109
+ };
110
+ const base = {
111
+ velocity,
112
+ angular,
113
+ extrapolated,
114
+ bounds,
115
+ };
116
+ if (resolveAutoMovieCenterOfMass_1.resolveAutoMovieCenterOfMass.margin(extrapolated, hull) > 0)
117
+ return { ...base, outcome: "absorb", steps: [] };
118
+ // Steps along the capture point's lead from the centre, from the base's
119
+ // edge that way.
120
+ const away = flat(Vector3_1.Vector3.subtract(extrapolated, props.centre));
121
+ const distance = Vector3_1.Vector3.length(away);
122
+ const along = distance > 0 ? Vector3_1.Vector3.scale(away, 1 / distance) : direction;
123
+ const rim = exit(hull, centre, along);
124
+ let left = Math.max(0, distance - rim) * Math.exp(w0 * first);
125
+ if (left >= capturable)
126
+ return { ...base, outcome: "fall", steps: [] };
127
+ const steps = [];
128
+ let from = Vector3_1.Vector3.add(centre, Vector3_1.Vector3.scale(along, rim));
129
+ for (;;) {
130
+ if (left <= caught) {
131
+ steps.push(Vector3_1.Vector3.add(from, Vector3_1.Vector3.scale(along, Math.min(left, reach))));
132
+ return { ...base, outcome: "step", steps };
133
+ }
134
+ steps.push(Vector3_1.Vector3.add(from, Vector3_1.Vector3.scale(along, reach)));
135
+ from = Vector3_1.Vector3.add(from, Vector3_1.Vector3.scale(along, caught));
136
+ left = (left - caught) * a;
137
+ }
138
+ }
139
+ /**
140
+ * How far a point may move along a direction before it leaves a convex hull
141
+ * on the floor plane.
142
+ *
143
+ * @param hull The hull's corners in order.
144
+ * @param point The point, inside or outside.
145
+ * @param direction A unit horizontal direction.
146
+ * @returns Metres; negative when the point is already outside along it.
147
+ */
148
+ function exit(hull, point, direction) {
149
+ if (hull.length < 3 || !(0, pointInHull_1.pointInHull)(point, hull))
150
+ return resolveAutoMovieCenterOfMass_1.resolveAutoMovieCenterOfMass.margin(point, hull);
151
+ let best = Number.POSITIVE_INFINITY;
152
+ for (let i = 0; i < hull.length; i++) {
153
+ const a = hull[i];
154
+ const b = hull[(i + 1) % hull.length];
155
+ const ex = b.x - a.x;
156
+ const ez = b.z - a.z;
157
+ const denominator = direction.x * ez - direction.z * ex;
158
+ if (denominator === 0)
159
+ continue;
160
+ const s = ((a.x - point.x) * ez - (a.z - point.z) * ex) / denominator;
161
+ const t = ((a.x - point.x) * direction.z - (a.z - point.z) * direction.x) /
162
+ denominator;
163
+ if (s >= 0 && t >= 0 && t <= 1)
164
+ best = Math.min(best, s);
165
+ }
166
+ return best;
167
+ }
168
+ //# sourceMappingURL=resolveAutoMovieBalanceOutcome.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveAutoMovieBalanceOutcome.js","sourceRoot":"","sources":["../../src/kinematics/resolveAutoMovieBalanceOutcome.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { AutoMovieHumanoidBone, IAutoMovieSkeleton, IAutoMovieVector3, IAutoMoviePhysicalProfile as P } from "@automovie/interface";
1
+ import type { AutoMovieHumanoidBone, IAutoMovieQuaternion, IAutoMovieSkeleton, IAutoMovieVector3, IAutoMoviePhysicalProfile as P } from "@automovie/interface";
2
2
  import { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
3
3
  /**
4
4
  * Resolve a body's mass model: every profile segment's mass and centre of
@@ -50,7 +50,32 @@ export declare namespace resolveAutoMovieCenterOfMass {
50
50
  mass: number;
51
51
  /** Centre of mass relative to the bone's joint, in its rest frame, metres. */
52
52
  point: IAutoMovieVector3;
53
+ /** Principal moments about the segment's centre, kg m², the profile's own. */
54
+ inertia: IAutoMovieVector3;
55
+ /** The rotation from the principal axes to the bone's rest frame, so a posed segment's axes are its bone's world rotation times this (`resolveAutoMovieMomentum.inertia`). */
56
+ axes: IAutoMovieQuaternion;
53
57
  }
58
+ /** The inverted pendulum's length in hip heights: the leg length, about 1.34 times the trochanteric height (Hof, Gazendam and Sinke 2005, J Biomech 38:1), which `pendulum` takes its length from. */
59
+ const PENDULUM: number;
60
+ /**
61
+ * The inverted pendulum's length of a body: Hof's leg length, `PENDULUM`
62
+ * hip heights.
63
+ *
64
+ * @param hipHeight The body's hip height, metres.
65
+ * @returns The pendulum's length, metres.
66
+ */
67
+ function pendulum(hipHeight: number): number;
68
+ /**
69
+ * The inverted pendulum's eigenfrequency, `ω0 = sqrt(g / l)` (Hof,
70
+ * Gazendam and Sinke 2005): its reciprocal is the time a centre of mass
71
+ * takes to cover its own velocity's extrapolation.
72
+ *
73
+ * @param length The pendulum's length, metres; positive.
74
+ * @param gravity Gravitational acceleration, m/s²; standard gravity (`AutoMovieGravity.STANDARD`) when absent.
75
+ * @returns Radians per second.
76
+ * @throws {Error} When the length or gravity is not positive.
77
+ */
78
+ function frequency(length: number, gravity?: number): number;
54
79
  /**
55
80
  * The whole-body centre of mass of a posed body.
56
81
  *
@@ -64,13 +89,13 @@ export declare namespace resolveAutoMovieCenterOfMass {
64
89
  * The extrapolated centre of mass (XCoM) of Hof, Gazendam and Sinke (2005,
65
90
  * "The condition for dynamic stability", J. Biomech. 38): the centre of
66
91
  * mass plus its velocity over the inverted pendulum's eigenfrequency,
67
- * `x + v / ω0` with `ω0 = sqrt(g / l)`, where `l` is the pendulum length
68
- * (Hof takes the leg length, about 1.34 times the trochanteric height).
92
+ * `x + v / ω0` with `ω0 = sqrt(g / l)` (`frequency`), where `l` is the
93
+ * pendulum length (Hof takes the leg length, `pendulum`).
69
94
  *
70
95
  * @param com The centre of mass, world metres.
71
96
  * @param velocity Its velocity, metres per second.
72
97
  * @param length The pendulum length, metres; positive.
73
- * @param gravity Gravitational acceleration, m/s²; 9.81 when absent.
98
+ * @param gravity Gravitational acceleration, m/s²; standard gravity (`AutoMovieGravity.STANDARD`) when absent.
74
99
  * @returns The extrapolated centre of mass, world metres.
75
100
  * @throws {Error} When the length or gravity is not positive.
76
101
  */
@@ -6,6 +6,7 @@ const Vector3_1 = require("../math/Vector3");
6
6
  const convexHull2D_1 = require("../math/convexHull2D");
7
7
  const nearestHullEdge_1 = require("../math/nearestHullEdge");
8
8
  const pointInHull_1 = require("../math/pointInHull");
9
+ const AutoMovieGravity_1 = require("../physics/AutoMovieGravity");
9
10
  const resolvePose_1 = require("./resolvePose");
10
11
  /**
11
12
  * Resolve a body's mass model: every profile segment's mass and centre of
@@ -39,10 +40,16 @@ function resolveAutoMovieCenterOfMass(skeleton, profile) {
39
40
  if (bone === undefined)
40
41
  throw new Error(`The mass model needs the rig bone ${s.bone}`);
41
42
  const world = Vector3_1.Vector3.add(s.neutral.position, Quaternion_1.Quaternion.rotateVector(s.neutral.rotation, s.centerOfMass));
43
+ const unturn = Quaternion_1.Quaternion.inverse(bone.worldRotation);
42
44
  return {
43
45
  bone: bone.bone,
44
46
  mass: s.mass,
45
- point: Quaternion_1.Quaternion.rotateVector(Quaternion_1.Quaternion.inverse(bone.worldRotation), Vector3_1.Vector3.subtract(world, bone.worldPosition)),
47
+ point: Quaternion_1.Quaternion.rotateVector(unturn, Vector3_1.Vector3.subtract(world, bone.worldPosition)),
48
+ inertia: s.inertia,
49
+ // The principal axes go from the segment's neutral frame to the
50
+ // bone's rest frame as the centre does, so a pose turns them by
51
+ // the bone's world rotation alone.
52
+ axes: Quaternion_1.Quaternion.normalize(Quaternion_1.Quaternion.multiply(unturn, Quaternion_1.Quaternion.multiply(s.neutral.rotation, s.inertiaRotation))),
46
53
  };
47
54
  });
48
55
  const mass = segments.reduce((sum, s) => sum + s.mass, 0);
@@ -59,6 +66,35 @@ function resolveAutoMovieCenterOfMass(skeleton, profile) {
59
66
  * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses resolved bones and the engine's hull routines.
60
67
  */
61
68
  (function (resolveAutoMovieCenterOfMass) {
69
+ /** The inverted pendulum's length in hip heights: the leg length, about 1.34 times the trochanteric height (Hof, Gazendam and Sinke 2005, J Biomech 38:1), which `pendulum` takes its length from. */
70
+ resolveAutoMovieCenterOfMass.PENDULUM = 1.34;
71
+ /**
72
+ * The inverted pendulum's length of a body: Hof's leg length, `PENDULUM`
73
+ * hip heights.
74
+ *
75
+ * @param hipHeight The body's hip height, metres.
76
+ * @returns The pendulum's length, metres.
77
+ */
78
+ function pendulum(hipHeight) {
79
+ return resolveAutoMovieCenterOfMass.PENDULUM * hipHeight;
80
+ }
81
+ resolveAutoMovieCenterOfMass.pendulum = pendulum;
82
+ /**
83
+ * The inverted pendulum's eigenfrequency, `ω0 = sqrt(g / l)` (Hof,
84
+ * Gazendam and Sinke 2005): its reciprocal is the time a centre of mass
85
+ * takes to cover its own velocity's extrapolation.
86
+ *
87
+ * @param length The pendulum's length, metres; positive.
88
+ * @param gravity Gravitational acceleration, m/s²; standard gravity (`AutoMovieGravity.STANDARD`) when absent.
89
+ * @returns Radians per second.
90
+ * @throws {Error} When the length or gravity is not positive.
91
+ */
92
+ function frequency(length, gravity = AutoMovieGravity_1.AutoMovieGravity.STANDARD) {
93
+ if (!(length > 0) || !(gravity > 0))
94
+ throw new Error(`The inverted pendulum needs a positive length and gravity, got ${length} and ${gravity}`);
95
+ return Math.sqrt(gravity / length);
96
+ }
97
+ resolveAutoMovieCenterOfMass.frequency = frequency;
62
98
  /**
63
99
  * The whole-body centre of mass of a posed body.
64
100
  *
@@ -87,20 +123,18 @@ function resolveAutoMovieCenterOfMass(skeleton, profile) {
87
123
  * The extrapolated centre of mass (XCoM) of Hof, Gazendam and Sinke (2005,
88
124
  * "The condition for dynamic stability", J. Biomech. 38): the centre of
89
125
  * mass plus its velocity over the inverted pendulum's eigenfrequency,
90
- * `x + v / ω0` with `ω0 = sqrt(g / l)`, where `l` is the pendulum length
91
- * (Hof takes the leg length, about 1.34 times the trochanteric height).
126
+ * `x + v / ω0` with `ω0 = sqrt(g / l)` (`frequency`), where `l` is the
127
+ * pendulum length (Hof takes the leg length, `pendulum`).
92
128
  *
93
129
  * @param com The centre of mass, world metres.
94
130
  * @param velocity Its velocity, metres per second.
95
131
  * @param length The pendulum length, metres; positive.
96
- * @param gravity Gravitational acceleration, m/s²; 9.81 when absent.
132
+ * @param gravity Gravitational acceleration, m/s²; standard gravity (`AutoMovieGravity.STANDARD`) when absent.
97
133
  * @returns The extrapolated centre of mass, world metres.
98
134
  * @throws {Error} When the length or gravity is not positive.
99
135
  */
100
- function extrapolate(com, velocity, length, gravity = 9.81) {
101
- if (!(length > 0) || !(gravity > 0))
102
- throw new Error(`The extrapolated centre needs a positive length and gravity, got ${length} and ${gravity}`);
103
- return Vector3_1.Vector3.add(com, Vector3_1.Vector3.scale(velocity, 1 / Math.sqrt(gravity / length)));
136
+ function extrapolate(com, velocity, length, gravity = AutoMovieGravity_1.AutoMovieGravity.STANDARD) {
137
+ return Vector3_1.Vector3.add(com, Vector3_1.Vector3.scale(velocity, 1 / frequency(length, gravity)));
104
138
  }
105
139
  resolveAutoMovieCenterOfMass.extrapolate = extrapolate;
106
140
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"resolveAutoMovieCenterOfMass.js","sourceRoot":"","sources":["../../src/kinematics/resolveAutoMovieCenterOfMass.ts"],"names":[],"mappings":";;;AAOA,mDAAgD;AAChD,6CAA0C;AAC1C,uDAAoD;AACpD,6DAA0D;AAC1D,qDAAkD;AAElD,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,sCACE,QAA4B,EAC5B,OAAU;IAEV,MAAM,IAAI,GAAuD,IAAI,GAAG,CACtE,IAAA,yBAAW,EACT,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EACjD,QAAQ,CACT,CAAC,GAAG,CACH,CACE,CAAyB,EACwB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAClE,CACF,CAAC;IACF,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,CAAC,CAAa,EAAyC,EAAE;QACvD,MAAM,IAAI,GAAuC,IAAI,CAAC,GAAG,CACvD,CAAC,CAAC,IAA6B,CAChC,CAAC;QACF,IAAI,IAAI,KAAK,SAAS;YACpB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,KAAK,GAAsB,iBAAO,CAAC,GAAG,CAC1C,CAAC,CAAC,OAAO,CAAC,QAAQ,EAClB,uBAAU,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC,CAC5D,CAAC;QACF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,uBAAU,CAAC,YAAY,CAC5B,uBAAU,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EACtC,iBAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAC5C;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IACJ,MAAM,IAAI,GAAW,QAAQ,CAAC,MAAM,CAClC,CAAC,GAAW,EAAE,CAAwC,EAAU,EAAE,CAChE,GAAG,GAAG,CAAC,CAAC,IAAI,EACd,CAAC,CACF,CAAC;IACF,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,WAAiB,4BAA4B;IAsB3C;;;;;;;OAOG;IACH,SAAgB,KAAK,CACnB,KAAa,EACb,KAAiE;QAEjE,IAAI,CAAC,GAAW,CAAC,CAAC;QAClB,IAAI,CAAC,GAAW,CAAC,CAAC;QAClB,IAAI,CAAC,GAAW,CAAC,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAuC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnE,IAAI,IAAI,KAAK,SAAS;gBACpB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACvE,MAAM,CAAC,GAAsB,iBAAO,CAAC,GAAG,CACtC,IAAI,CAAC,aAAa,EAClB,uBAAU,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CACrD,CAAC;YACF,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IApBe,6BAAA,KAAK,QAoBpB,CAAA;IAED;;;;;;;;;;;;;OAaG;IACH,SAAgB,WAAW,CACzB,GAAsB,EACtB,QAA2B,EAC3B,MAAc,EACd,OAAO,GAAW,IAAI;QAEtB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,oEAAoE,MAAM,QAAQ,OAAO,EAAE,CAC5F,CAAC;QACJ,OAAO,iBAAO,CAAC,GAAG,CAChB,GAAG,EACH,iBAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CACzD,CAAC;IACJ,CAAC;IAde,6BAAA,WAAW,cAc1B,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,MAAM,CACpB,KAAwB,EACxB,OAAqC;QAErC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,MAAM,IAAI,GAAwB,IAAA,2BAAY,EAAC,OAAO,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAW,IAAA,iCAAe,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC;QAC/D,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAA,yBAAW,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7E,CAAC;IATe,6BAAA,MAAM,SASrB,CAAA;AACH,CAAC,EAvGgB,4BAA4B,aAtD7B,4BAA4B,GAsD3B,4BAA4B,QAuG5C"}
1
+ {"version":3,"file":"resolveAutoMovieCenterOfMass.js","sourceRoot":"","sources":["../../src/kinematics/resolveAutoMovieCenterOfMass.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * The rigid ring modules of a humanoid body, each a short stack of
4
+ * eight-sided sections around one joint's segment, from the rest skeleton
5
+ * alone: joint positions, tips and girth radii.
6
+ *
7
+ * This is the one statement of the body's simple solid form. The polygon
8
+ * drawing lofts a mesh through each module's rings and the physical profile
9
+ * takes the convex hull of the same ring points as that segment's collider,
10
+ * so what is seen and what collides cannot drift apart.
11
+ *
12
+ * The skeleton is in the Human frame at rest: +X forward, +Y up, +Z left,
13
+ * metres. The trunk's modules share their boundary rings (pelvis floor, hip,
14
+ * waist, chest, shoulder, neck base), widened to the hip and shoulder joint
15
+ * spans; the neck runs from the neck joint to the head joint; the head widens
16
+ * to its girth and closes on a pole at its tip; a palm runs from the wrist
17
+ * toward the mean of the four finger roots as far as the farthest of them, so
18
+ * no knuckle is bare beyond it; a foot is two modules through the
19
+ * subtalar and midfoot joints to the toe roots; every other segment is three
20
+ * round rings from its joint to its end, narrowing to the next segment or
21
+ * bevelled at a leaf. Shoulder, scapula, foot, eye, jaw and atlas joints
22
+ * drive others and carry no module.
23
+ *
24
+ * @param bones The rest joints, parent before child, in the Human frame.
25
+ * @returns The modules in drawing order: hips, spine, head, chest, neck, each
26
+ * side's hand and two foot modules, then every remaining segment in joint
27
+ * order.
28
+ * @throws {Error} When a joint a module is built from is missing.
29
+ *
30
+ * @evidence contracts/development/common.md#meaningful-documentation States the frame, the unit, what each module is built from, which joints carry none, the order of the result and the two consumers the single statement serves.
31
+ * @evidence contracts/development/implementation.md#principled-implementation Every dimension is a joint span or a girth radius of the skeleton; a section widened to a breadth keeps its girth circle's area (depth = r²/breadth), and the two trunk shares are the anthropometric conventions named at their constants.
32
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pure function owns ring selection and ring points for the drawing and for the colliders; it knows no renderer and no physics, only vectors.
33
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No fitted dimension, body-specific branch or skin surface enters; a missing joint is refused rather than replaced. The non-null assertions index fixed-length lists the function builds.
34
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pass over the joints with map lookups: linear in the joint count, eight points per ring.
35
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the rest skeleton, called once when a drawing or a profile is built.
36
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; the returned modules belong to the caller.
37
+ */
38
+ export declare function resolveAutoMovieHumanoidRingModules(bones: readonly resolveAutoMovieHumanoidRingModules.IBone[]): resolveAutoMovieHumanoidRingModules.IModule[];
39
+ /**
40
+ * The skeleton input and the module records.
41
+ *
42
+ * @evidence contracts/development/common.md#meaningful-documentation Names the input joint and the two output records; each member states its frame, unit and meaning.
43
+ * @evidence contracts/development/design.md#principled-representation A module is its ring stack with the frame that generated it and an optional closing pole; a ring keeps both its analytic form (centre, half dimensions) and its eight points, which the mesh and the hull read. The two nullable members name a real absence: no breadth axis, no pole.
44
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by `resolveAutoMovieHumanoidRingModules`; the viewer's polygon drawing and the Human physical profile read every member.
45
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No `any`, `unknown`, index signature or cast. `IBone` is the structural shape of a generated rest joint, declared here because the engine cannot import the viewer's or the Human's record.
46
+ */
47
+ export declare namespace resolveAutoMovieHumanoidRingModules {
48
+ /** One rest joint and the segment leaving it. */
49
+ interface IBone {
50
+ /** Joint identity. */ bone: string;
51
+ /** Parent identity, or null at the root. */ parent: string | null;
52
+ /** Rest joint centre, Human frame metres. */ position: readonly [
53
+ number,
54
+ number,
55
+ number
56
+ ];
57
+ /** Leaf segment endpoint, metres; null when a child ends the segment. */ tip: readonly [number, number, number] | null;
58
+ /** Positive girth radius of the segment, metres. */ radius: number;
59
+ }
60
+ /** One section of a module. */
61
+ interface IRing {
62
+ /** Centre, Human frame metres. */ centre: IAutoMovieVector3;
63
+ /** Half dimension along the module's first in-plane axis, metres. */ depth: number;
64
+ /** Half dimension along its second in-plane axis, metres. */ breadth: number;
65
+ /** The ring's points, counter clockwise about the module axis, Human frame metres. */ points: IAutoMovieVector3[];
66
+ }
67
+ /** One rigid module. */
68
+ interface IModule {
69
+ /** The joint whose segment this module is. */ bone: string;
70
+ /** The direction the rings are stacked along; not a unit. */ axis: IAutoMovieVector3;
71
+ /** The direction of the rings' breadth, or null for the default frame whose depth axis is forward. */ breadth: IAutoMovieVector3 | null;
72
+ /** The stacked sections, first to last along the axis. */ rings: IRing[];
73
+ /** The point closing the last ring, or null for a flat end. */ pole: IAutoMovieVector3 | null;
74
+ }
75
+ }