@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,85 @@
1
+ import { IAutoMovieVector3 } from "@automovie/interface";
2
+
3
+ import { SOFT_BODY_NEIGHBOURS } from "./SOFT_BODY_NEIGHBOURS";
4
+ import { softBodyNeighbourOf } from "./softBodyNeighbourOf";
5
+
6
+ /**
7
+ * The force each held particle (an anchor, of zero inverse mass) bears from
8
+ * the compliant constraints that tie it to the rest of the lattice, at the
9
+ * end of a step: the pull a hand holding a cord's end feels.
10
+ *
11
+ * In XPBD a constraint's force is its gradient times its multiplier over the
12
+ * step squared (Macklin, Müller and Chentanez 2016, MIG 2016, equation 9's
13
+ * relation f = grad C^T lambda / dt^2). For an edge from particle i to k
14
+ * with unit direction n from k to i, the force on k is -lambda n / dt^2; a
15
+ * stretched edge has a negative multiplier, so the force points from the
16
+ * held particle into the body that hangs from it. The direction is read at
17
+ * the step's final positions, where the last sweep left the edge.
18
+ *
19
+ * @param props The lattice, the step's positions, the inverse masses, the rest lengths, the multipliers and the step.
20
+ * @returns The force on every held particle that a constraint pulls, newtons, world frame, by particle.
21
+ *
22
+ * @evidence contracts/development/common.md#meaningful-documentation States the relation with its source, the sign and where the direction is read.
23
+ * @evidence contracts/development/implementation.md#principled-implementation XPBD's constraint force from its multiplier.
24
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the edges that touch a held particle.
25
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An edge between two held particles carries no load onto the body and is skipped; a collapsed edge has no direction and is skipped.
26
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in particles times the twelve-slot stencil.
27
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Read once per step from that step's multipliers.
28
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Returns a fresh map of at most one entry per held particle.
29
+ */
30
+ export const softBodyHeldLoads: (props: {
31
+ columns: number;
32
+ rows: number;
33
+ position: Float64Array<ArrayBufferLike>;
34
+ inverseMass: Float64Array<ArrayBufferLike>;
35
+ restLength: Float64Array<ArrayBufferLike>;
36
+ lambda: Float64Array<ArrayBufferLike>;
37
+ dt: number;
38
+ }) => ReadonlyMap<number, IAutoMovieVector3> = (props: {
39
+ columns: number;
40
+ rows: number;
41
+ position: Float64Array<ArrayBufferLike>;
42
+ inverseMass: Float64Array<ArrayBufferLike>;
43
+ restLength: Float64Array<ArrayBufferLike>;
44
+ lambda: Float64Array<ArrayBufferLike>;
45
+ dt: number;
46
+ }): ReadonlyMap<number, IAutoMovieVector3> => {
47
+ const { columns, rows, position, inverseMass }: typeof props = props;
48
+ const slots: number = SOFT_BODY_NEIGHBOURS.length;
49
+ const scale: number = 1 / (props.dt * props.dt);
50
+ const out: Map<number, IAutoMovieVector3> = new Map();
51
+ const add = (particle: number, x: number, y: number, z: number): void => {
52
+ const was: IAutoMovieVector3 = out.get(particle) ?? { x: 0, y: 0, z: 0 };
53
+ out.set(particle, { x: was.x + x, y: was.y + y, z: was.z + z });
54
+ };
55
+ for (let row: number = 0; row < rows; ++row)
56
+ for (let column: number = 0; column < columns; ++column) {
57
+ const particle: number = row * columns + column;
58
+ for (let at: number = 0; at < slots; ++at) {
59
+ if (props.restLength[particle * slots + at] < 0) continue;
60
+ const other: number = softBodyNeighbourOf(
61
+ columns,
62
+ rows,
63
+ column,
64
+ row,
65
+ at,
66
+ );
67
+ if (other < particle) continue;
68
+ const heldI: boolean = inverseMass[particle] === 0;
69
+ const heldK: boolean = inverseMass[other] === 0;
70
+ if (heldI === heldK) continue;
71
+ const dx: number = position[particle * 3] - position[other * 3];
72
+ const dy: number = position[particle * 3 + 1] - position[other * 3 + 1];
73
+ const dz: number = position[particle * 3 + 2] - position[other * 3 + 2];
74
+ const length: number = Math.sqrt(dx * dx + dy * dy + dz * dz);
75
+ if (length === 0) continue;
76
+ const f: number =
77
+ (props.lambda[particle * slots + at] * scale) / length;
78
+
79
+ // On i the force is +lambda n / dt^2, on k it is -lambda n / dt^2.
80
+ if (heldI) add(particle, f * dx, f * dy, f * dz);
81
+ else add(other, -f * dx, -f * dy, -f * dz);
82
+ }
83
+ }
84
+ return out;
85
+ };
@@ -0,0 +1,107 @@
1
+ import { SOFT_BODY_NEIGHBOURS } from "./SOFT_BODY_NEIGHBOURS";
2
+ import { softBodyNeighbourOf } from "./softBodyNeighbourOf";
3
+
4
+ /**
5
+ * Run one sweep of compliant distance constraints over a lattice, in place:
6
+ * every edge of the lattice, its row and column neighbours, its diagonals
7
+ * and its second neighbours, projected one after another with its Lagrange
8
+ * multiplier, the extended position-based dynamics of Macklin, Müller and
9
+ * Chentanez 2016 ("XPBD: position-based simulation of compliant constrained
10
+ * dynamics", MIG 2016, pp. 49-54, equations 18 and 17).
11
+ *
12
+ * For an edge between particles i and k with rest length l, the constraint
13
+ * is C = |x_i - x_k| - l, its gradient the unit direction n from k to i, and
14
+ * the time-scaled compliance alpha~ = alpha / dt^2 with alpha the family's
15
+ * compliance in metres per newton. The multiplier's increment is
16
+ * dlambda = (-C - alpha~ lambda) / (w_i + w_k + alpha~), and the particles
17
+ * move by w_i dlambda n and -w_k dlambda n, w the inverse masses. Unlike the
18
+ * relaxation weight of the plain position-based solver, the stiffness this
19
+ * gives does not depend on the sweep count or the step (the paper's section
20
+ * 4), so a cord's stretch and bend are the same at 4 and at 16 sweeps. A
21
+ * compliance of zero is an inextensible edge. On a cord, a one-wide
22
+ * lattice, the second neighbours are its bending constraint in distance form:
23
+ * the distance between the ends of two consecutive segments, which is
24
+ * regular at a straight rest where the angle between the segments is not
25
+ * differentiable.
26
+ *
27
+ * Edges are visited in a fixed order (row-major particles, each with the
28
+ * neighbours that follow it in `SOFT_BODY_NEIGHBOURS`), so a solve is
29
+ * deterministic. `lambda` holds one multiplier per particle and neighbour
30
+ * slot and is reset by the caller at the start of each step.
31
+ *
32
+ * @param props The lattice, the working buffers and the step.
33
+ *
34
+ * @evidence contracts/development/common.md#meaningful-documentation States the constraint, its gradient, the multiplier update with its source equations, the units of compliance, the bending form and the order.
35
+ * @evidence contracts/development/implementation.md#principled-implementation XPBD's Gauss-Seidel update of each distance constraint with its own multiplier (Macklin, Müller and Chentanez 2016).
36
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One loop over edges in a fixed order sharing the lattice's neighbour table.
37
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A collapsed edge (zero current length) has no direction and is skipped, as the plain solver skips it; an edge between two anchors moves nothing.
38
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in particles times the twelve-slot stencil, with no allocation.
39
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Each sweep reads the positions the last one left; nothing is cached.
40
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Writes only the caller's predicted and multiplier buffers.
41
+ */
42
+ export const solveSoftBodyCompliantSweep: (props: {
43
+ columns: number;
44
+ rows: number;
45
+ predicted: Float64Array<ArrayBufferLike>;
46
+ inverseMass: Float64Array<ArrayBufferLike>;
47
+ restLength: Float64Array<ArrayBufferLike>;
48
+ compliance: readonly number[];
49
+ lambda: Float64Array<ArrayBufferLike>;
50
+ dt: number;
51
+ }) => void = (props: {
52
+ columns: number;
53
+ rows: number;
54
+ predicted: Float64Array<ArrayBufferLike>;
55
+ inverseMass: Float64Array<ArrayBufferLike>;
56
+ restLength: Float64Array<ArrayBufferLike>;
57
+ compliance: readonly number[];
58
+ lambda: Float64Array<ArrayBufferLike>;
59
+ dt: number;
60
+ }): void => {
61
+ const { columns, rows, predicted, inverseMass, lambda }: typeof props = props;
62
+ const slots: number = SOFT_BODY_NEIGHBOURS.length;
63
+ const scale: number = 1 / (props.dt * props.dt);
64
+ for (let row: number = 0; row < rows; ++row)
65
+ for (let column: number = 0; column < columns; ++column) {
66
+ const particle: number = row * columns + column;
67
+ for (let at: number = 0; at < slots; ++at) {
68
+ const rest: number = props.restLength[particle * slots + at];
69
+ if (rest < 0) continue;
70
+ const other: number = softBodyNeighbourOf(
71
+ columns,
72
+ rows,
73
+ column,
74
+ row,
75
+ at,
76
+ );
77
+
78
+ // Each edge once: from the particle with the lower index.
79
+ if (other < particle) continue;
80
+ const wi: number = inverseMass[particle];
81
+ const wk: number = inverseMass[other];
82
+ const tilde: number =
83
+ props.compliance[SOFT_BODY_NEIGHBOURS[at][2]] * scale;
84
+ if (wi + wk + tilde === 0) continue;
85
+ const dx: number = predicted[particle * 3] - predicted[other * 3];
86
+ const dy: number =
87
+ predicted[particle * 3 + 1] - predicted[other * 3 + 1];
88
+ const dz: number =
89
+ predicted[particle * 3 + 2] - predicted[other * 3 + 2];
90
+ const length: number = Math.sqrt(dx * dx + dy * dy + dz * dz);
91
+ if (length === 0) continue;
92
+ const slot: number = particle * slots + at;
93
+ const delta: number =
94
+ (-(length - rest) - tilde * lambda[slot]) / (wi + wk + tilde);
95
+ lambda[slot] += delta;
96
+ const nx: number = dx / length;
97
+ const ny: number = dy / length;
98
+ const nz: number = dz / length;
99
+ predicted[particle * 3] += wi * delta * nx;
100
+ predicted[particle * 3 + 1] += wi * delta * ny;
101
+ predicted[particle * 3 + 2] += wi * delta * nz;
102
+ predicted[other * 3] -= wk * delta * nx;
103
+ predicted[other * 3 + 1] -= wk * delta * ny;
104
+ predicted[other * 3 + 2] -= wk * delta * nz;
105
+ }
106
+ }
107
+ };
@@ -0,0 +1,143 @@
1
+ import {
2
+ IAutoMovieSoftAnchor,
3
+ IAutoMovieSoftAnchorPose,
4
+ IAutoMovieSoftBodyDomain,
5
+ IAutoMovieSoftNamedState,
6
+ } from "@automovie/interface";
7
+
8
+ import { ViolationCollector } from "../validation/ViolationCollector";
9
+ import { SOFT_MAX_ANCHORS } from "./constants/SOFT_MAX_ANCHORS";
10
+ import { SOFT_MAX_STATES } from "./constants/SOFT_MAX_STATES";
11
+ import { validateSoftBounded as bounded } from "./validateSoftBounded";
12
+ import { validateSoftIdentity as identity } from "./validateSoftIdentity";
13
+ import { validateSoftInteger as integer } from "./validateSoftInteger";
14
+ import { validateSoftVector as vector } from "./validateSoftVector";
15
+
16
+ /**
17
+ * Validate a soft-body domain's anchors and its named states: the anchors'
18
+ * budget, identities, particles (each held by one anchor only), static
19
+ * positions and moving bindings, then the states' budget, identities and the
20
+ * anchors each poses (declared, posed once, finite). Split from
21
+ * `validateSoftBodyDomain`, which calls it at the same place, so its
22
+ * findings keep their order.
23
+ *
24
+ * @param out The collector the domain's validation writes to.
25
+ * @param root The domain's path.
26
+ * @param domain The domain.
27
+ * @param count The lattice's particle count.
28
+ *
29
+ * @evidence contracts/development/common.md#meaningful-documentation States every rule and why the findings keep their order.
30
+ * @evidence contracts/development/implementation.md#principled-implementation Budget, identity, integer-range and vector admission through the shared primitive validators, and reference joins through the anchors' identity set.
31
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the anchors, then one over the states and their poses.
32
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A second anchor on a particle, a moving anchor with a static position, a blank binding identity and an undeclared or repeated pose are each reported, never repaired.
33
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in anchors plus state poses, with one identity set per collection.
34
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses the shared primitive validators.
35
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The identity sets belong to the call; only the caller's collector is written.
36
+ */
37
+ export const validateSoftAnchors: (
38
+ out: ViolationCollector,
39
+ root: string,
40
+ domain: IAutoMovieSoftBodyDomain,
41
+ count: number,
42
+ ) => void = (
43
+ out: ViolationCollector,
44
+ root: string,
45
+ domain: IAutoMovieSoftBodyDomain,
46
+ count: number,
47
+ ): void => {
48
+ bounded(
49
+ out,
50
+ `${root}.anchors`,
51
+ "anchors",
52
+ domain.anchors.length,
53
+ SOFT_MAX_ANCHORS,
54
+ );
55
+ const anchorIds: Set<string> = new Set<string>();
56
+ const anchoredParticles: Set<number> = new Set<number>();
57
+ domain.anchors.forEach(
58
+ (anchor: IAutoMovieSoftAnchor, index: number): void => {
59
+ const path: string = `${root}.anchors[${index}]`;
60
+ identity(out, path, "anchor", anchor.id, anchorIds);
61
+ integer(
62
+ out,
63
+ `${path}.particle`,
64
+ "anchor particle",
65
+ anchor.particle,
66
+ 0,
67
+ count - 1,
68
+ );
69
+ if (anchoredParticles.has(anchor.particle))
70
+ out.push(
71
+ "type",
72
+ `${path}.particle`,
73
+ `particle ${anchor.particle} is already held by another anchor`,
74
+ anchor.particle,
75
+ );
76
+ anchoredParticles.add(anchor.particle);
77
+ if (anchor.position !== null)
78
+ vector(out, `${path}.position`, anchor.position);
79
+ if (anchor.binding !== undefined) {
80
+ if (anchor.position !== null)
81
+ out.push(
82
+ "type",
83
+ `${path}.position`,
84
+ "a moving anchor must leave its static world position null",
85
+ anchor.position,
86
+ );
87
+ if (anchor.binding.kind === "node") {
88
+ if (anchor.binding.node.trim().length === 0)
89
+ out.push(
90
+ "type",
91
+ `${path}.binding.node`,
92
+ "moving anchor node identity must be non-empty",
93
+ anchor.binding.node,
94
+ );
95
+ } else if (anchor.binding.actor.trim().length === 0)
96
+ out.push(
97
+ "type",
98
+ `${path}.binding.actor`,
99
+ "moving anchor actor identity must be non-empty",
100
+ anchor.binding.actor,
101
+ );
102
+ vector(out, `${path}.binding.offset`, anchor.binding.offset);
103
+ }
104
+ },
105
+ );
106
+
107
+ bounded(
108
+ out,
109
+ `${root}.states`,
110
+ "named states",
111
+ domain.states.length,
112
+ SOFT_MAX_STATES,
113
+ );
114
+ const stateIds: Set<string> = new Set<string>();
115
+ domain.states.forEach(
116
+ (state: IAutoMovieSoftNamedState, index: number): void => {
117
+ const path: string = `${root}.states[${index}]`;
118
+ identity(out, path, "named state", state.id, stateIds);
119
+ const posed: Set<string> = new Set<string>();
120
+ state.anchors.forEach(
121
+ (pose: IAutoMovieSoftAnchorPose, at: number): void => {
122
+ const posePath: string = `${path}.anchors[${at}]`;
123
+ if (!anchorIds.has(pose.anchor))
124
+ out.push(
125
+ "type",
126
+ `${posePath}.anchor`,
127
+ `named state cites anchor "${pose.anchor}", which the domain does not declare`,
128
+ pose.anchor,
129
+ );
130
+ else if (posed.has(pose.anchor))
131
+ out.push(
132
+ "type",
133
+ `${posePath}.anchor`,
134
+ `named state poses anchor "${pose.anchor}" twice`,
135
+ pose.anchor,
136
+ );
137
+ posed.add(pose.anchor);
138
+ vector(out, `${posePath}.position`, pose.position);
139
+ },
140
+ );
141
+ },
142
+ );
143
+ };
@@ -1,21 +1,19 @@
1
1
  import {
2
- IAutoMovieSoftAnchor,
3
- IAutoMovieSoftAnchorPose,
4
2
  IAutoMovieSoftBodyDomain,
5
3
  IAutoMovieSoftCollider,
6
- IAutoMovieSoftNamedState,
7
4
  IAutoMovieValidation,
8
5
  IAutoMovieVector3,
9
6
  } from "@automovie/interface";
