@automovie/engine 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (966) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/analysis/index.d.ts +5 -0
  4. package/lib/analysis/index.js +5 -0
  5. package/lib/analysis/index.js.map +1 -1
  6. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  7. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  8. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  9. package/lib/anthropometry/index.d.ts +1 -0
  10. package/lib/anthropometry/index.js +18 -0
  11. package/lib/anthropometry/index.js.map +1 -0
  12. package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
  13. package/lib/architecture/appendBuiltRegionDefects.js +3 -3
  14. package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
  15. package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
  16. package/lib/architecture/builtOutlineIsClosed.js +3 -3
  17. package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
  18. package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
  19. package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
  20. package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
  21. package/lib/architecture/constants/index.d.ts +1 -1
  22. package/lib/architecture/constants/index.js +1 -1
  23. package/lib/architecture/constants/index.js.map +1 -1
  24. package/lib/architecture/index.d.ts +157 -117
  25. package/lib/architecture/index.js +171 -158
  26. package/lib/architecture/index.js.map +1 -1
  27. package/lib/cache/index.d.ts +9 -0
  28. package/lib/cache/index.js +26 -0
  29. package/lib/cache/index.js.map +1 -0
  30. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  31. package/lib/composition/AutoMovieComposition.js +4 -3
  32. package/lib/composition/AutoMovieComposition.js.map +1 -1
  33. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  34. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  35. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  36. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  37. package/lib/composition/AutoMovieScheduleError.js +51 -0
  38. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  39. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  40. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  41. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  42. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  43. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  44. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  45. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  46. package/lib/composition/index.d.ts +12 -7
  47. package/lib/composition/index.js +12 -2
  48. package/lib/composition/index.js.map +1 -1
  49. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  50. package/lib/composition/markAutoMovieContacts.js +69 -0
  51. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  52. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  53. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  54. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  55. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  56. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  57. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  58. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  59. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  60. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  61. package/lib/constants/index.d.ts +2 -0
  62. package/lib/constants/index.js +2 -0
  63. package/lib/constants/index.js.map +1 -1
  64. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  65. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  66. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  67. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  68. package/lib/drawing/index.d.ts +12 -0
  69. package/lib/drawing/index.js +12 -0
  70. package/lib/drawing/index.js.map +1 -1
  71. package/lib/effectRuntime/index.d.ts +7 -0
  72. package/lib/effectRuntime/index.js +7 -0
  73. package/lib/effectRuntime/index.js.map +1 -1
  74. package/lib/film/compileAttach.js +2 -5
  75. package/lib/film/compileAttach.js.map +1 -1
  76. package/lib/film/compileLaunch.d.ts +2 -2
  77. package/lib/film/compileLaunch.js +4 -3
  78. package/lib/film/compileLaunch.js.map +1 -1
  79. package/lib/film/constants/index.d.ts +3 -0
  80. package/lib/film/constants/index.js +3 -0
  81. package/lib/film/constants/index.js.map +1 -1
  82. package/lib/film/index.d.ts +61 -6
  83. package/lib/film/index.js +61 -12
  84. package/lib/film/index.js.map +1 -1
  85. package/lib/film/propAnchorFrame.js +6 -9
  86. package/lib/film/propAnchorFrame.js.map +1 -1
  87. package/lib/film/stageScene.js +3 -10
  88. package/lib/film/stageScene.js.map +1 -1
  89. package/lib/film/staging/index.d.ts +11 -0
  90. package/lib/film/staging/index.js +28 -0
  91. package/lib/film/staging/index.js.map +1 -0
  92. package/lib/film/staging/lowerLightPlacement.js +4 -7
  93. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  94. package/lib/formationSlotPosition.d.ts +6 -1
  95. package/lib/formationSlotPosition.js +38 -3
  96. package/lib/formationSlotPosition.js.map +1 -1
  97. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  98. package/lib/geometry/IAutoMovieMark.js +3 -0
  99. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  100. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  101. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  102. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  103. package/lib/geometry/constants/index.d.ts +2 -0
  104. package/lib/geometry/constants/index.js +2 -0
  105. package/lib/geometry/constants/index.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  107. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  108. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  109. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  110. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  111. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  112. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  113. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  114. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  115. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  116. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  117. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  118. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  120. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  121. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  123. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  124. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  125. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  126. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  127. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  128. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  129. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  130. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  131. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  132. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  133. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  135. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  136. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  137. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  138. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  139. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  140. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  141. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  142. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  143. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  144. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  145. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  146. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  147. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  148. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  149. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  150. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  151. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  152. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  153. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  154. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  155. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  156. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  157. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  158. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  159. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  160. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  161. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  162. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  163. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  164. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  165. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  166. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  167. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  168. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  169. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  170. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  171. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  172. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  173. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  174. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  175. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  176. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  177. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  178. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  179. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  180. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  181. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  182. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  183. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  184. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  185. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  186. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  187. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  188. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  189. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  190. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  191. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  192. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  193. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  194. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  195. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  196. package/lib/geometry/construction/index.d.ts +82 -2
  197. package/lib/geometry/construction/index.js +82 -2
  198. package/lib/geometry/construction/index.js.map +1 -1
  199. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  200. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  201. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  202. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  203. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  204. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  205. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  206. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  207. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  208. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  209. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  210. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  211. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  212. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  213. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  214. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  215. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  216. package/lib/geometry/curve/index.d.ts +48 -25
  217. package/lib/geometry/curve/index.js +48 -25
  218. package/lib/geometry/curve/index.js.map +1 -1
  219. package/lib/geometry/extract/index.d.ts +0 -1
  220. package/lib/geometry/extract/index.js +0 -1
  221. package/lib/geometry/extract/index.js.map +1 -1
  222. package/lib/geometry/index.d.ts +87 -53
  223. package/lib/geometry/index.js +87 -50
  224. package/lib/geometry/index.js.map +1 -1
  225. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  226. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  227. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  228. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  229. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  230. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  231. package/lib/geometry/sweep/index.d.ts +54 -15
  232. package/lib/geometry/sweep/index.js +54 -1
  233. package/lib/geometry/sweep/index.js.map +1 -1
  234. package/lib/index.d.ts +41 -450
  235. package/lib/index.js +41 -660
  236. package/lib/index.js.map +1 -1
  237. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  238. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  239. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  240. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  241. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  242. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  243. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  244. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  245. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  246. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  247. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  248. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  249. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  250. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  251. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  252. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  253. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  254. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  255. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  256. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  257. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  258. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  259. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  260. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  261. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  262. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  263. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  264. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  265. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  266. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  267. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  268. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  269. package/lib/kinematics/curlChainUntilContact.js +45 -5
  270. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  271. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  272. package/lib/kinematics/decomposeJointRotation.js +10 -131
  273. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  274. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  275. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  276. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  277. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  278. package/lib/kinematics/fitDigitDescent.js +142 -0
  279. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  280. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  281. package/lib/kinematics/fitDigitToTarget.js +251 -0
  282. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  283. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  284. package/lib/kinematics/hingedArmArticulation.js +273 -84
  285. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  286. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  287. package/lib/kinematics/hingedArmSwivel.js +196 -0
  288. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  289. package/lib/kinematics/index.d.ts +30 -7
  290. package/lib/kinematics/index.js +30 -5
  291. package/lib/kinematics/index.js.map +1 -1
  292. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  293. package/lib/kinematics/jointRomOvershoot.js +21 -17
  294. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  295. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  296. package/lib/kinematics/jointToQuaternion.js +4 -19
  297. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  298. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  299. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  300. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  301. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  302. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  303. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  304. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  305. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  306. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  307. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  308. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  309. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  310. package/lib/kinematics/normalizeJointAxes.js +52 -12
  311. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  312. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  313. package/lib/kinematics/poseJointCodec.js +70 -0
  314. package/lib/kinematics/poseJointCodec.js.map +1 -0
  315. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  316. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  317. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  318. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  319. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  320. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  321. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  322. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  323. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  324. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  325. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  326. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  327. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  328. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  329. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  330. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  331. package/lib/kinematics/swingTwistBasis.js +116 -0
  332. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  333. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  334. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  335. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  336. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  337. package/lib/kinematics/swingTwistRange.js +322 -0
  338. package/lib/kinematics/swingTwistRange.js.map +1 -0
  339. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  340. package/lib/kinematics/swingTwistRegion.js +212 -0
  341. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  342. package/lib/kinematics/swivelArcs.d.ts +166 -0
  343. package/lib/kinematics/swivelArcs.js +200 -0
  344. package/lib/kinematics/swivelArcs.js.map +1 -0
  345. package/lib/math/Quaternion.d.ts +29 -2
  346. package/lib/math/Quaternion.js +33 -2
  347. package/lib/math/Quaternion.js.map +1 -1
  348. package/lib/math/Transform.d.ts +50 -0
  349. package/lib/math/Transform.js +58 -0
  350. package/lib/math/Transform.js.map +1 -0
  351. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  352. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  353. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  354. package/lib/math/bracketedBisection.d.ts +33 -0
  355. package/lib/math/bracketedBisection.js +52 -0
  356. package/lib/math/bracketedBisection.js.map +1 -0
  357. package/lib/math/bracketedRoot.d.ts +32 -0
  358. package/lib/math/bracketedRoot.js +76 -0
  359. package/lib/math/bracketedRoot.js.map +1 -0
  360. package/lib/math/constants/index.d.ts +1 -0
  361. package/lib/math/constants/index.js +18 -0
  362. package/lib/math/constants/index.js.map +1 -0
  363. package/lib/math/index.d.ts +64 -5
  364. package/lib/math/index.js +64 -5
  365. package/lib/math/index.js.map +1 -1
  366. package/lib/math/nearestAngleAlias.d.ts +27 -0
  367. package/lib/math/nearestAngleAlias.js +44 -0
  368. package/lib/math/nearestAngleAlias.js.map +1 -0
  369. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  370. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  371. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  372. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  373. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  374. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  375. package/lib/measureAutoMovieGeometryReach.js +2 -4
  376. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  377. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  378. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  379. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  380. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  381. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  382. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  383. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  384. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  385. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  386. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  387. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  388. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  389. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  390. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  391. package/lib/motion/basisOf.d.ts +18 -0
  392. package/lib/motion/basisOf.js +25 -0
  393. package/lib/motion/basisOf.js.map +1 -0
  394. package/lib/motion/carriedAcceleration.d.ts +43 -0
  395. package/lib/motion/carriedAcceleration.js +55 -0
  396. package/lib/motion/carriedAcceleration.js.map +1 -0
  397. package/lib/motion/carriedRate.d.ts +48 -0
  398. package/lib/motion/carriedRate.js +60 -0
  399. package/lib/motion/carriedRate.js.map +1 -0
  400. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  401. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  402. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  403. package/lib/motion/constants/index.d.ts +1 -0
  404. package/lib/motion/constants/index.js +1 -0
  405. package/lib/motion/constants/index.js.map +1 -1
  406. package/lib/motion/fitChainBend.d.ts +23 -0
  407. package/lib/motion/fitChainBend.js +293 -0
  408. package/lib/motion/fitChainBend.js.map +1 -0
  409. package/lib/motion/fitChainToTarget.d.ts +11 -13
  410. package/lib/motion/fitChainToTarget.js +12 -283
  411. package/lib/motion/fitChainToTarget.js.map +1 -1
  412. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  413. package/lib/motion/fitHingedChainCandidate.js +186 -76
  414. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  415. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  416. package/lib/motion/fitHingedRotationError.js +107 -0
  417. package/lib/motion/fitHingedRotationError.js.map +1 -0
  418. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  419. package/lib/motion/fitSeededChainToTarget.js +32 -0
  420. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  421. package/lib/motion/gaitMotion.js +7 -13
  422. package/lib/motion/gaitMotion.js.map +1 -1
  423. package/lib/motion/gestureMotion.js +2 -5
  424. package/lib/motion/gestureMotion.js.map +1 -1
  425. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  426. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  427. package/lib/motion/index.d.ts +40 -9
  428. package/lib/motion/index.js +40 -12
  429. package/lib/motion/index.js.map +1 -1
  430. package/lib/motion/inertializeOffset.d.ts +15 -2
  431. package/lib/motion/inertializeOffset.js +16 -3
  432. package/lib/motion/inertializeOffset.js.map +1 -1
  433. package/lib/motion/inertializePose.d.ts +36 -13
  434. package/lib/motion/inertializePose.js +122 -43
  435. package/lib/motion/inertializePose.js.map +1 -1
  436. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  437. package/lib/motion/integrateAirborneRotation.js +204 -0
  438. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  439. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  440. package/lib/motion/integrateMotionTrajectory.js +156 -0
  441. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  442. package/lib/motion/orientChainEffector.d.ts +1 -1
  443. package/lib/motion/orientChainEffector.js +15 -7
  444. package/lib/motion/orientChainEffector.js.map +1 -1
  445. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  446. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  447. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  448. package/lib/motion/sampleMotion.js +2 -5
  449. package/lib/motion/sampleMotion.js.map +1 -1
  450. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  451. package/lib/motion/samplePoseVelocity.js +126 -38
  452. package/lib/motion/samplePoseVelocity.js.map +1 -1
  453. package/lib/motion/smoothMinimum.d.ts +29 -0
  454. package/lib/motion/smoothMinimum.js +40 -0
  455. package/lib/motion/smoothMinimum.js.map +1 -0
  456. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  457. package/lib/motion/solveAirborneTakeoff.js +324 -0
  458. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  459. package/lib/motion/solveDistalTwist.d.ts +62 -0
  460. package/lib/motion/solveDistalTwist.js +152 -0
  461. package/lib/motion/solveDistalTwist.js.map +1 -0
  462. package/lib/motion/speedProfile.d.ts +175 -0
  463. package/lib/motion/speedProfile.js +261 -0
  464. package/lib/motion/speedProfile.js.map +1 -0
  465. package/lib/motion/splitDistalTwist.d.ts +12 -17
  466. package/lib/motion/splitDistalTwist.js +37 -40
  467. package/lib/motion/splitDistalTwist.js.map +1 -1
  468. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  469. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  470. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  471. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  472. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  473. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  474. package/lib/perform/index.d.ts +10 -0
  475. package/lib/perform/index.js +10 -0
  476. package/lib/perform/index.js.map +1 -1
  477. package/lib/physics/AutoMovieAir.d.ts +21 -0
  478. package/lib/physics/AutoMovieAir.js +26 -0
  479. package/lib/physics/AutoMovieAir.js.map +1 -0
  480. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  481. package/lib/physics/AutoMovieGravity.js +30 -0
  482. package/lib/physics/AutoMovieGravity.js.map +1 -0
  483. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  484. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  485. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  486. package/lib/physics/admitMotionGeometry.js +12 -0
  487. package/lib/physics/admitMotionGeometry.js.map +1 -1
  488. package/lib/physics/bindPhysicalWorld.js +16 -4
  489. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  490. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  491. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  492. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  493. package/lib/physics/deriveCenterOfMass.js +2 -5
  494. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  495. package/lib/physics/derivePhysicalProfile.js +7 -5
  496. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  497. package/lib/physics/index.d.ts +155 -2
  498. package/lib/physics/index.js +155 -2
  499. package/lib/physics/index.js.map +1 -1
  500. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  501. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  502. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  503. package/lib/physics/physicalHullErode.d.ts +25 -0
  504. package/lib/physics/physicalHullErode.js +54 -0
  505. package/lib/physics/physicalHullErode.js.map +1 -0
  506. package/lib/physics/physicalHullFaces.d.ts +56 -0
  507. package/lib/physics/physicalHullFaces.js +151 -0
  508. package/lib/physics/physicalHullFaces.js.map +1 -0
  509. package/lib/physics/physicalHullMass.d.ts +32 -0
  510. package/lib/physics/physicalHullMass.js +80 -0
  511. package/lib/physics/physicalHullMass.js.map +1 -0
  512. package/lib/physics/physicalHullNearest.d.ts +37 -0
  513. package/lib/physics/physicalHullNearest.js +178 -0
  514. package/lib/physics/physicalHullNearest.js.map +1 -0
  515. package/lib/physics/physicalHullSegment.d.ts +34 -0
  516. package/lib/physics/physicalHullSegment.js +276 -0
  517. package/lib/physics/physicalHullSegment.js.map +1 -0
  518. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  519. package/lib/physics/physicalInertiaTensor.js +58 -0
  520. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  521. package/lib/physics/physicalNativeShape.d.ts +1 -1
  522. package/lib/physics/physicalNativeShape.js +15 -4
  523. package/lib/physics/physicalNativeShape.js.map +1 -1
  524. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  525. package/lib/physics/physicalPrincipalAxes.js +96 -0
  526. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  527. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  528. package/lib/physics/physicalShapeBounds.js +26 -2
  529. package/lib/physics/physicalShapeBounds.js.map +1 -1
  530. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  531. package/lib/physics/physicalShapeNearest.js +201 -0
  532. package/lib/physics/physicalShapeNearest.js.map +1 -0
  533. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  534. package/lib/physics/physicalShapeNormal.js +70 -0
  535. package/lib/physics/physicalShapeNormal.js.map +1 -0
  536. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  537. package/lib/physics/physicalShapePairDistance.js +124 -0
  538. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  539. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  540. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  541. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  542. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  543. package/lib/physics/physicalShapeSpan.js +55 -0
  544. package/lib/physics/physicalShapeSpan.js.map +1 -0
  545. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  546. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  547. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  548. package/lib/physics/projectileAt.d.ts +14 -12
  549. package/lib/physics/projectileAt.js +46 -16
  550. package/lib/physics/projectileAt.js.map +1 -1
  551. package/lib/physics/projectileContinue.d.ts +114 -0
  552. package/lib/physics/projectileContinue.js +189 -0
  553. package/lib/physics/projectileContinue.js.map +1 -0
  554. package/lib/physics/projectileDragFlight.d.ts +72 -0
  555. package/lib/physics/projectileDragFlight.js +166 -0
  556. package/lib/physics/projectileDragFlight.js.map +1 -0
  557. package/lib/physics/projectileFirstContact.d.ts +105 -0
  558. package/lib/physics/projectileFirstContact.js +174 -0
  559. package/lib/physics/projectileFirstContact.js.map +1 -0
  560. package/lib/physics/projectileTrajectory.js +3 -2
  561. package/lib/physics/projectileTrajectory.js.map +1 -1
  562. package/lib/physics/solveBallisticLaunch.js +2 -1
  563. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  564. package/lib/physics/solveMovingLaunch.js +2 -1
  565. package/lib/physics/solveMovingLaunch.js.map +1 -1
  566. package/lib/physics/validatePhysicalProfile.js +18 -1
  567. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  568. package/lib/populationRuntime/index.d.ts +6 -0
  569. package/lib/populationRuntime/index.js +6 -0
  570. package/lib/populationRuntime/index.js.map +1 -1
  571. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  572. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  573. package/lib/random/index.d.ts +1 -1
  574. package/lib/random/index.js +1 -0
  575. package/lib/random/index.js.map +1 -1
  576. package/lib/render/index.d.ts +20 -11
  577. package/lib/render/index.js +20 -11
  578. package/lib/render/index.js.map +1 -1
  579. package/lib/resolve/index.d.ts +7 -2
  580. package/lib/resolve/index.js +7 -5
  581. package/lib/resolve/index.js.map +1 -1
  582. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  583. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  584. package/lib/rom/clampJointRom.d.ts +11 -3
  585. package/lib/rom/clampJointRom.js +43 -3
  586. package/lib/rom/clampJointRom.js.map +1 -1
  587. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  588. package/lib/rom/clampJointToSkeleton.js +39 -8
  589. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  590. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  591. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  592. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  593. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  594. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  595. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  596. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  597. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  598. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  599. package/lib/rom/constants/index.d.ts +2 -0
  600. package/lib/rom/constants/index.js +2 -0
  601. package/lib/rom/constants/index.js.map +1 -1
  602. package/lib/rom/index.d.ts +1 -0
  603. package/lib/rom/index.js +1 -0
  604. package/lib/rom/index.js.map +1 -1
  605. package/lib/rom/scanJointRom.d.ts +62 -0
  606. package/lib/rom/scanJointRom.js +117 -0
  607. package/lib/rom/scanJointRom.js.map +1 -0
  608. package/lib/rom/validateJointRom.d.ts +4 -2
  609. package/lib/rom/validateJointRom.js +23 -45
  610. package/lib/rom/validateJointRom.js.map +1 -1
  611. package/lib/service/index.d.ts +9 -0
  612. package/lib/service/index.js +9 -0
  613. package/lib/service/index.js.map +1 -1
  614. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  615. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  616. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  617. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  618. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  619. package/lib/soft/applySoftBodyFriction.js +52 -0
  620. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  621. package/lib/soft/index.d.ts +22 -0
  622. package/lib/soft/index.js +22 -0
  623. package/lib/soft/index.js.map +1 -1
  624. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  625. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  626. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  627. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  628. package/lib/soft/simulateSoftBodyCore.js +108 -16
  629. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  630. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  631. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  632. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  633. package/lib/soft/softBodyBudget.js +7 -0
  634. package/lib/soft/softBodyBudget.js.map +1 -1
  635. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  636. package/lib/soft/softBodyHeldLoads.js +69 -0
  637. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  638. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  639. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  640. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  641. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  642. package/lib/soft/validateSoftAnchors.js +74 -0
  643. package/lib/soft/validateSoftAnchors.js.map +1 -0
  644. package/lib/soft/validateSoftBodyDomain.js +6 -48
  645. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  646. package/lib/soft/validateSoftBounded.d.ts +20 -0
  647. package/lib/soft/validateSoftBounded.js +27 -0
  648. package/lib/soft/validateSoftBounded.js.map +1 -0
  649. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  650. package/lib/soft/validateSoftCompliance.js +54 -0
  651. package/lib/soft/validateSoftCompliance.js.map +1 -0
  652. package/lib/sound/index.d.ts +2 -0
  653. package/lib/sound/index.js +2 -0
  654. package/lib/sound/index.js.map +1 -1
  655. package/lib/text/index.d.ts +1 -0
  656. package/lib/text/index.js +1 -0
  657. package/lib/text/index.js.map +1 -1
  658. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  659. package/lib/validation/AffordanceArticulation.js +142 -0
  660. package/lib/validation/AffordanceArticulation.js.map +1 -0
  661. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  662. package/lib/validation/affordanceFollowedTravel.js +43 -0
  663. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  664. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  665. package/lib/validation/affordanceLeadingTravel.js +99 -0
  666. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  667. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  668. package/lib/validation/affordanceTravelRange.js +39 -0
  669. package/lib/validation/affordanceTravelRange.js.map +1 -0
  670. package/lib/validation/appendShotEventsArtifact.js +12 -0
  671. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  672. package/lib/validation/constants/index.d.ts +3 -3
  673. package/lib/validation/constants/index.js +3 -3
  674. package/lib/validation/constants/index.js.map +1 -1
  675. package/lib/validation/detectFreeFall.js +2 -1
  676. package/lib/validation/detectFreeFall.js.map +1 -1
  677. package/lib/validation/index.d.ts +52 -4
  678. package/lib/validation/index.js +52 -6
  679. package/lib/validation/index.js.map +1 -1
  680. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  681. package/lib/validation/markAutoMovieSlip.js +52 -0
  682. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  683. package/lib/validation/validateAffordance.d.ts +3 -3
  684. package/lib/validation/validateAffordance.js +21 -3
  685. package/lib/validation/validateAffordance.js.map +1 -1
  686. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  687. package/lib/validation/validateAffordanceArticulation.js +183 -0
  688. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  689. package/lib/validation/validateBalanceSupport.d.ts +1 -2
  690. package/lib/validation/validateBalanceSupport.js.map +1 -1
  691. package/lib/validation/validateBody.d.ts +2 -2
  692. package/lib/validation/validateBody.js +27 -3
  693. package/lib/validation/validateBody.js.map +1 -1
  694. package/lib/validation/validateFootSkate.d.ts +1 -2
  695. package/lib/validation/validateFootSkate.js.map +1 -1
  696. package/lib/validation/validateGroundContact.d.ts +1 -2
  697. package/lib/validation/validateGroundContact.js.map +1 -1
  698. package/lib/validation/validateJointConstraint.d.ts +1 -1
  699. package/lib/validation/validateJointConstraint.js +9 -1
  700. package/lib/validation/validateJointConstraint.js.map +1 -1
  701. package/lib/validation/validateModel.js +2 -0
  702. package/lib/validation/validateModel.js.map +1 -1
  703. package/lib/validation/validateSelfIntersection.d.ts +1 -2
  704. package/lib/validation/validateSelfIntersection.js.map +1 -1
  705. package/lib/worldBlock.js +6 -9
  706. package/lib/worldBlock.js.map +1 -1
  707. package/package.json +6 -6
  708. package/src/IAutoMovieFormationPlacement.ts +4 -3
  709. package/src/analysis/index.ts +5 -0
  710. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  711. package/src/anthropometry/index.ts +1 -0
  712. package/src/architecture/appendBuiltRegionDefects.ts +3 -3
  713. package/src/architecture/builtOutlineIsClosed.ts +3 -3
  714. package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
  715. package/src/architecture/constants/index.ts +1 -1
  716. package/src/architecture/index.ts +157 -117
  717. package/src/cache/index.ts +9 -0
  718. package/src/composition/AutoMovieComposition.ts +34 -7
  719. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  720. package/src/composition/AutoMovieScheduleError.ts +108 -0
  721. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  722. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  723. package/src/composition/IAutoMovieIntent.ts +9 -7
  724. package/src/composition/index.ts +12 -7
  725. package/src/composition/markAutoMovieContacts.ts +79 -0
  726. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  727. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  728. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  729. package/src/constants/index.ts +2 -0
  730. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  731. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  732. package/src/drawing/index.ts +12 -0
  733. package/src/effectRuntime/index.ts +7 -0
  734. package/src/film/compileAttach.ts +2 -5
  735. package/src/film/compileLaunch.ts +5 -4
  736. package/src/film/constants/index.ts +3 -0
  737. package/src/film/index.ts +61 -6
  738. package/src/film/propAnchorFrame.ts +3 -6
  739. package/src/film/stageScene.ts +3 -10
  740. package/src/film/staging/index.ts +11 -0
  741. package/src/film/staging/lowerLightPlacement.ts +3 -7
  742. package/src/formationSlotPosition.ts +54 -7
  743. package/src/geometry/IAutoMovieMark.ts +115 -0
  744. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  745. package/src/geometry/constants/index.ts +2 -0
  746. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  747. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  748. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  749. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  750. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  751. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  752. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  753. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  754. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  755. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  756. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  757. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  758. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  759. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  760. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  761. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  762. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  763. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  764. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  765. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  766. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  767. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  768. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  769. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  770. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  771. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  772. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  773. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  774. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  775. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  776. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  777. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  778. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  779. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  780. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  781. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  782. package/src/geometry/construction/index.ts +82 -2
  783. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  784. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  785. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  786. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  787. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  788. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  789. package/src/geometry/curve/index.ts +48 -25
  790. package/src/geometry/extract/index.ts +0 -1
  791. package/src/geometry/index.ts +87 -53
  792. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  793. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  794. package/src/geometry/sweep/index.ts +54 -15
  795. package/src/index.ts +41 -450
  796. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  797. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  798. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  799. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  800. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  801. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  802. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  803. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  804. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  805. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  806. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  807. package/src/kinematics/curlChainUntilContact.ts +35 -8
  808. package/src/kinematics/decomposeJointRotation.ts +15 -178
  809. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  810. package/src/kinematics/fitDigitDescent.ts +253 -0
  811. package/src/kinematics/fitDigitToTarget.ts +425 -0
  812. package/src/kinematics/hingedArmArticulation.ts +402 -116
  813. package/src/kinematics/hingedArmSwivel.ts +295 -0
  814. package/src/kinematics/index.ts +30 -12
  815. package/src/kinematics/jointRomOvershoot.ts +30 -19
  816. package/src/kinematics/jointToQuaternion.ts +8 -43
  817. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  818. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  819. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  820. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  821. package/src/kinematics/normalizeJointAxes.ts +66 -12
  822. package/src/kinematics/poseJointCodec.ts +148 -0
  823. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  824. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  825. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  826. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  827. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  828. package/src/kinematics/swingTwistBasis.ts +162 -0
  829. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  830. package/src/kinematics/swingTwistRange.ts +460 -0
  831. package/src/kinematics/swingTwistRegion.ts +298 -0
  832. package/src/kinematics/swivelArcs.ts +245 -0
  833. package/src/math/Quaternion.ts +42 -2
  834. package/src/math/Transform.ts +65 -0
  835. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  836. package/src/math/bracketedBisection.ts +51 -0
  837. package/src/math/bracketedRoot.ts +72 -0
  838. package/src/math/constants/index.ts +1 -0
  839. package/src/math/index.ts +64 -5
  840. package/src/math/nearestAngleAlias.ts +43 -0
  841. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  842. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  843. package/src/measureAutoMovieGeometryReach.ts +2 -4
  844. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  845. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  846. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  847. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  848. package/src/motion/IFitChainToTargetProps.ts +67 -0
  849. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  850. package/src/motion/basisOf.ts +29 -0
  851. package/src/motion/carriedAcceleration.ts +56 -0
  852. package/src/motion/carriedRate.ts +61 -0
  853. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  854. package/src/motion/constants/index.ts +1 -0
  855. package/src/motion/fitChainBend.ts +491 -0
  856. package/src/motion/fitChainToTarget.ts +13 -485
  857. package/src/motion/fitHingedChainCandidate.ts +281 -148
  858. package/src/motion/fitHingedRotationError.ts +164 -0
  859. package/src/motion/fitSeededChainToTarget.ts +34 -0
  860. package/src/motion/gaitMotion.ts +6 -10
  861. package/src/motion/gestureMotion.ts +2 -5
  862. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  863. package/src/motion/index.ts +40 -9
  864. package/src/motion/inertializeOffset.ts +16 -2
  865. package/src/motion/inertializePose.ts +158 -53
  866. package/src/motion/integrateAirborneRotation.ts +334 -0
  867. package/src/motion/integrateMotionTrajectory.ts +309 -0
  868. package/src/motion/orientChainEffector.ts +19 -13
  869. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  870. package/src/motion/sampleMotion.ts +2 -5
  871. package/src/motion/samplePoseVelocity.ts +168 -41
  872. package/src/motion/smoothMinimum.ts +36 -0
  873. package/src/motion/solveAirborneTakeoff.ts +471 -0
  874. package/src/motion/solveDistalTwist.ts +256 -0
  875. package/src/motion/speedProfile.ts +470 -0
  876. package/src/motion/splitDistalTwist.ts +55 -64
  877. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  878. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  879. package/src/perform/index.ts +10 -0
  880. package/src/physics/AutoMovieAir.ts +22 -0
  881. package/src/physics/AutoMovieGravity.ts +28 -0
  882. package/src/physics/IAutoMovieHit.ts +13 -7
  883. package/src/physics/IAutoMovieProjectile.ts +82 -6
  884. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  885. package/src/physics/admitMotionGeometry.ts +16 -0
  886. package/src/physics/bindPhysicalWorld.ts +22 -11
  887. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  888. package/src/physics/deriveCenterOfMass.ts +2 -5
  889. package/src/physics/derivePhysicalProfile.ts +3 -1
  890. package/src/physics/index.ts +155 -2
  891. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  892. package/src/physics/physicalHullErode.ts +72 -0
  893. package/src/physics/physicalHullFaces.ts +215 -0
  894. package/src/physics/physicalHullMass.ts +99 -0
  895. package/src/physics/physicalHullNearest.ts +210 -0
  896. package/src/physics/physicalHullSegment.ts +338 -0
  897. package/src/physics/physicalInertiaTensor.ts +75 -0
  898. package/src/physics/physicalNativeShape.ts +31 -9
  899. package/src/physics/physicalPrincipalAxes.ts +114 -0
  900. package/src/physics/physicalShapeBounds.ts +24 -2
  901. package/src/physics/physicalShapeNearest.ts +287 -0
  902. package/src/physics/physicalShapeNormal.ts +105 -0
  903. package/src/physics/physicalShapePairDistance.ts +153 -0
  904. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  905. package/src/physics/physicalShapeSpan.ts +75 -0
  906. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  907. package/src/physics/projectileAt.ts +61 -20
  908. package/src/physics/projectileContinue.ts +287 -0
  909. package/src/physics/projectileDragFlight.ts +208 -0
  910. package/src/physics/projectileFirstContact.ts +286 -0
  911. package/src/physics/projectileTrajectory.ts +6 -5
  912. package/src/physics/solveBallisticLaunch.ts +2 -1
  913. package/src/physics/solveMovingLaunch.ts +2 -1
  914. package/src/physics/validatePhysicalProfile.ts +20 -1
  915. package/src/populationRuntime/index.ts +6 -0
  916. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  917. package/src/random/index.ts +1 -1
  918. package/src/render/index.ts +20 -11
  919. package/src/resolve/index.ts +7 -2
  920. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  921. package/src/rom/clampJointRom.ts +59 -2
  922. package/src/rom/clampJointToSkeleton.ts +52 -15
  923. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  924. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  925. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  926. package/src/rom/constants/index.ts +2 -0
  927. package/src/rom/index.ts +1 -0
  928. package/src/rom/scanJointRom.ts +169 -0
  929. package/src/rom/validateJointRom.ts +69 -74
  930. package/src/service/index.ts +9 -0
  931. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  932. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  933. package/src/soft/applySoftBodyFriction.ts +65 -0
  934. package/src/soft/index.ts +22 -0
  935. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  936. package/src/soft/simulateSoftBodyCore.ts +127 -15
  937. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  938. package/src/soft/softBodyBudget.ts +11 -0
  939. package/src/soft/softBodyHeldLoads.ts +85 -0
  940. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  941. package/src/soft/validateSoftAnchors.ts +143 -0
  942. package/src/soft/validateSoftBodyDomain.ts +5 -124
  943. package/src/soft/validateSoftBounded.ts +42 -0
  944. package/src/soft/validateSoftCompliance.ts +102 -0
  945. package/src/sound/index.ts +2 -0
  946. package/src/text/index.ts +1 -0
  947. package/src/validation/AffordanceArticulation.ts +173 -0
  948. package/src/validation/affordanceFollowedTravel.ts +40 -0
  949. package/src/validation/affordanceLeadingTravel.ts +108 -0
  950. package/src/validation/affordanceTravelRange.ts +42 -0
  951. package/src/validation/appendShotEventsArtifact.ts +26 -0
  952. package/src/validation/constants/index.ts +3 -3
  953. package/src/validation/detectFreeFall.ts +3 -2
  954. package/src/validation/index.ts +52 -4
  955. package/src/validation/markAutoMovieSlip.ts +65 -0
  956. package/src/validation/validateAffordance.ts +38 -3
  957. package/src/validation/validateAffordanceArticulation.ts +311 -0
  958. package/src/validation/validateBalanceSupport.ts +2 -5
  959. package/src/validation/validateBody.ts +80 -3
  960. package/src/validation/validateFootSkate.ts +1 -1
  961. package/src/validation/validateGroundContact.ts +2 -5
  962. package/src/validation/validateJointConstraint.ts +19 -1
  963. package/src/validation/validateModel.ts +7 -0
  964. package/src/validation/validateSelfIntersection.ts +2 -5
  965. package/src/worldBlock.ts +3 -6
  966. package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
