@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,260 @@
1
+ import {
2
+ IAutoMovieAngleRange,
3
+ IAutoMovieJointAxes,
4
+ IAutoMovieJointConstraint,
5
+ IAutoMovieQuaternion,
6
+ IAutoMovieVector3,
7
+ } from "@automovie/interface";
8
+
9
+ import { Quaternion } from "../math/Quaternion";
10
+ import { Vector3 } from "../math/Vector3";
11
+ import { IAutoMovieAxisFrame } from "../rom/IAutoMovieAxisFrame";
12
+ import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
13
+ import { ROM_TOLERANCE } from "../rom/constants/ROM_TOLERANCE";
14
+ import { swingTwistExcludedSwivels } from "./swingTwistExcludedSwivels";
15
+ import type { swingTwistRange } from "./swingTwistRange";
16
+ import { swivelArcs } from "./swivelArcs";
17
+
18
+ /**
19
+ * The swivels a joint's three-angle box provably refuses: for a joint whose
20
+ * bone-local rotation is a fixed rotation turned about a fixed axis by the
21
+ * swivel (the chain root of `hingedArmSwivel.pose`), a test of whether every
22
+ * swivel from `low` to `high` degrees reads past the joint's box in both of
23
+ * the charts `decomposeJointRotationOnBasis` chooses between, so that
24
+ * `jointRomOvershoot` scores each of them above zero.
25
+ *
26
+ * A rotation turned about a fixed axis by `ψ` has a matrix whose every entry
27
+ * is `a + b cos ψ + c sin ψ` (Rodrigues' formula between two fixed
28
+ * rotations), so every entry the decomposition reads is such a sinusoid,
29
+ * fitted exactly from the rotation at 0, 90 and 180 degrees. Each clinical
30
+ * bound is then a sinusoid's sign. The middle angle of the composition
31
+ * (`atan2(s, cos)` with a non-negative cosine, so `asin(s)`) lies past a
32
+ * bound `q` where `s - sin q` is positive; an outer angle `atan2(y, x)` lies
33
+ * past the upper end `β` of an interval no wider than a half turn where
34
+ * `y cos β - x sin β` (the vector's length times `sin(δ - β)`) is positive,
35
+ * and past the lower end `α` where `x sin α - y cos α` is. The alternate
36
+ * chart (`alternateRigJointAngles`) turns each outer angle by a half turn,
37
+ * negating its vector, and reflects the middle angle about its right angle.
38
+ * Where one such sinusoid exceeds `MARGIN`, its exact roots bound an arc of
39
+ * swivels (`φ ± acos((MARGIN - a) / R)`), and a reading is refused on the
40
+ * union of its axes' arcs.
41
+ *
42
+ * Every refusal is certain. A sinusoid above `MARGIN` puts its angle past
43
+ * the bound by more than `MARGIN` radians, the joints' tolerance
44
+ * (`ROM_TOLERANCE`, about 1.7e-4), far beyond the rounding of the fit, of
45
+ * the arc's ends and of the decomposition itself (near 1e-15); and an outer
46
+ * angle's vector is then longer than `MARGIN`, past the gimbal band
47
+ * (`sqrt(ε)`, 1.5e-8) inside which the decomposition pins that angle
48
+ * instead. A joint gated by swing and twist, which the box does not score,
49
+ * is read by its range instead (`swingTwistExcludedSwivels`) when the frame
50
+ * the overshoot reads it in is given, and refuses nothing otherwise; an
51
+ * axis without an interval, an outer interval wider than a half turn
52
+ * (whose refusal is an intersection, not a union, of two arcs) and a middle
53
+ * interval met twice by the half turn the middle angle covers refuse
54
+ * nothing, so the test only ever says less than the box would.
55
+ *
56
+ * @param props The joint and its rotation by swivel.
57
+ * @returns Whether every swivel in `[low, high]`, degrees, is refused; a joint with nothing to refuse refuses no swivel.
58
+ *
59
+ * @evidence contracts/development/common.md#meaningful-documentation States the premise on the rotation, why each entry is a sinusoid, each bound's sinusoid for both charts, the margin and why every refusal is certain, and every case that refuses nothing.
60
+ * @evidence contracts/development/implementation.md#principled-implementation Rodrigues' formula makes each entry an exact sinusoid in the swivel, so each bound's crossing swivels are a sinusoid's two arccos roots, and an angle's interval maps through the rest frame and the chart exactly as `decomposeJointRotationOnBasis` and `alternateRigJointAngles` read it.
61
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The entries are fitted once, each reading's axes give their bound sinusoids, the sinusoids their arcs, the arcs one merged list per reading, and the test reads the lists.
62
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Sound by construction, never by sampling: an arc is refused only from its sinusoid's roots with the joints' tolerance to spare, and a case the analysis does not cover refuses nothing rather than guessing.
63
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three rotations and nine dot products each fit the entries, a few arcs per reading are merged once, and each test is a scan of a handful of merged arcs.
64
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The fit, the arcs, their union and its test are `swivelArcs`'s, shared with a point's bounds; the arcs are built once per rotation and read by every test of its sweep.
65
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the two merged arc lists in the returned test only.
66
+ */
67
+ export function boxExcludedSwivels(props: {
68
+ /** The joint's clinical basis, admitted and normalized (`normalizeJointAxes`). */
69
+ basis: IAutoMovieJointAxes;
70
+
71
+ /** The rest frame lifting the joint's rest-relative angles to clinical ones; omitted, they are clinical. */
72
+ frame?: IAutoMovieRestFrame | undefined;
73
+
74
+ /** The joint's resolved range of motion, as the decomposition's domain and the overshoot read it; `null` refuses nothing. */
75
+ constraint: IAutoMovieJointConstraint | null;
76
+
77
+ /** The frame a swing-twist gate is read in, as the overshoot reads it (`scanJointRom`); omitted, a gated joint refuses nothing. */
78
+ joint?: swingTwistRange.IJoint | undefined;
79
+
80
+ /** The joint's bone-local rotation at a swivel, degrees: a fixed rotation turned about a fixed axis by the swivel. */
81
+ rotation: (swivel: number) => IAutoMovieQuaternion;
82
+ }): (low: number, high: number) => boolean {
83
+ const constraint: IAutoMovieJointConstraint | null = props.constraint;
84
+ if (constraint === null) return (): boolean => false;
85
+ if (constraint.swingTwist !== undefined && constraint.swingTwist !== null)
86
+ return props.joint === undefined
87
+ ? (): boolean => false
88
+ : swingTwistExcludedSwivels({
89
+ basis: props.basis,
90
+ frame: props.frame,
91
+ constraint,
92
+ joint: props.joint,
93
+ rotation: props.rotation,
94
+ });
95
+ const basis: IAutoMovieJointAxes = props.basis;
96
+ const handed: 1 | -1 =
97
+ Vector3.dot(basis.twist, Vector3.cross(basis.flexion, basis.abduction)) >= 0
98
+ ? 1
99
+ : -1;
100
+ const axes: IAutoMovieVector3[] = [
101
+ basis.flexion,
102
+ basis.abduction,
103
+ Vector3.scale(basis.twist, handed),
104
+ ];
105
+
106
+ // The entries R'[i][j] = axisᵢ · (R axisⱼ) at swivels 0, 90 and 180.
107
+ const sampled: number[][][] = [0, 90, 180].map(
108
+ (swivel: number): number[][] => {
109
+ const q: IAutoMovieQuaternion = props.rotation(swivel);
110
+ const turned: IAutoMovieVector3[] = axes.map(
111
+ (axis: IAutoMovieVector3): IAutoMovieVector3 =>
112
+ Quaternion.rotateVector(q, axis),
113
+ );
114
+ return axes.map((row: IAutoMovieVector3): number[] =>
115
+ turned.map((column: IAutoMovieVector3): number =>
116
+ Vector3.dot(row, column),
117
+ ),
118
+ );
119
+ },
120
+ );
121
+ const entry = (i: number, j: number): swivelArcs.ISinusoid => {
122
+ const [zero, quarter, half] = sampled.map(
123
+ (m: number[][]): number => m[i]![j]!,
124
+ ) as [number, number, number];
125
+ return swivelArcs.fitted(zero, quarter, half);
126
+ };
127
+
128
+ // How each clinical axis is read from the entries (as
129
+ // `decomposeJointRotationOnBasis` reads it): a distal twist composes
130
+ // Ry(a)·Rx(f)·Rz(t), with flexion in the middle; a proximal one
131
+ // Rz(t)·Ry(a)·Rx(f), with abduction in the middle.
132
+ const reading: Record<Axis, IRead> =
133
+ basis.twistPlacement === "distal"
134
+ ? {
135
+ flexion: { sine: swivelArcs.scaled(entry(1, 2), -1) },
136
+ abduction: { y: entry(0, 2), x: entry(2, 2), turn: 1 },
137
+ twist: { y: entry(1, 0), x: entry(1, 1), turn: handed },
138
+ }
139
+ : {
140
+ flexion: { y: entry(2, 1), x: entry(2, 2), turn: 1 },
141
+ abduction: { sine: swivelArcs.scaled(entry(2, 0), -1) },
142
+ twist: { y: entry(1, 0), x: entry(0, 0), turn: handed },
143
+ };
144
+
145
+ // Each chart's refused swivels: the union of its axes' arcs.
146
+ const charts: (swivelArcs.IArc[] | "all")[] = [false, true].map(
147
+ (alternate: boolean): swivelArcs.IArc[] | "all" => {
148
+ const arcs: swivelArcs.IArc[] = [];
149
+ for (const axis of AXES) {
150
+ const range: IAutoMovieAngleRange | null = constraint[axis];
151
+ if (range === null) continue;
152
+ const read: IRead = reading[axis];
153
+ for (const bound of bounds(
154
+ read,
155
+ rig(range, props.frame?.[axis]),
156
+ alternate,
157
+ )) {
158
+ const arc: swivelArcs.IArc | "all" | null = swivelArcs.above(
159
+ bound,
160
+ MARGIN,
161
+ );
162
+ if (arc === "all") return "all";
163
+ if (arc !== null) arcs.push(arc);
164
+ }
165
+ }
166
+ return swivelArcs.union(arcs);
167
+ },
168
+ );
169
+ return (low: number, high: number): boolean =>
170
+ charts.every((chart: swivelArcs.IArc[] | "all"): boolean =>
171
+ swivelArcs.covers(chart, low, high),
172
+ );
173
+ }
174
+
175
+ /**
176
+ * How far past a bound, in sine or projected units, a reading must lie to be
177
+ * refused: the joints' tolerance (`ROM_TOLERANCE`) in radians, past the
178
+ * rounding of every step and the decomposition's gimbal band.
179
+ */
180
+ const MARGIN: number = (ROM_TOLERANCE * Math.PI) / 180;
181
+
182
+ /** The three clinical axes. */
183
+ const AXES: readonly Axis[] = ["flexion", "abduction", "twist"];
184
+
185
+ /** A clinical axis. */
186
+ type Axis = "flexion" | "abduction" | "twist";
187
+
188
+ /** How an axis is read: the middle angle's sine, or an outer angle's vector and the sign its rest-relative angle takes. */
189
+ type IRead =
190
+ | { sine: swivelArcs.ISinusoid }
191
+ | { y: swivelArcs.ISinusoid; x: swivelArcs.ISinusoid; turn: 1 | -1 };
192
+
193
+ /** A clinical interval as rest-relative degrees, ordered (the inverse of `toClinicalAngle`). */
194
+ function rig(
195
+ range: IAutoMovieAngleRange,
196
+ frame: IAutoMovieAxisFrame | undefined,
197
+ ): [number, number] {
198
+ const sign: number = frame?.sign ?? 1;
199
+ const neutral: number = frame?.neutral ?? 0;
200
+ const ends: number[] = [
201
+ (range.min - neutral) * sign,
202
+ (range.max - neutral) * sign,
203
+ ];
204
+ return [Math.min(...ends), Math.max(...ends)];
205
+ }
206
+
207
+ /**
208
+ * The sinusoids positive where one chart's reading of an axis lies past its
209
+ * rest-relative interval `[lo, hi]`, any full-turn alias of the angle
210
+ * considered (`nearestAngleAlias`); none where the analysis cannot refuse.
211
+ */
212
+ function bounds(
213
+ read: IRead,
214
+ [lo, hi]: [number, number],
215
+ alternate: boolean,
216
+ ): swivelArcs.ISinusoid[] {
217
+ if (hi - lo >= 360) return [];
218
+ if ("sine" in read) {
219
+ // The middle angle is asin(s), or in the alternate chart 180 - asin(s),
220
+ // which lies in [lo, hi] exactly where asin(s) lies in [180 - hi, 180 - lo].
221
+ const [from, to] = alternate ? [180 - hi, 180 - lo] : [lo, hi];
222
+ const first: number = Math.ceil((-90 - to) / 360);
223
+ const last: number = Math.floor((90 - from) / 360);
224
+ if (last < first) return [{ a: 1, b: 0, c: 0 }];
225
+ if (last > first) return [];
226
+ const p: number = Math.max(from + 360 * first, -90);
227
+ const q: number = Math.min(to + 360 * first, 90);
228
+ const out: swivelArcs.ISinusoid[] = [];
229
+ if (q < 90)
230
+ out.push({
231
+ ...read.sine,
232
+ a: read.sine.a - Math.sin(q * Quaternion.DEG2RAD),
233
+ });
234
+ if (p > -90)
235
+ out.push(
236
+ swivelArcs.scaled(
237
+ { ...read.sine, a: read.sine.a - Math.sin(p * Quaternion.DEG2RAD) },
238
+ -1,
239
+ ),
240
+ );
241
+ return out;
242
+ }
243
+ // An outer angle δ = atan2(y, x) reads `turn · δ`, or a half turn more in
244
+ // the alternate chart, where the vector is negated.
245
+ if (hi - lo > 180) return [];
246
+ const ends: number[] = [lo * read.turn, hi * read.turn];
247
+ const alpha: number = Math.min(...ends) * Quaternion.DEG2RAD;
248
+ const beta: number = Math.max(...ends) * Quaternion.DEG2RAD;
249
+ const sign: number = alternate ? -1 : 1;
250
+ return [
251
+ swivelArcs.scaled(
252
+ swivelArcs.combined(read.y, Math.cos(beta), read.x, -Math.sin(beta)),
253
+ sign,
254
+ ),
255
+ swivelArcs.scaled(
256
+ swivelArcs.combined(read.x, Math.sin(alpha), read.y, -Math.cos(alpha)),
257
+ sign,
258
+ ),
259
+ ];
260
+ }
@@ -61,8 +61,22 @@ const HAND: readonly string[] = [
61
61
  * The forearm's twist is pronation and supination, which happens beyond the
62
62
  * elbow's hinge, so the lower arms declare a distal twist
63
63
  * (`AutoMovieJointTwistPlacement`): twisting a bent forearm turns it about its
64
- * own length and leaves where it points unchanged. Every other bone keeps the
65
- * proximal default.
64
+ * own length and leaves where it points unchanged.
65
+ *
66
+ * The upper arms declare a distal twist too. The humerus's internal and
67
+ * external rotation turns it about its own length wherever the arm points,
68
+ * which only the distal order composes. In the proximal order the twist turns
69
+ * about the T-pose arm line, fixed in the shoulder girdle: for an arm in the
70
+ * sagittal plane (hanging, swinging, reaching forward) that line is the
71
+ * flexion axis carried there by the 90 degree abduction from rest, so flexion
72
+ * and twist turn about one axis, the chart is at its gimbal for every such
73
+ * pose, and the arm's rotation about its length has no coordinate of its own
74
+ * there. With the distal order `flexion` and `abduction` alone place the arm
75
+ * (its line's latitude toward the front and its longitude in the frontal
76
+ * plane) and `twist` is the humeral rotation; the only gimbal left is the arm
77
+ * pointing straight forward or back, where abduction and twist turn about the
78
+ * arm's own line. A pose with no twist is the same rotation in both orders.
79
+ * Every other bone keeps the proximal default.
66
80
  *
67
81
  * Opt in by passing this to {@link resolvePose} / `applyPose`; a bone that
68
82
  * declares its own `axes` keeps them, and a bone absent from both uses
@@ -85,10 +99,11 @@ export const HUMANOID_JOINT_AXES: Partial<
85
99
  "rightUpperArm",
86
100
  "rightLowerArm",
87
101
  ];