10
7
 
11
8
  import { ViolationCollector } from "../validation/ViolationCollector";
12
- import { SOFT_MAX_ANCHORS } from "./constants/SOFT_MAX_ANCHORS";
13
9
  import { SOFT_MAX_COLLIDERS } from "./constants/SOFT_MAX_COLLIDERS";
14
10
  import { SOFT_MAX_ITERATIONS } from "./constants/SOFT_MAX_ITERATIONS";
15
11
  import { SOFT_MAX_PARTICLES } from "./constants/SOFT_MAX_PARTICLES";
16
- import { SOFT_MAX_STATES } from "./constants/SOFT_MAX_STATES";
17
12
  import { SOFT_MAX_STEPS } from "./constants/SOFT_MAX_STEPS";
18
13
  import { softBodyTravelNumber } from "./softBodyTravelNumber";
14
+ import { validateSoftAnchors } from "./validateSoftAnchors";
15
+ import { validateSoftBounded as bounded } from "./validateSoftBounded";
16
+ import { validateSoftCompliance } from "./validateSoftCompliance";
19
17
  import { validateSoftIdentity as identity } from "./validateSoftIdentity";
20
18
  import { validateSoftInteger as integer } from "./validateSoftInteger";
21
19
  import { validateSoftNumeric as numeric } from "./validateSoftNumeric";
