@egret/engine 0.0.0-stage → 7.0.2

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 (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,503 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Ropes and simple cloth: points joined by links of fixed length, moved by their
3
+ // own momentum and gravity and then pulled back to their link lengths. They are
4
+ // for dressing a scene - a flag, a cape, a hanging cable - not for carrying loads:
5
+ // points follow bodies they are pinned to and slide off simple colliders, but they
6
+ // do not push anything back. DOM-free and backend-independent.
7
+ import { World3DError, requireCount3D, requireFinite3D, requirePositive3D } from './core3D.js';
8
+ import { Attribute3D, Geometry3D } from './Geometry3D.js';
9
+ import { Mesh3D } from './Mesh3D.js';
10
+ /** The most points and colliders cloth and ropes hold. */
11
+ export const CLOTH3D_LIMITS = Object.freeze({ maxPoints: 16384, maxColliders: 32 });
12
+ /** Points and links shared by ropes and cloth. */
13
+ class Strands3D {
14
+ /** World positions, three numbers per point. Read them freely; write through setPoint(). */
15
+ points;
16
+ gravity = new Float32Array([0, -9.81, 0]);
17
+ /** A steady push on every free point, as an acceleration: wind. */
18
+ wind = new Float32Array(3);
19
+ damping;
20
+ iterations;
21
+ thickness;
22
+ friction;
23
+ colliders = [];
24
+ #previous;
25
+ #free;
26
+ #pins = [];
27
+ #links = new Int32Array(0);
28
+ #lengths = new Float32Array(0);
29
+ #linkCount = 0;
30
+ constructor(count, options) {
31
+ requireCount3D(count, 'points', CLOTH3D_LIMITS.maxPoints);
32
+ this.points = new Float32Array(count * 3);
33
+ this.#previous = new Float32Array(count * 3);
34
+ this.#free = new Uint8Array(count).fill(1);
35
+ if (options.gravity)
36
+ this.gravity.set(options.gravity);
37
+ this.damping = requireFinite3D(options.damping ?? 0.6, 'damping');
38
+ this.iterations = Math.min(Math.max(Math.floor(options.iterations ?? 8), 1), 64);
39
+ this.thickness = requireFinite3D(options.thickness ?? 0.02, 'thickness');
40
+ this.friction = requireFinite3D(options.friction ?? 0.3, 'friction');
41
+ if (this.damping < 0 || this.thickness < 0 || this.friction < 0 || this.friction > 1)
42
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'strand options');
43
+ if (options.colliders) {
44
+ if (options.colliders.length > CLOTH3D_LIMITS.maxColliders)
45
+ throw new World3DError('WORLD3D_BUDGET', 'colliders');
46
+ this.colliders.push(...options.colliders);
47
+ }
48
+ }
49
+ get pointCount() {
50
+ return this.points.length / 3;
51
+ }
52
+ get linkCount() {
53
+ return this.#linkCount;
54
+ }
55
+ /** @internal Place a point and forget its motion. */
56
+ place(index, x, y, z) {
57
+ const o = index * 3;
58
+ this.points[o] = this.#previous[o] = x;
59
+ this.points[o + 1] = this.#previous[o + 1] = y;
60
+ this.points[o + 2] = this.#previous[o + 2] = z;
61
+ }
62
+ /** @internal Join two points at the distance they are apart now. */
63
+ link(a, b) {
64
+ if (this.#linkCount * 2 >= this.#links.length) {
65
+ const links = new Int32Array(Math.max(64, this.#links.length * 2)), lengths = new Float32Array(links.length / 2);
66
+ links.set(this.#links);
67
+ lengths.set(this.#lengths);
68
+ this.#links = links;
69
+ this.#lengths = lengths;
70
+ }
71
+ const p = this.points;
72
+ this.#links[this.#linkCount * 2] = a;
73
+ this.#links[this.#linkCount * 2 + 1] = b;
74
+ this.#lengths[this.#linkCount++] = Math.hypot(p[a * 3] - p[b * 3], p[a * 3 + 1] - p[b * 3 + 1], p[a * 3 + 2] - p[b * 3 + 2]);
75
+ }
76
+ check(index) {
77
+ if (!Number.isInteger(index) || index < 0 || index >= this.pointCount)
78
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'point index');
79
+ return index;
80
+ }
81
+ /** Move a point and stop it; a pinned point is held at the new place. */
82
+ setPoint(index, x, y, z) {
83
+ this.place(this.check(index), requireFinite3D(x, 'x'), requireFinite3D(y, 'y'), requireFinite3D(z, 'z'));
84
+ for (const pin of this.#pins)
85
+ if (pin.index === index && !pin.body) {
86
+ pin.x = x;
87
+ pin.y = y;
88
+ pin.z = z;
89
+ }
90
+ }
91
+ /**
92
+ * Hold a point where it is now. With a body, the point keeps its place on
93
+ * that body and follows it as the body moves and turns. The pin is one-way:
94
+ * the cloth or rope follows the body and never pulls on it, so a tarp on a
95
+ * truck does not slow the truck.
96
+ */
97
+ pinPoint(index, body) {
98
+ this.check(index);
99
+ this.unpinPoint(index);
100
+ const o = index * 3, p = this.points;
101
+ let x = p[o], y = p[o + 1], z = p[o + 2];
102
+ if (body) {
103
+ const r = body.rotation, dx = x - body.position[0], dy = y - body.position[1], dz = z - body.position[2];
104
+ x = r[0] * dx + r[3] * dy + r[6] * dz;
105
+ y = r[1] * dx + r[4] * dy + r[7] * dz;
106
+ z = r[2] * dx + r[5] * dy + r[8] * dz;
107
+ }
108
+ this.#pins.push({ index, body, x, y, z });
109
+ this.#free[index] = 0;
110
+ }
111
+ unpinPoint(index) {
112
+ this.check(index);
113
+ const at = this.#pins.findIndex(pin => pin.index === index);
114
+ if (at >= 0)
115
+ this.#pins.splice(at, 1);
116
+ this.#free[index] = 1;
117
+ }
118
+ isPinned(index) {
119
+ return this.#free[this.check(index)] === 0;
120
+ }
121
+ /** @internal Advance the points by one update. */
122
+ advance(deltaSeconds) {
123
+ const dt = Math.min(Math.max(requireFinite3D(deltaSeconds, 'deltaSeconds'), 0), 1 / 20);
124
+ if (dt === 0)
125
+ return;
126
+ const p = this.points, previous = this.#previous, free = this.#free, count = this.pointCount, keep = Math.max(1 - this.damping * dt, 0);
127
+ const ax = (this.gravity[0] + this.wind[0]) * dt * dt, ay = (this.gravity[1] + this.wind[1]) * dt * dt, az = (this.gravity[2] + this.wind[2]) * dt * dt;
128
+ for (let i = 0; i < count; i++) {
129
+ if (!free[i])
130
+ continue;
131
+ const o = i * 3, x = p[o], y = p[o + 1], z = p[o + 2];
132
+ // Each point carries on as it was going, slowed a little, and falls.
133
+ p[o] = x + (x - previous[o]) * keep + ax;
134
+ p[o + 1] = y + (y - previous[o + 1]) * keep + ay;
135
+ p[o + 2] = z + (z - previous[o + 2]) * keep + az;
136
+ previous[o] = x;
137
+ previous[o + 1] = y;
138
+ previous[o + 2] = z;
139
+ }
140
+ for (const pin of this.#pins) {
141
+ const o = pin.index * 3, body = pin.body;
142
+ if (body) {
143
+ const r = body.rotation;
144
+ p[o] = body.position[0] + r[0] * pin.x + r[1] * pin.y + r[2] * pin.z;
145
+ p[o + 1] = body.position[1] + r[3] * pin.x + r[4] * pin.y + r[5] * pin.z;
146
+ p[o + 2] = body.position[2] + r[6] * pin.x + r[7] * pin.y + r[8] * pin.z;
147
+ }
148
+ else {
149
+ p[o] = pin.x;
150
+ p[o + 1] = pin.y;
151
+ p[o + 2] = pin.z;
152
+ }
153
+ previous[o] = p[o];
154
+ previous[o + 1] = p[o + 1];
155
+ previous[o + 2] = p[o + 2];
156
+ }
157
+ const links = this.#links, lengths = this.#lengths, linkCount = this.#linkCount;
158
+ for (let iteration = 0; iteration < this.iterations; iteration++) {
159
+ for (let i = 0; i < linkCount; i++) {
160
+ const a = links[i * 2], b = links[i * 2 + 1], fa = free[a], fb = free[b];
161
+ if (!fa && !fb)
162
+ continue;
163
+ const oa = a * 3, ob = b * 3, dx = p[ob] - p[oa], dy = p[ob + 1] - p[oa + 1], dz = p[ob + 2] - p[oa + 2], length = Math.hypot(dx, dy, dz);
164
+ if (length < 1e-9)
165
+ continue;
166
+ // Bring the pair back to its length; a held end leaves all of the move to the other.
167
+ const error = (length - lengths[i]) / length / (fa + fb);
168
+ if (fa) {
169
+ p[oa] += dx * error;
170
+ p[oa + 1] += dy * error;
171
+ p[oa + 2] += dz * error;
172
+ }
173
+ if (fb) {
174
+ p[ob] -= dx * error;
175
+ p[ob + 1] -= dy * error;
176
+ p[ob + 2] -= dz * error;
177
+ }
178
+ }
179
+ if (this.colliders.length > 0)
180
+ for (let i = 0; i < count; i++)
181
+ if (free[i])
182
+ this.collide(i);
183
+ }
184
+ }
185
+ collide(index) {
186
+ const p = this.points, previous = this.#previous, o = index * 3, gap = this.thickness;
187
+ for (const body of this.colliders) {
188
+ const shape = body.shape, c = body.position, r = body.rotation;
189
+ let nx = 0, ny = 0, nz = 0, depth = 0;
190
+ const x = p[o] - c[0], y = p[o + 1] - c[1], z = p[o + 2] - c[2];
191
+ if (shape.type === 'plane') {
192
+ nx = r[1];
193
+ ny = r[4];
194
+ nz = r[7];
195
+ depth = gap - (x * nx + y * ny + z * nz);
196
+ }
197
+ else if (shape.type === 'sphere' || shape.type === 'capsule') {
198
+ // The nearest place on the capsule's core line, or the sphere's center.
199
+ let along = 0;
200
+ if (shape.type === 'capsule')
201
+ along = Math.min(Math.max(x * r[1] + y * r[4] + z * r[7], -shape.halfHeight), shape.halfHeight);
202
+ const dx = x - r[1] * along, dy = y - r[4] * along, dz = z - r[7] * along, distance = Math.hypot(dx, dy, dz);
203
+ depth = shape.radius + gap - distance;
204
+ if (depth > 0) {
205
+ if (distance > 1e-9) {
206
+ nx = dx / distance;
207
+ ny = dy / distance;
208
+ nz = dz / distance;
209
+ }
210
+ else
211
+ ny = 1;
212
+ }
213
+ }
214
+ else if (shape.type === 'box') {
215
+ const h = shape.halfExtents, lx = r[0] * x + r[3] * y + r[6] * z, ly = r[1] * x + r[4] * y + r[7] * z, lz = r[2] * x + r[5] * y + r[8] * z;
216
+ const ex = h[0] + gap - Math.abs(lx), ey = h[1] + gap - Math.abs(ly), ez = h[2] + gap - Math.abs(lz);
217
+ if (ex > 0 && ey > 0 && ez > 0) {
218
+ // Leave through the nearest face.
219
+ let fx = 0, fy = 0, fz = 0;
220
+ if (ex <= ey && ex <= ez) {
221
+ depth = ex;
222
+ fx = Math.sign(lx) || 1;
223
+ }
224
+ else if (ey <= ez) {
225
+ depth = ey;
226
+ fy = Math.sign(ly) || 1;
227
+ }
228
+ else {
229
+ depth = ez;
230
+ fz = Math.sign(lz) || 1;
231
+ }
232
+ nx = r[0] * fx + r[1] * fy + r[2] * fz;
233
+ ny = r[3] * fx + r[4] * fy + r[5] * fz;
234
+ nz = r[6] * fx + r[7] * fy + r[8] * fz;
235
+ }
236
+ }
237
+ else
238
+ continue;
239
+ if (!(depth > 0))
240
+ continue;
241
+ p[o] += nx * depth;
242
+ p[o + 1] += ny * depth;
243
+ p[o + 2] += nz * depth;
244
+ // Rubbing against the surface takes away some of the slide.
245
+ const grip = this.friction;
246
+ previous[o] = previous[o] + (p[o] - previous[o]) * grip;
247
+ previous[o + 1] = previous[o + 1] + (p[o + 1] - previous[o + 1]) * grip;
248
+ previous[o + 2] = previous[o + 2] + (p[o + 2] - previous[o + 2]) * grip;
249
+ }
250
+ }
251
+ }
252
+ /** A rope or cable. Call update() once per frame, after the bodies it is pinned to have moved. */
253
+ export class Rope3D extends Strands3D {
254
+ segments;
255
+ /** Total length along the links at rest. */
256
+ length;
257
+ #mesh;
258
+ #radius = 0;
259
+ #sides = 0;
260
+ constructor(options) {
261
+ if (!options || !options.start || !options.end)
262
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'rope ends');
263
+ const segments = Math.floor(options.segments ?? 16);
264
+ if (!(segments >= 1))
265
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'rope segments');
266
+ super(segments + 1, options);
267
+ this.segments = segments;
268
+ const [ax, ay, az] = options.start, [bx, by, bz] = options.end, slack = requireFinite3D(options.slack ?? 0, 'slack');
269
+ if (slack < 0)
270
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'slack');
271
+ // Lay the points out at the link length, then bring them between the ends; a slack rope starts bunched and falls into its curve.
272
+ const straight = Math.hypot(bx - ax, by - ay, bz - az), spread = 1 + slack;
273
+ for (let i = 0; i <= segments; i++) {
274
+ const t = (i / segments) * spread;
275
+ this.place(i, ax + (bx - ax) * t, ay + (by - ay) * t, az + (bz - az) * t);
276
+ }
277
+ for (let i = 0; i < segments; i++)
278
+ this.link(i, i + 1);
279
+ this.length = straight * spread;
280
+ for (let i = 0; i <= segments; i++) {
281
+ const t = i / segments;
282
+ this.place(i, ax + (bx - ax) * t, ay + (by - ay) * t, az + (bz - az) * t);
283
+ }
284
+ if (options.pinStart)
285
+ this.pinPoint(0, options.pinStart === true ? undefined : options.pinStart);
286
+ if (options.pinEnd)
287
+ this.pinPoint(segments, options.pinEnd === true ? undefined : options.pinEnd);
288
+ }
289
+ /**
290
+ * A tube along the rope, rebuilt by update(). `radius` is its thickness and
291
+ * `sides` the number of faces around it.
292
+ */
293
+ createMesh(material, radius = 0.03, sides = 6) {
294
+ requirePositive3D(radius, 'radius');
295
+ if (!Number.isInteger(sides) || sides < 3 || sides > 32)
296
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'sides');
297
+ const rings = this.pointCount, geometry = new Geometry3D(), positions = new Attribute3D(new Float32Array(rings * sides * 3), 3), normals = new Attribute3D(new Float32Array(rings * sides * 3), 3);
298
+ positions.dynamic = true;
299
+ normals.dynamic = true;
300
+ const uvs = new Float32Array(rings * sides * 2), indices = [];
301
+ for (let ring = 0; ring < rings; ring++)
302
+ for (let s = 0; s < sides; s++) {
303
+ uvs[(ring * sides + s) * 2] = s / sides;
304
+ uvs[(ring * sides + s) * 2 + 1] = ring / (rings - 1);
305
+ }
306
+ for (let ring = 0; ring < rings - 1; ring++)
307
+ for (let s = 0; s < sides; s++) {
308
+ const a = ring * sides + s, b = ring * sides + ((s + 1) % sides), c = a + sides, d = b + sides;
309
+ indices.push(a, c, b, b, c, d);
310
+ }
311
+ geometry.setAttribute('position', positions);
312
+ geometry.setAttribute('normal', normals);
313
+ geometry.setAttribute('uv', new Attribute3D(uvs, 2));
314
+ geometry.setIndex(rings * sides > 65535 ? Uint32Array.from(indices) : Uint16Array.from(indices));
315
+ this.#mesh = new Mesh3D(geometry, material);
316
+ this.#radius = radius;
317
+ this.#sides = sides;
318
+ // The points are in world space, so the mesh must not be moved by a parent.
319
+ this.#mesh.frustumCulled = true;
320
+ this.rebuild();
321
+ return this.#mesh;
322
+ }
323
+ get mesh() {
324
+ return this.#mesh;
325
+ }
326
+ update(deltaSeconds) {
327
+ this.advance(deltaSeconds);
328
+ this.rebuild();
329
+ }
330
+ rebuild() {
331
+ const mesh = this.#mesh;
332
+ if (!mesh)
333
+ return;
334
+ const p = this.points, rings = this.pointCount, sides = this.#sides, radius = this.#radius;
335
+ const position = mesh.geometry.getAttribute('position'), normal = mesh.geometry.getAttribute('normal'), out = position.data, n = normal.data;
336
+ // A side direction carried from ring to ring, turned as little as the rope bends, keeps the tube from twisting.
337
+ let ux = 0, uy = 0, uz = 0;
338
+ for (let ring = 0; ring < rings; ring++) {
339
+ const before = Math.max(ring - 1, 0) * 3, after = Math.min(ring + 1, rings - 1) * 3;
340
+ let tx = p[after] - p[before], ty = p[after + 1] - p[before + 1], tz = p[after + 2] - p[before + 2];
341
+ const size = Math.hypot(tx, ty, tz) || 1;
342
+ tx /= size;
343
+ ty /= size;
344
+ tz /= size;
345
+ if (ring === 0) {
346
+ if (Math.abs(ty) < 0.9) {
347
+ ux = 0;
348
+ uy = 1;
349
+ uz = 0;
350
+ }
351
+ else {
352
+ ux = 1;
353
+ uy = 0;
354
+ uz = 0;
355
+ }
356
+ }
357
+ const along = ux * tx + uy * ty + uz * tz;
358
+ ux -= tx * along;
359
+ uy -= ty * along;
360
+ uz -= tz * along;
361
+ const length = Math.hypot(ux, uy, uz) || 1;
362
+ ux /= length;
363
+ uy /= length;
364
+ uz /= length;
365
+ const vx = ty * uz - tz * uy, vy = tz * ux - tx * uz, vz = tx * uy - ty * ux, o = ring * 3;
366
+ for (let s = 0; s < sides; s++) {
367
+ const angle = (s / sides) * Math.PI * 2, cos = Math.cos(angle), sin = Math.sin(angle), at = (ring * sides + s) * 3;
368
+ const nx = ux * cos + vx * sin, ny = uy * cos + vy * sin, nz = uz * cos + vz * sin;
369
+ n[at] = nx;
370
+ n[at + 1] = ny;
371
+ n[at + 2] = nz;
372
+ out[at] = p[o] + nx * radius;
373
+ out[at + 1] = p[o + 1] + ny * radius;
374
+ out[at + 2] = p[o + 2] + nz * radius;
375
+ }
376
+ }
377
+ position.touch();
378
+ normal.touch();
379
+ mesh.geometry.invalidateBounds();
380
+ }
381
+ }
382
+ /** A rectangular sheet. Call update() once per frame, after the bodies it is pinned to have moved. */
383
+ export class Cloth3D extends Strands3D {
384
+ columns;
385
+ rows;
386
+ #mesh;
387
+ constructor(options) {
388
+ const columns = Math.floor(options?.columns ?? 0), rows = Math.floor(options?.rows ?? 0);
389
+ if (!(columns >= 2) || !(rows >= 2) || !options.origin || !options.right || !options.down)
390
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'cloth grid');
391
+ super(columns * rows, options);
392
+ this.columns = columns;
393
+ this.rows = rows;
394
+ const o = options.origin, r = options.right, d = options.down;
395
+ for (let row = 0; row < rows; row++)
396
+ for (let column = 0; column < columns; column++) {
397
+ const u = column / (columns - 1), v = row / (rows - 1);
398
+ this.place(row * columns + column, o[0] + r[0] * u + d[0] * v, o[1] + r[1] * u + d[1] * v, o[2] + r[2] * u + d[2] * v);
399
+ }
400
+ const stiff = options.stiff ?? true;
401
+ for (let row = 0; row < rows; row++)
402
+ for (let column = 0; column < columns; column++) {
403
+ const i = row * columns + column;
404
+ // Along the weave, across the diagonals, and - for stiffness - to the next point but one.
405
+ if (column + 1 < columns)
406
+ this.link(i, i + 1);
407
+ if (row + 1 < rows)
408
+ this.link(i, i + columns);
409
+ if (column + 1 < columns && row + 1 < rows) {
410
+ this.link(i, i + columns + 1);
411
+ this.link(i + 1, i + columns);
412
+ }
413
+ if (stiff && column + 2 < columns)
414
+ this.link(i, i + 2);
415
+ if (stiff && row + 2 < rows)
416
+ this.link(i, i + columns * 2);
417
+ }
418
+ }
419
+ /** Index of the point at a column and row. */
420
+ indexOf(column, row) {
421
+ if (!Number.isInteger(column) ||
422
+ !Number.isInteger(row) ||
423
+ column < 0 ||
424
+ row < 0 ||
425
+ column >= this.columns ||
426
+ row >= this.rows)
427
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'cloth point');
428
+ return row * this.columns + column;
429
+ }
430
+ /** Hold the point at a column and row where it is, or on a body. */
431
+ pin(column, row, body) {
432
+ this.pinPoint(this.indexOf(column, row), body);
433
+ }
434
+ unpin(column, row) {
435
+ this.unpinPoint(this.indexOf(column, row));
436
+ }
437
+ /** A mesh of the sheet, rebuilt by update(). Draw it with a double-sided material to see both faces. */
438
+ createMesh(material) {
439
+ const columns = this.columns, rows = this.rows, count = columns * rows, geometry = new Geometry3D();
440
+ const positions = new Attribute3D(new Float32Array(count * 3), 3), normals = new Attribute3D(new Float32Array(count * 3), 3), uvs = new Float32Array(count * 2), indices = [];
441
+ positions.dynamic = true;
442
+ normals.dynamic = true;
443
+ for (let row = 0; row < rows; row++)
444
+ for (let column = 0; column < columns; column++) {
445
+ uvs[(row * columns + column) * 2] = column / (columns - 1);
446
+ uvs[(row * columns + column) * 2 + 1] = row / (rows - 1);
447
+ }
448
+ for (let row = 0; row < rows - 1; row++)
449
+ for (let column = 0; column < columns - 1; column++) {
450
+ const a = row * columns + column, b = a + 1, c = a + columns, d = c + 1;
451
+ indices.push(a, c, b, b, c, d);
452
+ }
453
+ geometry.setAttribute('position', positions);
454
+ geometry.setAttribute('normal', normals);
455
+ geometry.setAttribute('uv', new Attribute3D(uvs, 2));
456
+ geometry.setIndex(count > 65535 ? Uint32Array.from(indices) : Uint16Array.from(indices));
457
+ this.#mesh = new Mesh3D(geometry, material);
458
+ this.rebuild();
459
+ return this.#mesh;
460
+ }
461
+ get mesh() {
462
+ return this.#mesh;
463
+ }
464
+ update(deltaSeconds) {
465
+ this.advance(deltaSeconds);
466
+ this.rebuild();
467
+ }
468
+ rebuild() {
469
+ const mesh = this.#mesh;
470
+ if (!mesh)
471
+ return;
472
+ const p = this.points, columns = this.columns, rows = this.rows;
473
+ const position = mesh.geometry.getAttribute('position'), normal = mesh.geometry.getAttribute('normal'), n = normal.data;
474
+ position.data.set(p);
475
+ for (let row = 0; row < rows; row++)
476
+ for (let column = 0; column < columns; column++) {
477
+ // The normal at a point is across its neighbours along the row and down the column.
478
+ const left = (row * columns + Math.max(column - 1, 0)) * 3, right = (row * columns + Math.min(column + 1, columns - 1)) * 3;
479
+ const up = (Math.max(row - 1, 0) * columns + column) * 3, below = (Math.min(row + 1, rows - 1) * columns + column) * 3;
480
+ const ax = p[right] - p[left], ay = p[right + 1] - p[left + 1], az = p[right + 2] - p[left + 2], bx = p[below] - p[up], by = p[below + 1] - p[up + 1], bz = p[below + 2] - p[up + 2];
481
+ let nx = by * az - bz * ay, ny = bz * ax - bx * az, nz = bx * ay - by * ax;
482
+ const size = Math.hypot(nx, ny, nz) || 1, at = (row * columns + column) * 3;
483
+ nx /= size;
484
+ ny /= size;
485
+ nz /= size;
486
+ n[at] = nx;
487
+ n[at + 1] = ny;
488
+ n[at + 2] = nz;
489
+ }
490
+ position.touch();
491
+ normal.touch();
492
+ mesh.geometry.invalidateBounds();
493
+ }
494
+ }
495
+ /** Makes a rope of points that hangs and swings. */
496
+ export function createRope3D(options) {
497
+ return new Rope3D(options);
498
+ }
499
+ /** Makes a sheet of cloth that hangs, folds and blows. */
500
+ export function createCloth3D(options) {
501
+ return new Cloth3D(options);
502
+ }
503
+ //# sourceMappingURL=Cloth3D.js.map
@@ -0,0 +1,22 @@
1
+ /** The most bytes a decompression gives. */
2
+ export declare const COMPRESSION3D_LIMITS: Readonly<{
3
+ readonly maxOutputBytes: 536870912;
4
+ }>;
5
+ /**
6
+ * Decompress a zlib stream, or a bare deflate stream when `raw` is set.
7
+ * `sizeHint` is the expected output length when known.
8
+ */
9
+ export declare function inflate3D(source: Uint8Array, options?: {
10
+ readonly raw?: boolean;
11
+ readonly sizeHint?: number;
12
+ readonly maxBytes?: number;
13
+ }): Uint8Array;
14
+ /**
15
+ * Decompress Zstandard data: one or more frames, including skippable ones.
16
+ * Frames that need a dictionary are refused.
17
+ */
18
+ export declare function decompressZstd3D(source: Uint8Array, options?: {
19
+ readonly sizeHint?: number;
20
+ readonly maxBytes?: number;
21
+ }): Uint8Array;
22
+ //# sourceMappingURL=Compression3D.d.ts.map