@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
@@ -1 +1 @@
1
- {"version":3,"file":"validateJointRom.js","sourceRoot":"","sources":["../../src/rom/validateJointRom.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"validateJointRom.js","sourceRoot":"","sources":["../../src/rom/validateJointRom.ts"],"names":[],"mappings":";;;AAQA,iDAA8C;AAE9C;;;;;;;;;;GAUG;AACI,MAAM,gBAAgB,GAMhB,CAAC,KAeb,EAAQ,EAAE;IACT,MAAM,EACJ,KAAK,EACL,UAAU,EACV,IAAI,EACJ,SAAS,GACV,GAKG,KAAK,CAAC;IACV,2EAA2E;IAC3E,kEAAkE;IAClE,IAAA,2BAAY,EACV,KAAK,EACL,UAAU,EACV,CACE,IAAuB,EACvB,MAAc,EACd,SAA6B,EACvB,EAAE;QACR,MAAM,UAAU,GACd,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC;QAChC,IAAI,UAAU,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACnD,SAAS,CAAC,IAAI,CACZ,KAAK,EACL,GAAG,IAAI,IAAI,IAAI,EAAE,EACjB,IAAI,KAAK,OAAO;gBACd,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,wEAAwE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,uCAAuC;gBACnL,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,4CAA4C,UAAU,CAAC,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,+CAA+C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAClN,MAAM,EACN,SAAS,CACV,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,SAAS,CAAC,IAAI,CACZ,KAAK,EACL,GAAG,IAAI,QAAQ,EACf,GAAG,KAAK,CAAC,IAAI,oDAAoD,UAAU,CAAC,QAAQ,sDAAsD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,SAAU,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,EACxM,MAAM,EACN,SAAS,CACV,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAgC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,SAAS,KAAK,SAAS;YACzB,SAAS,CAAC,IAAI,CACZ,OAAO,EACP,GAAG,IAAI,IAAI,IAAI,EAAE,EACjB,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,oCAAoC,MAAM,EAAE,EACjE,MAAM,CACP,CAAC;aACC,IAAI,OAAO,KAAK,IAAI;YACvB,SAAS,CAAC,IAAI,CACZ,KAAK,EACL,GAAG,IAAI,IAAI,IAAI,EAAE,EACjB,GAAG,KAAK,CAAC,IAAI,qBAAqB,IAAI,0CAA0C,MAAM,KAAK,SAAS,QAAQ,EAC5G,MAAM,EACN,SAAS,CACV,CAAC;;YAEF,SAAS,CAAC,IAAI,CACZ,KAAK,EACL,GAAG,IAAI,IAAI,IAAI,EAAE,EACjB,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,oBAAoB,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,gCAAgC,MAAM,KAAK,SAAS,eAAe,EACvI,MAAM,EACN,SAAS,CACV,CAAC;IACN,CAAC,EACD,KAAK,CAAC,GAAG,CACV,CAAC;AACJ,CAAC,CAAC;AA9FW,QAAA,gBAAgB,GAAhB,gBAAgB,CA8F3B"}
@@ -13,6 +13,8 @@ export interface IAutoMovieSoftBodyBoundarySample {
13
13
  step: number;
14
14
  /** Resolved hard anchors for this step. */
15
15
  anchors: readonly IAutoMovieSoftBodyResolvedAnchor[];
16
+ /** Authored moving anchors left free at this step, by particle: a corner a hand has let go of, which falls with its mass until a later sample holds it again. Each authored moving anchor is in `anchors` or here, never both; none released when absent. */
17
+ released?: readonly number[];
16
18
  /** Resolved body capsules for this step. */
17
19
  capsules: readonly IAutoMovieSoftBodyResolvedCapsule[];
18
20
  }
@@ -0,0 +1,30 @@
1
+ import { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * A reader of every step of one soft-body solve, so a caller that needs the
4
+ * whole trajectory (a performance read by film seconds) solves once instead
5
+ * of replaying from step 0 for each step it reads.
6
+ *
7
+ * @evidence contracts/development/design.md#principled-representation One call per completed absolute step with that step's positions, velocities and the force each held particle bears.
8
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The one callback the trajectory's consumers read; the solver's result stays the final state as before.
9
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The buffers are the solver's working arrays, lent for the call: a reader copies what it keeps, so the solve allocates nothing per step for a reader that keeps nothing.
10
+ * @evidence contracts/development/common.md#meaningful-documentation States when it is called, the frames and units, the lending rule and how a held particle's force is read.
11
+ */
12
+ export interface IAutoMovieSoftBodyObserver {
13
+ /**
14
+ * Read one completed step.
15
+ *
16
+ * @param step The absolute step just completed, from 1; step 0 is the rest before any integration and is not reported.
17
+ * @param positions Every particle's world position, metres, row-major `[x, y, z, ...]`; lent for the call.
18
+ * @param velocities Every particle's velocity, metres per second, in the same layout; a held particle reads zero; lent for the call.
19
+ * @param loads The force each held particle bears from the constraints that tie it to the rest of the body, newtons, world frame, by particle: the pull a hand holding it feels. Read from the compliant solver's multipliers (force = lambda times the constraint gradient over the step squared); empty when the domain declares no compliance, since the relaxation weights of the plain solver are not forces.
20
+ *
21
+ * @evidence contracts/development/common.md#meaningful-documentation States completed-step timing, absolute indexing, world units, borrowed buffers, held-particle velocity and the force map's meaning and empty case.
22
+ * @evidenceExclude contracts/development/implementation.md#principled-implementation An observer method signature; each observer owns what it computes from a step.
23
+ * @evidenceExclude contracts/development/implementation.md#clear-and-simple-structure No observer body is declared here.
24
+ * @evidenceExclude contracts/development/implementation.md#prohibited-implementation-shortcuts This signature performs no observation or computation.
25
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms The observer implementation owns its per-step cost.
26
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work The signature owns no saved trajectory or coordinated reads.
27
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The signature retains no buffers; implementations must copy any borrowed data they keep.
28
+ */
29
+ step(step: number, positions: Float64Array<ArrayBufferLike>, velocities: Float64Array<ArrayBufferLike>, loads: ReadonlyMap<number, IAutoMovieVector3>): void;
30
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=IAutoMovieSoftBodyObserver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IAutoMovieSoftBodyObserver.js","sourceRoot":"","sources":["../../src/soft/IAutoMovieSoftBodyObserver.ts"],"names":[],"mappings":""}
@@ -0,0 +1,34 @@
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 declare 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;
@@ -0,0 +1,52 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.applySoftBodyFriction = void 0;
4
+ /**
5
+ * Apply Coulomb friction to one particle a collider has just pushed out, in
6
+ * place: the position-based friction of Macklin, Müller, Chentanez and Kim
7
+ * 2014 ("Unified particle physics for real-time applications", ACM TOG
8
+ * 33(4):153, section 6.1), with one coefficient for sticking and sliding.
9
+ *
10
+ * The collider's push (the predicted position after contact projection less
11
+ * the one before it) gives the contact normal and the penetration depth d.
12
+ * The particle's travel over the step (its predicted position less its
13
+ * position at the step's start) is split into its part along the normal and
14
+ * its tangential part t. A tangential travel shorter than mu d is removed
15
+ * entirely, so the particle sticks; a longer one is shortened by mu d, so
16
+ * it slides against a force bounded by mu times the normal one. The
17
+ * collider is taken as still over the step: a static collider is, and a
18
+ * moving body capsule's own travel is not subtracted, so friction against a
19
+ * moving limb drags the cloth toward rest rather than along with the limb.
20
+ *
21
+ * @param props The particle, the buffers, its position before projection and the coefficient.
22
+ *
23
+ * @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.
24
+ * @evidence contracts/development/implementation.md#principled-implementation Position-based Coulomb friction (Macklin et al. 2014) on the projection's own push.
25
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One read of the push, one split of the travel, one correction.
26
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A particle the projection did not move is untouched; a zero coefficient changes nothing.
27
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work per particle.
28
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse; the push is the projection's own.
29
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Writes only the caller's predicted triple.
30
+ */
31
+ const applySoftBodyFriction = (props) => {
32
+ if (props.friction === 0)
33
+ return;
34
+ const base = props.particle * 3;
35
+ const push = [0, 1, 2].map((axis) => props.predicted[base + axis] - props.before[axis]);
36
+ const depth = Math.hypot(push[0], push[1], push[2]);
37
+ if (depth === 0)
38
+ return;
39
+ const n = push.map((v) => v / depth);
40
+ const travel = [0, 1, 2].map((axis) => props.predicted[base + axis] - props.position[base + axis]);
41
+ const along = travel[0] * n[0] + travel[1] * n[1] + travel[2] * n[2];
42
+ const tangent = travel.map((v, axis) => v - along * n[axis]);
43
+ const slide = Math.hypot(tangent[0], tangent[1], tangent[2]);
44
+ if (slide === 0)
45
+ return;
46
+ const limit = props.friction * depth;
47
+ const keep = slide < limit ? 1 : limit / slide;
48
+ for (let axis = 0; axis < 3; ++axis)
49
+ props.predicted[base + axis] -= keep * tangent[axis];
50
+ };
51
+ exports.applySoftBodyFriction = applySoftBodyFriction;
52
+ //# sourceMappingURL=applySoftBodyFriction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"applySoftBodyFriction.js","sourceRoot":"","sources":["../../src/soft/applySoftBodyFriction.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,MAAM,qBAAqB,GAMrB,CAAC,KAMb,EAAQ,EAAE;IACT,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO;IACjC,MAAM,IAAI,GAAW,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;IACxC,MAAM,IAAI,GAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAClC,CAAC,IAAY,EAAU,EAAE,CACvB,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAE,CACrD,CAAC;IACF,MAAM,KAAK,GAAW,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;IAC/D,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO;IACxB,MAAM,CAAC,GAAa,IAAI,CAAC,GAAG,CAAC,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CACpC,CAAC,IAAY,EAAU,EAAE,CACvB,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,CAC7D,CAAC;IACF,MAAM,KAAK,GACT,MAAM,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IAC/D,MAAM,OAAO,GAAa,MAAM,CAAC,GAAG,CAClC,CAAC,CAAS,EAAE,IAAY,EAAU,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,IAAI,CAAE,CAC1D,CAAC;IACF,MAAM,KAAK,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;IACxE,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO;IACxB,MAAM,KAAK,GAAW,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC7C,MAAM,IAAI,GAAW,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;IACvD,KAAK,IAAI,IAAI,GAAW,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI;QACzC,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAE,CAAC;AAC1D,CAAC,CAAC;AArCW,QAAA,qBAAqB,GAArB,qBAAqB,CAqChC"}
@@ -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";
package/lib/soft/index.js CHANGED
@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./IAutoMoviePlantingFrame"), exports);
18
18
  __exportStar(require("./IAutoMovieSoftBodyBoundarySample"), exports);
19
+ __exportStar(require("./IAutoMovieSoftBodyObserver"), exports);
19
20
  __exportStar(require("./IAutoMovieSoftBodyResolvedAnchor"), exports);
20
21
  __exportStar(require("./IAutoMovieSoftBodyResolvedCapsule"), exports);
21
22
  __exportStar(require("./IAutoMovieSoftFurnishingFrame"), exports);
@@ -25,6 +26,7 @@ __exportStar(require("./IAutoMovieWearableSoftBudget"), exports);
25
26
  __exportStar(require("./IAutoMovieWearableSoftFrame"), exports);
26
27
  __exportStar(require("./IAutoMovieWearableSoftResult"), exports);
27
28
  __exportStar(require("./SOFT_BODY_NEIGHBOURS"), exports);
29
+ __exportStar(require("./applySoftBodyFriction"), exports);
28
30
  __exportStar(require("./arrangePlantingCluster"), exports);
29
31
  __exportStar(require("./constants"), exports);
30
32
  __exportStar(require("./gatherSoftBodyCorrections"), exports);
@@ -39,6 +41,7 @@ __exportStar(require("./plantingStateDigest"), exports);
39
41
  __exportStar(require("./plantingYaw"), exports);
40
42
  __exportStar(require("./productionSoftBodyUsesMovingBoundary"), exports);
41
43
  __exportStar(require("./projectSoftBodyContacts"), exports);
44
+ __exportStar(require("./projectSoftCordSelfContact"), exports);
42
45
  __exportStar(require("./readProductionLiveWearableSoftBodies"), exports);
43
46
  __exportStar(require("./sampleSoftBody"), exports);
44
47
  __exportStar(require("./selectProductionLiveWearableSoftBodies"), exports);
@@ -48,6 +51,7 @@ __exportStar(require("./simulateSoftBody"), exports);
48
51
  __exportStar(require("./simulateSoftBodyCore"), exports);
49
52
  __exportStar(require("./simulateSoftBodyWithBoundaries"), exports);
50
53
  __exportStar(require("./softBodyBudget"), exports);
54
+ __exportStar(require("./softBodyHeldLoads"), exports);
51
55
  __exportStar(require("./softBodyNeighbourOf"), exports);
52
56
  __exportStar(require("./softBodyParticleDistance"), exports);
53
57
  __exportStar(require("./softBodyRestBuffer"), exports);
@@ -56,11 +60,13 @@ __exportStar(require("./softBodyStateDigest"), exports);
56
60
  __exportStar(require("./softBodyStepAt"), exports);
57
61
  __exportStar(require("./softBodySurfaceGeometry"), exports);
58
62
  __exportStar(require("./softBodyTravelNumber"), exports);
63
+ __exportStar(require("./solveSoftBodyCompliantSweep"), exports);
59
64
  __exportStar(require("./validateAutoMovieSoftFurnishingDomainOwnership"), exports);
60
65
  __exportStar(require("./validatePlantingCluster"), exports);
61
66
  __exportStar(require("./validatePlantingDomain"), exports);
62
67
  __exportStar(require("./validatePlantingInstallations"), exports);
63
68
  __exportStar(require("./validateSoftBodyDomain"), exports);
69
+ __exportStar(require("./validateSoftCompliance"), exports);
64
70
  __exportStar(require("./validateSoftFurnishings"), exports);
65
71
  __exportStar(require("./validateSoftIdentity"), exports);
66
72
  __exportStar(require("./validateSoftInteger"), exports);
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/soft/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,qEAAmD;AACnD,qEAAmD;AACnD,sEAAoD;AACpD,kEAAgD;AAChD,gEAA8C;AAC9C,oEAAkD;AAClD,iEAA+C;AAC/C,gEAA8C;AAC9C,iEAA+C;AAC/C,yDAAuC;AACvC,2DAAyC;AACzC,8CAA4B;AAC5B,8DAA4C;AAC5C,iDAA+B;AAC/B,8DAA4C;AAC5C,wDAAsC;AACtC,mDAAiC;AACjC,yDAAuC;AACvC,0DAAwC;AACxC,4DAA0C;AAC1C,wDAAsC;AACtC,gDAA8B;AAC9B,yEAAuD;AACvD,4DAA0C;AAC1C,yEAAuD;AACvD,mDAAiC;AACjC,2EAAyD;AACzD,uDAAqC;AACrC,sEAAoD;AACpD,qDAAmC;AACnC,yDAAuC;AACvC,mEAAiD;AACjD,mDAAiC;AACjC,wDAAsC;AACtC,6DAA2C;AAC3C,uDAAqC;AACrC,8DAA4C;AAC5C,wDAAsC;AACtC,mDAAiC;AACjC,4DAA0C;AAC1C,yDAAuC;AACvC,mFAAiE;AACjE,4DAA0C;AAC1C,2DAAyC;AACzC,kEAAgD;AAChD,2DAAyC;AACzC,4DAA0C;AAC1C,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,gEAA8C;AAC9C,uDAAqC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/soft/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,qEAAmD;AACnD,+DAA6C;AAC7C,qEAAmD;AACnD,sEAAoD;AACpD,kEAAgD;AAChD,gEAA8C;AAC9C,oEAAkD;AAClD,iEAA+C;AAC/C,gEAA8C;AAC9C,iEAA+C;AAC/C,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AACzC,8CAA4B;AAC5B,8DAA4C;AAC5C,iDAA+B;AAC/B,8DAA4C;AAC5C,wDAAsC;AACtC,mDAAiC;AACjC,yDAAuC;AACvC,0DAAwC;AACxC,4DAA0C;AAC1C,wDAAsC;AACtC,gDAA8B;AAC9B,yEAAuD;AACvD,4DAA0C;AAC1C,+DAA6C;AAC7C,yEAAuD;AACvD,mDAAiC;AACjC,2EAAyD;AACzD,uDAAqC;AACrC,sEAAoD;AACpD,qDAAmC;AACnC,yDAAuC;AACvC,mEAAiD;AACjD,mDAAiC;AACjC,sDAAoC;AACpC,wDAAsC;AACtC,6DAA2C;AAC3C,uDAAqC;AACrC,8DAA4C;AAC5C,wDAAsC;AACtC,mDAAiC;AACjC,4DAA0C;AAC1C,yDAAuC;AACvC,gEAA8C;AAC9C,mFAAiE;AACjE,4DAA0C;AAC1C,2DAAyC;AACzC,kEAAgD;AAChD,2DAAyC;AACzC,2DAAyC;AACzC,4DAA0C;AAC1C,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,gEAA8C;AAC9C,uDAAqC"}
@@ -0,0 +1,53 @@
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 declare 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;
@@ -0,0 +1,172 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.projectSoftCordSelfContact = void 0;
4
+ /**
5
+ * Keep the segments of a cord apart: every two segments that share no
6
+ * particle are held at least two radii apart along the line between their
7
+ * closest points, with Coulomb friction between them, in place on the
8
+ * predicted positions.
9
+ *
10
+ * A cord is a one-wide lattice, its particles in index order along it and
11
+ * segment s joining particles s and s + 1. Each segment is a capsule of the
12
+ * domain's `thickness` (its radius). For two segments, the closest points
13
+ * p = a0 + s (a1 - a0) and q = b0 + t (b1 - b0) come from the clamped
14
+ * segment-segment solution of Ericson ("Real-Time Collision Detection",
15
+ * 2005, section 5.1.9). The non-penetration constraint C = |p - q| - 2r
16
+ * (r the radius) has gradients (1 - s) n and s n on a0 and a1 and
17
+ * -(1 - t) n and -t n on b0 and b1, n the unit direction from q to p; an
18
+ * active one (C < 0) is projected as a position-based constraint with
19
+ * those gradients and the particles' inverse masses (Müller, Heidelberger,
20
+ * Hennix and Ratcliff 2007, "Position based dynamics", section 3.3).
21
+ *
22
+ * Friction is the position-based Coulomb model of Macklin, Müller,
23
+ * Chentanez and Kim 2014 ("Unified particle physics for real-time
24
+ * applications", ACM TOG 33(4):153, section 6.1), with one coefficient for
25
+ * sticking and sliding: the relative tangential displacement of the two
26
+ * closest points over the step is removed entirely while it is under mu
27
+ * times the penetration depth, and shortened by mu times the depth above
28
+ * it, distributed over the four particles as the normal correction is.
29
+ *
30
+ * Candidate pairs come from a uniform grid whose cell is the longest segment
31
+ * plus two radii, so two segments within two radii of each other have
32
+ * midpoints in neighbouring cells; segments are visited in index order and
33
+ * each one's candidates in ascending order, so the result is deterministic.
34
+ * A segment travels less than the radius a step when the domain's admission
35
+ * holds (`dt * referenceSpeed <= thickness`), so a pass discovered at the
36
+ * end of a step cannot have been tunnelled through.
37
+ *
38
+ * @param props The cord's particles, its previous and predicted positions, inverse masses and contact.
39
+ * @returns How many pairs were in contact.
40
+ *
41
+ * @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.
42
+ * @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).
43
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure A grid pass for candidates, then one projection per candidate pair.
44
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Adjacent segments, which share a particle, are never paired; two anchored particles move nothing.
45
+ * @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.
46
+ * @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.
47
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The grid is call-local; only the caller's predicted buffer is written.
48
+ */
49
+ const projectSoftCordSelfContact = (props) => {
50
+ // The pair projection reads the positions and the inverse masses from
51
+ // `props`; the grid needs only the predicted positions.
52
+ const { count, predicted } = props;
53
+ const segments = count - 1;
54
+ if (segments < 3)
55
+ return 0;
56
+ const reach = 2 * props.radius;
57
+ // The grid: a cell the longest segment plus two radii wide.
58
+ let longest = 0;
59
+ for (let s = 0; s < segments; ++s)
60
+ longest = Math.max(longest, distance(predicted, s, s + 1));
61
+ const cell = longest + reach;
62
+ const key = (x, y, z) => `${x},${y},${z}`;
63
+ const index = (s, axis) => Math.floor((predicted[s * 3 + axis] + predicted[(s + 1) * 3 + axis]) / 2 / cell);
64
+ const grid = new Map();
65
+ for (let s = 0; s < segments; ++s) {
66
+ const k = key(index(s, 0), index(s, 1), index(s, 2));
67
+ const list = grid.get(k);
68
+ if (list === undefined)
69
+ grid.set(k, [s]);
70
+ else
71
+ list.push(s);
72
+ }
73
+ let contacts = 0;
74
+ for (let a = 0; a < segments; ++a) {
75
+ const candidates = [];
76
+ const cx = index(a, 0);
77
+ const cy = index(a, 1);
78
+ const cz = index(a, 2);
79
+ for (let x = -1; x <= 1; ++x)
80
+ for (let y = -1; y <= 1; ++y)
81
+ for (let z = -1; z <= 1; ++z)
82
+ for (const b of grid.get(key(cx + x, cy + y, cz + z)) ?? [])
83
+ if (b >= a + 2)
84
+ candidates.push(b);
85
+ candidates.sort((l, r) => l - r);
86
+ for (const b of candidates)
87
+ if (separate(props, a, b, reach))
88
+ ++contacts;
89
+ }
90
+ return contacts;
91
+ };
92
+ exports.projectSoftCordSelfContact = projectSoftCordSelfContact;
93
+ /** Project one pair of segments apart and apply friction between them, returning whether they were in contact. */
94
+ const separate = (props, a, b, reach) => {
95
+ const { predicted, position, inverseMass } = props;
96
+ const [s, t] = closest(predicted, a, b);
97
+ const point = (buffer, first, share, axis) => buffer[first * 3 + axis] * (1 - share) +
98
+ buffer[(first + 1) * 3 + axis] * share;
99
+ const d = [0, 1, 2].map((axis) => point(predicted, a, s, axis) - point(predicted, b, t, axis));
100
+ const length = Math.hypot(d[0], d[1], d[2]);
101
+ if (length >= reach || length === 0)
102
+ return false;
103
+ const n = d.map((v) => v / length);
104
+ // The four particles with their gradient weights along n.
105
+ const ids = [a, a + 1, b, b + 1];
106
+ const weights = [1 - s, s, -(1 - t), -t];
107
+ const denominator = ids.reduce((sum, id, i) => sum + inverseMass[id] * weights[i] * weights[i], 0);
108
+ if (denominator === 0)
109
+ return true;
110
+ const depth = reach - length;
111
+ const normal = depth / denominator;
112
+ ids.forEach((id, i) => {
113
+ for (let axis = 0; axis < 3; ++axis)
114
+ predicted[id * 3 + axis] +=
115
+ inverseMass[id] * weights[i] * normal * n[axis];
116
+ });
117
+ // Coulomb friction on the closest points' relative tangential travel.
118
+ const travel = [0, 1, 2].map((axis) => point(predicted, a, s, axis) -
119
+ point(position, a, s, axis) -
120
+ (point(predicted, b, t, axis) - point(position, b, t, axis)));
121
+ const along = travel[0] * n[0] + travel[1] * n[1] + travel[2] * n[2];
122
+ const tangent = travel.map((v, axis) => v - along * n[axis]);
123
+ const slide = Math.hypot(tangent[0], tangent[1], tangent[2]);
124
+ if (slide === 0)
125
+ return true;
126
+ const keep = slide < props.friction * depth
127
+ ? 1
128
+ : Math.min((props.friction * depth) / slide, 1);
129
+ ids.forEach((id, i) => {
130
+ for (let axis = 0; axis < 3; ++axis)
131
+ predicted[id * 3 + axis] -=
132
+ (inverseMass[id] * weights[i] * keep * tangent[axis]) / denominator;
133
+ });
134
+ return true;
135
+ };
136
+ /**
137
+ * The shares along two segments of their closest points, each in [0, 1]
138
+ * (Ericson 2005, section 5.1.9, `ClosestPtSegmentSegment`).
139
+ */
140
+ const closest = (x, a, b) => {
141
+ const d1 = [0, 1, 2].map((k) => x[(a + 1) * 3 + k] - x[a * 3 + k]);
142
+ const d2 = [0, 1, 2].map((k) => x[(b + 1) * 3 + k] - x[b * 3 + k]);
143
+ const r = [0, 1, 2].map((k) => x[a * 3 + k] - x[b * 3 + k]);
144
+ const dot = (u, v) => u[0] * v[0] + u[1] * v[1] + u[2] * v[2];
145
+ const aa = dot(d1, d1);
146
+ const ee = dot(d2, d2);
147
+ const f = dot(d2, r);
148
+ const clamp = (v) => Math.max(0, Math.min(1, v));
149
+ if (aa === 0 && ee === 0)
150
+ return [0, 0];
151
+ if (aa === 0)
152
+ return [0, clamp(f / ee)];
153
+ const c = dot(d1, r);
154
+ if (ee === 0)
155
+ return [clamp(-c / aa), 0];
156
+ const bb = dot(d1, d2);
157
+ const denom = aa * ee - bb * bb;
158
+ let s = denom !== 0 ? clamp((bb * f - c * ee) / denom) : 0;
159
+ let t = (bb * s + f) / ee;
160
+ if (t < 0) {
161
+ t = 0;
162
+ s = clamp(-c / aa);
163
+ }
164
+ else if (t > 1) {
165
+ t = 1;
166
+ s = clamp((bb - c) / aa);
167
+ }
168
+ return [s, t];
169
+ };
170
+ /** The distance between two particles of a buffer. */
171
+ const distance = (x, i, k) => Math.hypot(x[i * 3] - x[k * 3], x[i * 3 + 1] - x[k * 3 + 1], x[i * 3 + 2] - x[k * 3 + 2]);
172
+ //# sourceMappingURL=projectSoftCordSelfContact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projectSoftCordSelfContact.js","sourceRoot":"","sources":["../../src/soft/projectSoftCordSelfContact.ts"],"names":[],"mappings":"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"}
@@ -1,13 +1,16 @@
1
1
  import { IAutoMovieSoftBodyDomain, IAutoMovieSoftBodyState } from "@automovie/interface";
2
2
  import { IAutoMovieSoftBodyBoundarySample } from "./IAutoMovieSoftBodyBoundarySample";
3
+ import { IAutoMovieSoftBodyObserver } from "./IAutoMovieSoftBodyObserver";
3
4
  /** Integrate an admitted cloth lattice from its authored rest boundary to one absolute fixed step.
4
5
  *
5
- * @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.
6
+ * 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.
7
+ *
8
+ * @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.
6
9
  * @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.
7
- * @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.
10
+ * @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.
8
11
  * @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.
9
12
  * @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.
10
13
  * @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.
11
14
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Working typed arrays and maps are call-local; only fresh plain position/velocity arrays and scalar measurements transfer in the result, and thrown failure retains no integration task or cursor.
12
15
  */
13
- export declare const simulateSoftBodyCore: (domain: IAutoMovieSoftBodyDomain, step: number, state: string | null, boundaries: readonly IAutoMovieSoftBodyBoundarySample[] | null) => IAutoMovieSoftBodyState;
16
+ export declare const simulateSoftBodyCore: (domain: IAutoMovieSoftBodyDomain, step: number, state: string | null, boundaries: readonly IAutoMovieSoftBodyBoundarySample[] | null, observer?: IAutoMovieSoftBodyObserver | null) => IAutoMovieSoftBodyState;