@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Apply Coulomb friction to one particle a collider has just pushed out, in
3
+ * place: the position-based friction of Macklin, Müller, Chentanez and Kim
4
+ * 2014 ("Unified particle physics for real-time applications", ACM TOG
5
+ * 33(4):153, section 6.1), with one coefficient for sticking and sliding.
6
+ *
7
+ * The collider's push (the predicted position after contact projection less
8
+ * the one before it) gives the contact normal and the penetration depth d.
9
+ * The particle's travel over the step (its predicted position less its
10
+ * position at the step's start) is split into its part along the normal and
11
+ * its tangential part t. A tangential travel shorter than mu d is removed
12
+ * entirely, so the particle sticks; a longer one is shortened by mu d, so
13
+ * it slides against a force bounded by mu times the normal one. The
14
+ * collider is taken as still over the step: a static collider is, and a
15
+ * moving body capsule's own travel is not subtracted, so friction against a
16
+ * moving limb drags the cloth toward rest rather than along with the limb.
17
+ *
18
+ * @param props The particle, the buffers, its position before projection and the coefficient.
19
+ *
20
+ * @evidence contracts/development/common.md#meaningful-documentation States the law with its source, how the normal and depth are read, the two regimes and the still-collider premise with its consequence for moving capsules.
21
+ * @evidence contracts/development/implementation.md#principled-implementation Position-based Coulomb friction (Macklin et al. 2014) on the projection's own push.
22
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One read of the push, one split of the travel, one correction.
23
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A particle the projection did not move is untouched; a zero coefficient changes nothing.
24
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work per particle.
25
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse; the push is the projection's own.
26
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Writes only the caller's predicted triple.
27
+ */
28
+ export const applySoftBodyFriction: (props: {
29
+ particle: number;
30
+ position: Float64Array<ArrayBufferLike>;
31
+ predicted: Float64Array<ArrayBufferLike>;
32
+ before: readonly [number, number, number];
33
+ friction: number;
34
+ }) => void = (props: {
35
+ particle: number;
36
+ position: Float64Array<ArrayBufferLike>;
37
+ predicted: Float64Array<ArrayBufferLike>;
38
+ before: readonly [number, number, number];
39
+ friction: number;
40
+ }): void => {
41
+ if (props.friction === 0) return;
42
+ const base: number = props.particle * 3;
43
+ const push: number[] = [0, 1, 2].map(
44
+ (axis: number): number =>
45
+ props.predicted[base + axis] - props.before[axis]!,
46
+ );
47
+ const depth: number = Math.hypot(push[0]!, push[1]!, push[2]!);
48
+ if (depth === 0) return;
49
+ const n: number[] = push.map((v: number): number => v / depth);
50
+ const travel: number[] = [0, 1, 2].map(
51
+ (axis: number): number =>
52
+ props.predicted[base + axis] - props.position[base + axis],
53
+ );
54
+ const along: number =
55
+ travel[0]! * n[0]! + travel[1]! * n[1]! + travel[2]! * n[2]!;
56
+ const tangent: number[] = travel.map(
57
+ (v: number, axis: number): number => v - along * n[axis]!,
58
+ );
59
+ const slide: number = Math.hypot(tangent[0]!, tangent[1]!, tangent[2]!);
60
+ if (slide === 0) return;
61
+ const limit: number = props.friction * depth;
62
+ const keep: number = slide < limit ? 1 : limit / slide;
63
+ for (let axis: number = 0; axis < 3; ++axis)
64
+ props.predicted[base + axis] -= keep * tangent[axis]!;
65
+ };
package/src/soft/index.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  export * from "./IAutoMoviePlantingFrame";
2
2
  export * from "./IAutoMovieSoftBodyBoundarySample";
3
+ export * from "./IAutoMovieSoftBodyObserver";
3
4
  export * from "./IAutoMovieSoftBodyResolvedAnchor";
4
5
  export * from "./IAutoMovieSoftBodyResolvedCapsule";
5
6
  export * from "./IAutoMovieSoftFurnishingFrame";
@@ -9,6 +10,7 @@ export * from "./IAutoMovieWearableSoftBudget";
9
10
  export * from "./IAutoMovieWearableSoftFrame";
10
11
  export * from "./IAutoMovieWearableSoftResult";
11
12
  export * from "./SOFT_BODY_NEIGHBOURS";
13
+ export * from "./applySoftBodyFriction";
12
14
  export * from "./arrangePlantingCluster";
13
15
  export * from "./constants";
