@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
@@ -14,6 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./AutoMovieAir"), exports);
18
+ __exportStar(require("./AutoMovieGravity"), exports);
17
19
  __exportStar(require("./AutoMovieImpactKind"), exports);
18
20
  __exportStar(require("./AutoMovieMotionAudit"), exports);
19
21
  __exportStar(require("./AutoMoviePhysicalBalance"), exports);
@@ -100,6 +102,11 @@ __exportStar(require("./physicalContactBindingRows"), exports);
100
102
  __exportStar(require("./physicalContactSupportGoals"), exports);
101
103
  __exportStar(require("./physicalContactSupportRows"), exports);
102
104
  __exportStar(require("./physicalGravityTorques"), exports);
105
+ __exportStar(require("./physicalHullErode"), exports);
106
+ __exportStar(require("./physicalHullFaces"), exports);
107
+ __exportStar(require("./physicalHullMass"), exports);
108
+ __exportStar(require("./physicalHullNearest"), exports);
109
+ __exportStar(require("./physicalHullSegment"), exports);
103
110
  __exportStar(require("./physicalInputDigest"), exports);
104
111
  __exportStar(require("./physicalJointChain"), exports);
105
112
  __exportStar(require("./physicalJointEffort"), exports);
@@ -111,10 +118,16 @@ __exportStar(require("./physicalModelRestTransforms"), exports);
111
118
  __exportStar(require("./physicalNativeShape"), exports);
112
119
  __exportStar(require("./physicalNativeVector"), exports);
113
120
  __exportStar(require("./physicalPointProjection"), exports);
121
+ __exportStar(require("./physicalInertiaTensor"), exports);
122
+ __exportStar(require("./physicalPrincipalAxes"), exports);
114
123
  __exportStar(require("./physicalRecoverySupportGoals"), exports);
115
124
  __exportStar(require("./physicalReleasedQuality"), exports);
116
125
  __exportStar(require("./physicalShapeBounds"), exports);
126
+ __exportStar(require("./physicalShapeNearest"), exports);
127
+ __exportStar(require("./physicalShapeNormal"), exports);
128
+ __exportStar(require("./physicalShapePairDistance"), exports);
117
129
  __exportStar(require("./physicalShapeSegmentDistance"), exports);
130
+ __exportStar(require("./physicalShapeSpan"), exports);
118
131
  __exportStar(require("./physicalShapeSurfaceAnchor"), exports);
119
132
  __exportStar(require("./physicalSingularBudget"), exports);
120
133
  __exportStar(require("./physicalSupportPoint"), exports);
@@ -134,6 +147,9 @@ __exportStar(require("./projectPhysicalJointVelocity"), exports);
134
147
  __exportStar(require("./projectPhysicalSupportReach"), exports);
135
148
  __exportStar(require("./projectPhysicalTargets"), exports);
136
149
  __exportStar(require("./projectileAt"), exports);
150
+ __exportStar(require("./projectileContinue"), exports);
151
+ __exportStar(require("./projectileDragFlight"), exports);
152
+ __exportStar(require("./projectileFirstContact"), exports);
137
153
  __exportStar(require("./projectileSphereHit"), exports);
138
154
  __exportStar(require("./projectileTrajectory"), exports);
139
155
  __exportStar(require("./readPhysicalFrame"), exports);
@@ -176,4 +192,5 @@ __exportStar(require("./validatePhysicalProfile"), exports);
176
192
  __exportStar(require("./visitPhysicalNative"), exports);
177
193
  __exportStar(require("./warmPhysicalSupportTargets"), exports);
178
194
  __exportStar(require("./yieldPhysicalSimulation"), exports);
