@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,286 @@
1
+ import type {
2
+ AutoMovieHumanoidBone,
3
+ IAutoMovieQuaternion,
4
+ IAutoMovieSkeleton,
5
+ IAutoMovieVector3,
6
+ IAutoMoviePhysicalProfile as P,
7
+ } from "@automovie/interface";
8
+
9
+ import { Quaternion } from "../math/Quaternion";
10
+ import { Vector3 } from "../math/Vector3";
11
+ import { physicalHullFaces } from "../physics/physicalHullFaces";
12
+ import { physicalShapeBounds } from "../physics/physicalShapeBounds";
13
+ import { physicalShapeNormal } from "../physics/physicalShapeNormal";
14
+ import type { AutoMovieHumanoidSurfaceRegions } from "./AutoMovieHumanoidSurfaceRegions";
15
+ import type { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
16
+ import type { resolveAutoMovieHumanoidSurfaces } from "./resolveAutoMovieHumanoidSurfaces";
17
+ import { resolvePose } from "./resolvePose";
18
+
19
+ /**
20
+ * The rest-pose readers a humanoid's surfaces are resolved with
21
+ * (`resolveAutoMovieHumanoidSurfaces`): its bones, segments, collider
22
+ * bounds, bone-local frames, stations, and the exits of rays from them
23
+ * through the colliders with the colliders' outward normal there.
24
+ *
25
+ * @evidence contracts/development/common.md#meaningful-documentation States the readers and their reader.
26
+ * @evidence contracts/development/design.md#principled-representation Exact ray exits through convex colliders and the exited collider's outward normal (`physicalShapeNormal`).
27
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One reader bundle and the exit record.
28
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts A missing bone, segment or hit throws rather than inventing a point.
29
+ */
30
+ export namespace AutoMovieHumanoidSurfaceRays {
31
+ /** The farthest distance along a unit ray at which it is still inside a shape, or -Infinity on a miss. */
32
+ function shapeExit(
33
+ frame: P.ITransform,
34
+ shape: P.IShape,
35
+ origin: IAutoMovieVector3,
36
+ d: IAutoMovieVector3,
37
+ ): number {
38
+ const centre: IAutoMovieVector3 = Vector3.add(
39
+ frame.position,
40
+ Quaternion.rotateVector(frame.rotation, shape.transform.position),
41
+ );
42
+ const rotation: IAutoMovieQuaternion = Quaternion.multiply(
43
+ frame.rotation,
44
+ shape.transform.rotation,
45
+ );
46
+ const sphere = (c: IAutoMovieVector3, r: number): number => {
47
+ const oc: IAutoMovieVector3 = Vector3.subtract(origin, c);
48
+ const b: number = Vector3.dot(oc, d);
49
+ const disc: number = b * b - (Vector3.dot(oc, oc) - r * r);
50
+ return disc < -BOUNDARY * r
51
+ ? -Infinity
52
+ : -b + Math.sqrt(Math.max(0, disc));
53
+ };
54
+ if (shape.kind === "sphere") return sphere(centre, shape.radius);
55
+ if (shape.kind === "capsule") {
56
+ const axis: IAutoMovieVector3 = Quaternion.rotateVector(rotation, {
57
+ x: 0,
58
+ y: 1,
59
+ z: 0,
60
+ });
61
+ const a: IAutoMovieVector3 = Vector3.subtract(
62
+ centre,
63
+ Vector3.scale(axis, shape.halfLength),
64
+ );
65
+ let far: number = Math.max(
66
+ sphere(a, shape.radius),
67
+ sphere(
68
+ Vector3.add(centre, Vector3.scale(axis, shape.halfLength)),
69
+ shape.radius,
70
+ ),
71
+ );
72
+ // The cylinder: the ray's component across the axis meets the radius.
73
+ const oc: IAutoMovieVector3 = Vector3.subtract(origin, a);
74
+ const dp: IAutoMovieVector3 = Vector3.subtract(
75
+ d,
76
+ Vector3.scale(axis, Vector3.dot(d, axis)),
77
+ );
78
+ const op: IAutoMovieVector3 = Vector3.subtract(
79
+ oc,
80
+ Vector3.scale(axis, Vector3.dot(oc, axis)),
81
+ );
82
+ const qa: number = Vector3.dot(dp, dp);
83
+ if (qa > 1e-12) {
84
+ const qb: number = Vector3.dot(op, dp);
85
+ const disc: number =
86
+ qb * qb - qa * (Vector3.dot(op, op) - shape.radius * shape.radius);
87
+ if (disc >= 0) {
88
+ const t: number = (-qb + Math.sqrt(disc)) / qa;
89
+ const along: number = Vector3.dot(
90
+ Vector3.add(oc, Vector3.scale(d, t)),
91
+ axis,
92
+ );
93
+ if (along >= 0 && along <= 2 * shape.halfLength)
94
+ far = Math.max(far, t);
95
+ }
96
+ }
97
+ return far;
98
+ }
99
+ const inverse: IAutoMovieQuaternion = Quaternion.inverse(rotation);
100
+ const o: IAutoMovieVector3 = Quaternion.rotateVector(
101
+ inverse,
102
+ Vector3.subtract(origin, centre),
103
+ );
104
+ const dir: IAutoMovieVector3 = Quaternion.rotateVector(inverse, d);
105
+ let near: number = -Infinity;
106
+ let far: number = Infinity;
107
+ if (shape.kind === "hull") {
108
+ // Clip the ray against every face plane: it enters through the planes
109
+ // it runs against and leaves through the ones it runs with.
110
+ for (const face of physicalHullFaces(shape.points).faces) {
111
+ const speed: number = Vector3.dot(face.normal, dir);
112
+ const height: number = Vector3.dot(face.normal, o) - face.offset;
113
+ if (Math.abs(speed) < 1e-12) {
114
+ if (height > BOUNDARY) return -Infinity;
115
+ continue;
116
+ }
117
+ if (speed < 0) near = Math.max(near, -height / speed);
118
+ else far = Math.min(far, -height / speed);
119
+ }
120
+ return near <= far ? far : -Infinity;
121
+ }
122
+ if (shape.kind !== "box") {
123
+ shape satisfies never;
124
+ throw new Error("Unknown physical shape kind");
125
+ }
126
+ for (const k of ["x", "y", "z"] as const) {
127
+ const h: number = shape.halfExtents[k];
128
+ if (Math.abs(dir[k]) < 1e-12) {
129
+ if (Math.abs(o[k]) > h + BOUNDARY) return -Infinity;
130
+ continue;
131
+ }
132
+ const t1: number = (-h - o[k]) / dir[k];
133
+ const t2: number = (h - o[k]) / dir[k];
134
+ near = Math.max(near, Math.min(t1, t2));
135
+ far = Math.min(far, Math.max(t1, t2));
136
+ }
137
+ return near <= far ? far : -Infinity;
138
+ }
139
+
140
+ /**
141
+ * A point where a ray leaves a segment's colliders, with their outward
142
+ * normal there.
143
+ *
144
+ * @evidence contracts/development/common.md#meaningful-documentation States what the point and the normal are and in which frame.
145
+ * @evidence contracts/development/design.md#principled-representation A surface sample: a world point and the collider's outward unit normal at it.
146
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The two members a region frame is built from.
147
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None; the normal is the exited collider's own, not the ray's direction.
148
+ */
149
+ export interface ISurfacePoint {
150
+ /** The point, world metres in the rest pose. */
151
+ point: IAutoMovieVector3;
152
+
153
+ /** The outward unit normal there. */
154
+ normal: IAutoMovieVector3;
155
+ }
156
+
157
+ /**
158
+ * The rest pose readers every surface is resolved with: bones, segments,
159
+ * collider bounds, bone-local frames, stations and ray exits of one body.
160
+ *
161
+ * @evidence contracts/development/common.md#meaningful-documentation Names each reader the record returns and the body it reads.
162
+ * @evidence contracts/development/implementation.md#principled-implementation The rest pose resolved once; bounds are the union of the colliders' exact bounds; a ray's exit is the farthest exit over the segment's convex colliders, its normal that collider's.
163
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Six small closures over one rest pose map.
164
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing bone, segment or hit throws rather than inventing a point.
165
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pose resolution; each read is linear in one segment's colliders.
166
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every reader shares the one resolved rest pose.
167
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The closures retain only the one body's rest pose, released with them.
168
+ */
169
+ export function tools(skeleton: IAutoMovieSkeleton, profile: P) {
170
+ const rest: Map<AutoMovieHumanoidBone, IAutoMovieResolvedBone> = new Map(
171
+ resolvePose(
172
+ { skeleton: skeleton.id, root: null, joints: [] },
173
+ skeleton,
174
+ ).map(
175
+ (
176
+ r: IAutoMovieResolvedBone,
177
+ ): [AutoMovieHumanoidBone, IAutoMovieResolvedBone] => [r.bone, r],
178
+ ),
179
+ );
180
+ const at = (bone: AutoMovieHumanoidBone): IAutoMovieResolvedBone => {
181
+ const r: IAutoMovieResolvedBone | undefined = rest.get(bone);
182
+ if (r === undefined)
183
+ throw new Error(`Surfaces need the rig bone ${bone}`);
184
+ return r;
185
+ };
186
+ const segment = (bone: AutoMovieHumanoidBone): P.ISegment => {
187
+ const s: P.ISegment | undefined = profile.segments.find(
188
+ (x: P.ISegment): boolean => x.bone === bone,
189
+ );
190
+ if (s === undefined)
191
+ throw new Error(`Surfaces need the profile segment ${bone}`);
192
+ return s;
193
+ };
194
+ const bounds = (
195
+ bone: AutoMovieHumanoidBone,
196
+ ): { min: IAutoMovieVector3; max: IAutoMovieVector3 } => {
197
+ const s: P.ISegment = segment(bone);
198
+ const min: IAutoMovieVector3 = { x: Infinity, y: Infinity, z: Infinity };
199
+ const max: IAutoMovieVector3 = {
200
+ x: -Infinity,
201
+ y: -Infinity,
202
+ z: -Infinity,
203
+ };
204
+ for (const shape of s.shapes) {
205
+ const b: { min: IAutoMovieVector3; max: IAutoMovieVector3 } =
206
+ physicalShapeBounds(s.neutral, shape);
207
+ for (const k of ["x", "y", "z"] as const) {
208
+ min[k] = Math.min(min[k], b.min[k]);
209
+ max[k] = Math.max(max[k], b.max[k]);
210
+ }
211
+ }
212
+ return { min, max };
213
+ };
214
+ const local = (
215
+ bone: AutoMovieHumanoidBone,
216
+ world: IAutoMovieVector3,
217
+ direction: IAutoMovieVector3,
218
+ forward?: IAutoMovieVector3,
219
+ ): resolveAutoMovieHumanoidSurfaces.IFrame => {
220
+ const r: IAutoMovieResolvedBone = at(bone);
221
+ const inverse: IAutoMovieQuaternion = Quaternion.inverse(r.worldRotation);
222
+ return {
223
+ bone,
224
+ point: Quaternion.rotateVector(
225
+ inverse,
226
+ Vector3.subtract(world, r.worldPosition),
227
+ ),
228
+ normal: Quaternion.rotateVector(inverse, Vector3.normalize(direction)),
229
+ ...(forward === undefined
230
+ ? {}
231
+ : {
232
+ forward: Quaternion.rotateVector(
233
+ inverse,
234
+ Vector3.normalize(forward),
235
+ ),
236
+ }),
237
+ };
238
+ };
239
+ const station = (
240
+ s: AutoMovieHumanoidSurfaceRegions.IStation,
241
+ ): IAutoMovieVector3 => {
242
+ if (s.toward === "centre") {
243
+ const b = bounds(s.bone);
244
+ return Vector3.scale(Vector3.add(b.min, b.max), 0.5);
245
+ }
246
+ return Vector3.lerp(
247
+ at(s.bone).worldPosition,
248
+ at(s.toward).worldPosition,
249
+ s.share,
250
+ );
251
+ };
252
+ const surface = (
253
+ bone: AutoMovieHumanoidBone,
254
+ origin: IAutoMovieVector3,
255
+ direction: IAutoMovieVector3,
256
+ ): ISurfacePoint => {
257
+ const d: IAutoMovieVector3 = Vector3.normalize(direction);
258
+ const s: P.ISegment = segment(bone);
259
+ let far: number = -Infinity;
260
+ let left: P.IShape | undefined;
261
+ for (const shape of s.shapes) {
262
+ const t: number = shapeExit(s.neutral, shape, origin, d);
263
+ if (t > far) {
264
+ far = t;
265
+ left = shape;
266
+ }
267
+ }
268
+ if (!(far > -Infinity) || left === undefined)
269
+ throw new Error(`A surface ray from ${bone} misses its colliders`);
270
+ const point: IAutoMovieVector3 = Vector3.add(
271
+ origin,
272
+ Vector3.scale(d, far),
273
+ );
274
+ return { point, normal: physicalShapeNormal(s.neutral, left, point, d) };
275
+ };
276
+ const exit = (
277
+ bone: AutoMovieHumanoidBone,
278
+ origin: IAutoMovieVector3,
279
+ direction: IAutoMovieVector3,
280
+ ): IAutoMovieVector3 => surface(bone, origin, direction).point;
281
+ return { at, bounds, local, station, exit, surface };
282
+ }
283
+ }
284
+
285
+ /** Metres a station may sit outside a collider and still count as on it: the colliders are closed sets, so a station on a face or a cap must not miss by rounding. */
286
+ const BOUNDARY: number = 1e-9;
@@ -0,0 +1,189 @@
1
+ import type {
2
+ AutoMovieHumanoidBone,
3
+ AutoMovieHumanoidRegion,
4
+ IAutoMovieVector3,
5
+ } from "@automovie/interface";
6
+
7
+ /**
8
+ * The definitions of the anatomical regions a humanoid's surfaces resolve
9
+ * (`resolveAutoMovieHumanoidSurfaces`): each region's station on a bone's
10
+ * segment and its outward direction in the rest frame, the ray that finds
11
+ * its point on the colliders.
12
+ *
13
+ * @evidence contracts/development/common.md#meaningful-documentation States what the table holds and who reads it.
14
+ * @evidence contracts/development/design.md#principled-representation A station (a bone, a joint it leans toward, a share) and a direction per region, both sides from one table.
15
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The station and definition records and the table the resolver reads.
16
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Keys are the interface's closed region union.
17
+ */
18
+ export namespace AutoMovieHumanoidSurfaceRegions {
19
+ /**
20
+ * Where on a segment a region's ray starts: a share of the way from a
21
+ * bone's joint toward a child joint, or the centre of the bone's collider
22
+ * bounds.
23
+ *
24
+ * @evidence contracts/development/common.md#meaningful-documentation States the two forms a station takes.
25
+ * @evidence contracts/development/design.md#principled-representation A bone, the joint it leans toward or the bounds centre, and a share.
26
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The three members the surface resolver reads.
27
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Bones are the interface's closed bone union.
28
+ */
29
+ export interface IStation {
30
+ /** The bone. */
31
+ bone: AutoMovieHumanoidBone;
32
+
33
+ /** A child joint to interpolate toward, or the colliders' bounds centre. */
34
+ toward: AutoMovieHumanoidBone | "centre";
35
+
36
+ /** Share of the way toward the child joint. */
37
+ share: number;
38
+ }
39
+
40
+ /**
41
+ * A region's station and rest-frame outward direction: the ray whose exit
42
+ * through the segment's colliders is the region's point.
43
+ *
44
+ * @evidence contracts/development/common.md#meaningful-documentation States what the pair defines.
45
+ * @evidence contracts/development/design.md#principled-representation A ray: an origin on the segment and a direction in the rest frame.
46
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The two members a region needs.
47
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None; the point itself is read from the colliders, never stored.
48
+ */
49
+ export interface IDefinition {
50
+ /** Ray origin. */
51
+ station: IStation;
52
+
53
+ /** Outward direction in the T-pose rest frame. */
54
+ direction: IAutoMovieVector3;
55
+ }
56
+
57
+ /** Every region's definition, both sides from one table: +X is the body's left. */
58
+ export const TABLE: Readonly<
59
+ Partial<Record<AutoMovieHumanoidRegion, IDefinition>>
60
+ > = (() => {
61
+ const v = (x: number, y: number, z: number): IAutoMovieVector3 => ({
62
+ x,
63
+ y,
64
+ z,
65
+ });
66
+ const head: IStation = { bone: "head", toward: "centre", share: 0 };
67
+ const neck: IStation = { bone: "neck", toward: "head", share: 0.5 };
68
+ const chest = (share: number): IStation => ({
69
+ bone: "chest",
70
+ toward: "neck",
71
+ share,
72
+ });
73
+ const spine = (share: number): IStation => ({
74
+ bone: "spine",
75
+ toward: "chest",
76
+ share,
77
+ });
78
+ const table: Partial<Record<AutoMovieHumanoidRegion, IDefinition>> = {
79
+ crown: { station: head, direction: v(0, 1, 0) },
80
+ forehead: { station: head, direction: v(0, 0.45, 1) },
81
+ face: { station: head, direction: v(0, 0, 1) },
82
+ noseBridge: { station: head, direction: v(0, 0.1, 1) },
83
+ nose: { station: head, direction: v(0, -0.15, 1) },
84
+ mouth: { station: head, direction: v(0, -0.4, 1) },
85
+ chin: { station: head, direction: v(0, -0.75, 0.65) },
86
+ headBack: { station: head, direction: v(0, 0, -1) },
87
+ throat: { station: neck, direction: v(0, 0, 1) },
88
+ nape: { station: neck, direction: v(0, 0, -1) },
89
+ sternum: { station: chest(0.5), direction: v(0, 0, 1) },
90
+ solarPlexus: { station: chest(0), direction: v(0, 0, 1) },
91
+ liver: { station: chest(0.1), direction: v(-0.8, 0, 0.6) },
92
+ spleen: { station: chest(0.1), direction: v(0.8, 0, 0.6) },
93
+ upperBack: { station: chest(0.5), direction: v(0, 0, -1) },
94
+ abdomen: { station: spine(0.4), direction: v(0, 0, 1) },
95
+ lowerBack: { station: spine(0.4), direction: v(0, 0, -1) },
96
+ groin: {
97
+ station: { bone: "hips", toward: "centre", share: 0 },
98
+ direction: v(0, -0.6, 0.8),
99
+ },
100
+ };
101
+ for (const [Side, x] of [
102
+ ["Left", 1],
103
+ ["Right", -1],
104
+ ] as const) {
105
+ const s = (name: string): AutoMovieHumanoidBone =>
106
+ `${Side.toLowerCase()}${name}` as AutoMovieHumanoidBone;
107
+ const set = (name: string, def: IDefinition): void => {
108
+ table[`${name}${Side}` as AutoMovieHumanoidRegion] = def;
109
+ };
110
+ set("jaw", { station: head, direction: v(0.7 * x, -0.55, 0.45) });
111
+ // The cheek: the zygomatic prominence over the buccal area, at the
112
+ // nose's height (its ray's -0.15) and 40 degrees out from the face's
113
+ // forward ray, tan 40 = 0.84 (provisional).
114
+ set("cheek", { station: head, direction: v(0.84 * x, -0.15, 1) });
115
+ set("temple", { station: head, direction: v(x, 0.25, 0.3) });
116
+ set("ear", { station: head, direction: v(x, 0, 0) });
117
+ set("neck", { station: neck, direction: v(x, 0, 0) });
118
+ set("chest", { station: chest(0.55), direction: v(0.45 * x, 0, 1) });
119
+ set("ribs", { station: chest(0.25), direction: v(x, 0, 0.15) });
120
+ set("kidney", { station: spine(0.8), direction: v(0.6 * x, 0, -0.8) });
121
+ set("hip", {
122
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0 },
123
+ direction: v(x, 0, 0),
124
+ });
125
+ // The top of the shoulder over the acromion, on the thorax's collider
126
+ // at nine tenths of the way from the chest's joint to the shoulder's,
127
+ // facing up and a little out along the trapezius' slope
128
+ // (provisional). It rode the upper arm's capsule before; with the arm
129
+ // hanging, that point and its normal turned to the arm's outer side.
130
+ set("shoulder", {
131
+ station: { bone: "chest", toward: s("UpperArm"), share: 0.9 },
132
+ direction: v(0.3 * x, 1, 0),
133
+ });
134
+ set("upperArm", {
135
+ station: { bone: s("UpperArm"), toward: s("LowerArm"), share: 0.5 },
136
+ direction: v(0, 1, 0),
137
+ });
138
+ set("elbow", {
139
+ station: { bone: s("LowerArm"), toward: s("Hand"), share: 0 },
140
+ direction: v(0, 0, -1),
141
+ });
142
+ set("forearm", {
143
+ station: { bone: s("LowerArm"), toward: s("Hand"), share: 0.5 },
144
+ direction: v(0, 1, 0),
145
+ });
146
+ set("wrist", {
147
+ station: { bone: s("LowerArm"), toward: s("Hand"), share: 0.95 },
148
+ direction: v(0, 1, 0),
149
+ });
150
+ set("pocketFront", {
151
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.15 },
152
+ direction: v(0.35 * x, 0, 1),
153
+ });
154
+ set("handBack", {
155
+ station: { bone: s("Hand"), toward: s("MiddleProximal"), share: 0.5 },
156
+ direction: v(0, 1, 0),
157
+ });
158
+ set("thighFront", {
159
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.5 },
160
+ direction: v(0, 0, 1),
161
+ });
162
+ set("thighOuter", {
163
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.5 },
164
+ direction: v(x, 0, 0),
165
+ });
166
+ set("thighInner", {
167
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.5 },
168
+ direction: v(-x, 0, 0),
169
+ });
170
+ set("knee", {
171
+ station: { bone: s("LowerLeg"), toward: s("Foot"), share: 0 },
172
+ direction: v(0, 0, 1),
173
+ });
174
+ set("shin", {
175
+ station: { bone: s("LowerLeg"), toward: s("Foot"), share: 0.5 },
176
+ direction: v(0, 0, 1),
177
+ });
178
+ set("calf", {
179
+ station: { bone: s("LowerLeg"), toward: s("Foot"), share: 0.35 },
180
+ direction: v(0, 0, -1),
181
+ });
182
+ set("footTop", {
183
+ station: { bone: s("Foot"), toward: s("Toes"), share: 0.5 },
184
+ direction: v(0, 1, 0),
185
+ });
186
+ }
187
+ return table;
188
+ })();
189
+ }
@@ -1,5 +1,7 @@
1
1
  import { IAutoMovieQuaternion } from "@automovie/interface";