14
16
  export * from "./gatherSoftBodyCorrections";
@@ -23,6 +25,7 @@ export * from "./plantingStateDigest";
23
25
  export * from "./plantingYaw";
24
26
  export * from "./productionSoftBodyUsesMovingBoundary";
25
27
  export * from "./projectSoftBodyContacts";
28
+ export * from "./projectSoftCordSelfContact";
26
29
  export * from "./readProductionLiveWearableSoftBodies";
27
30
  export * from "./sampleSoftBody";
28
31
  export * from "./selectProductionLiveWearableSoftBodies";
@@ -32,6 +35,7 @@ export * from "./simulateSoftBody";
32
35
  export * from "./simulateSoftBodyCore";
33
36
  export * from "./simulateSoftBodyWithBoundaries";
34
37
  export * from "./softBodyBudget";
38
+ export * from "./softBodyHeldLoads";
35
39
  export * from "./softBodyNeighbourOf";
36
40
  export * from "./softBodyParticleDistance";
37
41
  export * from "./softBodyRestBuffer";
@@ -40,11 +44,13 @@ export * from "./softBodyStateDigest";
40
44
  export * from "./softBodyStepAt";
41
45
  export * from "./softBodySurfaceGeometry";
42
46
  export * from "./softBodyTravelNumber";
47
+ export * from "./solveSoftBodyCompliantSweep";
43
48
  export * from "./validateAutoMovieSoftFurnishingDomainOwnership";
44
49
  export * from "./validatePlantingCluster";
45
50
  export * from "./validatePlantingDomain";
46
51
  export * from "./validatePlantingInstallations";
47
52
  export * from "./validateSoftBodyDomain";
53
+ export * from "./validateSoftCompliance";
48
54
  export * from "./validateSoftFurnishings";
49
55
  export * from "./validateSoftIdentity";
50
56
  export * from "./validateSoftInteger";