195
+ __exportStar(require("./markAutoMovieSkeleton"), exports);
179
196
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/physics/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/physics/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ import type { IAutoMoviePhysicalProfile } from "@automovie/interface";
2
+ import type { IAutoMovieMark } from "../geometry/IAutoMovieMark";
3
+ import type { AutoMoviePhysicsCache } from "./AutoMoviePhysicsCache";
4
+ /**
5
+ * Turn articulated bodies at one cached instant into inspection marks: one bone segment per joint, from the parent segment's position to the child's, and one joint point per segment.
6
+ *
7
+ * It works on any body a physical profile describes, whatever its rig. A bone mark has kind `bone`, label `bone`, colour ochre `c8a24a` and path `<body>/<child>/bone`; a joint mark has kind `joint`, label `joint`, colour pink `ff7eb6` and path `<body>/<bone>/joint`, so a pattern naming a body or one of its bones selects its marks. Both are in world metres and unanchored, because the cached positions are world positions.
8
+ *
9
+ * It throws naming the body and bone when the frame lacks a segment the profile names.
10
+ *
11
+ * ```ts
12
+ * const marks = markAutoMovieSkeleton({ bodies, frame: cache.at(seconds) });
13
+ * ```
14
+ *
15
+ * @param props.bodies Scene body ids with their profiles, whose joints and segments are drawn.
16
+ * @param props.frame The cached state at the drawn second.
17
+ * @returns Every body's bone marks in joint order, then its joint marks in segment order, body by body.
18
+ *
19
+ * @evidence contracts/development/common.md#meaningful-documentation States what is drawn and from which data, the kinds, labels, colours, paths and frame of both mark kinds, the refusal, and shows the call.
20
+ * @evidence contracts/development/implementation.md#principled-implementation A profile joint connects a parent segment to a child segment, so its bone is the line between the two segments' cached world positions, and each segment's position is where its joint sits; nothing is inferred from a rig's bone names.
21
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over each body's joints, one over its segments.
22
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing segment is refused instead of drawn at the origin, and no body or bone is treated specially; the two colours are a drawing convention chosen apart from every other kind's.
23
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the joints and segments of the bodies.
24
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of one instant.
25
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh marks and keeps nothing.
26
+ */
27
+ export declare function markAutoMovieSkeleton(props: {
28
+ bodies: readonly {
29
+ id: string;
30
+ profile: IAutoMoviePhysicalProfile;
31
+ }[];
32
+ frame: AutoMoviePhysicsCache.IFrame;
33
+ }): IAutoMovieMark[];
@@ -0,0 +1,62 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.markAutoMovieSkeleton = markAutoMovieSkeleton;
4
+ /**
5
+ * Turn articulated bodies at one cached instant into inspection marks: one bone segment per joint, from the parent segment's position to the child's, and one joint point per segment.
6
+ *
7
+ * It works on any body a physical profile describes, whatever its rig. A bone mark has kind `bone`, label `bone`, colour ochre `c8a24a` and path `<body>/<child>/bone`; a joint mark has kind `joint`, label `joint`, colour pink `ff7eb6` and path `<body>/<bone>/joint`, so a pattern naming a body or one of its bones selects its marks. Both are in world metres and unanchored, because the cached positions are world positions.
8
+ *
9
+ * It throws naming the body and bone when the frame lacks a segment the profile names.
10
+ *
11
+ * ```ts
12
+ * const marks = markAutoMovieSkeleton({ bodies, frame: cache.at(seconds) });
13
+ * ```
14
+ *
15
+ * @param props.bodies Scene body ids with their profiles, whose joints and segments are drawn.
16
+ * @param props.frame The cached state at the drawn second.
17
+ * @returns Every body's bone marks in joint order, then its joint marks in segment order, body by body.
18
+ *
19
+ * @evidence contracts/development/common.md#meaningful-documentation States what is drawn and from which data, the kinds, labels, colours, paths and frame of both mark kinds, the refusal, and shows the call.
20
+ * @evidence contracts/development/implementation.md#principled-implementation A profile joint connects a parent segment to a child segment, so its bone is the line between the two segments' cached world positions, and each segment's position is where its joint sits; nothing is inferred from a rig's bone names.
21
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over each body's joints, one over its segments.
22
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing segment is refused instead of drawn at the origin, and no body or bone is treated specially; the two colours are a drawing convention chosen apart from every other kind's.
23
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the joints and segments of the bodies.
24
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of one instant.
25
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh marks and keeps nothing.
26
+ */
27
+ function markAutoMovieSkeleton(props) {
28
+ const marks = [];
29
+ for (const body of props.bodies) {
30
+ const at = (bone) => {
31
+ const state = props.frame.bodies[body.id]?.[bone];
32
+ if (state === undefined)
33
+ throw new Error(`markAutoMovieSkeleton: the frame has no segment ${body.id}/${bone}`);
34
+ return [state.position.x, state.position.y, state.position.z];
35
+ };
36
+ for (const joint of body.profile.joints)
37
+ marks.push({
38
+ path: `${body.id}/${joint.child}/bone`,
39
+ kind: "bone",
40
+ label: "bone",
41
+ color: 0xc8a24a,
42
+ shape: {
43
+ type: "segments",
44
+ points: [...at(joint.parent), ...at(joint.child)],
45
+ },
46
+ flagged: false,
47
+ anchor: null,
48
+ });
49
+ for (const segment of body.profile.segments)
50
+ marks.push({
51
+ path: `${body.id}/${segment.bone}/joint`,
52
+ kind: "joint",
53
+ label: "joint",
54
+ color: 0xff7eb6,
55
+ shape: { type: "points", points: at(segment.bone) },
56
+ flagged: false,
57
+ anchor: null,
58
+ });
59
+ }
60
+ return marks;
61
+ }
62
+ //# sourceMappingURL=markAutoMovieSkeleton.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markAutoMovieSkeleton.js","sourceRoot":"","sources":["../../src/physics/markAutoMovieSkeleton.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,+BAAsC,KAGrC;IACC,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,EAAE,GAA+B,CAAC,IAAY,EAAY,EAAE;YAChE,MAAM,KAAK,GACT,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,KAAK,KAAK,SAAS;gBACrB,MAAM,IAAI,KAAK,CACb,mDAAmD,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CACrE,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YACrC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,KAAK,OAAO;gBACtC,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE;oBACL,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;iBAClD;gBACD,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QACL,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ;YACzC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,QAAQ;gBACxC,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACnD,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;IACP,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,25 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * The vertices of a convex hull shrunk inward by a depth: every face plane
4
+ * moves inward by `depth`, and the eroded solid is what remains behind all
5
+ * of them.
6
+ *
7
+ * A vertex of the eroded solid is the meeting point of three moved planes
8
+ * that lies behind every other moved plane, so each triple of faces is
9
+ * solved by Cramer's rule and kept when it does.
10
+ *
11
+ * @param points The hull's shape-local points, metres, spanning a volume.
12
+ * @param depth The inward offset, metres; below the hull's `depth` about its
13
+ * centre, so the eroded solid keeps a volume.
14
+ * @returns The eroded solid's vertices in the points' frame.
15
+ * @throws {Error} When the depth leaves no volume.
16
+ *
17
+ * @evidence contracts/development/common.md#meaningful-documentation States the erosion as moved half-spaces, how vertices are found, the premise on the depth and the frame.
18
+ * @evidence contracts/development/implementation.md#principled-implementation Erosion of a convex polytope by a ball is the intersection of its half-spaces moved inward by the radius; vertex enumeration of that intersection takes each plane triple's unique point and keeps the feasible ones.
19
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Owns only the erosion: faces come from `physicalHullFaces`, and the result is a point set any hull consumer reads, so a compliant shape's rigid core is one more hull.
20
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Parallel triples are refused by a determinant below 1e-12, dimensionless because the normals are units; feasibility uses the hull's own coplanarity tolerance. The non-null assertions index the face list by bounded indices.
21
+ * @evidence contracts/development/implementation.md#efficient-algorithms Quartic in the face count, a few dozen faces, once per compliant hull when a world is bound.
22
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Called once per compliant hull collider at binding; nothing repeats it.
23
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
24
+ */
25
+ export declare function physicalHullErode(points: readonly IAutoMovieVector3[], depth: number): IAutoMovieVector3[];
@@ -0,0 +1,54 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalHullErode = physicalHullErode;
4
+ const Vector3_1 = require("../math/Vector3");
5
+ const physicalHullFaces_1 = require("./physicalHullFaces");
6
+ /**
7
+ * The vertices of a convex hull shrunk inward by a depth: every face plane
8
+ * moves inward by `depth`, and the eroded solid is what remains behind all
9
+ * of them.
10
+ *
11
+ * A vertex of the eroded solid is the meeting point of three moved planes
12
+ * that lies behind every other moved plane, so each triple of faces is
13
+ * solved by Cramer's rule and kept when it does.
14
+ *
15
+ * @param points The hull's shape-local points, metres, spanning a volume.
16
+ * @param depth The inward offset, metres; below the hull's `depth` about its
17
+ * centre, so the eroded solid keeps a volume.
18
+ * @returns The eroded solid's vertices in the points' frame.
19
+ * @throws {Error} When the depth leaves no volume.
20
+ *
21
+ * @evidence contracts/development/common.md#meaningful-documentation States the erosion as moved half-spaces, how vertices are found, the premise on the depth and the frame.
22
+ * @evidence contracts/development/implementation.md#principled-implementation Erosion of a convex polytope by a ball is the intersection of its half-spaces moved inward by the radius; vertex enumeration of that intersection takes each plane triple's unique point and keeps the feasible ones.
23
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Owns only the erosion: faces come from `physicalHullFaces`, and the result is a point set any hull consumer reads, so a compliant shape's rigid core is one more hull.
24
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Parallel triples are refused by a determinant below 1e-12, dimensionless because the normals are units; feasibility uses the hull's own coplanarity tolerance. The non-null assertions index the face list by bounded indices.
25
+ * @evidence contracts/development/implementation.md#efficient-algorithms Quartic in the face count, a few dozen faces, once per compliant hull when a world is bound.
26
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Called once per compliant hull collider at binding; nothing repeats it.
27
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
28
+ */
29
+ function physicalHullErode(points, depth) {
30
+ const hull = (0, physicalHullFaces_1.physicalHullFaces)(points);
31
+ if (!(depth < hull.depth))
32
+ throw new Error("A hull's erosion must leave a volume");
33
+ const faces = hull.faces;
34
+ const out = [];
35
+ for (let i = 0; i < faces.length; i++)
36
+ for (let j = i + 1; j < faces.length; j++)
37
+ for (let k = j + 1; k < faces.length; k++) {
38
+ const a = faces[i].normal;
39
+ const b = faces[j].normal;
40
+ const c = faces[k].normal;
41
+ const bc = Vector3_1.Vector3.cross(b, c);
42
+ const determinant = Vector3_1.Vector3.dot(a, bc);
43
+ if (Math.abs(determinant) < 1e-12)
44
+ continue;
45
+ // Cramer's rule for the point on all three moved planes.
46
+ const point = Vector3_1.Vector3.scale(Vector3_1.Vector3.add(Vector3_1.Vector3.add(Vector3_1.Vector3.scale(bc, faces[i].offset - depth), Vector3_1.Vector3.scale(Vector3_1.Vector3.cross(c, a), faces[j].offset - depth)), Vector3_1.Vector3.scale(Vector3_1.Vector3.cross(a, b), faces[k].offset - depth)), 1 / determinant);
47
+ if (faces.every((face) => Vector3_1.Vector3.dot(face.normal, point) - (face.offset - depth) <=
48
+ hull.tolerance) &&
49
+ !out.some((seen) => Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(seen, point)) <= hull.tolerance))
50
+ out.push(point);
51
+ }
52
+ return out;
53
+ }
54
+ //# sourceMappingURL=physicalHullErode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalHullErode.js","sourceRoot":"","sources":["../../src/physics/physicalHullErode.ts"],"names":[],"mappings":";;;AAEA,6CAA0C;AAC1C,2DAAwD;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,2BACE,MAAoC,EACpC,KAAa;IAEb,MAAM,IAAI,GAA4B,IAAA,qCAAiB,EAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAA8B,IAAI,CAAC,KAAK,CAAC;IACpD,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAC3C,KAAK,IAAI,CAAC,GAAW,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;YAC/C,KAAK,IAAI,CAAC,GAAW,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClD,MAAM,CAAC,GAAsB,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;gBAC9C,MAAM,CAAC,GAAsB,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;gBAC9C,MAAM,CAAC,GAAsB,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;gBAC9C,MAAM,EAAE,GAAsB,iBAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClD,MAAM,WAAW,GAAW,iBAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,KAAK;oBAAE,SAAS;gBAC5C,yDAAyD;gBACzD,MAAM,KAAK,GAAsB,iBAAO,CAAC,KAAK,CAC5C,iBAAO,CAAC,GAAG,CACT,iBAAO,CAAC,GAAG,CACT,iBAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,GAAG,KAAK,CAAC,EAC3C,iBAAO,CAAC,KAAK,CAAC,iBAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,GAAG,KAAK,CAAC,CAC7D,EACD,iBAAO,CAAC,KAAK,CAAC,iBAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,GAAG,KAAK,CAAC,CAC7D,EACD,CAAC,GAAG,WAAW,CAChB,CAAC;gBACF,IACE,KAAK,CAAC,KAAK,CACT,CAAC,IAA6B,EAAW,EAAE,CACzC,iBAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;oBACvD,IAAI,CAAC,SAAS,CACjB;oBACD,CAAC,GAAG,CAAC,IAAI,CACP,CAAC,IAAuB,EAAW,EAAE,CACnC,iBAAO,CAAC,MAAM,CAAC,iBAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAClE;oBAED,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;IACL,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,56 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * The faces of the convex hull of a point set: each face's outward unit
4
+ * normal, its plane offset along that normal and its vertex loop, counter
5
+ * clockwise seen from outside.
6
+ *
7
+ * A plane through three points is a face when no point lies in front of it;
8
+ * every point on that plane then belongs to the face, and their planar convex
9
+ * hull (Andrew's monotone chain) orders the loop. Points within `tolerance`
10
+ * of a plane count as on it, so a flat ring of many points yields one face
11
+ * rather than a fan of slivers. A point set that spans no volume has no face.
12
+ *
13
+ * The result is remembered per `points` array, so a profile's shape pays the
14
+ * search once however many queries read it; the array must not be mutated
15
+ * after its first use.
16
+ *
17
+ * @param points Shape-local points, metres.
18
+ * @returns The hull's faces, its vertices, the mean of its vertices, the
19
+ * radii about that mean of a sphere containing the hull and of one inside
20
+ * it, and how deep any input point lies below the surface.
21
+ *
22
+ * @evidence contracts/development/common.md#meaningful-documentation States what a face is, how coplanar points are gathered, the loop order, the degenerate case and the per-array memo with its no-mutation premise.
23
+ * @evidence contracts/development/implementation.md#principled-implementation The definition of a hull face applied directly: a supporting plane through three non-collinear points with every other point behind it (de Berg et al., Computational Geometry, chapter 11), and Andrew's monotone chain for the loop of each face.
24
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of hull topology: the nearest-point query, bounds, mass, erosion, validation and the native mapping all read these faces instead of deriving their own.
25
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The tolerance is 1e-9 of the point set's extent, a relative floor above double rounding of the plane products and far below any modelled dimension; the non-null assertions index arrays by indices the loops themselves bound.
26
+ * @evidence contracts/development/implementation.md#efficient-algorithms Triples of points against all points is cubic to quartic in the point count, taken once per array for the few dozen points of a body module; triples already covered by a found face are skipped, and every later call is a map lookup.
27
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The faces of one `points` array are computed once and shared by every consumer through the module's `WeakMap`.
28
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The `WeakMap` holds one result per live `points` array and releases it when the array is collected, so retention is bounded by the shapes the caller still holds.
29
+ */
30
+ export declare function physicalHullFaces(points: readonly IAutoMovieVector3[]): physicalHullFaces.IHull;
31
+ /**
32
+ * The hull record and its face.
33
+ *
34
+ * @evidence contracts/development/common.md#meaningful-documentation Names the two records the hull owner returns; each member states its frame, unit and orientation.
35
+ * @evidence contracts/development/design.md#principled-representation A convex polytope as its supporting half-spaces with their boundary loops, the form every distance, clipping and integration consumer needs; no optional member.
36
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by `physicalHullFaces`; each member is read by a hull consumer in this package (nearest query, bounds, mass, erosion, validation).
37
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No `any`, `unknown`, index signature or cast; it repeats no type another owner declares.
38
+ */
39
+ export declare namespace physicalHullFaces {
40
+ /** One supporting plane of the hull with its boundary. */
41
+ interface IFace {
42
+ /** Outward unit normal, shape-local. */ normal: IAutoMovieVector3;
43
+ /** The plane's distance from the origin along the normal, metres. */ offset: number;
44
+ /** Boundary vertices, counter clockwise seen from outside. */ loop: IAutoMovieVector3[];
45
+ }
46
+ /** The hull of one point set. */
47
+ interface IHull {
48
+ /** Every face; empty when the points span no volume. */ faces: IFace[];
49
+ /** The points that are corners of some face. */ vertices: IAutoMovieVector3[];
50
+ /** Mean of the vertices, shape-local metres. */ centre: IAutoMovieVector3;
51
+ /** Radius about `centre` of a sphere containing the hull, metres. */ radius: number;
52
+ /** Least distance from `centre` to a face plane, metres: a sphere of this radius about `centre` lies inside the hull. Zero without faces. */ depth: number;
53
+ /** Greatest depth of any input point below the surface, metres: at most `tolerance` when every point lies on the surface. */ buried: number;
54
+ /** The coplanarity tolerance used, metres: 1e-9 of the extent. */ tolerance: number;
55
+ }
56
+ }
@@ -0,0 +1,151 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalHullFaces = physicalHullFaces;
4
+ const Vector3_1 = require("../math/Vector3");
5
+ /**
6
+ * The faces of the convex hull of a point set: each face's outward unit
7
+ * normal, its plane offset along that normal and its vertex loop, counter
8
+ * clockwise seen from outside.
9
+ *
10
+ * A plane through three points is a face when no point lies in front of it;
11
+ * every point on that plane then belongs to the face, and their planar convex
12
+ * hull (Andrew's monotone chain) orders the loop. Points within `tolerance`
13
+ * of a plane count as on it, so a flat ring of many points yields one face
14
+ * rather than a fan of slivers. A point set that spans no volume has no face.
15
+ *
16
+ * The result is remembered per `points` array, so a profile's shape pays the
17
+ * search once however many queries read it; the array must not be mutated
18
+ * after its first use.
19
+ *
20
+ * @param points Shape-local points, metres.
21
+ * @returns The hull's faces, its vertices, the mean of its vertices, the
22
+ * radii about that mean of a sphere containing the hull and of one inside
23
+ * it, and how deep any input point lies below the surface.
24
+ *
25
+ * @evidence contracts/development/common.md#meaningful-documentation States what a face is, how coplanar points are gathered, the loop order, the degenerate case and the per-array memo with its no-mutation premise.
26
+ * @evidence contracts/development/implementation.md#principled-implementation The definition of a hull face applied directly: a supporting plane through three non-collinear points with every other point behind it (de Berg et al., Computational Geometry, chapter 11), and Andrew's monotone chain for the loop of each face.
27
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of hull topology: the nearest-point query, bounds, mass, erosion, validation and the native mapping all read these faces instead of deriving their own.
28
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The tolerance is 1e-9 of the point set's extent, a relative floor above double rounding of the plane products and far below any modelled dimension; the non-null assertions index arrays by indices the loops themselves bound.
29
+ * @evidence contracts/development/implementation.md#efficient-algorithms Triples of points against all points is cubic to quartic in the point count, taken once per array for the few dozen points of a body module; triples already covered by a found face are skipped, and every later call is a map lookup.
30
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The faces of one `points` array are computed once and shared by every consumer through the module's `WeakMap`.
31
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The `WeakMap` holds one result per live `points` array and releases it when the array is collected, so retention is bounded by the shapes the caller still holds.
32
+ */
33
+ function physicalHullFaces(points) {
34
+ const cached = HULLS.get(points);
35
+ if (cached !== undefined)
36
+ return cached;
37
+ const count = points.length;
38
+ let extent = 0;
39
+ for (const p of points)
40
+ for (const q of points)
41
+ extent = Math.max(extent, Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(p, q)));
42
+ const tolerance = 1e-9 * extent;
43
+ const faces = [];
44
+ const members = [];
45
+ const used = points.map(() => false);
46
+ for (let i = 0; i < count; i++)
47
+ for (let j = i + 1; j < count; j++)
48
+ for (let k = j + 1; k < count; k++) {
49
+ if (members.some((member) => member[i] && member[j] && member[k]))
50
+ continue;
51
+ const raw = Vector3_1.Vector3.cross(Vector3_1.Vector3.subtract(points[j], points[i]), Vector3_1.Vector3.subtract(points[k], points[i]));
52
+ const area = Vector3_1.Vector3.length(raw);
53
+ // Collinear or coincident triples span no plane.
54
+ if (!(area > tolerance * extent))
55
+ continue;
56
+ let normal = Vector3_1.Vector3.scale(raw, 1 / area);
57
+ let offset = Vector3_1.Vector3.dot(normal, points[i]);
58
+ let front = false;
59
+ let back = false;
60
+ for (const p of points) {
61
+ const d = Vector3_1.Vector3.dot(normal, p) - offset;
62
+ if (d > tolerance)
63
+ front = true;
64
+ else if (d < -tolerance)
65
+ back = true;
66
+ }
67
+ // Points on both sides: an interior plane. Points on neither: the
68
+ // whole set is flat and encloses no volume.
69
+ if (front === back)
70
+ continue;
71
+ if (front) {
72
+ normal = Vector3_1.Vector3.scale(normal, -1);
73
+ offset = -offset;
74
+ }
75
+ const member = points.map((p) => Vector3_1.Vector3.dot(normal, p) - offset >= -tolerance);
76
+ const loop = planarLoop(points, member, normal);
77
+ for (const index of loop)
78
+ used[index] = true;
79
+ members.push(member);
80
+ faces.push({
81
+ normal,
82
+ offset,
83
+ loop: loop.map((index) => points[index]),
84
+ });
85
+ }
86
+ const vertices = points.filter((_, index) => used[index]);
87
+ let centre = { x: 0, y: 0, z: 0 };
88
+ for (const vertex of vertices)
89
+ centre = Vector3_1.Vector3.add(centre, Vector3_1.Vector3.scale(vertex, 1 / vertices.length));
90
+ let radius = 0;
91
+ for (const vertex of vertices)
92
+ radius = Math.max(radius, Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(vertex, centre)));
93
+ let depth = faces.length ? Infinity : 0;
94
+ for (const face of faces)
95
+ depth = Math.min(depth, face.offset - Vector3_1.Vector3.dot(face.normal, centre));
96
+ let buried = 0;
97
+ if (faces.length)
98
+ for (const p of points) {
99
+ let outermost = -Infinity;
100
+ for (const face of faces)
101
+ outermost = Math.max(outermost, Vector3_1.Vector3.dot(face.normal, p) - face.offset);
102
+ buried = Math.max(buried, -outermost);
103
+ }
104
+ const hull = {
105
+ faces,
106
+ vertices,
107
+ centre,
108
+ radius,
109
+ depth,
110
+ buried,
111
+ tolerance,
112
+ };
113
+ HULLS.set(points, hull);
114
+ return hull;
115
+ }
116
+ /** One hull per live points array, released with the array. */
117
+ const HULLS = new WeakMap();
118
+ /**
119
+ * The indices of the member points on a face's boundary, counter clockwise
120
+ * about the face normal, by Andrew's monotone chain in the face plane.
121
+ */
122
+ const planarLoop = (points, member, normal) => {
123
+ const seed = Math.abs(normal.x) <= Math.abs(normal.y) &&
124
+ Math.abs(normal.x) <= Math.abs(normal.z)
125
+ ? { x: 1, y: 0, z: 0 }
126
+ : Math.abs(normal.y) <= Math.abs(normal.z)
127
+ ? { x: 0, y: 1, z: 0 }
128
+ : { x: 0, y: 0, z: 1 };
129
+ const u = Vector3_1.Vector3.normalize(Vector3_1.Vector3.cross(normal, seed));
130
+ const v = Vector3_1.Vector3.cross(normal, u);
131
+ const flat = [];
132
+ points.forEach((p, index) => {
133
+ if (member[index])
134
+ flat.push({ index, x: Vector3_1.Vector3.dot(p, u), y: Vector3_1.Vector3.dot(p, v) });
135
+ });
136
+ flat.sort((a, b) => a.x - b.x || a.y - b.y);
137
+ const turn = (o, a, b) => (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);
138
+ const chain = (ordered) => {
139
+ const out = [];
140
+ for (const p of ordered) {
141
+ while (out.length >= 2 &&
142
+ turn(out[out.length - 2], out[out.length - 1], p) <= 0)
143
+ out.pop();
144
+ out.push(p);
145
+ }
146
+ out.pop();
147
+ return out;
148
+ };
149
+ return [...chain(flat), ...chain([...flat].reverse())].map((p) => p.index);
150
+ };
151
+ //# sourceMappingURL=physicalHullFaces.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalHullFaces.js","sourceRoot":"","sources":["../../src/physics/physicalHullFaces.ts"],"names":[],"mappings":";;;AAEA,6CAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,2BACE,MAAoC;IAEpC,MAAM,MAAM,GAAwC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,KAAK,GAAW,MAAM,CAAC,MAAM,CAAC;IACpC,IAAI,MAAM,GAAW,CAAC,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,MAAM;QACpB,KAAK,MAAM,CAAC,IAAI,MAAM;YACpB,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,iBAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,SAAS,GAAW,IAAI,GAAG,MAAM,CAAC;IACxC,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAc,MAAM,CAAC,GAAG,CAAC,GAAY,EAAE,CAAC,KAAK,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;QACpC,KAAK,IAAI,CAAC,GAAW,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;YACxC,KAAK,IAAI,CAAC,GAAW,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,IACE,OAAO,CAAC,IAAI,CACV,CAAC,MAAiB,EAAW,EAAE,CAC7B,MAAM,CAAC,CAAC,CAAE,IAAI,MAAM,CAAC,CAAC,CAAE,IAAI,MAAM,CAAC,CAAC,CAAE,CACzC;oBAED,SAAS;gBACX,MAAM,GAAG,GAAsB,iBAAO,CAAC,KAAK,CAC1C,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,EACxC,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,CACzC,CAAC;gBACF,MAAM,IAAI,GAAW,iBAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzC,iDAAiD;gBACjD,IAAI,CAAC,CAAC,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;oBAAE,SAAS;gBAC3C,IAAI,MAAM,GAAsB,iBAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC7D,IAAI,MAAM,GAAW,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;gBACrD,IAAI,KAAK,GAAY,KAAK,CAAC;gBAC3B,IAAI,IAAI,GAAY,KAAK,CAAC;gBAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;oBACvB,MAAM,CAAC,GAAW,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;oBAClD,IAAI,CAAC,GAAG,SAAS;wBAAE,KAAK,GAAG,IAAI,CAAC;yBAC3B,IAAI,CAAC,GAAG,CAAC,SAAS;wBAAE,IAAI,GAAG,IAAI,CAAC;gBACvC,CAAC;gBACD,kEAAkE;gBAClE,4CAA4C;gBAC5C,IAAI,KAAK,KAAK,IAAI;oBAAE,SAAS;gBAC7B,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,GAAG,iBAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;oBACnC,MAAM,GAAG,CAAC,MAAM,CAAC;gBACnB,CAAC;gBACD,MAAM,MAAM,GAAc,MAAM,CAAC,GAAG,CAClC,CAAC,CAAoB,EAAW,EAAE,CAChC,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAChD,CAAC;gBACF,MAAM,IAAI,GAAa,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC1D,KAAK,MAAM,KAAK,IAAI,IAAI;oBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;gBAC7C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC;oBACT,MAAM;oBACN,MAAM;oBACN,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAa,EAAqB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC;iBACrE,CAAC,CAAC;YACL,CAAC;IACL,MAAM,QAAQ,GAAwB,MAAM,CAAC,MAAM,CACjD,CAAC,CAAoB,EAAE,KAAa,EAAW,EAAE,CAAC,IAAI,CAAC,KAAK,CAAE,CAC/D,CAAC;IACF,IAAI,MAAM,GAAsB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,QAAQ;QAC3B,MAAM,GAAG,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,IAAI,MAAM,GAAW,CAAC,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,QAAQ;QAC3B,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,iBAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,KAAK,GAAW,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,KAAK;QACtB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,iBAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,IAAI,MAAM,GAAW,CAAC,CAAC;IACvB,IAAI,KAAK,CAAC,MAAM;QACd,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,SAAS,GAAW,CAAC,QAAQ,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK;gBACtB,SAAS,GAAG,IAAI,CAAC,GAAG,CAClB,SAAS,EACT,iBAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAC1C,CAAC;YACJ,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;IACH,MAAM,IAAI,GAA4B;QACpC,KAAK;QACL,QAAQ;QACR,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,SAAS;KACV,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,MAAM,KAAK,GAGP,IAAI,OAAO,EAAE,CAAC;AAElB;;;GAGG;AACH,MAAM,UAAU,GAAG,CACjB,MAAoC,EACpC,MAA0B,EAC1B,MAAyB,EACf,EAAE;IACZ,MAAM,IAAI,GACR,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QACtB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YACtB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAsB,iBAAO,CAAC,SAAS,CAAC,iBAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,CAAC,GAAsB,iBAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAA8C,EAAE,CAAC;IAC3D,MAAM,CAAC,OAAO,CAAC,CAAC,CAAoB,EAAE,KAAa,EAAQ,EAAE;QAC3D,IAAI,MAAM,CAAC,KAAK,CAAE;YAChB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,iBAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,iBAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CACP,CACE,CAA0C,EAC1C,CAA0C,EAClC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CACpC,CAAC;IACF,MAAM,IAAI,GAAG,CACX,CAA2B,EAC3B,CAA2B,EAC3B,CAA2B,EACnB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,CACZ,OAAkD,EACP,EAAE;QAC7C,MAAM,GAAG,GAA8C,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,OACE,GAAG,CAAC,MAAM,IAAI,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,CAAC,CAAC,IAAI,CAAC;gBAExD,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,CAAC;QACV,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CACxD,CAAC,CAA0C,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAChE,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,32 @@
1
+ import type { IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * The volume, centroid and principal inertia of the uniform solid convex
4
+ * hull of a point set.
5
+ *
6
+ * Each face is fanned into triangles and each triangle joined to the hull's
7
+ * mean vertex, so the solid is a sum of tetrahedra. A tetrahedron's volume
8
+ * and centroid are closed forms, and its second moments are exact under the
9
+ * quadrature that weighs each vertex by a twentieth of the volume and the
10
+ * centroid by four fifths. The summed second moments move to the centroid by
11
+ * the parallel-axis theorem and are diagonalized by `physicalPrincipalAxes`.
12
+ *
13
+ * @param points Shape-local points, metres, spanning a volume.
14
+ * @returns The volume in cubic metres, the centroid in the points' frame, and
15
+ * the principal moments per unit mass (square metres, ascending) with the
16
+ * rotation from the principal frame to the points' frame.
17
+ * @throws {Error} When the points span no volume.
18
+ *
19
+ * @evidence contracts/development/common.md#meaningful-documentation States the decomposition, the exact quadrature, the frame of each result and that the moments are per unit mass.
20
+ * @evidence contracts/development/implementation.md#principled-implementation Polyhedral mass properties by tetrahedral decomposition (Mirtich 1996, Fast and accurate computation of polyhedral mass properties; Tonon 2004, Explicit exact formulas for the 3-D tetrahedron inertia tensor): the degree-two quadrature with weights 1/20 at the four vertices and 4/5 at the centroid integrates every product of two coordinates exactly.
21
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Reads the faces from `physicalHullFaces` and the diagonalization from `physicalPrincipalAxes`; it owns only the integration.
22
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance and no sampling: the sums are exact for the polytope; the non-null assertions index loops and 3x3 rows the function bounds itself.
23
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the hull's triangle count, a few dozen for a body module, once per profile build.
24
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A profile integrates each hull once while it is built; the face search behind it is already shared by `physicalHullFaces`.
25
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
26
+ */
27
+ export declare function physicalHullMass(points: readonly IAutoMovieVector3[]): {
28
+ volume: number;
29
+ centerOfMass: IAutoMovieVector3;
30
+ inertia: IAutoMovieVector3;
31
+ inertiaRotation: IAutoMovieQuaternion;
32
+ };
@@ -0,0 +1,80 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalHullMass = physicalHullMass;
4
+ const Vector3_1 = require("../math/Vector3");
5
+ const physicalHullFaces_1 = require("./physicalHullFaces");
6
+ const physicalPrincipalAxes_1 = require("./physicalPrincipalAxes");
7
+ /**
8
+ * The volume, centroid and principal inertia of the uniform solid convex
9
+ * hull of a point set.
10
+ *
11
+ * Each face is fanned into triangles and each triangle joined to the hull's
12
+ * mean vertex, so the solid is a sum of tetrahedra. A tetrahedron's volume
13
+ * and centroid are closed forms, and its second moments are exact under the
14
+ * quadrature that weighs each vertex by a twentieth of the volume and the
15
+ * centroid by four fifths. The summed second moments move to the centroid by
16
+ * the parallel-axis theorem and are diagonalized by `physicalPrincipalAxes`.
17
+ *
18
+ * @param points Shape-local points, metres, spanning a volume.
19
+ * @returns The volume in cubic metres, the centroid in the points' frame, and
20
+ * the principal moments per unit mass (square metres, ascending) with the
21
+ * rotation from the principal frame to the points' frame.
22
+ * @throws {Error} When the points span no volume.
23
+ *
24
+ * @evidence contracts/development/common.md#meaningful-documentation States the decomposition, the exact quadrature, the frame of each result and that the moments are per unit mass.
25
+ * @evidence contracts/development/implementation.md#principled-implementation Polyhedral mass properties by tetrahedral decomposition (Mirtich 1996, Fast and accurate computation of polyhedral mass properties; Tonon 2004, Explicit exact formulas for the 3-D tetrahedron inertia tensor): the degree-two quadrature with weights 1/20 at the four vertices and 4/5 at the centroid integrates every product of two coordinates exactly.
26
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Reads the faces from `physicalHullFaces` and the diagonalization from `physicalPrincipalAxes`; it owns only the integration.
27
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance and no sampling: the sums are exact for the polytope; the non-null assertions index loops and 3x3 rows the function bounds itself.
28
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the hull's triangle count, a few dozen for a body module, once per profile build.
29
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A profile integrates each hull once while it is built; the face search behind it is already shared by `physicalHullFaces`.
30
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
31
+ */
32
+ function physicalHullMass(points) {
33
+ const hull = (0, physicalHullFaces_1.physicalHullFaces)(points);
34
+ const axes = ["x", "y", "z"];
35
+ let volume = 0;
36
+ let moment = { x: 0, y: 0, z: 0 };
37
+ const second = [
38
+ [0, 0, 0],
39
+ [0, 0, 0],
40
+ [0, 0, 0],
41
+ ];
42
+ for (const face of hull.faces)
43
+ for (let index = 1; index + 1 < face.loop.length; index++) {
44
+ const a = Vector3_1.Vector3.subtract(face.loop[0], hull.centre);
45
+ const b = Vector3_1.Vector3.subtract(face.loop[index], hull.centre);
46
+ const c = Vector3_1.Vector3.subtract(face.loop[index + 1], hull.centre);
47
+ const v = Vector3_1.Vector3.dot(a, Vector3_1.Vector3.cross(b, c)) / 6;
48
+ const s = Vector3_1.Vector3.add(Vector3_1.Vector3.add(a, b), c);
49
+ volume += v;
50
+ moment = Vector3_1.Vector3.add(moment, Vector3_1.Vector3.scale(s, v / 4));
51
+ for (let row = 0; row < 3; row++)
52
+ for (let column = 0; column < 3; column++)
53
+ second[row][column] +=
54
+ (v / 20) *
55
+ (a[axes[row]] * a[axes[column]] +
56
+ b[axes[row]] * b[axes[column]] +
57
+ c[axes[row]] * c[axes[column]] +
58
+ s[axes[row]] * s[axes[column]]);
59
+ }
60
+ if (!(volume > 0))
61
+ throw new Error("A hull must span a volume");
62
+ const offset = Vector3_1.Vector3.scale(moment, 1 / volume);
63
+ // Second moments about the centroid per unit mass, then the inertia tensor
64
+ // as their trace on the diagonal less the moments themselves.
65
+ for (let row = 0; row < 3; row++)
66
+ for (let column = 0; column < 3; column++)
67
+ second[row][column] =
68
+ second[row][column] / volume -
69
+ offset[axes[row]] * offset[axes[column]];
70
+ const trace = second[0][0] + second[1][1] + second[2][2];
71
+ const tensor = second.map((line, row) => line.map((value, column) => (row === column ? trace : 0) - value));
72
+ const principal = (0, physicalPrincipalAxes_1.physicalPrincipalAxes)(tensor);
73
+ return {
74
+ volume,
75
+ centerOfMass: Vector3_1.Vector3.add(hull.centre, offset),
76
+ inertia: principal.moments,
77
+ inertiaRotation: principal.rotation,
78
+ };
79
+ }
80
+ //# sourceMappingURL=physicalHullMass.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalHullMass.js","sourceRoot":"","sources":["../../src/physics/physicalHullMass.ts"],"names":[],"mappings":"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"}