2
2
 
3
+ import { IAutoMovieSwivelSeed } from "./IAutoMovieSwivelSeed";
4
+
3
5
  /**
4
6
  * The articulation `hingedArmArticulation` chose for an arm reach, with its
5
7
  * range-of-motion cost.
@@ -7,14 +9,16 @@ import { IAutoMovieQuaternion } from "@automovie/interface";
7
9
  * Every candidate the solver scores lands the hand on the reachable shell
8
10
  * toward the target, so the choice among them is legality first and then the
9
11
  * least clinical deviation from the anatomical neutral. `reachPose` lowers
10
- * `upper` and `lower` into clinical angles for the shoulder and elbow.
12
+ * `upper` and `lower` into clinical angles for the shoulder and elbow. Its
13
+ * branch and swivel are the seed a fit of a nearby target continues from
14
+ * (`IAutoMovieSwivelNear`).
11
15
  *
12
16
  * @evidence contracts/development/design.md#principled-representation The two deltas are a hinge rotation in closed form and a chain-root rotation from the swivel sweep, and `overshoot` is the caller scorer's value, which `reachPose` takes from `jointRomOvershoot`, the measure the pose gate applies, so the reported cost is the gate's verdict rather than a solver-private score.
13
- * @evidence contracts/development/design.md#minimal-and-owned-surface Mirrors the two-delta shape of `IAutoMovieTwoBoneArticulation` with the one extra fact a hinged solve has, its cost; the scorer's deviation term decides the choice but is dropped from the result because no caller reads it.
17
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Mirrors the two-delta shape of `IAutoMovieTwoBoneArticulation` with the facts a hinged solve adds, its cost and the seed that continues it; the scorer's deviation and second key are returned for a caller that ranks fits by what they scored.
14
18
  * @evidence contracts/development/design.md#prohibited-design-shortcuts A rig that cannot hold any legal pose still returns its least-overshoot candidate with a positive `overshoot` rather than a clamped pose presented as clean, and a non-finite angle scores `Infinity` so it cannot win.
15
19
  * @evidence contracts/development/common.md#meaningful-documentation States the producer, the selection rule, the consumer, each delta's joint and frame, the hinge-only property of `lower`, and the unit and meaning of `overshoot` including `0` and `Infinity`.
16
20
  */