@@ -0,0 +1,239 @@
1
+ /**
2
+ * Keep the segments of a cord apart: every two segments that share no
3
+ * particle are held at least two radii apart along the line between their
4
+ * closest points, with Coulomb friction between them, in place on the
5
+ * predicted positions.
6
+ *
7
+ * A cord is a one-wide lattice, its particles in index order along it and
8
+ * segment s joining particles s and s + 1. Each segment is a capsule of the
9
+ * domain's `thickness` (its radius). For two segments, the closest points
10
+ * p = a0 + s (a1 - a0) and q = b0 + t (b1 - b0) come from the clamped
11
+ * segment-segment solution of Ericson ("Real-Time Collision Detection",
12
+ * 2005, section 5.1.9). The non-penetration constraint C = |p - q| - 2r
13
+ * (r the radius) has gradients (1 - s) n and s n on a0 and a1 and
14
+ * -(1 - t) n and -t n on b0 and b1, n the unit direction from q to p; an
15
+ * active one (C < 0) is projected as a position-based constraint with
16
+ * those gradients and the particles' inverse masses (Müller, Heidelberger,
17
+ * Hennix and Ratcliff 2007, "Position based dynamics", section 3.3).
18
+ *
19
+ * Friction is the position-based Coulomb model of Macklin, Müller,
20
+ * Chentanez and Kim 2014 ("Unified particle physics for real-time
21
+ * applications", ACM TOG 33(4):153, section 6.1), with one coefficient for
22
+ * sticking and sliding: the relative tangential displacement of the two
23
+ * closest points over the step is removed entirely while it is under mu
24
+ * times the penetration depth, and shortened by mu times the depth above
25
+ * it, distributed over the four particles as the normal correction is.
26
+ *
27
+ * Candidate pairs come from a uniform grid whose cell is the longest segment
28
+ * plus two radii, so two segments within two radii of each other have
29
+ * midpoints in neighbouring cells; segments are visited in index order and
30
+ * each one's candidates in ascending order, so the result is deterministic.
31
+ * A segment travels less than the radius a step when the domain's admission
32
+ * holds (`dt * referenceSpeed <= thickness`), so a pass discovered at the
33
+ * end of a step cannot have been tunnelled through.
34
+ *
35
+ * @param props The cord's particles, its previous and predicted positions, inverse masses and contact.
36
+ * @returns How many pairs were in contact.
37
+ *
38
+ * @evidence contracts/development/common.md#meaningful-documentation States the segment model, the closest points with their source, the constraint and its gradients, the friction law with its source, the grid's premise and the tunnelling premise.
39
+ * @evidence contracts/development/implementation.md#principled-implementation Ericson's segment-segment closest points, a position-based non-penetration constraint (Müller et al. 2007) and position-based Coulomb friction (Macklin et al. 2014).
40
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure A grid pass for candidates, then one projection per candidate pair.
41
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Adjacent segments, which share a particle, are never paired; two anchored particles move nothing.
42
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in segments for the grid, then linear in candidate pairs; a cord in contact with itself only near a crossing checks a few neighbours per segment.
43
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Each call reads the positions the last constraint pass left; the grid is rebuilt because they move.
44
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The grid is call-local; only the caller's predicted buffer is written.
45
+ */
46
+ export const projectSoftCordSelfContact: (props: {
47
+ count: number;
48
+ position: Float64Array<ArrayBufferLike>;
49
+ predicted: Float64Array<ArrayBufferLike>;
50
+ inverseMass: Float64Array<ArrayBufferLike>;
51
+ radius: number;
52
+ friction: number;
53
+ }) => number = (props: {
54
+ count: number;
55
+ position: Float64Array<ArrayBufferLike>;
56
+ predicted: Float64Array<ArrayBufferLike>;
57
+ inverseMass: Float64Array<ArrayBufferLike>;
58
+ radius: number;
59
+ friction: number;
60
+ }): number => {
61
+ // The pair projection reads the positions and the inverse masses from
62
+ // `props`; the grid needs only the predicted positions.
63
+ const { count, predicted }: typeof props = props;
64
+ const segments: number = count - 1;
65
+ if (segments < 3) return 0;
66
+ const reach: number = 2 * props.radius;
67
+
68
+ // The grid: a cell the longest segment plus two radii wide.
69
+ let longest: number = 0;
70
+ for (let s: number = 0; s < segments; ++s)
71
+ longest = Math.max(longest, distance(predicted, s, s + 1));
72
+ const cell: number = longest + reach;
73
+ const key = (x: number, y: number, z: number): string => `${x},${y},${z}`;
74
+ const index = (s: number, axis: number): number =>
75
+ Math.floor(
76
+ (predicted[s * 3 + axis] + predicted[(s + 1) * 3 + axis]) / 2 / cell,
77
+ );
78
+ const grid: Map<string, number[]> = new Map();
79
+ for (let s: number = 0; s < segments; ++s) {
80
+ const k: string = key(index(s, 0), index(s, 1), index(s, 2));
81
+ const list: number[] | undefined = grid.get(k);
82
+ if (list === undefined) grid.set(k, [s]);
83
+ else list.push(s);
84
+ }
85
+
86
+ let contacts: number = 0;
87
+ for (let a: number = 0; a < segments; ++a) {
88
+ const candidates: number[] = [];
89
+ const cx: number = index(a, 0);
90
+ const cy: number = index(a, 1);
91
+ const cz: number = index(a, 2);
92
+ for (let x: number = -1; x <= 1; ++x)
93
+ for (let y: number = -1; y <= 1; ++y)
94
+ for (let z: number = -1; z <= 1; ++z)
95
+ for (const b of grid.get(key(cx + x, cy + y, cz + z)) ?? [])
96
+ if (b >= a + 2) candidates.push(b);
97
+ candidates.sort((l: number, r: number): number => l - r);
98
+ for (const b of candidates) if (separate(props, a, b, reach)) ++contacts;
99
+ }
100
+ return contacts;
101
+ };
102
+
103
+ /** The buffers and coefficient one pair's projection reads. */
104
+ interface IPair {
105
+ position: Float64Array<ArrayBufferLike>;
106
+ predicted: Float64Array<ArrayBufferLike>;
107
+ inverseMass: Float64Array<ArrayBufferLike>;
108
+ friction: number;
109
+ }
110
+
111
+ /** Project one pair of segments apart and apply friction between them, returning whether they were in contact. */
112
+ const separate: (
113
+ props: IPair,
114
+ a: number,
115
+ b: number,
116
+ reach: number,
117
+ ) => boolean = (props: IPair, a: number, b: number, reach: number): boolean => {
118
+ const { predicted, position, inverseMass }: typeof props = props;
119
+ const [s, t]: [number, number] = closest(predicted, a, b);
120
+ const point = (
121
+ buffer: Float64Array<ArrayBufferLike>,
122
+ first: number,
123
+ share: number,
124
+ axis: number,
125
+ ): number =>
126
+ buffer[first * 3 + axis] * (1 - share) +
127
+ buffer[(first + 1) * 3 + axis] * share;
128
+ const d: number[] = [0, 1, 2].map(
129
+ (axis: number): number =>
130
+ point(predicted, a, s, axis) - point(predicted, b, t, axis),
131
+ );
132
+ const length: number = Math.hypot(d[0]!, d[1]!, d[2]!);
133
+ if (length >= reach || length === 0) return false;
134
+ const n: number[] = d.map((v: number): number => v / length);
135
+
136
+ // The four particles with their gradient weights along n.
137
+ const ids: readonly number[] = [a, a + 1, b, b + 1];
138
+ const weights: readonly number[] = [1 - s, s, -(1 - t), -t];
139
+ const denominator: number = ids.reduce(
140
+ (sum: number, id: number, i: number): number =>
141
+ sum + inverseMass[id] * weights[i]! * weights[i]!,
142
+ 0,
143
+ );
144
+ if (denominator === 0) return true;
145
+ const depth: number = reach - length;
146
+ const normal: number = depth / denominator;
147
+ ids.forEach((id: number, i: number): void => {
148
+ for (let axis: number = 0; axis < 3; ++axis)
149
+ predicted[id * 3 + axis] +=
150
+ inverseMass[id] * weights[i]! * normal * n[axis]!;
151
+ });
152
+
153
+ // Coulomb friction on the closest points' relative tangential travel.
154
+ const travel: number[] = [0, 1, 2].map(
155
+ (axis: number): number =>
156
+ point(predicted, a, s, axis) -
157
+ point(position, a, s, axis) -
158
+ (point(predicted, b, t, axis) - point(position, b, t, axis)),
159
+ );
160
+ const along: number =
161
+ travel[0]! * n[0]! + travel[1]! * n[1]! + travel[2]! * n[2]!;
162
+ const tangent: number[] = travel.map(
163
+ (v: number, axis: number): number => v - along * n[axis]!,
164
+ );
165
+ const slide: number = Math.hypot(tangent[0]!, tangent[1]!, tangent[2]!);
166
+ if (slide === 0) return true;
167
+ const keep: number =
168
+ slide < props.friction * depth
169
+ ? 1
170
+ : Math.min((props.friction * depth) / slide, 1);
171
+ ids.forEach((id: number, i: number): void => {
172
+ for (let axis: number = 0; axis < 3; ++axis)
173
+ predicted[id * 3 + axis] -=
174
+ (inverseMass[id] * weights[i]! * keep * tangent[axis]!) / denominator;
175
+ });
176
+ return true;
177
+ };
178
+
179
+ /**
180
+ * The shares along two segments of their closest points, each in [0, 1]
181
+ * (Ericson 2005, section 5.1.9, `ClosestPtSegmentSegment`).
182
+ */
183
+ const closest: (
184
+ x: Float64Array<ArrayBufferLike>,
185
+ a: number,
186
+ b: number,
187
+ ) => [number, number] = (
188
+ x: Float64Array<ArrayBufferLike>,
189
+ a: number,
190
+ b: number,
191
+ ): [number, number] => {
192
+ const d1: number[] = [0, 1, 2].map(
193
+ (k: number): number => x[(a + 1) * 3 + k] - x[a * 3 + k],
194
+ );
195
+ const d2: number[] = [0, 1, 2].map(
196
+ (k: number): number => x[(b + 1) * 3 + k] - x[b * 3 + k],
197
+ );
198
+ const r: number[] = [0, 1, 2].map(
199
+ (k: number): number => x[a * 3 + k] - x[b * 3 + k],
200
+ );
201
+ const dot = (u: number[], v: number[]): number =>
202
+ u[0]! * v[0]! + u[1]! * v[1]! + u[2]! * v[2]!;
203
+ const aa: number = dot(d1, d1);
204
+ const ee: number = dot(d2, d2);
205
+ const f: number = dot(d2, r);
206
+ const clamp = (v: number): number => Math.max(0, Math.min(1, v));
207
+ if (aa === 0 && ee === 0) return [0, 0];
208
+ if (aa === 0) return [0, clamp(f / ee)];
209
+ const c: number = dot(d1, r);
210
+ if (ee === 0) return [clamp(-c / aa), 0];
211
+ const bb: number = dot(d1, d2);
212
+ const denom: number = aa * ee - bb * bb;
213
+ let s: number = denom !== 0 ? clamp((bb * f - c * ee) / denom) : 0;
214
+ let t: number = (bb * s + f) / ee;
215
+ if (t < 0) {
216
+ t = 0;
217
+ s = clamp(-c / aa);
218
+ } else if (t > 1) {
219
+ t = 1;
220
+ s = clamp((bb - c) / aa);
221
+ }
222
+ return [s, t];
223
+ };
224
+
225
+ /** The distance between two particles of a buffer. */
226
+ const distance: (
227
+ x: Float64Array<ArrayBufferLike>,
228
+ i: number,
229
+ k: number,
230
+ ) => number = (
231
+ x: Float64Array<ArrayBufferLike>,
232
+ i: number,
233
+ k: number,
234
+ ): number =>
235
+ Math.hypot(
236
+ x[i * 3] - x[k * 3],
237
+ x[i * 3 + 1] - x[k * 3 + 1],
238
+ x[i * 3 + 2] - x[k * 3 + 2],
239
+ );
@@ -1,24 +1,34 @@
1
1
  import {
2
+ IAutoMovieSoftAnchor,
2
3
  IAutoMovieSoftBodyDomain,
3
4
  IAutoMovieSoftBodyState,
5
+ IAutoMovieSoftCompliance,
6
+ IAutoMovieSoftContact,
4
7
  IAutoMovieSoftWind,
5
8
  IAutoMovieVector3,
6
9
  } from "@automovie/interface";
