@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,300 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { decodeSRGBByte } from './srgbBytes.js';
3
+ import { DisplayObjectContainer, EgretError, Mesh2D } from '@egret/runtime';
4
+ import { createTexturedGeometry2D } from '@egret/contracts';
5
+ const finite = (value) => typeof value === 'number' && Number.isFinite(value);
6
+ const linear = decodeSRGBByte;
7
+ const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
8
+ function range(value, otherwise, least = -Infinity) {
9
+ if (value === undefined)
10
+ return otherwise;
11
+ const pair = typeof value === 'number'
12
+ ? [value, value]
13
+ : Array.isArray(value) && value.length === 2
14
+ ? [value[0], value[1]]
15
+ : undefined;
16
+ if (pair === undefined || !finite(pair[0]) || !finite(pair[1]) || pair[0] > pair[1] || pair[0] < least)
17
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
18
+ return pair;
19
+ }
20
+ const colour = (value, otherwise) => {
21
+ if (value === undefined)
22
+ return otherwise;
23
+ if (!Number.isSafeInteger(value) || value < 0 || value > 0xffffff)
24
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
25
+ return value;
26
+ };
27
+ const unit = (value, otherwise) => {
28
+ if (value === undefined)
29
+ return otherwise;
30
+ if (!finite(value) || value < 0 || value > 1)
31
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
32
+ return value;
33
+ };
34
+ const mix = (a, b, t) => a + (b - a) * t;
35
+ const channel = (rgb, shift) => ((rgb >> shift) & 255) / 255;
36
+ /** A stream of particles over one texture, drawn as one mesh that is built again each update. */
37
+ export function createParticleEmitter(options) {
38
+ if (!record(options))
39
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
40
+ const o = options;
41
+ const maxParticles = o.maxParticles ?? 512, rate = o.rate ?? 50, drag = o.drag ?? 0, seed0 = o.seed ?? 1, running0 = o.running ?? true, duration = o.duration;
42
+ if (!Number.isSafeInteger(maxParticles) ||
43
+ maxParticles < 1 ||
44
+ maxParticles > 16384 ||
45
+ !finite(rate) ||
46
+ rate < 0 ||
47
+ !finite(drag) ||
48
+ drag < 0 ||
49
+ !Number.isSafeInteger(seed0) ||
50
+ typeof running0 !== 'boolean' ||
51
+ (duration !== undefined && (!finite(duration) || duration <= 0)))
52
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
53
+ const lifetime = range(o.lifetime, [1, 1], Number.MIN_VALUE), speed = range(o.speed, [100, 100]), angle = range(o.angle, [0, 360]);
54
+ const startScale = range(o.startScale, [1, 1], 0), endScale = range(o.endScale, [1, 1], 0), rotation0 = range(o.rotation, [0, 0]), spin = range(o.spin, [0, 0]);
55
+ const startAlpha = unit(o.startAlpha, 1), endAlpha = unit(o.endAlpha, 0), startColor = colour(o.startColor, 0xffffff), endColor = colour(o.endColor, 0xffffff);
56
+ const gravity = o.gravity ?? { x: 0, y: 0 };
57
+ if (!record(gravity) || !finite(gravity.x) || !finite(gravity.y))
58
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
59
+ const size = o.size ?? 8, width = typeof size === 'number' ? size : record(size) ? size.width : NaN, height = typeof size === 'number' ? size : record(size) ? size.height : NaN;
60
+ if (!finite(width) || !finite(height) || width <= 0 || height <= 0)
61
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
62
+ const shape = o.shape ?? { kind: 'point' };
63
+ if (!record(shape) ||
64
+ !(shape.kind === 'point' ||
65
+ (shape.kind === 'rectangle' &&
66
+ finite(shape.width) &&
67
+ finite(shape.height) &&
68
+ shape.width >= 0 &&
69
+ shape.height >= 0) ||
70
+ (shape.kind === 'circle' &&
71
+ finite(shape.radius) &&
72
+ shape.radius >= 0 &&
73
+ (shape.edge === undefined || typeof shape.edge === 'boolean'))))
74
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
75
+ const lease = o.texture;
76
+ // A particle is a row of these columns: place, speed, age, life, and what it was born with.
77
+ const STRIDE = 12, X = 0, Y = 1, VX = 2, VY = 3, AGE = 4, LIFE = 5, S0 = 6, S1 = 7, R0 = 8, SPIN = 9;
78
+ const data = new Float64Array(maxParticles * STRIDE);
79
+ let alive = 0, born = 0, refused = 0, time = 0, debt = 0, running = running0, closed = false, x = 0, y = 0;
80
+ let state = seed0 | 0 || 1;
81
+ /** A seeded generator: the same seed, the same particles. */
82
+ const random = () => {
83
+ state = (state + 0x6d2b79f5) | 0;
84
+ let t = Math.imul(state ^ (state >>> 15), 1 | state);
85
+ t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
86
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
87
+ };
88
+ const pick = (pair) => (pair[0] === pair[1] ? pair[0] : mix(pair[0], pair[1], random()));
89
+ const display = new DisplayObjectContainer();
90
+ if (o.blendMode !== undefined) {
91
+ try {
92
+ display.blendMode = o.blendMode;
93
+ }
94
+ catch {
95
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
96
+ }
97
+ }
98
+ let mesh;
99
+ function spawn(count) {
100
+ for (let n = 0; n < count; n++) {
101
+ if (alive >= maxParticles) {
102
+ refused++;
103
+ continue;
104
+ }
105
+ let px = x, py = y;
106
+ if (shape.kind === 'rectangle') {
107
+ px += (random() - 0.5) * shape.width;
108
+ py += (random() - 0.5) * shape.height;
109
+ }
110
+ else if (shape.kind === 'circle') {
111
+ // Even over the area of the circle, or on its edge alone.
112
+ const a = random() * Math.PI * 2, r = shape.edge === true ? shape.radius : shape.radius * Math.sqrt(random());
113
+ px += Math.cos(a) * r;
114
+ py += Math.sin(a) * r;
115
+ }
116
+ const direction = (pick(angle) * Math.PI) / 180, v = pick(speed), at = alive * STRIDE;
117
+ data[at + X] = px;
118
+ data[at + Y] = py;
119
+ data[at + VX] = Math.cos(direction) * v;
120
+ data[at + VY] = Math.sin(direction) * v;
121
+ data[at + AGE] = 0;
122
+ data[at + LIFE] = pick(lifetime);
123
+ data[at + S0] = pick(startScale);
124
+ data[at + S1] = pick(endScale);
125
+ data[at + R0] = pick(rotation0);
126
+ data[at + SPIN] = pick(spin);
127
+ alive++;
128
+ born++;
129
+ }
130
+ }
131
+ function view(at) {
132
+ const t = Math.min(1, data[at + AGE] / data[at + LIFE]);
133
+ const r = mix(channel(startColor, 16), channel(endColor, 16), t), g = mix(channel(startColor, 8), channel(endColor, 8), t), b = mix(channel(startColor, 0), channel(endColor, 0), t);
134
+ return Object.freeze({
135
+ x: data[at + X],
136
+ y: data[at + Y],
137
+ vx: data[at + VX],
138
+ vy: data[at + VY],
139
+ age: t,
140
+ scale: mix(data[at + S0], data[at + S1], t),
141
+ alpha: mix(startAlpha, endAlpha, t),
142
+ color: (Math.round(r * 255) << 16) | (Math.round(g * 255) << 8) | Math.round(b * 255),
143
+ rotation: data[at + R0] + data[at + SPIN] * data[at + AGE]
144
+ });
145
+ }
146
+ /** The mesh is built again from the particles alive; with none it is hidden and keeps what it had. */
147
+ function draw() {
148
+ if (alive === 0) {
149
+ if (mesh !== undefined)
150
+ mesh.visible = false;
151
+ return;
152
+ }
153
+ const positions = new Float64Array(alive * 8), uvs = new Float64Array(alive * 8), lightColors = new Float64Array(alive * 16), indices = new Uint32Array(alive * 6);
154
+ for (let i = 0; i < alive; i++) {
155
+ const p = view(i * STRIDE), hw = (width * p.scale) / 2, hh = (height * p.scale) / 2, a = (p.rotation * Math.PI) / 180, cos = Math.cos(a), sin = Math.sin(a);
156
+ const corners = [
157
+ [-hw, -hh],
158
+ [hw, -hh],
159
+ [hw, hh],
160
+ [-hw, hh]
161
+ ];
162
+ corners.forEach(([cx, cy], k) => {
163
+ positions[i * 8 + k * 2] = p.x + cx * cos - cy * sin;
164
+ positions[i * 8 + k * 2 + 1] = p.y + cx * sin + cy * cos;
165
+ });
166
+ uvs.set([0, 0, 1, 0, 1, 1, 0, 1], i * 8);
167
+ // The colour as it is seen, in the linear light the renderer multiplies a texture by, so that white shows as the colour given.
168
+ const r = linear((p.color >> 16) & 255), g = linear((p.color >> 8) & 255), b = linear(p.color & 255);
169
+ for (let k = 0; k < 4; k++)
170
+ lightColors.set([r, g, b, p.alpha], i * 16 + k * 4);
171
+ indices.set([i * 4, i * 4 + 1, i * 4 + 2, i * 4, i * 4 + 2, i * 4 + 3], i * 6);
172
+ }
173
+ const geometry = createTexturedGeometry2D({ positions, uvs, lightColors, indices });
174
+ if (mesh === undefined) {
175
+ mesh = new Mesh2D(lease, geometry);
176
+ display.addChild(mesh);
177
+ }
178
+ else {
179
+ mesh.setContent(lease, geometry);
180
+ mesh.visible = true;
181
+ }
182
+ }
183
+ const open = () => {
184
+ if (closed)
185
+ throw new EgretError('PARTICLE_CLOSED');
186
+ };
187
+ function place(value) {
188
+ if (!finite(value))
189
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
190
+ return value;
191
+ }
192
+ return Object.freeze({
193
+ get state() {
194
+ return closed ? 'closed' : 'active';
195
+ },
196
+ display,
197
+ get x() {
198
+ return x;
199
+ },
200
+ set x(value) {
201
+ x = place(value);
202
+ },
203
+ get y() {
204
+ return y;
205
+ },
206
+ set y(value) {
207
+ y = place(value);
208
+ },
209
+ get running() {
210
+ return running;
211
+ },
212
+ get alive() {
213
+ return alive;
214
+ },
215
+ start() {
216
+ open();
217
+ running = true;
218
+ },
219
+ stop() {
220
+ running = false;
221
+ },
222
+ burst(count) {
223
+ if (!Number.isSafeInteger(count) || count < 0)
224
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
225
+ open();
226
+ spawn(count);
227
+ draw();
228
+ },
229
+ clear() {
230
+ open();
231
+ alive = 0;
232
+ debt = 0;
233
+ draw();
234
+ },
235
+ update(seconds) {
236
+ if (!finite(seconds) || seconds < 0)
237
+ throw new EgretError('PARTICLE_OPTIONS_INVALID');
238
+ open();
239
+ const damp = Math.exp(-drag * seconds);
240
+ // Age and move what is alive; a particle that dies takes the place of the last one.
241
+ for (let i = 0; i < alive;) {
242
+ const at = i * STRIDE;
243
+ data[at + AGE] += seconds;
244
+ if (data[at + AGE] >= data[at + LIFE]) {
245
+ alive--;
246
+ data.copyWithin(at, alive * STRIDE, alive * STRIDE + STRIDE);
247
+ continue;
248
+ }
249
+ data[at + VX] = (data[at + VX] + gravity.x * seconds) * damp;
250
+ data[at + VY] = (data[at + VY] + gravity.y * seconds) * damp;
251
+ data[at + X] += data[at + VX] * seconds;
252
+ data[at + Y] += data[at + VY] * seconds;
253
+ i++;
254
+ }
255
+ if (running) {
256
+ // The time left of a run that has a duration is all that is emitted for.
257
+ const span = duration === undefined ? seconds : Math.max(0, Math.min(seconds, duration - time));
258
+ debt += rate * span;
259
+ // A sum of steps that should reach a whole particle may fall short of it by the last bit of a float.
260
+ const count = Math.floor(debt + 1e-9);
261
+ debt = Math.max(0, debt - count);
262
+ spawn(count);
263
+ if (duration !== undefined && time + seconds >= duration)
264
+ running = false;
265
+ }
266
+ time += seconds;
267
+ draw();
268
+ },
269
+ particles() {
270
+ return Object.freeze(Array.from({ length: alive }, (_, i) => view(i * STRIDE)));
271
+ },
272
+ snapshot() {
273
+ return Object.freeze({ alive, born, refused, running, time });
274
+ },
275
+ dispose() {
276
+ if (closed)
277
+ return;
278
+ closed = true;
279
+ running = false;
280
+ alive = 0;
281
+ const failures = [];
282
+ try {
283
+ mesh?.dispose();
284
+ }
285
+ catch (cause) {
286
+ failures.push(cause);
287
+ }
288
+ try {
289
+ display.dispose();
290
+ }
291
+ catch (cause) {
292
+ failures.push(cause);
293
+ }
294
+ mesh = undefined;
295
+ if (failures.length > 0)
296
+ throw new EgretError('PARTICLE_CLEANUP_FAILED', { cause: failures[0], cleanupErrors: failures.slice(1) });
297
+ }
298
+ });
299
+ }
300
+ //# sourceMappingURL=particleEmitter.js.map
@@ -0,0 +1,115 @@
1
+ import type { AssetLease, DisplayObjectContainer, Texture } from '@egret/runtime';
2
+ /** A value picked once for each particle, evenly between the two ends; a number is both ends. */
3
+ export type ParticleRange = number | readonly [number, number];
4
+ /** Where particles are born, around the place of the emitter. */
5
+ export type ParticleShape = {
6
+ readonly kind: 'point';
7
+ } | {
8
+ readonly kind: 'rectangle';
9
+ readonly width: number;
10
+ readonly height: number;
11
+ } | {
12
+ readonly kind: 'circle';
13
+ readonly radius: number;
14
+ readonly edge?: boolean;
15
+ };
16
+ /** An emitter to make: its texture and how many particles, and how they are born, move, grow, fade and turn. */
17
+ export interface ParticleEmitterOptions {
18
+ /** The image of each particle: the whole of the texture. */
19
+ readonly texture: AssetLease<Texture>;
20
+ /** The most particles alive at once, 1 to 16384. Defaults to 512. */
21
+ readonly maxParticles?: number;
22
+ /** Particles born each second while the emitter runs. Defaults to 50. */
23
+ readonly rate?: number;
24
+ /** Seconds a particle lives. Defaults to 1. */
25
+ readonly lifetime?: ParticleRange;
26
+ /** Units a second. Defaults to 100. */
27
+ readonly speed?: ParticleRange;
28
+ /** Degrees of the direction a particle sets off in; 0 is right, 90 down. Defaults to [0, 360]. */
29
+ readonly angle?: ParticleRange;
30
+ /** Units a second, every second, across and down. Defaults to none. */
31
+ readonly gravity?: {
32
+ readonly x: number;
33
+ readonly y: number;
34
+ };
35
+ /** How much of its speed a particle loses each second, as a rate: 0 none. Defaults to 0. */
36
+ readonly drag?: number;
37
+ /** The width and height of a particle in units at the scale of 1. Defaults to 8. */
38
+ readonly size?: number | {
39
+ readonly width: number;
40
+ readonly height: number;
41
+ };
42
+ /** The scale a particle is born with and dies with. Default to 1. */
43
+ readonly startScale?: ParticleRange;
44
+ readonly endScale?: ParticleRange;
45
+ /** The alpha it is born with and dies with. Default to 1 and 0. */
46
+ readonly startAlpha?: number;
47
+ readonly endAlpha?: number;
48
+ /** The tint it is born with and dies with, as 0xRRGGBB. Default to white. */
49
+ readonly startColor?: number;
50
+ readonly endColor?: number;
51
+ /** Degrees it is born turned by, and turns by each second. Default to 0. */
52
+ readonly rotation?: ParticleRange;
53
+ readonly spin?: ParticleRange;
54
+ readonly shape?: ParticleShape;
55
+ /** The same seed gives the same particles for the same updates. Defaults to 1. */
56
+ readonly seed?: number;
57
+ /** Whether it starts running. Defaults to true. */
58
+ readonly running?: boolean;
59
+ /** Seconds after which it stops by itself. Defaults to running until stopped. */
60
+ readonly duration?: number;
61
+ /**
62
+ * How the particles are combined with what is under them, as `DisplayObject.blendMode`: `add` for glows and sparks.
63
+ * Defaults to `normal`. The same as setting `blendMode` on `emitter.display` after it is made.
64
+ */
65
+ readonly blendMode?: 'normal' | 'add' | 'multiply' | 'screen' | 'erase';
66
+ }
67
+ /** An emitter as it is now: how many particles live, were born and were refused, and its time. */
68
+ export interface ParticleSnapshot {
69
+ readonly alive: number;
70
+ readonly born: number;
71
+ /** Particles that could not be born because the most were alive. */
72
+ readonly refused: number;
73
+ readonly running: boolean;
74
+ readonly time: number;
75
+ }
76
+ /** One live particle: where it is and how fast it moves, its age, scale, alpha, color and rotation. */
77
+ export interface ParticleView {
78
+ readonly x: number;
79
+ readonly y: number;
80
+ readonly vx: number;
81
+ readonly vy: number;
82
+ /** 0 when born, 1 when it dies. */
83
+ readonly age: number;
84
+ readonly scale: number;
85
+ readonly alpha: number;
86
+ readonly color: number;
87
+ readonly rotation: number;
88
+ }
89
+ /**
90
+ * Particles drawn as one mesh. Put `display` in the world; the emitter is a place inside it, and a
91
+ * particle stays where it was born when the emitter moves. It keeps no clock: `update` moves it.
92
+ */
93
+ export interface ParticleEmitter {
94
+ readonly state: 'active' | 'closed';
95
+ readonly display: DisplayObjectContainer;
96
+ /** The place particles are born around. */
97
+ x: number;
98
+ y: number;
99
+ readonly running: boolean;
100
+ readonly alive: number;
101
+ start(): void;
102
+ /** Stops new particles; those alive live out their lives. */
103
+ stop(): void;
104
+ /** Makes this many particles at once, running or not. */
105
+ burst(count: number): void;
106
+ /** Takes every particle away at once. */
107
+ clear(): void;
108
+ update(seconds: number): void;
109
+ /** Each particle alive, in the order they are drawn. For checks and tools. */
110
+ particles(): readonly ParticleView[];
111
+ snapshot(): ParticleSnapshot;
112
+ /** Takes the mesh off the display and lets go of it. A scope can own an emitter through this. */
113
+ dispose(): void;
114
+ }
115
+ //# sourceMappingURL=particleTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=particleTypes.js.map
@@ -0,0 +1,4 @@
1
+ /** Optional 2D particles: emitters drawn as one mesh each, moved by the time a game gives them. */
2
+ export { createParticleEmitter } from './particleEmitter.js';
3
+ export type { ParticleEmitter, ParticleEmitterOptions, ParticleRange, ParticleShape, ParticleSnapshot, ParticleView } from './particleTypes.js';
4
+ //# sourceMappingURL=particles.d.ts.map
@@ -0,0 +1,4 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ /** Optional 2D particles: emitters drawn as one mesh each, moved by the time a game gives them. */
3
+ export { createParticleEmitter } from './particleEmitter.js';
4
+ //# sourceMappingURL=particles.js.map
@@ -0,0 +1,4 @@
1
+ /** Optional 2D collision and simple physics: bodies without turning, distance and rope joints, queries, and character movement. */
2
+ export { createPhysicsWorld } from './physics2dWorld.js';
3
+ export type { PhysicsBody, PhysicsBodyKind, PhysicsBodyOptions, PhysicsContact, PhysicsJoint, PhysicsJointOptions, PhysicsMoveResult, PhysicsRayHit, PhysicsShape, PhysicsSnapshot, PhysicsTileColliders, PhysicsVector, PhysicsWorld, PhysicsWorldOptions } from './physics2dTypes.js';
4
+ //# sourceMappingURL=physics2d.d.ts.map
@@ -0,0 +1,4 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ /** Optional 2D collision and simple physics: bodies without turning, distance and rope joints, queries, and character movement. */
3
+ export { createPhysicsWorld } from './physics2dWorld.js';
4
+ //# sourceMappingURL=physics2d.js.map
@@ -0,0 +1,39 @@
1
+ import type { PhysicsShape, PhysicsVector } from './physics2dTypes.js';
2
+ export interface Placed {
3
+ readonly kind: 'circle' | 'polygon';
4
+ readonly x: number;
5
+ readonly y: number;
6
+ readonly radius: number;
7
+ readonly points: Float64Array;
8
+ }
9
+ export interface Box {
10
+ readonly minX: number;
11
+ readonly minY: number;
12
+ readonly maxX: number;
13
+ readonly maxY: number;
14
+ }
15
+ /** How two shapes meet: the normal from the first to the second, and how far they reach into each other. */
16
+ export interface Meeting {
17
+ readonly nx: number;
18
+ readonly ny: number;
19
+ readonly depth: number;
20
+ }
21
+ /** A shape in the world, at a place and a turn: a circle, or the corners of a convex polygon. */
22
+ export declare function place(shape: PhysicsShape, x: number, y: number, degrees: number): Placed;
23
+ export declare function boxOf(shape: Placed): Box;
24
+ export declare const boxesMeet: (a: Box, b: Box) => boolean;
25
+ /** The area of a shape, for the mass of a body. */
26
+ export declare function areaOf(shape: PhysicsShape): number;
27
+ /** Whether points make a convex polygon of some area, in either turning. */
28
+ export declare function convex(points: readonly PhysicsVector[]): boolean;
29
+ /** Whether two shapes meet, by separating axes; when they do, the shortest way out of each other. */
30
+ export declare function meet(a: Placed, b: Placed): Meeting | undefined;
31
+ /** Whether a point is inside a shape, its edge included. */
32
+ export declare function holds(shape: Placed, x: number, y: number): boolean;
33
+ /** Where a segment from (x0, y0) by (dx, dy) first meets a shape it starts outside of: the fraction along it and the normal there. */
34
+ export declare function cast(shape: Placed, x0: number, y0: number, dx: number, dy: number): {
35
+ readonly t: number;
36
+ readonly nx: number;
37
+ readonly ny: number;
38
+ } | undefined;
39
+ //# sourceMappingURL=physics2dGeometry.d.ts.map