@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,295 @@
1
+ import { IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
2
+
3
+ import { Quaternion } from "../math/Quaternion";
4
+ import { Vector3 } from "../math/Vector3";
5
+ import { ROM_TOLERANCE } from "../rom/constants/ROM_TOLERANCE";
6
+ import { IAutoMovieChainBone } from "./IAutoMovieChainBone";
7
+ import { aimRotation } from "./aimRotation";
8
+
9
+ /**
10
+ * The geometry of a two-bone chain whose mid joint bends only about its own
11
+ * hinge, as `hingedArmArticulation` poses it: the hinge angles that reach a
12
+ * target's distance (the chain's bend branches, each stopped inside the mid
13
+ * joint's range), and the root rotation that aims the chain at the target
14
+ * and then turns it by a swivel about its own root-to-effector line, which
15
+ * leaves the effector where it is (Tolani, Goswami and Badler 2000). A
16
+ * swivel and a branch name one pose of the chain for any target, so a
17
+ * caller that holds them while the target moves poses the chain exactly as
18
+ * the articulation does, and `read` recovers them from a posed chain.
19
+ *
20
+ * @evidence contracts/development/common.md#meaningful-documentation States the branches, the aim and swivel, and what a held swivel means.
21
+ * @evidence contracts/development/design.md#principled-representation The swivel parameterisation of Tolani, Goswami and Badler 2000: a hinge angle per branch and a swivel about the root-to-effector line.
22
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The chain, the swivel and three functions: the branches, the pose and its reading; `hingedArmArticulation` poses its candidates through them.
23
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `aimRotation`; the scoring and the sweep stay with `hingedArmArticulation`.
24
+ */
25
+ export namespace hingedArmSwivel {
26
+ /**
27
+ * Swivel resolution of `hingedArmArticulation`'s candidate sweep, in
28
+ * degrees.
29
+ *
30
+ * Every candidate lands the effector on the same point, so the step decides
31
+ * only which of the equally exact poses is chosen, never how close the hand
32
+ * gets. One degree gives 360 candidates per bend branch, and the solve runs
33
+ * once per authored action rather than per frame.
34
+ */
35
+ export const STEP: number = 1;
36
+
37
+ /** The golden-section ratio, `(sqrt(5) - 1) / 2`, by which each refinement pass shrinks the swivel bracket. */
38
+ export const GOLDEN: number = (Math.sqrt(5) - 1) / 2;
39
+
40
+ /**
41
+ * Golden-section passes refining the swivel inside the two-step bracket
42
+ * around each local minimum of the sweep: the fewest that shrink the
43
+ * bracket, `2 STEP`, by `GOLDEN` a pass to within the joint's tolerance
44
+ * (`ROM_TOLERANCE`), since a swivel turns the chain root's joint by itself
45
+ * and a solver need resolve a joint's angle no finer.
46
+ */
47
+ export const REFINEMENTS: number = Math.ceil(
48
+ Math.log(ROM_TOLERANCE / (2 * STEP)) / Math.log(GOLDEN),
49
+ );
50
+
51
+ /** The width the refinement leaves of a swivel's bracket, degrees: the two-step bracket shrunk by `GOLDEN` per pass, the swivel's resolution, within `ROM_TOLERANCE`. */
52
+ export const RESOLUTION: number = 2 * STEP * GOLDEN ** REFINEMENTS;
53
+
54
+ /**
55
+ * A hinged chain toward a target.
56
+ *
57
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its frame.
58
+ * @evidence contracts/development/design.md#principled-representation The chain's rest geometry, its root's frame and the target, as `hingedArmArticulation` takes them.
59
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Seven members.
60
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `IAutoMovieChainBone`.
61
+ */
62
+ export interface IChain {
63
+ /** Chain-root bone (the shoulder or the hip) resolved under the rig's rest FK. */
64
+ upper: IAutoMovieChainBone;
65
+
66
+ /** Mid bone's rest offset from the chain root, in the root's bone frame. */
67
+ midOffset: IAutoMovieVector3;
68
+
69
+ /** Mid bone's rest rotation relative to the chain root. */
70
+ midRest: IAutoMovieQuaternion;
71
+
72
+ /** Effector's rest offset from the mid joint, in the mid bone's frame. */
73
+ endOffset: IAutoMovieVector3;
74
+
75
+ /** The mid joint's flexion axis in the mid bone's frame; any length. */
76
+ hinge: IAutoMovieVector3;
77
+
78
+ /** World target the effector should land on. */
79
+ target: IAutoMovieVector3;
80
+
81
+ /** The mid joint's legal rotation about `hinge`, radians, `min <= max` and no wider than a full turn; every hinge angle is legal when absent. */
82
+ range?: { min: number; max: number };
83
+ }
84
+
85
+ /**
86
+ * One bend branch after the hinge's range.
87
+ *
88
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its unit.
89
+ * @evidence contracts/development/design.md#principled-representation A hinge angle and how far short of the target it stops.
90
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Two members.
91
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None.
92
+ */
93
+ export interface IStop {
94
+ /** The hinge angle, radians, inside the range when one is given. */
95
+ theta: number;
96
+
97
+ /** Metres between the chain's span at `theta` and the target distance; `0` for a branch that reaches the distance inside the range. */
98
+ shortfall: number;
99
+ }
100
+
101
+ /**
102
+ * The chain's bend branches toward its target: the two hinge angles whose
103
+ * span is the target's distance, `phase + acos` first, or the fully
104
+ * extended or folded one outside the span, each stopped at the nearer limit
105
+ * of the range.
106
+ *
107
+ * @param chain The chain.
108
+ * @returns The branches, in that order, or null for a degenerate chain (`hingedArmArticulation`).
109
+ *
110
+ * @evidence contracts/development/common.md#meaningful-documentation States the order, the stops and the null.
111
+ * @evidence contracts/development/implementation.md#principled-implementation The span is an exact sinusoid in the hinge angle, so its two arccos roots are the only hinge angles reaching the distance.
112
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The sinusoid, its roots, then the range.
113
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The degeneracy thresholds are the engine's shared length scale.
114
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
115
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
116
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
117
+ */
118
+ export function branches(chain: IChain): IStop[] | null {
119
+ const root: IAutoMovieVector3 = chain.upper.worldPosition;
120
+ if (
121
+ Vector3.length(chain.midOffset) < 1e-6 ||
122
+ Vector3.length(chain.endOffset) < 1e-6
123
+ )
124
+ return null;
125
+ const distance: number = Vector3.length(
126
+ Vector3.subtract(chain.target, root),
127
+ );
128
+ if (distance < 1e-6) return null;
129
+ if (Vector3.length(chain.hinge) < 1e-6) return null;
130
+ const hinge: IAutoMovieVector3 = Vector3.normalize(chain.hinge);
131
+ // |m(θ)|² = k + α cos θ + β sin θ, with the far segment split into the part
132
+ // the hinge cannot move (along the hinge) and the part it swings.
133
+ const along: number = Vector3.dot(hinge, chain.endOffset);
134
+ const swung: IAutoMovieVector3 = Vector3.subtract(
135
+ chain.endOffset,
136
+ Vector3.scale(hinge, along),
137
+ );
138
+ const radius: number = Vector3.length(swung);
139
+ const rotated = (vector: IAutoMovieVector3): IAutoMovieVector3 =>
140
+ Quaternion.rotateVector(chain.midRest, vector);
141
+ const k: number =
142
+ Vector3.dot(chain.midOffset, chain.midOffset) +
143
+ Vector3.dot(chain.endOffset, chain.endOffset) +
144
+ 2 * along * Vector3.dot(chain.midOffset, rotated(hinge));
145
+ let alpha: number = 0;
146
+ let beta: number = 0;
147
+ if (radius >= SPAN_EPSILON) {
148
+ const unit: IAutoMovieVector3 = Vector3.scale(swung, 1 / radius);
149
+ alpha = 2 * radius * Vector3.dot(chain.midOffset, rotated(unit));
150
+ beta =
151
+ 2 *
152
+ radius *
153
+ Vector3.dot(chain.midOffset, rotated(Vector3.cross(hinge, unit)));
154
+ }
155
+ const span: number = Math.hypot(alpha, beta);
156
+ if (span < SPAN_EPSILON) return null;
157
+ const phase: number = Math.atan2(beta, alpha);
158
+ const ratio: number = (distance * distance - k) / span;
159
+ // Outside the span the chain clamps to its extreme, so the effector stops
160
+ // on the reachable shell pointing at the target rather than failing.
161
+ const thetas: number[] =
162
+ ratio >= 1
163
+ ? [phase]
164
+ : ratio <= -1
165
+ ? [phase + Math.PI]
166
+ : [phase + Math.acos(ratio), phase - Math.acos(ratio)];
167
+ const outside: boolean = ratio >= 1 || ratio <= -1;
168
+ const short = (theta: number): number =>
169
+ Math.abs(
170
+ Math.sqrt(
171
+ Math.max(0, k + alpha * Math.cos(theta) + beta * Math.sin(theta)),
172
+ ) - distance,
173
+ );
174
+ // A hinge angle outside the joint's own range stops at the nearer limit,
175
+ // so the effector rests on the legal shell along the line to the target.
176
+ const range: { min: number; max: number } | undefined = chain.range;
177
+ return thetas.map((theta: number): IStop => {
178
+ if (range === undefined)
179
+ return { theta, shortfall: outside ? short(theta) : 0 };
180
+ const centre: number = (range.min + range.max) / 2;
181
+ const wrapped: number =
182
+ theta - 2 * Math.PI * Math.round((theta - centre) / (2 * Math.PI));
183
+ const legal: number = Math.min(range.max, Math.max(range.min, wrapped));
184
+ return {
185
+ theta: legal,
186
+ shortfall: legal === wrapped && !outside ? 0 : short(legal),
187
+ };
188
+ });
189
+ }
190
+
191
+ /**
192
+ * The chain posed at a hinge angle, for any swivel: the mid joint turned by
193
+ * the hinge angle, the root aimed so the chain's root-to-effector line
194
+ * points at the target (`aimRotation`), then turned about that line by the
195
+ * swivel.
196
+ *
197
+ * @param chain The chain.
198
+ * @param theta The hinge angle, radians.
199
+ * @returns The bone-local root and mid rotations at a swivel about the root-to-effector line, degrees.
200
+ *
201
+ * @evidence contracts/development/common.md#meaningful-documentation States the order of the turns and the units.
202
+ * @evidence contracts/development/implementation.md#principled-implementation The swivel about the root-to-effector line is an exact null space of the effector's position.
203
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The hinge, the line and the aim once, then the swivel per call.
204
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
205
+ * @evidence contracts/development/implementation.md#efficient-algorithms The mid direction and the aim are read once for every swivel of a branch.
206
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `aimRotation`.
207
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the branch's mid rotation, line and aim in the returned function only.
208
+ */
209
+ export function pose(
210
+ chain: IChain,
211
+ theta: number,
212
+ ): (swivel: number) => {
213
+ upper: IAutoMovieQuaternion;
214
+ lower: IAutoMovieQuaternion;
215
+ } {
216
+ const { lower, line, aim } = aimed(chain, theta);
217
+ return (swivel: number) => ({
218
+ upper: Quaternion.multiply(aim, Quaternion.fromAxisAngle(line, swivel)),
219
+ lower,
220
+ });
221
+ }
222
+
223
+ /**
224
+ * The swivel of a posed chain: the root's turn about the chain's
225
+ * root-to-effector line past the aim `pose` gives for its hinge angle.
226
+ *
227
+ * @param chain The chain, its target where the posed effector lies.
228
+ * @param upper The posed bone-local root rotation.
229
+ * @param theta The posed hinge angle, radians.
230
+ * @returns Degrees, in (-180, 180].
231
+ *
232
+ * @evidence contracts/development/common.md#meaningful-documentation States what is read and its range.
233
+ * @evidence contracts/development/implementation.md#principled-implementation The inverse of `pose`: the aim removed, the rest is a turn about the line.
234
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The aim, the remainder, its angle.
235
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
236
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
237
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Shares `pose`'s aim.
238
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
239
+ */
240
+ export function read(
241
+ chain: IChain,
242
+ upper: IAutoMovieQuaternion,
243
+ theta: number,
244
+ ): number {
245
+ const { line, aim } = aimed(chain, theta);
246
+ const rest: IAutoMovieQuaternion = Quaternion.multiply(
247
+ Quaternion.inverse(aim),
248
+ upper,
249
+ );
250
+ const along: number = rest.x * line.x + rest.y * line.y + rest.z * line.z;
251
+ const degrees: number = (2 * Math.atan2(along, rest.w) * 180) / Math.PI;
252
+ return degrees > 180
253
+ ? degrees - 360
254
+ : degrees <= -180
255
+ ? degrees + 360
256
+ : degrees;
257
+ }
258
+
259
+ /** The mid rotation, the root-to-effector line in the root's frame and the aim at a hinge angle. */
260
+ function aimed(
261
+ chain: IChain,
262
+ theta: number,
263
+ ): {
264
+ lower: IAutoMovieQuaternion;
265
+ line: IAutoMovieVector3;
266
+ aim: IAutoMovieQuaternion;
267
+ } {
268
+ const lower: IAutoMovieQuaternion = Quaternion.fromAxisAngle(
269
+ Vector3.normalize(chain.hinge),
270
+ theta * RAD2DEG,
271
+ );
272
+ const mid: IAutoMovieVector3 = Vector3.add(
273
+ chain.midOffset,
274
+ Quaternion.rotateVector(
275
+ chain.midRest,
276
+ Quaternion.rotateVector(lower, chain.endOffset),
277
+ ),
278
+ );
279
+ const goal: IAutoMovieVector3 = Quaternion.rotateVector(
280
+ Quaternion.inverse(chain.upper.worldRotation),
281
+ Vector3.subtract(chain.target, chain.upper.worldPosition),
282
+ );
283
+ return {
284
+ lower,
285
+ line: Vector3.normalize(mid),
286
+ aim: aimRotation(mid, goal),
287
+ };
288
+ }
289
+
290
+ /** Below this the mid joint cannot change the chain's span at all. */
291
+ const SPAN_EPSILON: number = 1e-9;
292
+
293
+ /** Degrees per radian. */
294
+ const RAD2DEG: number = 180 / Math.PI;
295
+ }
@@ -4,33 +4,57 @@ export * from "./IAutoMovieChainBone";
4
4
  export * from "./IAutoMovieHingedArticulation";
5
5
  export * from "./IAutoMovieJointAxesIssue";
6
6
  export * from "./IAutoMovieJointRotationDomain";
7
+ export * from "./IAutoMoviePoseRig";
7
8
  export * from "./IAutoMovieResolvedBone";
8
9
  export * from "./IAutoMovieResolvedJointAngles";
9
10
  export * from "./IAutoMovieSkeletonTopology";
11
+ export * from "./IAutoMovieSwivelNear";
12
+ export * from "./IAutoMovieSwivelSeed";
10
13
  export * from "./IAutoMovieTwoBoneArticulation";
11
14
  export * from "./ITwoBoneIK";
12
15
  export * from "./aimRotation";
13
16
  export * from "./aimYawPitch";
17
+ export * from "./alternateRigJointAngles";
14
18
  export * from "./armChainFault";
19
+ export * from "./boxExcludedSwivels";
15
20
  export * from "./clinicalDeviation";
16
21
  export * from "./constants";
17
22
  export * from "./curlChainUntilContact";
18
23
  export * from "./decomposeJointRotation";
24
+ export * from "./decomposeJointRotationOnBasis";
25
+ export * from "./fitDigitDescent";
26
+ export * from "./fitDigitToTarget";
19
27
  export * from "./gazeChainJoints";
20
28
  export * from "./hingedArmArticulation";
29
+ export * from "./hingedArmSwivel";
21
30
  export * from "./indexSkeletonTopology";
22
31
  export * from "./jointRomOvershoot";
23
32
  export * from "./jointToQuaternion";
33
+ export * from "./jointToQuaternionOnBasis";
24
34
  export * from "./measureAutoMovieHumanoidBody";
25
35
  export * from "./normalizeJointAxes";
36
+ export * from "./poseJointCodec";
26
37
  export * from "./reachPose";
27
38
  export * from "./reachableBoneNames";
28
39
  export * from "./resolveAttachment";
40
+ export * from "./resolveAutoMovieBalanceOutcome";
29
41
  export * from "./resolveAutoMovieCenterOfMass";
42
+ export * from "./resolveAutoMovieMomentum";
43
+ export * from "./resolveAutoMovieHumanoidRingModules";
44
+ export * from "./AutoMovieHumanoidDigitSurfaces";
45
+ export * from "./AutoMovieHumanoidSurfaceExtents";
46
+ export * from "./AutoMovieHumanoidSurfaceRays";
47
+ export * from "./AutoMovieHumanoidSurfaceRegions";
30
48
  export * from "./resolveAutoMovieHumanoidSurfaces";
31
49
  export * from "./resolveLookAt";
32
50
  export * from "./resolvePose";
33
51
  export * from "./skeletonJointAxes";
34
52
  export * from "./solveTwoBoneIK";
53
+ export * from "./swingTwistBasis";
54
+ export * from "./swingTwistRange";
55
+ export * from "./swingTwistRegion";
56
+ export * from "./swivelArcs";
35
57
  export * from "./twoBoneChainArticulation";
36
58
  export * from "./validateJointAxesBasis";
59
+ export * from "./markAutoMovieBalance";
60
+ export * from "./markAutoMovieRomOvershoot";
@@ -1,51 +1,62 @@
1
1
  import {
2
- IAutoMovieConstraintViolation,
3
2
  IAutoMovieJointConstraint,
4
3
  IAutoMovieJointPose,
5
4
  } from "@automovie/interface";
6
5
 
7
- import { validateJointRom } from "../rom/validateJointRom";
8
- import { ViolationCollector } from "../validation/ViolationCollector";
6
+ import { scanJointRom } from "../rom/scanJointRom";
7
+ import type { swingTwistRange } from "./swingTwistRange";
9
8
 
10
9
  /**
11
10
  * The total range-of-motion overshoot of one joint's clinical angles, in
12
11
  * degrees, or `0` when the joint is within its constraint.
13
12
  *
14
- * It sums the `overshoot` of every violation {@link validateJointRom} reports,
15
- * the same check the pose gate runs, so a solver that ranks candidates by this
16
- * number cannot judge itself by a kinder rule than the gate. A non-finite angle
17
- * is reported without an overshoot and scores `Infinity`, so it never wins a
18
- * ranking. A `null` constraint scores `0`.
13
+ * It sums the overshoot of every fault {@link scanJointRom} reports, the
14
+ * measure the pose gate's `validateJointRom` words into its violations, so a
15
+ * solver that ranks candidates by this number cannot judge itself by a kinder
16
+ * rule than the gate, and a ranking over hundreds of candidates builds no
17
+ * message for any of them. A non-finite angle is reported without an
18
+ * overshoot and scores `Infinity`, so it never wins a ranking. A `null`
19
+ * constraint scores `0`.
19
20
  *
20
21
  * @param joint Clinical angles of one joint; `null` axes are at rest.
21
22
  * @param constraint The joint's resolved ROM, or `null` when unconstrained.
23
+ * @param rig The bone's frame as the caller's rig resolves it, for a joint gated by swing and twist; the humanoid tables' when absent.
22
24
  *
23
25
  * @evidence contracts/development/implementation.md#principled-implementation Reduces the gate's own per-axis and swing-cone violations to one comparable sum, so ordering by it is ordering by the gate's distances; a violation without a measured distance is a non-finite angle, which the sum treats as infinitely far instead of free.
24
- * @evidence contracts/development/implementation.md#clear-and-simple-structure Wraps `validateJointRom` instead of restating its limits, so `decomposeJointRotation`'s chart choice and `reachPose`'s candidate scoring read exactly the rule `validatePose` enforces.
26
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Sums `scanJointRom`'s faults instead of restating its limits, so `decomposeJointRotation`'s chart choice and `reachPose`'s candidate scoring read exactly the rule `validatePose` enforces.
25
27
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Adds no tolerance and no special case for any bone or axis; the `Infinity` score is the stated meaning of an unmeasurable violation, not a compensation.
26
28
  * @evidence contracts/development/common.md#meaningful-documentation States the unit, the zero answer, that the gate's check is reused and why, the `Infinity` case, and what `null` means for the constraint and for an axis.
27
- * @evidence contracts/development/implementation.md#efficient-algorithms Three axis checks plus at most one swing-cone check and a sum over at most four violations, constant per call; the short-lived collector is the gate's own message-building path, accepted so the score cannot drift from the gate.
29
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three axis checks plus at most one swing-cone check and a sum over at most four faults, constant per call, with no message and no collector built; the gate words the same faults, so the score cannot drift from it.
28
30
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of one joint and constraint that coordinates no work across calls.
29
- * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Owns one `ViolationCollector` holding at most four violations for the duration of the call; it is unreachable after the sum returns, and nothing is retained.
31
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the sum is a local number.
30
32
  */
31
33
  export const jointRomOvershoot: (
32
34
  joint: IAutoMovieJointPose,
33
35
  constraint: IAutoMovieJointConstraint | null,
36
+ rig?: swingTwistRange.IJoint,
34
37
  ) => number = (
35
38
  joint: IAutoMovieJointPose,
36
39
  constraint: IAutoMovieJointConstraint | null,
40
+ rig?: swingTwistRange.IJoint,
37
41
  ): number => {
38
42
  if (constraint === null) return 0;
39
- const collector: ViolationCollector = new ViolationCollector();
40
- validateJointRom({ joint, constraint, path: "$candidate", collector });
41
- return collector.items.reduce(
42
- // A violation with no overshoot is not a free one. `validateJointRom` omits
43
- // the measure exactly when the angle is NOT FINITE, which is worse than any
43
+ let total: number = 0;
44
+ scanJointRom(
45
+ joint,
46
+ constraint,
47
+ // A fault with no overshoot is not a free one. `scanJointRom` omits the
48
+ // measure exactly when the angle is NOT FINITE, which is worse than any
44
49
  // distance past a limit and has no distance to report. Scoring it `0` would
45
50
  // rank a malformed candidate as perfectly legal and let it win the
46
51
  // selection outright, so it is scored as unusable instead.
47
- (total: number, item: IAutoMovieConstraintViolation): number =>
48
- total + (item.overshoot ?? Number.POSITIVE_INFINITY),
49
- 0,
52
+ (
53
+ _part: scanJointRom.Part,
54
+ _actual: number,
55
+ overshoot: number | undefined,
56
+ ): void => {
57
+ total += overshoot ?? Number.POSITIVE_INFINITY;
58
+ },
59
+ rig,
50
60
  );
61
+ return total;
51
62
  };
@@ -4,32 +4,12 @@ import {
4
4
  IAutoMovieQuaternion,
5
5
  } from "@automovie/interface";
6
6
 
7
- import { Quaternion } from "../math/Quaternion";
8
- import { IAutoMovieAxisFrame } from "../rom/IAutoMovieAxisFrame";
9
7
  import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
10
- import { toRigAngle } from "../rom/toRigAngle";
11
8
  import { DEFAULT_JOINT_AXES } from "./constants/DEFAULT_JOINT_AXES";
9
+ import { jointToQuaternionOnBasis } from "./jointToQuaternionOnBasis";
12
10
  import { normalizeJointAxes } from "./normalizeJointAxes";
13
11
 
14
12
  type AutoMovieClinicalAxis = "flexion" | "abduction" | "twist";
15
-
16
- const readAngle: (
17
- joint: Pick<IAutoMovieJointPose, AutoMovieClinicalAxis>,
18
- axis: AutoMovieClinicalAxis,
19
- frame: IAutoMovieAxisFrame | undefined,
20
- ) => number = (
21
- joint: Pick<IAutoMovieJointPose, AutoMovieClinicalAxis>,
22
- axis: AutoMovieClinicalAxis,
23
- frame: IAutoMovieRestFrame[AutoMovieClinicalAxis] | undefined,
24
- ): number => {
25
- const value: number | null = joint[axis];
26
- if (value !== null && !Number.isFinite(value))
27
- throw new Error(
28
- `jointToQuaternion ${axis} must be finite or null, but was ${value}`,
29
- );
30
- return toRigAngle(value, frame) ?? 0;
31
- };
32
-
33
13
  /**
34
14
  * Convert a joint's clinical flexion, abduction and twist, in degrees, into
35
15
  * one bone-local rotation quaternion.
@@ -65,10 +45,10 @@ const readAngle: (
65
45
  * omitted, the angles are already rest-relative.
66
46
  *
67
47
  * @evidence contracts/development/implementation.md#principled-implementation An intrinsic Euler composition of three axis-angle quaternions in a declared order, which is a rotation for any orthonormal basis; `normalizeJointAxes` enforces that basis and the frame map is the exact affine inverse of `toClinicalAngle`, so `decomposeJointRotation` round-trips it.
68
- * @evidence contracts/development/implementation.md#clear-and-simple-structure The forward half of the joint convention, used by `resolvePose` for every articulated bone; basis checking lives in `normalizeJointAxes` and frame arithmetic in `toRigAngle`, so the forward and inverse maps share those rules.
48
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The forward half of the joint convention, used by `resolvePose` for every articulated bone: `jointToQuaternionOnBasis` behind one `normalizeJointAxes`, so basis checking and composition each live in one place and the forward and inverse maps share those rules.
69
49
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Reads every bone through its declared axes and frame; a `null` angle is the documented rest rotation, and a non-finite angle throws instead of becoming zero.
70
50
  * @evidence contracts/development/common.md#meaningful-documentation States each axis and its default, both composition orders and when each applies, what `null` means, the frame map and its purpose, the inverse function, the thrown inputs, and each parameter's default.
71
- * @evidence contracts/development/implementation.md#efficient-algorithms Constant time: one basis validation and normalization, three axis-angle quaternions and two products.
51
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant time: one basis admission (a remembered record costs ten comparisons), three axis-angle quaternions and two products.
72
52
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of one joint that coordinates no work across calls.
73
53
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the caller owns the returned quaternion.
74
54
  */
@@ -80,24 +60,9 @@ export const jointToQuaternion: (
80
60
  joint: Pick<IAutoMovieJointPose, AutoMovieClinicalAxis>,
81
61
  axes: IAutoMovieJointAxes = DEFAULT_JOINT_AXES,
82
62
  frame?: IAutoMovieRestFrame,
83
- ): IAutoMovieQuaternion => {
84
- const basis: IAutoMovieJointAxes = normalizeJointAxes(
85
- axes,
86
- "jointToQuaternion axes",
87
- );
88
- const qFlexion: IAutoMovieQuaternion = Quaternion.fromAxisAngle(
89
- basis.flexion,
90
- readAngle(joint, "flexion", frame?.flexion),
91
- );
92
- const qAbduction: IAutoMovieQuaternion = Quaternion.fromAxisAngle(
93
- basis.abduction,
94
- readAngle(joint, "abduction", frame?.abduction),
95
- );
96
- const qTwist: IAutoMovieQuaternion = Quaternion.fromAxisAngle(
97
- basis.twist,
98
- readAngle(joint, "twist", frame?.twist),
63
+ ): IAutoMovieQuaternion =>
64
+ jointToQuaternionOnBasis(
65
+ joint,
66
+ normalizeJointAxes(axes, "jointToQuaternion axes"),
67
+ frame,
99
68
  );
100
- return basis.twistPlacement === "distal"
101
- ? Quaternion.multiply(qAbduction, Quaternion.multiply(qFlexion, qTwist))
102
- : Quaternion.multiply(qTwist, Quaternion.multiply(qAbduction, qFlexion));
103
- };
@@ -0,0 +1,84 @@
1
+ import {
2
+ IAutoMovieJointAxes,
3
+ IAutoMovieJointPose,
4
+ IAutoMovieQuaternion,
5
+ } from "@automovie/interface";
6
+
7
+ import { Quaternion } from "../math/Quaternion";
8
+ import { IAutoMovieAxisFrame } from "../rom/IAutoMovieAxisFrame";
9
+ import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
10
+ import { toRigAngle } from "../rom/toRigAngle";
11
+
12
+ type AutoMovieClinicalAxis = "flexion" | "abduction" | "twist";
13
+
14
+ const readAngle: (
15
+ joint: Pick<IAutoMovieJointPose, AutoMovieClinicalAxis>,
16
+ axis: AutoMovieClinicalAxis,
17
+ frame: IAutoMovieAxisFrame | undefined,
18
+ ) => number = (
19
+ joint: Pick<IAutoMovieJointPose, AutoMovieClinicalAxis>,
20
+ axis: AutoMovieClinicalAxis,
21
+ frame: IAutoMovieRestFrame[AutoMovieClinicalAxis] | undefined,
22
+ ): number => {
23
+ const value: number | null = joint[axis];
24
+ if (value !== null && !Number.isFinite(value))
25
+ throw new Error(
26
+ `jointToQuaternion ${axis} must be finite or null, but was ${value}`,
27
+ );
28
+ return toRigAngle(value, frame) ?? 0;
29
+ };
30
+
31
+ /**
32
+ * {@link jointToQuaternion} on a basis its caller already admitted and
33
+ * normalized through {@link normalizeJointAxes}: the composition itself, with
34
+ * no validation of the basis.
35
+ *
36
+ * A solver that composes hundreds of candidate joints through one basis
37
+ * normalizes it once and calls this for each, as
38
+ * `decomposeJointRotationOnBasis` serves the inverse. The axes, the two
39
+ * composition orders, the `null` rest and the frame map are
40
+ * `jointToQuaternion`'s, which documents them and is this function behind
41
+ * one normalization.
42
+ *
43
+ * Throws on a non-finite angle or an invalid frame sign or neutral. A basis
44
+ * that is not orthonormal composes a quaternion that is not the joint's
45
+ * rotation; nothing here detects it.
46
+ *
47
+ * @param joint Clinical angles in degrees; `null` axes are at rest.
48
+ * @param basis Orthonormal clinical axis basis, as `normalizeJointAxes` returns it.
49
+ * @param frame Rest frame mapping clinical angles to rest-relative ones;
50
+ * omitted, the angles are already rest-relative.
51
+ *
52
+ * @evidence contracts/development/common.md#meaningful-documentation States what the caller must have done to the basis, why the entry exists, that the conventions are `jointToQuaternion`'s, what is thrown and what an unnormalized basis silently gives.
53
+ * @evidence contracts/development/implementation.md#principled-implementation An intrinsic Euler composition of three axis-angle quaternions in a declared order, a rotation for any orthonormal basis; the frame map is the exact affine inverse of `toClinicalAngle`.
54
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The composition alone; `jointToQuaternion` is this function behind one normalization, so both read one rule.
55
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A `null` angle is the documented rest rotation, and a non-finite angle throws instead of becoming zero.
56
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three axis-angle quaternions and two products in constant time, with no validation of the basis.
57
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The caller normalizes a joint's basis once and passes it to every composition, which is the reason this entry exists beside `jointToQuaternion`.
58
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the caller owns the returned quaternion.
59
+ */
60
+ export const jointToQuaternionOnBasis: (
61
+ joint: Pick<IAutoMovieJointPose, AutoMovieClinicalAxis>,
62
+ basis: IAutoMovieJointAxes,
63
+ frame?: IAutoMovieRestFrame | undefined,
64
+ ) => IAutoMovieQuaternion = (
65
+ joint: Pick<IAutoMovieJointPose, AutoMovieClinicalAxis>,
66
+ basis: IAutoMovieJointAxes,
67
+ frame?: IAutoMovieRestFrame,
68
+ ): IAutoMovieQuaternion => {
69
+ const qFlexion: IAutoMovieQuaternion = Quaternion.fromAxisAngle(
70
+ basis.flexion,
71
+ readAngle(joint, "flexion", frame?.flexion),
72
+ );
73
+ const qAbduction: IAutoMovieQuaternion = Quaternion.fromAxisAngle(
74
+ basis.abduction,
75
+ readAngle(joint, "abduction", frame?.abduction),
76
+ );
77
+ const qTwist: IAutoMovieQuaternion = Quaternion.fromAxisAngle(
78
+ basis.twist,
79
+ readAngle(joint, "twist", frame?.twist),
80
+ );
81
+ return basis.twistPlacement === "distal"
82
+ ? Quaternion.multiply(qAbduction, Quaternion.multiply(qFlexion, qTwist))
83
+ : Quaternion.multiply(qTwist, Quaternion.multiply(qAbduction, qFlexion));
84
+ };