7
10
 
8
11
  import { IAutoMovieSoftBodyBoundarySample } from "./IAutoMovieSoftBodyBoundarySample";
12
+ import { IAutoMovieSoftBodyObserver } from "./IAutoMovieSoftBodyObserver";
9
13
  import { IAutoMovieSoftBodyResolvedAnchor } from "./IAutoMovieSoftBodyResolvedAnchor";
10
14
  import { SOFT_BODY_NEIGHBOURS } from "./SOFT_BODY_NEIGHBOURS";
15
+ import { applySoftBodyFriction } from "./applySoftBodyFriction";
11
16
  import { gatherSoftBodyCorrections } from "./gatherSoftBodyCorrections";
12
17
  import { projectSoftBodyContacts } from "./projectSoftBodyContacts";
18
+ import { projectSoftCordSelfContact } from "./projectSoftCordSelfContact";
19
+ import { softBodyHeldLoads } from "./softBodyHeldLoads";
13
20
  import { softBodyNeighbourOf } from "./softBodyNeighbourOf";
14
21
  import { softBodyParticleDistance } from "./softBodyParticleDistance";
15
22
  import { softBodyRestBuffer } from "./softBodyRestBuffer";
23
+ import { solveSoftBodyCompliantSweep } from "./solveSoftBodyCompliantSweep";
16
24
 