@@ -194,6 +192,7 @@ export const validateSoftBodyDomain: (props: {
194
192
  coincident(out, root, domain, particle, particle + columns);
195
193
  }
196
194
 
195
+ validateSoftCompliance(out, root, domain);
197
196
  const travel: number = softBodyTravelNumber(domain);
198
197
  if (travel > 1)
199
198
  out.push(
@@ -204,101 +203,7 @@ export const validateSoftBodyDomain: (props: {
204
203
  Number.isFinite(travel) ? travel - 1 : undefined,
205
204
  );
206
205
 
207
- bounded(
208
- out,
209
- `${root}.anchors`,
210
- "anchors",
211
- domain.anchors.length,
212
- SOFT_MAX_ANCHORS,
213
- );
214
- const anchorIds: Set<string> = new Set<string>();
215
- const anchoredParticles: Set<number> = new Set<number>();
216
- domain.anchors.forEach(
217
- (anchor: IAutoMovieSoftAnchor, index: number): void => {
218
- const path: string = `${root}.anchors[${index}]`;
219
- identity(out, path, "anchor", anchor.id, anchorIds);
220
- integer(
221
- out,
222
- `${path}.particle`,
223
- "anchor particle",
224
- anchor.particle,
225
- 0,
226
- count - 1,
227
- );
228
- if (anchoredParticles.has(anchor.particle))
229
- out.push(
230
- "type",
231
- `${path}.particle`,
232
- `particle ${anchor.particle} is already held by another anchor`,
233
- anchor.particle,
234
- );
235
- anchoredParticles.add(anchor.particle);
236
- if (anchor.position !== null)
237
- vector(out, `${path}.position`, anchor.position);
238
- if (anchor.binding !== undefined) {
239
- if (anchor.position !== null)
240
- out.push(
241
- "type",
242
- `${path}.position`,
243
- "a moving anchor must leave its static world position null",
244
- anchor.position,
245
- );
246
- if (anchor.binding.kind === "node") {
247
- if (anchor.binding.node.trim().length === 0)
248
- out.push(
249
- "type",
250
- `${path}.binding.node`,
251
- "moving anchor node identity must be non-empty",
252
- anchor.binding.node,
253
- );
254
- } else if (anchor.binding.actor.trim().length === 0)
255
- out.push(
256
- "type",
257
- `${path}.binding.actor`,
258
- "moving anchor actor identity must be non-empty",
259
- anchor.binding.actor,
260
- );
261
- vector(out, `${path}.binding.offset`, anchor.binding.offset);
262
- }
263
- },
264
- );
265
-
266
- bounded(
267
- out,
268
- `${root}.states`,
269
- "named states",
270
- domain.states.length,
271
- SOFT_MAX_STATES,
272
- );
273
- const stateIds: Set<string> = new Set<string>();
274
- domain.states.forEach(
275
- (state: IAutoMovieSoftNamedState, index: number): void => {
276
- const path: string = `${root}.states[${index}]`;
277
- identity(out, path, "named state", state.id, stateIds);
278
- const posed: Set<string> = new Set<string>();
279
- state.anchors.forEach(
280
- (pose: IAutoMovieSoftAnchorPose, at: number): void => {
281
- const posePath: string = `${path}.anchors[${at}]`;
282
- if (!anchorIds.has(pose.anchor))
283
- out.push(
284
- "type",
285
- `${posePath}.anchor`,
286
- `named state cites anchor "${pose.anchor}", which the domain does not declare`,
287
- pose.anchor,
288
- );
289
- else if (posed.has(pose.anchor))
290
- out.push(
291
- "type",
292
- `${posePath}.anchor`,
293
- `named state poses anchor "${pose.anchor}" twice`,
294
- pose.anchor,
295
- );
296
- posed.add(pose.anchor);
297
- vector(out, `${posePath}.position`, pose.position);
298
- },
299
- );
300
- },
301
- );
206
+ validateSoftAnchors(out, root, domain, count);
302
207
 
303
208
  bounded(
304
209
  out,
@@ -511,27 +416,3 @@ const length: (
511
416
  actual,
512
417
  );
513
418
  };
514
-
515
- /** A declared collection that must stay inside its budget. */
516
- const bounded: (
517
- out: ViolationCollector,
518
- path: string,
519
- label: string,
520
- actual: number,
521
- budget: number,
522
- ) => void = (
523
- out: ViolationCollector,
524
- path: string,
525
- label: string,
526
- actual: number,
527
- budget: number,
528
- ): void => {
529
- if (actual > budget)
530
- out.push(
531
- "range",
532
- path,
533
- `a soft body may declare at most ${budget} ${label}, but declared ${actual}`,
534
- actual,
535
- actual - budget,
536
- );
537
- };
@@ -0,0 +1,42 @@
1
+ import { ViolationCollector } from "../validation/ViolationCollector";
2
+
3
+ /**
4
+ * Report a declared collection of a soft body that is larger than its
5
+ * budget: its path, its size and how far past the budget it runs.
6
+ *
7
+ * @param out The collector.
8
+ * @param path The collection's path.
9
+ * @param label The collection's name in the message.
10
+ * @param actual The declared size.
11
+ * @param budget The largest size admitted.
12
+ *
13
+ * @evidence contracts/development/common.md#meaningful-documentation States what is reported and with which numbers.
14
+ * @evidence contracts/development/implementation.md#principled-implementation One comparison against the stated budget.
15
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One condition, one finding.
16
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A collection at its budget passes; one past it is reported with its excess, never truncated.
17
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
18
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
19
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Writes only the caller's collector.
20
+ */
21
+ export const validateSoftBounded: (
22
+ out: ViolationCollector,
23
+ path: string,
24
+ label: string,
25
+ actual: number,
26
+ budget: number,
27
+ ) => void = (
28
+ out: ViolationCollector,
29
+ path: string,
30
+ label: string,
31
+ actual: number,
32
+ budget: number,
33
+ ): void => {
34
+ if (actual > budget)
35
+ out.push(
36
+ "range",
37
+ path,
38
+ `a soft body may declare at most ${budget} ${label}, but declared ${actual}`,
39
+ actual,
40
+ actual - budget,
41
+ );
42
+ };
@@ -0,0 +1,102 @@
1
+ import {
2
+ IAutoMovieSoftBodyDomain,
3
+ IAutoMovieSoftCompliance,
4
+ IAutoMovieSoftContact,
5
+ } from "@automovie/interface";
6
+
7
+ import { ViolationCollector } from "../validation/ViolationCollector";
8
+ import { validateSoftNumeric as numeric } from "./validateSoftNumeric";
9
+
10
+ /**
11
+ * Admit a domain's compliance and contact: every compliance finite and not
12
+ * negative, the thickness finite and positive, the friction finite and not
13
+ * negative; and, when a cord asks for self-collision, a step that cannot
14
+ * carry a segment past another unseen.
15
+ *
16
+ * A cord's self-contact is found at the end of a step, so a segment that
17
+ * travels farther than the cord's radius in one step can pass through
18
+ * another between two checks. The domain's declared design speed bounds the
19
+ * travel: `fixedStepSeconds * referenceSpeed <= thickness` is required, the
20
+ * same declared-speed premise the structural travel number rests on. Self
21
+ * collision is evaluated only on a cord, a one-wide lattice; a sheet that
22
+ * asks for it is refused, since the solver does not evaluate cloth on
23
+ * cloth.
24
+ *
25
+ * @param out The collector the domain's validation writes to.
26
+ * @param root The domain's path.
27
+ * @param domain The domain.
28
+ *
29
+ * @evidence contracts/development/common.md#meaningful-documentation States every rule, the tunnelling premise and the sheet refusal.
30
+ * @evidence contracts/development/implementation.md#principled-implementation Range checks through the shared numeric validator, and the travel bound of a discrete contact check against the cord's radius.
31
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One function the domain's validation calls, so the domain's own validator does not grow.
32
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The travel bound is a declared-speed premise, not a proof of continuous collision; it is stated as such.
33
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
34
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
35
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Writes only the caller's collector.
36
+ */
37
+ export const validateSoftCompliance: (
38
+ out: ViolationCollector,
39
+ root: string,
40
+ domain: IAutoMovieSoftBodyDomain,
41
+ ) => void = (
42
+ out: ViolationCollector,
43
+ root: string,
44
+ domain: IAutoMovieSoftBodyDomain,
45
+ ): void => {
46
+ const compliance: IAutoMovieSoftCompliance | null =
47
+ domain.solver.compliance ?? null;
48
+ if (compliance !== null)
49
+ for (const family of ["structural", "shear", "bend"] as const)
50
+ numeric(
51
+ out,
52
+ `${root}.solver.compliance.${family}`,
53
+ `${family} compliance`,
54
+ compliance[family],
55
+ 0,
56
+ false,
57
+ Infinity,
58
+ );
59
+ const contact: IAutoMovieSoftContact | null = domain.contact ?? null;
60
+ if (contact !== null) {
61
+ numeric(
62
+ out,
63
+ `${root}.contact.thickness`,
64
+ "contact thickness",
65
+ contact.thickness,
66
+ 0,
67
+ true,
68
+ Infinity,
69
+ );
70
+ numeric(
71
+ out,
72
+ `${root}.contact.friction`,
73
+ "contact friction",
74
+ contact.friction,
75
+ 0,
76
+ false,
77
+ Infinity,
78
+ );
79
+ }
80
+ if (!domain.selfCollision || contact === null) return;
81
+ const cord: boolean =
82
+ domain.lattice.columns === 1 || domain.lattice.rows === 1;
83
+ if (!cord) {
84
+ out.push(
85
+ "type",
86
+ `${root}.selfCollision`,
87
+ "self-collision is evaluated only on a cord, a one-wide lattice",
88
+ domain.selfCollision,
89
+ );
90
+ return;
91
+ }
92
+ const travel: number =
93
+ domain.solver.fixedStepSeconds * domain.solver.referenceSpeed;
94
+ if (travel > contact.thickness)
95
+ out.push(
96
+ "range",
97
+ `${root}.solver.fixedStepSeconds`,
98
+ `a cord's segment may not travel further than its radius in one step: fixedStepSeconds·referenceSpeed <= thickness (${contact.thickness}), but travels ${travel}`,
99
+ domain.solver.fixedStepSeconds,
100
+ travel - contact.thickness,
101
+ );
102
+ };