88
- const forearm: IAutoMovieJointAxes = { ...arm, twistPlacement: "distal" };
102
+ // the humerus and the forearm turn about their own length beyond the swing
103
+ const turning: IAutoMovieJointAxes = { ...arm, twistPlacement: "distal" };
89
104
  const table: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>> = {};
90
105
  for (const s of slots)
91
- table[s] = s === "leftLowerArm" || s === "rightLowerArm" ? forearm : arm;
106
+ table[s] = s === "leftShoulder" || s === "rightShoulder" ? arm : turning;
92
107
  const hand: IAutoMovieJointAxes = {
93
108
  flexion: { x: 0, y: 0, z: 1 },
94
109
  abduction: { x: 0, y: 1, z: 0 },
@@ -11,9 +11,11 @@ import type {
11
11
 
12
12
  import { Quaternion } from "../math/Quaternion";
13
13
  import { Vector3 } from "../math/Vector3";
14
+ import { physicalHullFaces } from "../physics/physicalHullFaces";
14
15
  import { physicalShapeSegmentDistance } from "../physics/physicalShapeSegmentDistance";
15
16
  import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
16
17
  import { clampJointToSkeleton } from "../rom/clampJointToSkeleton";
18
+ import { ROM_TOLERANCE } from "../rom/constants/ROM_TOLERANCE";
17
19
  import { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
18
20
  import { IAutoMovieSkeletonTopology } from "./IAutoMovieSkeletonTopology";
19
21
  import { resolvePose } from "./resolvePose";
@@ -215,6 +217,24 @@ export function curlChainUntilContact(
215
217
  * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the physical profile's shape union and the resolver's axes and rest frames.
216
218
  */
217
219
  export namespace curlChainUntilContact {
220
+ /**
221
+ * How far a curled digit's angle may move with the limb that carries it,
222
+ * degrees: a point the limb carries moves by no more than the limb's reach
223
+ * times the joints' tolerance (`ROM_TOLERANCE`, in radians) when the
224
+ * limb's chain is resolved to it, and a digit that closes on a contact
225
+ * follows the hand by about as far at its tip, which at its lever (the
226
+ * length from the joint to the digit's tip) turns it by this angle. A
227
+ * curl solves its own contact far finer (a step bisected 30 times); this
228
+ * is the change a curled digit shows when the limb's resolution moves the
229
+ * hand, not the curl's precision.
230
+ *
231
+ * @param reach The limb's reach, metres: its two segments' lengths.
232
+ * @param lever The joint's lever, metres: its length to the digit's tip.
233
+ * @returns Degrees.
234
+ */
235
+ export function resolution(reach: number, lever: number): number {
236
+ return (ROM_TOLERANCE * reach) / lever;
237
+ }
218
238
  /** The curl request. */
219
239
  export interface IInput {
220
240
  /** The rig, whose range of motion caps every flexion. */
@@ -287,14 +307,21 @@ export namespace curlChainUntilContact {
287
307
 
288
308
  /** Refuse a shape whose dimensions cannot give a distance. */
289
309
  function validate(shape: P.IShape): void {
290
- const ok: boolean =
291
- shape.kind === "sphere"
292
- ? shape.radius > 0
293
- : shape.kind === "capsule"
294
- ? shape.radius > 0 && shape.halfLength >= 0
295
- : shape.halfExtents.x > 0 &&
296
- shape.halfExtents.y > 0 &&
297
- shape.halfExtents.z > 0;
310
+ let ok: boolean;
311
+ if (shape.kind === "sphere") ok = shape.radius > 0;
312
+ else if (shape.kind === "capsule")
313
+ ok = shape.radius > 0 && shape.halfLength >= 0;
314
+ else if (shape.kind === "box")
315
+ ok =
316
+ shape.halfExtents.x > 0 &&
317
+ shape.halfExtents.y > 0 &&
318
+ shape.halfExtents.z > 0;
319
+ else if (shape.kind === "hull")
320
+ ok = physicalHullFaces(shape.points).faces.length >= 4;
321
+ else {
322
+ shape satisfies never;
323
+ ok = false;
324
+ }
298
325
  if (!ok)
299
326
  throw new Error(`A collider ${shape.id} has non-positive dimensions`);
300
327
  }
@@ -1,58 +1,12 @@
1
- import {
2
- IAutoMovieAngleRange,
3
- IAutoMovieJointAxes,
4
- IAutoMovieJointConstraint,
5
- IAutoMovieQuaternion,
6
- IAutoMovieVector3,
7
- } from "@automovie/interface";
1
+ import { IAutoMovieJointAxes, IAutoMovieQuaternion } from "@automovie/interface";
8
2
 
9
- import { Quaternion } from "../math/Quaternion";
10
- import { Vector3 } from "../math/Vector3";
11
3
  import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
12
- import { toClinicalAngle } from "../rom/toClinicalAngle";
13
4
  import { IAutoMovieJointRotationDomain } from "./IAutoMovieJointRotationDomain";
14
5
  import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
15
6
  import { DEFAULT_JOINT_AXES } from "./constants/DEFAULT_JOINT_AXES";
16
- import { jointRomOvershoot } from "./jointRomOvershoot";
7
+ import { decomposeJointRotationOnBasis } from "./decomposeJointRotationOnBasis";
17
8
  import { normalizeJointAxes } from "./normalizeJointAxes";
18
9
 
19
- const RAD2DEG: number = 180 / Math.PI;
20
-
21
- const QUATERNION_AXES: readonly ["x", "y", "z", "w"] = ["x", "y", "z", "w"];
22
-
23
- /**
24
- * Projected cosine below which cancellation is at unit-matrix roundoff and the
25
- * gimbal convention pins one outer angle. Resolvable near-gimbal turns stay active.
26
- */
27
- const GIMBAL_COSINE_EPSILON: number = 4 * Number.EPSILON;
28
-
29
- /** Choose an admitted full-turn alias when one exists; never clamp an angle. */
30
- const periodicAngle: (
31
- angle: number,
32
- range: IAutoMovieAngleRange | null,
33
- ) => number = (angle: number, range: IAutoMovieAngleRange | null): number => {
34
- const minimum: number = range?.min ?? 0;
35
- const maximum: number = range?.max ?? 0;
36
- if (angle >= minimum && angle <= maximum) return angle;
37
- const first: number = Math.ceil((minimum - angle) / 360);
38
- const last: number = Math.floor((maximum - angle) / 360);
39
- return first > last
40
- ? angle
41
- : angle + 360 * Math.max(first, Math.min(last, 0));
42
- };
43
-
44
- const assertFiniteQuaternion: (q: IAutoMovieQuaternion) => void = (
45
- q: IAutoMovieQuaternion,
46
- ): void => {
47
- for (const axis of QUATERNION_AXES) {
48
- const value: number = q[axis];
49
- if (!Number.isFinite(value))
50
- throw new Error(
51
- `decomposeJointRotation quaternion.${axis} must be finite, but was ${value}`,
52
- );
53
- }
54
- };
55
-
56
10
  /**
57
11
  * Recover a joint's flexion, abduction and twist, in degrees, from its
58
12
  * bone-local rotation: the inverse of {@link jointToQuaternion} for the same
@@ -66,6 +20,9 @@ const assertFiniteQuaternion: (q: IAutoMovieQuaternion) => void = (
66
20
  * (abduction ±90 for a proximal twist, flexion ±90 for a distal one) only one
67
21
  * combination of the outer angles is determined, so the other outer angle is
68
22
  * pinned to 0 and twist takes the rest; the angles still rebuild the rotation.
23
+ * The pin holds within a projected cosine of the square root of the unit
24
+ * roundoff, about 1.5e-8, where the two outer angles are otherwise rounding
25
+ * noise and the pinned angles rebuild the rotation within 1e-7 radian.
69
26
  * A left-handed basis, such as the default (`flexion × abduction = −twist`),
70
27
  * is extracted against `−twist` and the twist sign restored, so the round trip
71
28
  * holds for any orthonormal basis.
@@ -74,7 +31,7 @@ const assertFiniteQuaternion: (q: IAutoMovieQuaternion) => void = (
74
31
  * `clinical = sign · r + neutral`. A `domain` with a non-null constraint also
75
32
  * considers the rotation's second Euler chart, `(f + 180, 180 − a, t + 180)`
76
33
  * for a proximal twist and `(180 − f, a + 180, t + 180)` for a distal one, and
77
- * full-turn aliases of each that fall inside the constraint's ranges. The
34
+ * the full-turn alias of each angle nearest the constraint's range. The
78
35
  * candidate with the least {@link jointRomOvershoot} wins, the principal chart
79
36
  * on a tie. Every candidate is the same rotation, so a pose no chart can hold
80
37
  * keeps its overshoot instead of being clamped.
@@ -90,7 +47,7 @@ const assertFiniteQuaternion: (q: IAutoMovieQuaternion) => void = (
90
47
  * @param domain Bone and resolved ROM that choose among equivalent charts;
91
48
  * omitted or with a `null` constraint, the principal chart is returned.
92
49
  *
93
- * @evidence contracts/development/implementation.md#principled-implementation Closed-form Euler extraction reads sine and projected cosine through atan2, preserving resolvable near-gimbal rotations that asin can round to ninety degrees; only cosine at four binary64 unit epsilons takes the undetermined-angle convention. Normalized orthogonal axes and unit input rotations are the premises, and alternate charts/full turns retain the same rotation up to roundoff.
50
+ * @evidence contracts/development/implementation.md#principled-implementation Closed-form Euler extraction reads sine and projected cosine through atan2, preserving resolvable near-gimbal rotations that asin can round to ninety degrees; only a projected cosine within the square root of the binary64 unit roundoff, where a rounding error and the pin's truncation error meet, takes the undetermined-angle convention. Normalized orthogonal axes and unit input rotations are the premises, and alternate charts/full turns retain the same rotation up to roundoff.
94
51
  * @evidence contracts/development/implementation.md#clear-and-simple-structure The extraction, the handedness correction, the clinical lift and the ROM chart choice sit in one inverse because each depends on the others' convention; ROM scoring is delegated to `jointRomOvershoot` and frame arithmetic to `toClinicalAngle`, so the gate and this inverse read one rule.
95
52
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Selection compares the caller's unchanged constraint and never clamps an angle into range; the gimbal pin is the standard convention for an undetermined pair, not a compensation, and no bone is special-cased.
96
53
  * @evidence contracts/development/common.md#meaningful-documentation States the inverse relationship, both composition orders, the gimbal convention, the handedness correction, the frame lift, both alternate charts and the tie rule, the thrown inputs, the unit-quaternion premise, and each parameter's default.
@@ -108,132 +65,12 @@ export const decomposeJointRotation: (
108
65
  axes: IAutoMovieJointAxes = DEFAULT_JOINT_AXES,
109
66
  frame?: IAutoMovieRestFrame,
110
67
  domain?: IAutoMovieJointRotationDomain,
111
- ): IAutoMovieResolvedJointAngles => {
112
- assertFiniteQuaternion(q);
113
- const basis: IAutoMovieJointAxes = normalizeJointAxes(
114
- axes,
115
- "decomposeJointRotation axes",
68
+ ): IAutoMovieResolvedJointAngles =>
69
+ // The extraction lives in `decomposeJointRotationOnBasis`, which a solver
70
+ // calls directly on a basis it normalized once; this entry admits the basis.
71
+ decomposeJointRotationOnBasis(
72
+ q,
73
+ normalizeJointAxes(axes, "decomposeJointRotation axes"),
74
+ frame,
75
+ domain,
116
76
  );
117
-
118
- // Lift a rig-relative extraction into clinical angles (the inverse of
119
- // jointToQuaternion's `frame` map); the identity when no frame is given.
120
- const clinical: (
121
- rig: IAutoMovieResolvedJointAngles,
122
- ) => IAutoMovieResolvedJointAngles = (
123
- rig: IAutoMovieResolvedJointAngles,
124
- ): IAutoMovieResolvedJointAngles => ({
125
- // toClinicalAngle only returns null for a null input; these are numbers.
126
- flexion: toClinicalAngle(rig.flexion, frame?.flexion)!,
127
- abduction: toClinicalAngle(rig.abduction, frame?.abduction)!,
128
- twist: toClinicalAngle(rig.twist, frame?.twist)!,
129
- });
130
- // Right-handedness of the basis: +1 when flex × abd = +twist. A left-handed
131
- // triple is made right-handed by extracting against −twist, then negating the
132
- // recovered twist (a rotation about −t by θ is one about t by −θ).
133
- const handed: number =
134
- Vector3.dot(basis.twist, Vector3.cross(basis.flexion, basis.abduction)) >= 0
135
- ? 1
136
- : -1;
137
- const twistAxis: IAutoMovieVector3 = Vector3.scale(basis.twist, handed);
138
- const lift: (
139
- rig: IAutoMovieResolvedJointAngles,
140
- ) => IAutoMovieResolvedJointAngles = (
141
- rig: IAutoMovieResolvedJointAngles,
142
- ): IAutoMovieResolvedJointAngles => {
143
- const principal: IAutoMovieResolvedJointAngles = clinical(rig);
144
- if (domain === undefined || domain.constraint === null) return principal;
145
- const constraint: IAutoMovieJointConstraint = domain.constraint;
146
- const align: (
147
- candidate: IAutoMovieResolvedJointAngles,
148
- ) => IAutoMovieResolvedJointAngles = (
149
- candidate: IAutoMovieResolvedJointAngles,
150
- ): IAutoMovieResolvedJointAngles => ({
151
- flexion: periodicAngle(candidate.flexion, constraint.flexion),
152
- abduction: periodicAngle(candidate.abduction, constraint.abduction),
153
- twist: periodicAngle(candidate.twist, constraint.twist),
154
- });
155
- const alternate: IAutoMovieResolvedJointAngles = clinical({
156
- flexion:
157
- basis.twistPlacement === "distal"
158
- ? 180 - rig.flexion
159
- : rig.flexion + 180,
160
- abduction:
161
- basis.twistPlacement === "distal"
162
- ? rig.abduction + 180
163
- : 180 - rig.abduction,
164
- twist: rig.twist + 180 * handed,
165
- });
166
- let selected: IAutoMovieResolvedJointAngles = principal;
167
- let overshoot: number = jointRomOvershoot(
168
- { bone: domain.bone, ...selected },
169
- constraint,
170
- );
171
- for (const candidate of [align(principal), align(alternate)]) {
172
- const next: number = jointRomOvershoot(
173
- { bone: domain.bone, ...candidate },
174
- constraint,
175
- );
176
- if (next < overshoot) {
177
- selected = candidate;
178
- overshoot = next;
179
- }
180
- }
181
- return selected;
182
- };
183
-
184
- const Rf: IAutoMovieVector3 = Quaternion.rotateVector(q, basis.flexion);
185
- const Ra: IAutoMovieVector3 = Quaternion.rotateVector(q, basis.abduction);
186
- const Rt: IAutoMovieVector3 = Quaternion.rotateVector(q, twistAxis);
187
-
188
- // Entries of R' = Mᵀ R M (M = [flex|abd|twist]): R'[i][j] = axisᵢ · (R axisⱼ).
189
- if (basis.twistPlacement === "distal") {
190
- // R = Ry(a)·Rx(f)·Rz(t): R12 = −sin f, R02 = sin a cos f, R22 = cos a cos f,
191
- // R10 = cos f sin t, R11 = cos f cos t (row i: basis axis i, column j:
192
- // basis axis j rotated)
193
- const r12: number = Vector3.dot(basis.abduction, Rt);
194
- const r10: number = Vector3.dot(basis.abduction, Rf);
195
- const r11: number = Vector3.dot(basis.abduction, Ra);
196
- const cosine: number = Math.hypot(r10, r11);
197
- if (cosine <= GIMBAL_COSINE_EPSILON) {
198
- // with abduction pinned to 0, R = Rx(±90°)·Rz(t): R00 = cos t, R01 = −sin t
199
- const r00: number = Vector3.dot(basis.flexion, Rf);
200
- const r01: number = Vector3.dot(basis.flexion, Ra);
201
- return lift({
202
- flexion: r12 < 0 ? 90 : -90,
203
- abduction: 0,
204
- twist: handed * Math.atan2(-r01, r00) * RAD2DEG,
205
- });
206
- }
207
- return lift({
208
- flexion: Math.atan2(-r12, cosine) * RAD2DEG,
209
- abduction:
210
- Math.atan2(Vector3.dot(basis.flexion, Rt), Vector3.dot(twistAxis, Rt)) *
211
- RAD2DEG,
212
- twist: handed * Math.atan2(r10, r11) * RAD2DEG,
213
- });
214
- }
215
-
216
- const m00: number = Vector3.dot(basis.flexion, Rf);
217
- const m10: number = Vector3.dot(basis.abduction, Rf);
218
- const m20: number = Vector3.dot(twistAxis, Rf);
219
- const m21: number = Vector3.dot(twistAxis, Ra);
220
- const m22: number = Vector3.dot(twistAxis, Rt);
221
-
222
- const cosine: number = Math.hypot(m00, m10);
223
- if (cosine <= GIMBAL_COSINE_EPSILON) {
224
- // Gimbal: abduction = ±90°, flexion folds into twist. Pin flexion = 0.
225
- const m01: number = Vector3.dot(basis.flexion, Ra);
226
- const m11: number = Vector3.dot(basis.abduction, Ra);
227
- // Both gimbals leave only (twist ± flexion) determined; with flexion pinned
228
- // to 0, twist = −atan2(R'[0][1], R'[1][1]) reconstructs the rotation.
229
- const abduction: number = m20 < 0 ? 90 : -90;
230
- const twist: number = -Math.atan2(m01, m11) * RAD2DEG;
231
- return lift({ flexion: 0, abduction, twist: handed * twist });
232
- }
233
-
234
- return lift({
235
- flexion: Math.atan2(m21, m22) * RAD2DEG,
236
- abduction: Math.atan2(-m20, cosine) * RAD2DEG,
237
- twist: handed * Math.atan2(m10, m00) * RAD2DEG,
238
- });
239
- };