17
25
  /** Integrate an admitted cloth lattice from its authored rest boundary to one absolute fixed step.
18
26
  *
19
- * @evidence contracts/development/implementation.md#principled-implementation Damped prediction, ordered simultaneous Jacobi constraint gathers and discrete collider escape form the existing position-based scheme. Anchors have zero inverse mass and prescribed targets; domain admission and complete moving samples are caller premises. Nonfinite integrated arrays throw, without proving universal stability or collision freedom.
27
+ * Without declared compliance and contact the solve is the plain position-based one, operation for operation. With compliance, each sweep projects the lattice's edges as compliant constraints with their own multipliers (`solveSoftBodyCompliantSweep`); with contact, a collider's push is followed by Coulomb friction (`applySoftBodyFriction`) and a cord that asks for self-collision keeps its segments apart after each sweep (`projectSoftCordSelfContact`). A moving anchor a boundary sample lists as released regains its mass for that step, leaving with the velocity its target last moved at. An observer reads every completed step, with the force each held particle bears when the solve is compliant.
28
+ *
29
+ * @evidence contracts/development/implementation.md#principled-implementation Damped prediction, ordered simultaneous Jacobi constraint gathers or XPBD Gauss-Seidel sweeps (Macklin, Müller and Chentanez 2016), discrete collider escape with optional position-based friction (Macklin et al. 2014) and cord self-contact form the scheme. Anchors have zero inverse mass and prescribed targets while held; domain admission and complete moving samples are caller premises. Nonfinite integrated arrays throw, without proving universal stability or collision freedom.
20
30
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Static and moving-boundary public wrappers delegate to one core, sharing rest-target setup, lattice topology, fold ordering and contact geometry without changing their admission APIs.
21
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Every seek replays the fixed clock from rest; no fixture state, adaptive timestep, concealed self-collision pass or substituted moving target changes the declared trajectory.
31
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Every seek replays the fixed clock from rest; no fixture state, adaptive timestep, undeclared self-collision pass or substituted moving target changes the declared trajectory. Self-contact and friction run only when the domain declares contact.
22
32
  * @evidence contracts/development/common.md#meaningful-documentation States absolute replay, caller admission, fixed-order stages and nonfinite failure rather than claiming every admitted large arithmetic input is safe.
23
33
  * @evidence contracts/development/implementation.md#efficient-algorithms For P particles, I sweeps, K target steps, C colliders, B moving capsules and A anchors, setup is O(P+A+S+T) for S states and T selected targets, each step is O(P*I+P*(C+B)+P*A) in the moving-anchor find path, with O(P) working arrays plus supplied boundary storage.
24
34
  * @evidence contracts/development/implementation.md#reuse-equivalent-work Rest lengths, valences, inverse masses and static targets are built once and reused across all steps/sweeps in this solve; changing domains, states or complete boundary sequences starts a new replay, without cross-call cache equivalence.
@@ -29,11 +39,13 @@ export const simulateSoftBodyCore: (
29
39
  step: number,
30
40
  state: string | null,
31
41
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[] | null,
42
+ observer?: IAutoMovieSoftBodyObserver | null,
32
43
  ) => IAutoMovieSoftBodyState = (
33
44
  domain: IAutoMovieSoftBodyDomain,
34
45
  step: number,
35
46
  state: string | null,
36
47
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[] | null,
48
+ observer: IAutoMovieSoftBodyObserver | null = null,
37
49
  ): IAutoMovieSoftBodyState => {
38
50
  if (!Number.isInteger(step) || step < 0)
39
51
  throw new Error(
@@ -97,6 +109,36 @@ export const simulateSoftBodyCore: (
97
109
  }
98
110
  }
99
111
 
112
+ // The compliant solve (XPBD) when the domain declares compliance, with one
113
+ // multiplier per particle and neighbour slot, reset at every step; the
114
+ // plain weighted sweeps otherwise, unchanged.
115
+ const declared: IAutoMovieSoftCompliance | null =
116
+ domain.solver.compliance ?? null;
117
+ const compliance: readonly number[] | null =
118
+ declared === null
119
+ ? null
120
+ : [declared.structural, declared.shear, declared.bend];
121
+ const lambda: Float64Array<ArrayBuffer> | null =
122
+ compliance === null
123
+ ? null
124
+ : new Float64Array(count * SOFT_BODY_NEIGHBOURS.length);
125
+ const contact: IAutoMovieSoftContact | null = domain.contact ?? null;
126
+ const friction: number = contact?.friction ?? 0;
127
+ const cord: boolean =
128
+ contact !== null && domain.selfCollision && (columns === 1 || rows === 1);
129
+ const before: [number, number, number] = [0, 0, 0];
130
+
131
+ // A moving anchor a boundary releases regains its mass and leaves with
132
+ // the velocity its target last moved at, so a dropped corner keeps the
133
+ // hand's motion instead of starting from rest.
134
+ const moving: number[] = domain.anchors
135
+ .filter(
136
+ (anchor: IAutoMovieSoftAnchor): boolean => anchor.binding !== undefined,
137
+ )
138
+ .map((anchor: IAutoMovieSoftAnchor): number => anchor.particle);
139
+ const carried: Float64Array<ArrayBuffer> = new Float64Array(count * 3);
140
+ const free: Uint8Array<ArrayBuffer> = new Uint8Array(count);
141
+
100
142
  const gravity: IAutoMovieVector3 = domain.solver.gravity;
101
143
  const draught: IAutoMovieVector3 = windAxis(domain);
102
144
  let contacts: number = 0;
@@ -104,7 +146,24 @@ export const simulateSoftBodyCore: (
104
146
  for (let index: number = 0; index < step; ++index) {
105
147
  const boundary: IAutoMovieSoftBodyBoundarySample | null =
106
148
  boundaries?.[index + 1] ?? null;
107
- if (boundary !== null) applyResolvedAnchors(position, boundary.anchors);
149
+ if (boundary !== null) {
150
+ for (const anchor of boundary.anchors) {
151
+ const base: number = anchor.particle * 3;
152
+ carried[base] = (anchor.position.x - position[base]) / dt;
153
+ carried[base + 1] = (anchor.position.y - position[base + 1]) / dt;
154
+ carried[base + 2] = (anchor.position.z - position[base + 2]) / dt;
155
+ }
156
+ applyResolvedAnchors(position, boundary.anchors);
157
+ const released: ReadonlySet<number> = new Set(boundary.released ?? []);
158
+ for (const particle of moving) {
159
+ const now: number = released.has(particle) ? 1 : 0;
160
+ if (now === 1 && free[particle] === 0)
161
+ for (let axis: number = 0; axis < 3; ++axis)
162
+ velocity[particle * 3 + axis] = carried[particle * 3 + axis];
163
+ free[particle] = now;
164
+ inverseMass[particle] = now === 1 ? 1 / domain.mass[particle] : 0;
165
+ }
166
+ }
108
167
  const gust: number = windAcceleration(domain, index * dt);
109
168
  contacts = 0;
110
169
 
@@ -132,23 +191,49 @@ export const simulateSoftBodyCore: (
132
191
  predicted[base + 2] = position[base + 2] + velocity[base + 2] * dt;
133
192
  }
134
193
 
194
+ if (lambda !== null) lambda.fill(0);
135
195
  for (let sweep: number = 0; sweep < domain.solver.iterations; ++sweep) {
136
- gatherSoftBodyCorrections({
137
- columns,
138
- rows,
139
- predicted,
140
- correction,
141
- inverseMass,
142
- valence,
143
- restLength,
144
- stiffness,
145
- });
146
- for (let value: number = 0; value < predicted.length; ++value)
147
- predicted[value] += correction[value];
196
+ if (lambda !== null)
197
+ solveSoftBodyCompliantSweep({
198
+ columns,
199
+ rows,
200
+ predicted,
201
+ inverseMass,
202
+ restLength,
203
+ compliance: compliance!,
204
+ lambda,
205
+ dt,
206
+ });
207
+ else {
208
+ gatherSoftBodyCorrections({
209
+ columns,
210
+ rows,
211
+ predicted,
212
+ correction,
213
+ inverseMass,
214
+ valence,
215
+ restLength,
216
+ stiffness,
217
+ });
218
+ for (let value: number = 0; value < predicted.length; ++value)
219
+ predicted[value] += correction[value];
220
+ }
221
+ if (cord)
222
+ projectSoftCordSelfContact({
223
+ count,
224
+ position,
225
+ predicted,
226
+ inverseMass,
227
+ radius: contact!.thickness,
228
+ friction,
229
+ });
148
230
  }
149
231
 
150
232
  for (let particle: number = 0; particle < count; ++particle) {
151
233
  if (inverseMass[particle] === 0) continue;
234
+ before[0] = predicted[particle * 3];
235
+ before[1] = predicted[particle * 3 + 1];
236
+ before[2] = predicted[particle * 3 + 2];
152
237
  contacts = projectSoftBodyContacts(
153
238
  domain.colliders,
154
239
  boundary?.capsules ?? null,
@@ -156,6 +241,14 @@ export const simulateSoftBodyCore: (
156
241
  particle,
157
242
  contacts,
158
243
  );
244
+ if (friction > 0)
245
+ applySoftBodyFriction({
246
+ particle,
247
+ position,
248
+ predicted,
249
+ before,
250
+ friction,
251
+ });
159
252
  }
160
253
 
161
254
  for (let particle: number = 0; particle < count; ++particle) {
@@ -181,6 +274,22 @@ export const simulateSoftBodyCore: (
181
274
  throw new Error(
182
275
  `soft body "${domain.id}" produced a non-finite state at step ${index + 1}`,
183
276
  );
277
+ observer?.step(
278
+ index + 1,
279
+ position,
280
+ velocity,
281
+ lambda === null
282
+ ? EMPTY
283
+ : softBodyHeldLoads({
284
+ columns,
285
+ rows,
286
+ position,
287
+ inverseMass,
288
+ restLength,
289
+ lambda,
290
+ dt,
291
+ }),
292
+ );
184
293
  }
185
294
 
186
295
  let maxSpeed: number = 0;
@@ -232,6 +341,9 @@ export const simulateSoftBodyCore: (
232
341
  };
233
342
  };
234
343
 
344
+ /** The loads of a solve with no multipliers to read them from. */
345
+ const EMPTY: ReadonlyMap<number, IAutoMovieVector3> = new Map();
346
+
235
347
  /** Overwrite each resolved hard target in the working position buffer, leaving unrelated particles untouched. */