17
- export interface IAutoMovieHingedArticulation {
21
+ export interface IAutoMovieHingedArticulation extends IAutoMovieSwivelSeed {
18
22
  /** Bone-local articulation delta for the chain-root joint (the shoulder). */
19
23
  upper: IAutoMovieQuaternion;
20
24
 
@@ -37,4 +41,18 @@ export interface IAutoMovieHingedArticulation {
37
41
  * rather than free, so a malformed candidate can never win the selection.
38
42
  */
39
43
  overshoot: number;
44
+
45
+ /**
46
+ * Metres the effector rests short of (or past) the target along the line
47
+ * from the chain root, because the target distance lies outside the chain's
48
+ * span or the mid joint stopped at a limit of its own range; `0` when a
49
+ * legal hinge angle reaches the distance.
50
+ */
51
+ shortfall: number;
52
+
53
+ /** The chosen candidate's exact deviation, the scorer's tie-break after the overshoot. */
54
+ deviation: number;
55
+
56
+ /** The chosen candidate's second key (the scorer's `tiebreak`), when the sweep has a `tie`. */
57
+ second?: number;
40
58
  }
@@ -0,0 +1,39 @@
1
+ import {
2
+ AutoMovieHumanoidBone,
3
+ IAutoMovieJointAxes,
4
+ IAutoMovieSkeleton,
5
+ } from "@automovie/interface";
6
+
7
+ import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
8
+
9
+ /**
10
+ * The rig a pose's clinical angles are read through: its skeleton and the
11
+ * host's per-bone axis and rest-frame tables, the same three inputs
12
+ * {@link resolvePose} takes.
13
+ *
14
+ * A function that must turn a joint's `[flexion, abduction, twist]` into its
15
+ * bone-local rotation and back (to difference or blend poses as rotations
16
+ * instead of as angle triples) receives them as one value, so the forward and
17
+ * inverse maps cannot be given different tables.
18
+ *
19
+ * @evidence contracts/development/common.md#meaningful-documentation States what the rig is for and each member's precedence and default.
20
+ * @evidence contracts/development/design.md#principled-representation The skeleton with its two tables is exactly what fixes the map between clinical angles and bone-local rotations.
21
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Three members, each already an input of `resolvePose`.
22
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the interface skeleton and the engine's axis and rest-frame types.
23
+ */
24
+ export interface IAutoMoviePoseRig {
25
+ /** The rig the poses articulate; its bones may declare axes and ranges. */
26
+ skeleton: IAutoMovieSkeleton;
27
+
28
+ /**
29
+ * Clinical axes for the bones that declare none, such as
30
+ * `HUMANOID_JOINT_AXES`; a bone in neither uses the default basis.
31
+ */
32
+ jointAxes?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>>;
33
+
34
+ /**
35
+ * Rest frames that read the angles as clinical, such as
36
+ * `HUMANOID_REST_FRAME`; an absent bone's angles are rest-relative.
37
+ */
38
+ restFrames?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieRestFrame>>;
39
+ }
@@ -0,0 +1,26 @@
1
+ import { IAutoMovieSwivelSeed } from "./IAutoMovieSwivelSeed";
2
+
3
+ /**
4
+ * A hinged chain's fit continued from a nearby one: the seed's branch, and
5
+ * its swivel refined within one sweep step either way to `tolerance`, in
6
+ * place of the sweep over every swivel (`hingedArmArticulation`).
7
+ *
8
+ * A fit's chosen swivel moves continuously with its target inside one basin
9
+ * of its score, so a target a moment away from the seed's has its fit's
10
+ * swivel within a step of the seed's, and the seeded fit is that fit. Where
11
+ * the best basin changes between the two targets, the seeded fit stays on
12
+ * the seed's basin: the continuous pose the seed's motion carries on to, which
13
+ * a velocity read across the change wants, where the fit itself jumps.
14
+ *
15
+ * @evidence contracts/development/design.md#principled-representation A seed and the width its swivel is refined to, the two facts a continued fit needs.
16
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The seed's two members and one tolerance.
17
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Extends `IAutoMovieSwivelSeed` rather than repeating it.
18
+ * @evidence contracts/development/common.md#meaningful-documentation States what a seeded fit searches, why it equals the fit inside a basin and what it gives where the basin changes.
19
+ */
20
+ export interface IAutoMovieSwivelNear extends IAutoMovieSwivelSeed {
21
+ /**
22
+ * The width of the swivel bracket the refinement stops at, degrees,
23
+ * positive; the swivel found lies within it of the bracket's best.
24
+ */
25
+ tolerance: number;
26
+ }
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Which of a hinged chain's poses a fit chose, by the two numbers that name
3
+ * one for any target (`hingedArmSwivel`): its bend branch and its swivel
4
+ * about the chain's root-to-effector line. A fit of a nearby target seeded
5
+ * with it (`IAutoMovieSwivelNear`) continues the same pose instead of
6
+ * searching every swivel again.
7
+ *
8
+ * @evidence contracts/development/design.md#principled-representation The swivel parameterisation of Tolani, Goswami and Badler 2000: a branch and a swivel name one pose of the chain for any target.
9
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Two members, what a fit chose and a seeded fit continues.
10
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The pose itself stays the fit's; the seed carries only what continues it.
11
+ * @evidence contracts/development/common.md#meaningful-documentation States what the two numbers name, their units and who reads them.
12
+ */
13
+ export interface IAutoMovieSwivelSeed {
14
+ /** The swivel about the chain's root-to-effector line, degrees (`hingedArmSwivel.pose`). */
15
+ swivel: number;
16
+
17
+ /** The bend branch: its index in `hingedArmSwivel.branches`. */
18
+ branch: number;
19
+ }
@@ -0,0 +1,41 @@
1
+ import { AutoMovieJointTwistPlacement } from "@automovie/interface";
2
+
3
+ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
4
+
5
+ /**
6
+ * The second Euler chart of a joint rotation, in rest-relative (rig)
7
+ * degrees: the other triple that composes to the same rotation.
8
+ *
9
+ * A distal twist composes `Ry(a)·Rx(f)·Rz(t)`, whose second chart is
10
+ * `(180 − f, a + 180, t + 180)`; a proximal twist composes `Rz(t)·Ry(a)·Rx(f)`,
11
+ * whose second chart is `(f + 180, 180 − a, t + 180)`. A left-handed basis is
12
+ * extracted against `−twist`, so its twist takes `−180` where a right-handed
13
+ * one takes `+180`, the same rotation by a full turn. No angle is wrapped:
14
+ * the caller chooses the full-turn alias it needs.
15
+ *
16
+ * @param rig The rest-relative angles of one chart, degrees.
17
+ * @param placement Where the basis places the twist; absent means proximal.
18
+ * @param handed `1` for a right-handed basis (`flexion × abduction = +twist`), `-1` for a left-handed one.
19
+ * @returns The other chart's rest-relative angles, degrees.
20
+ *
21
+ * @evidence contracts/development/implementation.md#principled-implementation The two charts of a three-angle composition differ by a half turn of each outer angle and the reflection of the middle one about its right angle, which leaves every entry of the composed matrix unchanged.
22
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One record of three sums; `decomposeJointRotationOnBasis` scores it against a range, so the chart rule is written once.
23
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No angle is wrapped or clamped and no bone is named.
24
+ * @evidence contracts/development/common.md#meaningful-documentation States both composition orders with their second chart, the handedness term, the unit and that aliases are the caller's.
25
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three additions.
26
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of three numbers with nothing to share between calls.
27
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the caller owns the returned angles.
28
+ */
29
+ export const alternateRigJointAngles: (
30
+ rig: IAutoMovieResolvedJointAngles,
31
+ placement: AutoMovieJointTwistPlacement | undefined,
32
+ handed: 1 | -1,
33
+ ) => IAutoMovieResolvedJointAngles = (
34
+ rig: IAutoMovieResolvedJointAngles,
35
+ placement: AutoMovieJointTwistPlacement | undefined,
36
+ handed: 1 | -1,
37
+ ): IAutoMovieResolvedJointAngles => ({
38
+ flexion: placement === "distal" ? 180 - rig.flexion : rig.flexion + 180,
39
+ abduction: placement === "distal" ? rig.abduction + 180 : 180 - rig.abduction,
40
+ twist: rig.twist + 180 * handed,
41
+ });