@@ -0,0 +1,322 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.swingTwistRange = void 0;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ const nearestAngleAlias_1 = require("../math/nearestAngleAlias");
7
+ const positiveModulo_1 = require("../math/positiveModulo");
8
+ const rotationBetween_1 = require("../math/rotationBetween");
9
+ const swingTwist_1 = require("../math/swingTwist");
10
+ const wrapDegrees_1 = require("../math/wrapDegrees");
11
+ const HUMANOID_REST_FRAME_1 = require("../rom/constants/HUMANOID_REST_FRAME");
12
+ const toClinicalAngle_1 = require("../rom/toClinicalAngle");
13
+ const toRigAngle_1 = require("../rom/toRigAngle");
14
+ const HUMANOID_JOINT_AXES_1 = require("./constants/HUMANOID_JOINT_AXES");
15
+ const skeletonJointAxes_1 = require("./skeletonJointAxes");
16
+ const swingTwistBasis_1 = require("./swingTwistBasis");
17
+ const swingTwistRegion_1 = require("./swingTwistRegion");
18
+ const DEG = swingTwistBasis_1.swingTwistBasis.DEG;
19
+ /**
20
+ * The range of a ball joint read by swing and twist: where the limb's long
21
+ * axis may point, and how far the limb may turn about it.
22
+ *
23
+ * A joint rotation `q`, rest-relative in the bone's own frame, splits into a
24
+ * twist about the limb's rest axis `u` (the joint's twist axis) taken first
25
+ * and a swing, the shortest turn that carries `u` to the limb's direction
26
+ * `q u`. The twist is that turn's angle about `u`, lifted to clinical degrees
27
+ * by the rest frame's twist mapping. The decomposition is singular only where
28
+ * the limb points at `-u`, the rest direction's antipode.
29
+ *
30
+ * The swing is limited by the directions the constraint's `flexion` and
31
+ * `abduction` intervals reach with no twist (and its `swingDeg`, when it has
32
+ * one), taken as a star about the rest direction: every direction between
33
+ * the rest direction and a reached one, along the great circle through both.
34
+ * Through a three-angle chart the reached directions pinch where two of the
35
+ * angles turn about one axis (a hip flexed to 90 degrees, where abduction
36
+ * turns the thigh about itself), and the star fills the pinch, so a flexed
37
+ * hip may still swing aside. The star is stored as its radius along each
38
+ * great circle leaving the rest direction, `swingTwistBasis.RAYS` of them, the farthest swing
39
+ * along it that the ranges reach, raised where it would turn faster than
40
+ * `SLOPE` with the azimuth (beside an edge of the region that runs along a
41
+ * ray, where the farthest reach jumps), and interpolated linearly between
42
+ * rays. A direction outside is brought back along its own great circle to
43
+ * the radius there, which moves continuously with the direction because the
44
+ * radius does.
45
+ *
46
+ * The twist is limited by the constraint's `swingTwist.twist` interval, and
47
+ * clamped to it. A clamp of a turn onto an arc must break somewhere on the
48
+ * circle: here at the turn farthest from the interval on either side, which
49
+ * no limb reaches.
50
+ *
51
+ * The construction is this module's; no published method is claimed for it.
52
+ *
53
+ * @evidence contracts/development/common.md#meaningful-documentation States the decomposition, its singular direction, how the swing region is read from the constraint, how a direction outside it is brought back and the premise that keeps that continuous.
54
+ * @evidence contracts/development/design.md#principled-representation A rotation is split into the two quantities a ball joint's range limits independently, where the limb points and how it is turned about itself, neither read through a three-angle chart.
55
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The joint frame of a rig's bone, the reading, the measure outside the range, the projection into it and the radius on a circle; the radius table is cached per constraint and basis.
56
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No joint is named: the axes, the rest frame and the intervals are the caller's.
57
+ */
58
+ var swingTwistRange;
59
+ (function (swingTwistRange) {
60
+ /**
61
+ * The frame a rig's bone is read in: its clinical axes as the skeleton
62
+ * resolves them (`skeletonJointAxes`, the bone's own declaration over the
63
+ * humanoid table) and the humanoid rest frame; the humanoid table's axes
64
+ * when no skeleton is given.
65
+ *
66
+ * @param bone The bone.
67
+ * @param skeleton The rig; the humanoid tables alone when absent.
68
+ * @returns The frame; none for a bone that has no axes.
69
+ *
70
+ * @evidence contracts/development/common.md#meaningful-documentation States the precedence, the fallback and the empty case.
71
+ * @evidence contracts/development/implementation.md#principled-implementation The skeleton's own axes win over the family table, the precedence every engine entry with a skeleton reads.
72
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One table read and one record.
73
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No bone is special-cased.
74
+ * @evidence contracts/development/implementation.md#efficient-algorithms The frames of a skeleton are resolved once, by one scan of its bones, and read by every later call: a limb fit clamps its candidates through here twice per swivel candidate, where a scan per call cost about 8 percent of a sweep cell.
75
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `skeletonJointAxes`, once per skeleton and bones list.
76
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The frames are kept in a weak map keyed by the skeleton, released with it, and resolved again when its bones list is replaced; a bone's axes changed in place on a list already read are not seen.
77
+ */
78
+ function of(bone, skeleton) {
79
+ const key = skeleton ?? NO_SKELETON;
80
+ let kept = FRAMES.get(key);
81
+ if (kept === undefined ||
82
+ (skeleton !== undefined && kept.bones !== skeleton.bones)) {
83
+ kept = {
84
+ bones: skeleton?.bones,
85
+ table: skeleton === undefined
86
+ ? HUMANOID_JOINT_AXES_1.HUMANOID_JOINT_AXES
87
+ : (0, skeletonJointAxes_1.skeletonJointAxes)(skeleton, HUMANOID_JOINT_AXES_1.HUMANOID_JOINT_AXES),
88
+ frames: new Map(),
89
+ };
90
+ FRAMES.set(key, kept);
91
+ }
92
+ if (kept.frames.has(bone))
93
+ return kept.frames.get(bone);
94
+ const axes = kept.table[bone];
95
+ const frame = axes === undefined
96
+ ? undefined
97
+ : { axes, frame: HUMANOID_REST_FRAME_1.HUMANOID_REST_FRAME[bone] };
98
+ kept.frames.set(bone, frame);
99
+ return frame;
100
+ }
101
+ swingTwistRange.of = of;
102
+ /** The kept tables, per skeleton (or the humanoid tables, keyed by `NO_SKELETON`). */
103
+ const FRAMES = new WeakMap();
104
+ /** The key of the humanoid tables read with no skeleton. */
105
+ const NO_SKELETON = Object.freeze({});
106
+ /**
107
+ * A rotation read by swing and twist.
108
+ *
109
+ * @param q The joint's rest-relative rotation.
110
+ * @param joint The joint's axes and rest frame.
111
+ * @returns The reading.
112
+ *
113
+ * @evidence contracts/development/common.md#meaningful-documentation States the input, its frame and the result.
114
+ * @evidence contracts/development/implementation.md#principled-implementation The twist is the angle of the rotation's twist about the rest axis (the engine's `swingTwist`), so the swing that remains carries the rest axis to the limb's direction by the shortest turn.
115
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One rotation of the axis, one projection and two angles.
116
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The twist is lifted by the joint's own rest frame, so its sign is the clinical one.
117
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
118
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `swingTwist` and `wrapDegrees`.
119
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
120
+ */
121
+ function read(q, joint) {
122
+ const basis = swingTwistBasis_1.swingTwistBasis.of(joint.axes);
123
+ const unit = Quaternion_1.Quaternion.normalize(q);
124
+ const direction = Vector3_1.Vector3.normalize(Quaternion_1.Quaternion.rotateVector(unit, basis.u));
125
+ const twisted = (0, swingTwist_1.swingTwist)(unit, basis.u).twist;
126
+ const rig = 2 *
127
+ Math.atan2(twisted.x * basis.u.x + twisted.y * basis.u.y + twisted.z * basis.u.z, twisted.w) *
128
+ DEG;
129
+ return {
130
+ direction,
131
+ swing: Math.acos(swingTwistBasis_1.swingTwistBasis.clamp(Vector3_1.Vector3.dot(direction, basis.u), -1, 1)) * DEG,
132
+ azimuth: swingTwistBasis_1.swingTwistBasis.azimuth(basis, direction),
133
+ twist: (0, wrapDegrees_1.wrapDegrees)((0, toClinicalAngle_1.toClinicalAngle)((0, wrapDegrees_1.wrapDegrees)(rig), joint.frame?.twist)),
134
+ };
135
+ }
136
+ swingTwistRange.read = read;
137
+ /**
138
+ * How far a rotation lies outside a swing-twist range, degrees: the swing
139
+ * past the region's radius on its great circle plus the twist past its
140
+ * interval.
141
+ *
142
+ * @param q The joint's rest-relative rotation.
143
+ * @param constraint The constraint, with `swingTwist`.
144
+ * @param joint The joint's axes and rest frame.
145
+ * @returns Degrees; 0 inside the range.
146
+ *
147
+ * @evidence contracts/development/common.md#meaningful-documentation States the two parts of the measure and its unit.
148
+ * @evidence contracts/development/implementation.md#principled-implementation Degrees past the swing's radius and past the twist's interval, the two limits the range states, so a solver ranks candidates by how far out they are.
149
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One reading, one radius and one interval.
150
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The twist is aliased to the interval before it is measured, so a full turn is never counted.
151
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work once the radius table is built.
152
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reads `read` and the cached `radius`.
153
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
154
+ */
155
+ function overshoot(q, constraint, joint) {
156
+ const reading = read(q, joint);
157
+ const twist = constraint.swingTwist.twist;
158
+ const turned = (0, nearestAngleAlias_1.nearestAngleAlias)(reading.twist, twist);
159
+ return (Math.max(0, reading.swing - radius(constraint, joint, reading.azimuth)) +
160
+ Math.max(0, twist.min - turned, turned - twist.max));
161
+ }
162
+ swingTwistRange.overshoot = overshoot;
163
+ /**
164
+ * A rotation brought into a swing-twist range: its direction brought back
165
+ * along its great circle from the rest direction to the region's radius
166
+ * there, and its twist clamped to its interval. A rotation inside is
167
+ * returned unchanged.
168
+ *
169
+ * @param q The joint's rest-relative rotation.
170
+ * @param constraint The constraint, with `swingTwist`.
171
+ * @param joint The joint's axes and rest frame.
172
+ * @returns The rotation in range.
173
+ *
174
+ * @evidence contracts/development/common.md#meaningful-documentation States how the swing and the twist are each brought back and that a rotation inside is returned as given.
175
+ * @evidence contracts/development/implementation.md#principled-implementation The swing is brought back along its own great circle from the rest direction, a radial map onto a region star-shaped about the rest direction, which moves continuously with the rotation wherever the radius does; the twist is clamped to its interval.
176
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One reading, one radius, one shortest turn (`rotationBetween`) and one twist.
177
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No nearest point is sought, since a nearest point jumps where two tie.
178
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work once the radius table is built.
179
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reads `read` and `radius`.
180
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
181
+ */
182
+ function project(q, constraint, joint) {
183
+ const basis = swingTwistBasis_1.swingTwistBasis.of(joint.axes);
184
+ const reading = read(q, joint);
185
+ const interval = constraint.swingTwist.twist;
186
+ const turned = (0, nearestAngleAlias_1.nearestAngleAlias)(reading.twist, interval);
187
+ const twist = swingTwistBasis_1.swingTwistBasis.clamp(turned, interval.min, interval.max);
188
+ const limit = radius(constraint, joint, reading.azimuth);
189
+ if (reading.swing <= limit && twist === turned)
190
+ return q;
191
+ const swing = Math.min(reading.swing, limit);
192
+ const direction = swing === reading.swing
193
+ ? reading.direction
194
+ : swingTwistBasis_1.swingTwistBasis.direction(basis, swing, reading.azimuth);
195
+ return Quaternion_1.Quaternion.normalize(Quaternion_1.Quaternion.multiply((0, rotationBetween_1.rotationBetween)(basis.u, direction), Quaternion_1.Quaternion.fromAxisAngle(basis.u, (0, toRigAngle_1.toRigAngle)(twist, joint.frame?.twist))));
196
+ }
197
+ swingTwistRange.project = project;
198
+ /**
199
+ * A rotation's place in the range's chart: its swing as a share of the
200
+ * region's radius on its own great circle, laid out on the unit disc by its
201
+ * azimuth (`x`, `y`), and its twist read inside the interval (`twist`). The
202
+ * region is star-shaped about the rest direction with a radius below 180
203
+ * degrees on every great circle (`ISwingTwist.reach`), so the region is the
204
+ * unit disc exactly, the rest direction its centre, and the chart is
205
+ * continuous and one to one over it: the rest direction's antipode, where a
206
+ * direction has no azimuth and a rotation no twist, lies outside.
207
+ *
208
+ * @param q The joint's rest-relative rotation.
209
+ * @param constraint The constraint, with `swingTwist`.
210
+ * @param joint The joint's axes and rest frame.
211
+ * @returns The disc coordinates and the twist, clinical degrees.
212
+ *
213
+ * @evidence contracts/development/common.md#meaningful-documentation States the three coordinates, why the region is the unit disc and why the chart is continuous over it.
214
+ * @evidence contracts/development/implementation.md#principled-implementation A star-shaped region about a pole is mapped onto the unit disc by the swing's share of its radius along the azimuth, the polar form of the pole's chart, whose only singularity, the pole's antipode, lies outside the region.
215
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One reading, one radius and two products.
216
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The twist is the reading's alias nearest the interval, never clamped.
217
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work once the radius table is built.
218
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `read`, `radius` and `nearestAngleAlias`.
219
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
220
+ */
221
+ function chart(q, constraint, joint) {
222
+ const reading = read(q, joint);
223
+ const k = reading.swing / radius(constraint, joint, reading.azimuth);
224
+ const turn = reading.azimuth / DEG;
225
+ return {
226
+ x: k * Math.cos(turn),
227
+ y: k * Math.sin(turn),
228
+ twist: (0, nearestAngleAlias_1.nearestAngleAlias)(reading.twist, constraint.swingTwist.twist),
229
+ };
230
+ }
231
+ swingTwistRange.chart = chart;
232
+ /**
233
+ * The rotation at a place of the range's chart (`chart`), its inverse.
234
+ *
235
+ * @param place The disc coordinates and the twist, clinical degrees.
236
+ * @param constraint The constraint, with `swingTwist`.
237
+ * @param joint The joint's axes and rest frame.
238
+ * @returns The joint's rest-relative rotation.
239
+ *
240
+ * @evidence contracts/development/common.md#meaningful-documentation States the input and the result.
241
+ * @evidence contracts/development/implementation.md#principled-implementation The direction the swing of the disc's share of the radius reaches along the disc's azimuth, then the twist about the rest axis, composed as `project` composes a rotation.
242
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One azimuth, one radius, one direction and one composition.
243
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A place off the disc gives a rotation outside the region, never a clamped one.
244
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work once the radius table is built.
245
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `radius`, `swingTwistBasis.direction`, `rotationBetween` and `toRigAngle`.
246
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
247
+ */
248
+ function placed(place, constraint, joint) {
249
+ const basis = swingTwistBasis_1.swingTwistBasis.of(joint.axes);
250
+ const k = Math.hypot(place.x, place.y);
251
+ const azimuth = k > 1e-12 ? Math.atan2(place.y, place.x) * DEG : 0;
252
+ return Quaternion_1.Quaternion.normalize(Quaternion_1.Quaternion.multiply((0, rotationBetween_1.rotationBetween)(basis.u, swingTwistBasis_1.swingTwistBasis.direction(basis, k * radius(constraint, joint, azimuth), azimuth)), Quaternion_1.Quaternion.fromAxisAngle(basis.u, (0, toRigAngle_1.toRigAngle)(place.twist, joint.frame?.twist))));
253
+ }
254
+ swingTwistRange.placed = placed;
255
+ /**
256
+ * A rotation part of the way between two, blended in the range's chart
257
+ * (`chart`): the two places moved straight across the unit disc and the
258
+ * twist straight between the two. The disc and the interval are convex, so
259
+ * two ends inside the range give a blend inside it at every share; the
260
+ * chart is continuous and one to one over the region, so the blend is
261
+ * continuous in its share and in both ends, and meets each end exactly.
262
+ *
263
+ * A spherical interpolation of the two rotations leaves the region where it
264
+ * is not convex: a shoulder carried from a hanging arm to a hand on the nape
265
+ * ran 40 degrees outside it, and its projection onto a radius that rose from
266
+ * 68.5 to 106.7 degrees over 16 degrees of azimuth moved the elbow 200 to
267
+ * 690 mm in a frame.
268
+ *
269
+ * @param a The joint's rest-relative rotation at share 0.
270
+ * @param b The same at share 1.
271
+ * @param share How far from `a` to `b`, in [0, 1].
272
+ * @param constraint The constraint, with `swingTwist`.
273
+ * @param joint The joint's axes and rest frame.
274
+ * @returns The rotation: inside the range when both ends are.
275
+ *
276
+ * @evidence contracts/development/common.md#meaningful-documentation States the blend, why it stays inside and is continuous and meets its ends, and the measured defect of the spherical interpolation.
277
+ * @evidence contracts/development/implementation.md#principled-implementation A straight line between two points of a convex set stays in it, and the chart is a homeomorphism of the region onto the disc times the interval.
278
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Two charts, one straight blend and one inverse.
279
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No projection is needed and none is taken.
280
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work once the radius table is built.
281
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `chart` and `placed`.
282
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
283
+ */
284
+ function blend(a, b, share, constraint, joint) {
285
+ const from = chart(a, constraint, joint);
286
+ const to = chart(b, constraint, joint);
287
+ return placed({
288
+ x: from.x + (to.x - from.x) * share,
289
+ y: from.y + (to.y - from.y) * share,
290
+ twist: from.twist + (to.twist - from.twist) * share,
291
+ }, constraint, joint);
292
+ }
293
+ swingTwistRange.blend = blend;
294
+ /**
295
+ * The swing region's radius on one great circle, degrees, read off the
296
+ * cached table by linear interpolation between its two nearest rays.
297
+ *
298
+ * @param constraint The constraint.
299
+ * @param joint The joint's axes and rest frame.
300
+ * @param azimuth The great circle, degrees about the rest direction from the flexion axis.
301
+ * @returns The radius, degrees.
302
+ *
303
+ * @evidence contracts/development/common.md#meaningful-documentation States the reading and its interpolation.
304
+ * @evidence contracts/development/implementation.md#principled-implementation The radius is read on `swingTwistBasis.RAYS` great circles once, from the farthest reached swing on each, found by a scan from the far end and a bisection, widened for a proximal twist by the reach of every twist in its interval, raised to turn no faster than `SLOPE` with the azimuth, and interpolated linearly between them, which is continuous in the azimuth.
305
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One table lookup and one interpolation.
306
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scan runs from the far end, so a ray the ranges leave and re-enter keeps its farthest reach: the radius is the star's, not the first exit's. `SLOPE` (3) is provisional; `SCAN` and `HALVINGS` are resolutions, not fitted to a case.
307
+ * @evidence contracts/development/implementation.md#efficient-algorithms The table is built once per constraint and basis and kept.
308
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every call after the first reads the cached table.
309
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The tables are kept in a WeakMap keyed by the constraint object and released with it.
310
+ */
311
+ function radius(constraint, joint, azimuth) {
312
+ const table = swingTwistRegion_1.swingTwistRegion.table(constraint, joint);
313
+ const rays = swingTwistBasis_1.swingTwistBasis.RAYS;
314
+ const at = (0, positiveModulo_1.positiveModulo)(azimuth, 360) / (360 / rays);
315
+ const before = Math.floor(at) % rays;
316
+ const after = (before + 1) % rays;
317
+ const share = at - Math.floor(at);
318
+ return table[before] + (table[after] - table[before]) * share;
319
+ }
320
+ swingTwistRange.radius = radius;
321
+ })(swingTwistRange || (exports.swingTwistRange = swingTwistRange = {}));
322
+ //# sourceMappingURL=swingTwistRange.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"swingTwistRange.js","sourceRoot":"","sources":["../../src/kinematics/swingTwistRange.ts"],"names":[],"mappings":";;;AAUA,mDAAgD;AAChD,6CAA0C;AAC1C,iEAA8D;AAC9D,2DAAwD;AACxD,6DAA0D;AAC1D,mDAAgD;AAChD,qDAAkD;AAElD,8EAA2E;AAC3E,4DAAyD;AACzD,kDAA+C;AAC/C,yEAAsE;AACtE,2DAAwD;AACxD,uDAAoD;AACpD,yDAAsD;AAEtD,MAAM,GAAG,GAAW,iCAAe,CAAC,GAAG,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,IAAiB,eAAe,CAwY/B;AAxYD,WAAiB,eAAe;IAuC9B;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAgB,EAAE,CAChB,IAA2B,EAC3B,QAA6B;QAE7B,MAAM,GAAG,GAAW,QAAQ,IAAI,WAAW,CAAC;QAC5C,IAAI,IAAI,GAAsB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,IACE,IAAI,KAAK,SAAS;YAClB,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC,EACzD,CAAC;YACD,IAAI,GAAG;gBACL,KAAK,EAAE,QAAQ,EAAE,KAAK;gBACtB,KAAK,EACH,QAAQ,KAAK,SAAS;oBACpB,CAAC,CAAC,yCAAmB;oBACrB,CAAC,CAAC,IAAA,qCAAiB,EAAC,QAAQ,EAAE,yCAAmB,CAAC;gBACtD,MAAM,EAAE,IAAI,GAAG,EAAE;aAClB,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,IAAI,GAAoC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,KAAK,GACT,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,yCAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IA5Be,gBAAA,EAAE,KA4BjB,CAAA;IASD,sFAAsF;IACtF,MAAM,MAAM,GAA2B,IAAI,OAAO,EAAE,CAAC;IAErD,4DAA4D;IAC5D,MAAM,WAAW,GAAW,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE9C;;;;;;;;;;;;;;OAcG;IACH,SAAgB,IAAI,CAAC,CAAuB,EAAE,KAAa;QACzD,MAAM,KAAK,GAA2B,iCAAe,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,IAAI,GAAyB,uBAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAsB,iBAAO,CAAC,SAAS,CACpD,uBAAU,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CACvC,CAAC;QACF,MAAM,OAAO,GAAyB,IAAA,uBAAU,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACtE,MAAM,GAAG,GACP,CAAC;YACD,IAAI,CAAC,KAAK,CACR,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EACrE,OAAO,CAAC,CAAC,CACV;YACD,GAAG,CAAC;QACN,OAAO;YACL,SAAS;YACT,KAAK,EACH,IAAI,CAAC,IAAI,CACP,iCAAe,CAAC,KAAK,CAAC,iBAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAC9D,GAAG,GAAG;YACT,OAAO,EAAE,iCAAe,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;YAClD,KAAK,EAAE,IAAA,yBAAW,EAChB,IAAA,iCAAe,EAAC,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAE,CACvD;SACF,CAAC;IACJ,CAAC;IAzBe,gBAAA,IAAI,OAyBnB,CAAA;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAgB,SAAS,CACvB,CAAuB,EACvB,UAAqC,EACrC,KAAa;QAEb,MAAM,OAAO,GAAa,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,KAAK,GAAyB,UAAU,CAAC,UAAW,CAAC,KAAK,CAAC;QACjE,MAAM,MAAM,GAAW,IAAA,qCAAiB,EAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/D,OAAO,CACL,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACvE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CACpD,CAAC;IACJ,CAAC;IAZe,gBAAA,SAAS,YAYxB,CAAA;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAgB,OAAO,CACrB,CAAuB,EACvB,UAAqC,EACrC,KAAa;QAEb,MAAM,KAAK,GAA2B,iCAAe,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,OAAO,GAAa,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAyB,UAAU,CAAC,UAAW,CAAC,KAAK,CAAC;QACpE,MAAM,MAAM,GAAW,IAAA,qCAAiB,EAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClE,MAAM,KAAK,GAAW,iCAAe,CAAC,KAAK,CACzC,MAAM,EACN,QAAQ,CAAC,GAAG,EACZ,QAAQ,CAAC,GAAG,CACb,CAAC;QACF,MAAM,KAAK,GAAW,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,KAAK,IAAI,KAAK,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,CAAC;QACzD,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACrD,MAAM,SAAS,GACb,KAAK,KAAK,OAAO,CAAC,KAAK;YACrB,CAAC,CAAC,OAAO,CAAC,SAAS;YACnB,CAAC,CAAC,iCAAe,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,uBAAU,CAAC,SAAS,CACzB,uBAAU,CAAC,QAAQ,CACjB,IAAA,iCAAe,EAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EACnC,uBAAU,CAAC,aAAa,CACtB,KAAK,CAAC,CAAC,EACP,IAAA,uBAAU,EAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAE,CACvC,CACF,CACF,CAAC;IACJ,CAAC;IA9Be,gBAAA,OAAO,UA8BtB,CAAA;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAgB,KAAK,CACnB,CAAuB,EACvB,UAAqC,EACrC,KAAa;QAEb,MAAM,OAAO,GAAa,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,GACL,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAW,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QAC3C,OAAO;YACL,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACrB,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACrB,KAAK,EAAE,IAAA,qCAAiB,EAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,UAAW,CAAC,KAAK,CAAC;SACtE,CAAC;IACJ,CAAC;IAde,gBAAA,KAAK,QAcpB,CAAA;IAED;;;;;;;;;;;;;;;OAeG;IACH,SAAgB,MAAM,CACpB,KAA8C,EAC9C,UAAqC,EACrC,KAAa;QAEb,MAAM,KAAK,GAA2B,iCAAe,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,CAAC,GAAW,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAW,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,OAAO,uBAAU,CAAC,SAAS,CACzB,uBAAU,CAAC,QAAQ,CACjB,IAAA,iCAAe,EACb,KAAK,CAAC,CAAC,EACP,iCAAe,CAAC,SAAS,CACvB,KAAK,EACL,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,EACtC,OAAO,CACR,CACF,EACD,uBAAU,CAAC,aAAa,CACtB,KAAK,CAAC,CAAC,EACP,IAAA,uBAAU,EAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAE,CAC7C,CACF,CACF,CAAC;IACJ,CAAC;IAxBe,gBAAA,MAAM,SAwBrB,CAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,SAAgB,KAAK,CACnB,CAAuB,EACvB,CAAuB,EACvB,KAAa,EACb,UAAqC,EACrC,KAAa;QAEb,MAAM,IAAI,GAA4C,KAAK,CACzD,CAAC,EACD,UAAU,EACV,KAAK,CACN,CAAC;QACF,MAAM,EAAE,GAA4C,KAAK,CACvD,CAAC,EACD,UAAU,EACV,KAAK,CACN,CAAC;QACF,OAAO,MAAM,CACX;YACE,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK;YACnC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK;SACpD,EACD,UAAU,EACV,KAAK,CACN,CAAC;IACJ,CAAC;IA1Be,gBAAA,KAAK,QA0BpB,CAAA;IACD;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CACpB,UAAqC,EACrC,KAAa,EACb,OAAe;QAEf,MAAM,KAAK,GAAiB,mCAAgB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,GAAW,iCAAe,CAAC,IAAI,CAAC;QAC1C,MAAM,EAAE,GAAW,IAAA,+BAAc,EAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QAC7C,MAAM,KAAK,GAAW,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;QAC1C,MAAM,KAAK,GAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,MAAM,CAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAE,GAAG,KAAK,CAAC,MAAM,CAAE,CAAC,GAAG,KAAK,CAAC;IACnE,CAAC;IAZe,gBAAA,MAAM,SAYrB,CAAA;AACH,CAAC,EAxYgB,eAAe,aAAf,eAAe,GAAf,eAAe,QAwY/B"}
@@ -0,0 +1,50 @@
1
+ import type { IAutoMovieJointAxes, IAutoMovieJointConstraint } from "@automovie/interface";
2
+ import type { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
3
+ /**
4
+ * The swing region of a ball joint: the farthest the limb may point from its
5
+ * rest direction along each great circle, read once off the constraint's
6
+ * flexion and abduction intervals and kept.
7
+ *
8
+ * The region is the star of the directions the intervals reach with no twist
9
+ * (and the constraint's `swingDeg`), widened for a proximal twist by the reach
10
+ * of every twist in its interval, and raised so it turns no faster than
11
+ * `SLOPE` with the azimuth. `swingTwistRange` reads its radius and brings a
12
+ * rotation back into it.
13
+ *
14
+ * @evidence contracts/development/common.md#meaningful-documentation States what the region is, how its table is built from the constraint and what it is widened and raised by.
15
+ * @evidence contracts/development/design.md#principled-representation The region is a radius per great circle, the representation a radial projection needs.
16
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One function, the table of a constraint; the reading and the projection are `swingTwistRange`'s.
17
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No joint is named: the axes, the rest frame and the intervals are the caller's.
18
+ */
19
+ export declare namespace swingTwistRegion {
20
+ /**
21
+ * The joint's frame the region is read in: its axes and its rest frame.
22
+ *
23
+ * @evidence contracts/development/common.md#meaningful-documentation States that the axes are the joint's clinical basis, that the rest frame lifts its angles and that an absent frame leaves them rest-relative.
24
+ * @evidence contracts/development/design.md#principled-representation The caller's clinical axis basis and rest frame, the two things that turn a rotation's angles into the joint's clinical ones.
25
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Two members, both read by the table and by the key it is kept under.
26
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No joint or bone is named, and the members are the engine's own types.
27
+ */
28
+ interface IJoint {
29
+ /** The joint's clinical axes. */
30
+ axes: IAutoMovieJointAxes;
31
+ /** The rest frame its clinical angles are lifted by. */
32
+ frame?: IAutoMovieRestFrame | undefined;
33
+ }
34
+ /**
35
+ * The radius table of a constraint on a joint's frame.
36
+ *
37
+ * @param constraint The constraint.
38
+ * @param joint The joint's axes and rest frame.
39
+ * @returns The radius on each of `swingTwistBasis.RAYS` great circles, degrees; built on first use and kept.
40
+ *
41
+ * @evidence contracts/development/common.md#meaningful-documentation States the table, its units and that it is kept.
42
+ * @evidence contracts/development/implementation.md#principled-implementation Each radius is the farthest reached swing found by a scan from the far end and a bisection, widened for a proximal twist and raised to the slope bound.
43
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure A lookup by identity, and the build in three steps on a miss.
44
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scan runs from the far end, so a ray the ranges leave and re-enter keeps its farthest reach. `SLOPE` (3) is provisional; `SCAN` and `HALVINGS` are resolutions.
45
+ * @evidence contracts/development/implementation.md#efficient-algorithms A hit is three map reads by identity, no serialization; a miss builds the table once per constraint, axes and frame: on each of `swingTwistBasis.RAYS` (360) rays a scan of up to 360 half-degree steps and 20 bisections, each one reach test of two flexions; the widening reads one ray per degree of the twist's interval; the raise compares every pair of rays, 360 squared.
46
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every call after the first reads the kept table.
47
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The tables are kept in weak maps keyed by the constraint and the axes and released with either; the frame map under them holds the rest-frame records, which are table constants.
48
+ */
49
+ function table(constraint: IAutoMovieJointConstraint, joint: IJoint): Float64Array;
50
+ }
@@ -0,0 +1,212 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.swingTwistRegion = void 0;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ const nearestAngleAlias_1 = require("../math/nearestAngleAlias");
7
+ const positiveModulo_1 = require("../math/positiveModulo");
8
+ const swingConeAngle_1 = require("../rom/swingConeAngle");
9
+ const toClinicalAngle_1 = require("../rom/toClinicalAngle");
10
+ const toRigAngle_1 = require("../rom/toRigAngle");
11
+ const swingTwistBasis_1 = require("./swingTwistBasis");
12
+ /**
13
+ * The swing region of a ball joint: the farthest the limb may point from its
14
+ * rest direction along each great circle, read once off the constraint's
15
+ * flexion and abduction intervals and kept.
16
+ *
17
+ * The region is the star of the directions the intervals reach with no twist
18
+ * (and the constraint's `swingDeg`), widened for a proximal twist by the reach
19
+ * of every twist in its interval, and raised so it turns no faster than
20
+ * `SLOPE` with the azimuth. `swingTwistRange` reads its radius and brings a
21
+ * rotation back into it.
22
+ *
23
+ * @evidence contracts/development/common.md#meaningful-documentation States what the region is, how its table is built from the constraint and what it is widened and raised by.
24
+ * @evidence contracts/development/design.md#principled-representation The region is a radius per great circle, the representation a radial projection needs.
25
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One function, the table of a constraint; the reading and the projection are `swingTwistRange`'s.
26
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No joint is named: the axes, the rest frame and the intervals are the caller's.
27
+ */
28
+ var swingTwistRegion;
29
+ (function (swingTwistRegion) {
30
+ /**
31
+ * The radius table of a constraint on a joint's frame.
32
+ *
33
+ * @param constraint The constraint.
34
+ * @param joint The joint's axes and rest frame.
35
+ * @returns The radius on each of `swingTwistBasis.RAYS` great circles, degrees; built on first use and kept.
36
+ *
37
+ * @evidence contracts/development/common.md#meaningful-documentation States the table, its units and that it is kept.
38
+ * @evidence contracts/development/implementation.md#principled-implementation Each radius is the farthest reached swing found by a scan from the far end and a bisection, widened for a proximal twist and raised to the slope bound.
39
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure A lookup by identity, and the build in three steps on a miss.
40
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scan runs from the far end, so a ray the ranges leave and re-enter keeps its farthest reach. `SLOPE` (3) is provisional; `SCAN` and `HALVINGS` are resolutions.
41
+ * @evidence contracts/development/implementation.md#efficient-algorithms A hit is three map reads by identity, no serialization; a miss builds the table once per constraint, axes and frame: on each of `swingTwistBasis.RAYS` (360) rays a scan of up to 360 half-degree steps and 20 bisections, each one reach test of two flexions; the widening reads one ray per degree of the twist's interval; the raise compares every pair of rays, 360 squared.
42
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every call after the first reads the kept table.
43
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The tables are kept in weak maps keyed by the constraint and the axes and released with either; the frame map under them holds the rest-frame records, which are table constants.
44
+ */
45
+ function table(constraint, joint) {
46
+ let byAxes = TABLES.get(constraint);
47
+ if (byAxes === undefined) {
48
+ byAxes = new WeakMap();
49
+ TABLES.set(constraint, byAxes);
50
+ }
51
+ let byFrame = byAxes.get(joint.axes);
52
+ if (byFrame === undefined) {
53
+ byFrame = new Map();
54
+ byAxes.set(joint.axes, byFrame);
55
+ }
56
+ const frame = joint.frame ?? NO_FRAME;
57
+ let kept = byFrame.get(frame);
58
+ if (kept === undefined) {
59
+ kept = build(constraint, joint);
60
+ byFrame.set(frame, kept);
61
+ }
62
+ return kept;
63
+ }
64
+ swingTwistRegion.table = table;
65
+ })(swingTwistRegion || (exports.swingTwistRegion = swingTwistRegion = {}));
66
+ /** The radius tables, by the identity of the constraint, the axes and the rest frame: the tables of a rig are kept as long as its records are. */
67
+ const TABLES = new WeakMap();
68
+ /** The key of a joint read with no rest frame. */
69
+ const NO_FRAME = Object.freeze({});
70
+ /** The fastest the region's radius may change with the azimuth, degrees per degree (provisional: three, so a projection's step is at most about three times the azimuth's step). */
71
+ const SLOPE = 3;
72
+ /** The step of the scan for the farthest reached swing on a ray, degrees. */
73
+ const SCAN = 0.5;
74
+ /** The bisections that refine it: twenty halve half a degree to under a millionth. */
75
+ const HALVINGS = 20;
76
+ /** The region's radius on each ray: reached, widened and raised. */
77
+ function build(constraint, joint) {
78
+ // The limb points no farther from rest than its stated reach, which keeps
79
+ // the rest direction's antipode outside (`ISwingTwist.reach`).
80
+ const cap = constraint.swingTwist?.reach ?? 180;
81
+ return raise(widen(reach(constraint, joint), constraint, joint)).map((radius) => Math.min(cap, radius));
82
+ }
83
+ /**
84
+ * The farthest swing along each ray at which the flexion and abduction
85
+ * intervals reach the direction, found by a scan from the far end in `SCAN`
86
+ * degree steps toward the rest direction and refined by `HALVINGS` bisections.
87
+ */
88
+ function reach(constraint, joint) {
89
+ const basis = swingTwistBasis_1.swingTwistBasis.of(joint.axes);
90
+ const table = new Float64Array(swingTwistBasis_1.swingTwistBasis.RAYS);
91
+ for (let ray = 0; ray < swingTwistBasis_1.swingTwistBasis.RAYS; ++ray) {
92
+ const azimuth = (360 * ray) / swingTwistBasis_1.swingTwistBasis.RAYS;
93
+ const inside = (swing) => reached(constraint, joint, basis, swingTwistBasis_1.swingTwistBasis.direction(basis, swing, azimuth));
94
+ let hi = 180;
95
+ let lo = 0;
96
+ for (let swing = 180 - SCAN; swing > 0; swing -= SCAN) {
97
+ if (inside(swing)) {
98
+ lo = swing;
99
+ break;
100
+ }
101
+ hi = swing;
102
+ }
103
+ for (let i = 0; i < HALVINGS && lo > 0; ++i) {
104
+ const mid = (lo + hi) / 2;
105
+ if (inside(mid))
106
+ lo = mid;
107
+ else
108
+ hi = mid;
109
+ }
110
+ table[ray] = lo;
111
+ }
112
+ return table;
113
+ }
114
+ /**
115
+ * A proximal twist turns about the rest axis outside the flexion and the
116
+ * abduction, so it carries every reached direction around the rest direction
117
+ * by its own angle: on a hip flexed forward it swings the thigh sideways. The
118
+ * directions its interval reaches are then those of no twist turned by any
119
+ * twist in it, which shifts each ray's reach along the azimuth.
120
+ */
121
+ function widen(table, constraint, joint) {
122
+ const twist = constraint.twist;
123
+ if (joint.axes.twistPlacement === "distal" || twist === null)
124
+ return table;
125
+ const ends = [
126
+ (0, toRigAngle_1.toRigAngle)(twist.min, joint.frame?.twist),
127
+ (0, toRigAngle_1.toRigAngle)(twist.max, joint.frame?.twist),
128
+ ];
129
+ const low = Math.min(...ends);
130
+ const high = Math.max(...ends);
131
+ const width = 360 / swingTwistBasis_1.swingTwistBasis.RAYS;
132
+ const turned = new Float64Array(swingTwistBasis_1.swingTwistBasis.RAYS);
133
+ for (let ray = 0; ray < swingTwistBasis_1.swingTwistBasis.RAYS; ++ray) {
134
+ let most = table[ray];
135
+ for (let shift = low; shift <= high + 1e-9; shift += width) {
136
+ const from = (0, positiveModulo_1.positiveModulo)(Math.round(ray - shift / width), swingTwistBasis_1.swingTwistBasis.RAYS);
137
+ most = Math.max(most, table[from]);
138
+ }
139
+ turned[ray] = most;
140
+ }
141
+ return turned;
142
+ }
143
+ /**
144
+ * Where the region's edge runs along a ray the farthest reach jumps between
145
+ * two rays, and a projection along the rays would jump with it. So the radius
146
+ * is raised to the least function at or above it that turns no faster than
147
+ * `SLOPE` degrees of radius per degree of azimuth: the region gains a sliver
148
+ * beside such an edge and loses nothing.
149
+ */
150
+ function raise(table) {
151
+ const raised = new Float64Array(swingTwistBasis_1.swingTwistBasis.RAYS);
152
+ const width = 360 / swingTwistBasis_1.swingTwistBasis.RAYS;
153
+ for (let ray = 0; ray < swingTwistBasis_1.swingTwistBasis.RAYS; ++ray) {
154
+ let most = 0;
155
+ for (let other = 0; other < swingTwistBasis_1.swingTwistBasis.RAYS; ++other) {
156
+ const apart = Math.min(Math.abs(ray - other), swingTwistBasis_1.swingTwistBasis.RAYS - Math.abs(ray - other));
157
+ most = Math.max(most, table[other] - SLOPE * apart * width);
158
+ }
159
+ raised[ray] = Math.min(180, most);
160
+ }
161
+ return raised;
162
+ }
163
+ /**
164
+ * Whether the flexion and abduction intervals, with no twist and within the
165
+ * swing cone, reach a direction in either reading. With no twist the rotation
166
+ * is the abduction's after the flexion's, in either order of the twist: the
167
+ * flexion turns `u` within the plane normal to the flexion axis, and the
168
+ * abduction then turns it about its own axis, which keeps the part along that
169
+ * axis, so that part gives the flexion twice and the abduction follows for
170
+ * each.
171
+ */
172
+ function reached(constraint, joint, basis, direction) {
173
+ const flexion = constraint.flexion;
174
+ const abduction = constraint.abduction;
175
+ const admits = (rigFlexion, rigAbduction) => {
176
+ const f = (0, nearestAngleAlias_1.nearestAngleAlias)((0, toClinicalAngle_1.toClinicalAngle)(rigFlexion, joint.frame?.flexion), flexion);
177
+ const a = (0, nearestAngleAlias_1.nearestAngleAlias)((0, toClinicalAngle_1.toClinicalAngle)(rigAbduction, joint.frame?.abduction), abduction);
178
+ return (f >= flexion.min &&
179
+ f <= flexion.max &&
180
+ a >= abduction.min &&
181
+ a <= abduction.max &&
182
+ (typeof constraint.swingDeg !== "number" ||
183
+ (0, swingConeAngle_1.swingConeAngle)(f, a) <= constraint.swingDeg));
184
+ };
185
+ const across = Vector3_1.Vector3.dot(Vector3_1.Vector3.cross(basis.f, basis.u), basis.a);
186
+ const first = Math.asin(swingTwistBasis_1.swingTwistBasis.clamp(Vector3_1.Vector3.dot(direction, basis.a) / across, -1, 1)) * swingTwistBasis_1.swingTwistBasis.DEG;
187
+ for (const f of [first, 180 - first]) {
188
+ const swung = Quaternion_1.Quaternion.rotateVector(Quaternion_1.Quaternion.fromAxisAngle(basis.f, f), basis.u);
189
+ const from = flat(swung, basis.a);
190
+ const to = flat(direction, basis.a);
191
+ if (Vector3_1.Vector3.length(from) < 1e-9 || Vector3_1.Vector3.length(to) < 1e-9) {
192
+ // On the abduction axis any abduction keeps the direction.
193
+ for (const a of [
194
+ abduction.min,
195
+ abduction.max,
196
+ (abduction.min + abduction.max) / 2,
197
+ ])
198
+ if (admits(f, (0, toRigAngle_1.toRigAngle)(a, joint.frame?.abduction)))
199
+ return true;
200
+ continue;
201
+ }
202
+ const a = Math.atan2(Vector3_1.Vector3.dot(basis.a, Vector3_1.Vector3.cross(from, to)), Vector3_1.Vector3.dot(from, to)) * swingTwistBasis_1.swingTwistBasis.DEG;
203
+ if (admits(f, a))
204
+ return true;
205
+ }
206
+ return false;
207
+ }
208
+ /** A vector with its part along a unit axis taken off. */
209
+ function flat(v, axis) {
210
+ return Vector3_1.Vector3.subtract(v, Vector3_1.Vector3.scale(axis, Vector3_1.Vector3.dot(v, axis)));
211
+ }
212
+ //# sourceMappingURL=swingTwistRegion.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"swingTwistRegion.js","sourceRoot":"","sources":["../../src/kinematics/swingTwistRegion.ts"],"names":[],"mappings":"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"}