236
348
  const applyResolvedAnchors: (
237
349
  position: Float64Array<ArrayBufferLike>,
@@ -7,9 +7,10 @@ import {
7
7
  } from "@automovie/interface";
8
8
 
9
9
  import { IAutoMovieSoftBodyBoundarySample } from "./IAutoMovieSoftBodyBoundarySample";
10
+ import { IAutoMovieSoftBodyObserver } from "./IAutoMovieSoftBodyObserver";
10
11
  import { simulateSoftBodyCore } from "./simulateSoftBodyCore";
11
12
 
12
- /** Replay cloth against a complete resolved moving boundary for every absolute step from zero through the target. Static colliders remain active. This public API currently reaches portable tests through the wearable resolver; no production/viewer host wires that live solver.
13
+ /** Replay cloth against a complete resolved moving boundary for every absolute step from zero through the target. Static colliders remain active. Each sample holds every authored moving anchor or releases it; an observer reads every completed step. This public API currently reaches portable tests through the wearable resolver; no production/viewer host wires that live solver.
13
14
  *
14
15
  * @evidence contracts/development/implementation.md#principled-implementation Every boundary step, moving-anchor particle and body-capsule id must cover its authored counterpart exactly, with finite target vectors and positive finite radii, before the shared fixed-clock core runs. Core domain validity remains a separate caller premise.
15
16
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Boundary completeness is checked once before integration, while one shared core owns both static and moving trajectories and their numeric ordering.
@@ -24,11 +25,13 @@ export const simulateSoftBodyWithBoundaries: (
24
25
  step: number,
25
26
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[],
26
27
  state?: string | null,
28
+ observer?: IAutoMovieSoftBodyObserver | null,
27
29
  ) => IAutoMovieSoftBodyState = (
28
30
  domain: IAutoMovieSoftBodyDomain,
29
31
  step: number,
30
32
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[],
31
33
  state: string | null = null,
34
+ observer: IAutoMovieSoftBodyObserver | null = null,
32
35
  ): IAutoMovieSoftBodyState => {
33
36
  if (boundaries.length !== step + 1)
34
37
  throw new Error(
@@ -80,6 +83,17 @@ export const simulateSoftBodyWithBoundaries: (
80
83
  particles.add(anchor.particle);
81
84
  assertVector(anchor.position, `moving boundary[${index}] anchor`);
82
85
  }
86
+ for (const particle of boundary.released ?? []) {
87
+ if (!movingAnchorParticles.has(particle))
88
+ throw new Error(
89
+ `soft body "${domain.id}" moving boundary[${index}] releases particle ${particle}, which is not an authored moving anchor`,
90
+ );
91
+ if (particles.has(particle))
92
+ throw new Error(
93
+ `soft body "${domain.id}" moving boundary[${index}] both holds and releases particle ${particle}`,
94
+ );
95
+ particles.add(particle);
96
+ }
83
97
  for (const particle of movingAnchorParticles)
84
98
  if (!particles.has(particle))
85
99
  throw new Error(
@@ -113,7 +127,7 @@ export const simulateSoftBodyWithBoundaries: (
113
127
  `soft body "${domain.id}" moving boundary[${index}] is missing authored body capsule "${id}"`,
114
128
  );
115
129
  }
116
- return simulateSoftBodyCore(domain, step, state, boundaries);
130
+ return simulateSoftBodyCore(domain, step, state, boundaries, observer);
117
131
  };
118
132
 
119
133
  /** Refuse a nonfinite resolved moving-boundary vector. */
@@ -32,6 +32,15 @@ export const softBodyBudget: (
32
32
  const structural: number = span(columns, 1) * rows + columns * span(rows, 1);
33
33
  const shear: number = 2 * quads;
34
34
  const bend: number = span(columns, 2) * rows + columns * span(rows, 2);
35
+
36
+ // A cord's self-contact pairs every two segments that share no particle.
37
+ const segments: number = particles - 1;
38
+ const selfContact: boolean =
39
+ (domain.contact ?? null) !== null &&
40
+ domain.selfCollision &&
41
+ (columns === 1 || rows === 1);
42
+ const pairs: number =
43
+ selfContact && segments > 2 ? ((segments - 1) * (segments - 2)) / 2 : 0;
35
44
  return {
36
45
  domain: domain.id,
37
46
  particles,
@@ -47,6 +56,8 @@ export const softBodyBudget: (
47
56
  (structural + shear + bend) *
48
57
  domain.solver.iterations *
49
58
  domain.solver.maxSteps,
59
+ worstCaseSelfContactPairs:
60
+ pairs * domain.solver.iterations * domain.solver.maxSteps,
50
61
  travel: softBodyTravelNumber(domain),
51
62
  };
52
63
  };