@egret/engine 0.0.0-stage → 7.0.1-rc.3

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 (575) 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 +464 -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 +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -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 +15 -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 +43 -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 +233 -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 +29 -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 +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -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 +411 -0
  57. package/dist/cameraTypes.d.ts +114 -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 +33 -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 +42 -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 +34 -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 +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -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 +134 -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 +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -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 +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -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 +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -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 +37 -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 +292 -0
  145. package/dist/particleTypes.d.ts +107 -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 +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -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 +331 -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 +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -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 +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -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 +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,473 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ import { createAudioMixer } from '@egret/engine/audio';
4
+ const LIMITER = { threshold: -6, knee: 4, ratio: 12, attack: 0.003, release: 0.16 };
5
+ /** Shorter than a click can be heard, long enough that a step in volume makes none. */
6
+ const SMOOTH = 0.005;
7
+ const gestures = ['pointerdown', 'pointerup', 'touchend', 'keydown', 'click'];
8
+ const passive = Object.freeze({ capture: true, passive: true });
9
+ const at = (line, time) => time >= line.end
10
+ ? line.to
11
+ : time <= line.start
12
+ ? line.from
13
+ : line.from + ((line.to - line.from) * (time - line.start)) / (line.end - line.start);
14
+ /**
15
+ * Sound for a page on Web Audio. A page may not sound before the person has touched it: until
16
+ * then the mixer is locked, music asked for waits, and the first touch or key lets it start.
17
+ */
18
+ export function createBrowserAudio(options = {}) {
19
+ if (options === null || typeof options !== 'object' || Array.isArray(options))
20
+ throw new EgretError('AUDIO_OPTIONS_INVALID');
21
+ const { context: given, unlockTarget, pauseWhenHidden = true, onError, limiter: limit, ...configuration } = options;
22
+ const Live = globalThis.AudioContext, page = globalThis.document;
23
+ if ((given !== undefined && (given === null || typeof given !== 'object')) ||
24
+ typeof pauseWhenHidden !== 'boolean' ||
25
+ (onError !== undefined && typeof onError !== 'function') ||
26
+ (unlockTarget !== undefined && (unlockTarget === null || typeof unlockTarget.addEventListener !== 'function')) ||
27
+ (limit !== undefined && typeof limit !== 'boolean' && (limit === null || typeof limit !== 'object')))
28
+ throw new EgretError('AUDIO_OPTIONS_INVALID');
29
+ if (given === undefined && typeof Live !== 'function')
30
+ throw new EgretError('AUDIO_HOST_UNAVAILABLE');
31
+ const context = given ?? new Live();
32
+ /** Only an output that runs in real time can be suspended, resumed and locked. */
33
+ const live = typeof Live === 'function' && context instanceof Live ? context : undefined;
34
+ const buffers = new WeakMap();
35
+ // The limiter sits between the master volume and the speakers.
36
+ let limiter;
37
+ if (limit) {
38
+ const settings = { ...LIMITER, ...(limit === true ? {} : limit) };
39
+ for (const value of Object.values(settings))
40
+ if (!Number.isFinite(value))
41
+ throw new EgretError('AUDIO_OPTIONS_INVALID');
42
+ limiter = context.createDynamicsCompressor();
43
+ limiter.threshold.value = settings.threshold;
44
+ limiter.knee.value = settings.knee;
45
+ limiter.ratio.value = settings.ratio;
46
+ limiter.attack.value = settings.attack;
47
+ limiter.release.value = settings.release;
48
+ limiter.connect(context.destination);
49
+ }
50
+ const nodes = new WeakMap();
51
+ const streams = new WeakMap();
52
+ /** The media elements that should be heard now. */
53
+ const sounding = new Set();
54
+ const pairs = [];
55
+ const armed = [];
56
+ let closed = false, desired = true, output, silent;
57
+ function report(cause) {
58
+ if (onError !== undefined)
59
+ onError(cause);
60
+ else if (typeof globalThis.reportError === 'function')
61
+ globalThis.reportError(cause);
62
+ }
63
+ function ramp(parameter, line, value, seconds) {
64
+ const time = context.currentTime;
65
+ // The first value of a gain is where it starts, not a movement.
66
+ if (line === undefined) {
67
+ parameter.value = value;
68
+ return { from: value, to: value, start: time, end: time };
69
+ }
70
+ const from = at(line, time), end = time + Math.max(seconds, SMOOTH);
71
+ parameter.cancelScheduledValues(time);
72
+ parameter.setValueAtTime(from, time);
73
+ parameter.linearRampToValueAtTime(value, end);
74
+ return { from, to: value, start: time, end };
75
+ }
76
+ function listen(list, target, type, listener) {
77
+ target.addEventListener(type, listener, passive);
78
+ list.push({ target, type, listener });
79
+ }
80
+ function unlisten(list) {
81
+ for (const pair of list.splice(0).reverse())
82
+ try {
83
+ pair.target.removeEventListener(pair.type, pair.listener, passive);
84
+ }
85
+ catch (cause) {
86
+ report(cause);
87
+ }
88
+ }
89
+ /** After the output or what is wanted of it changed: the lock of the mixer follows the output. */
90
+ function settle() {
91
+ if (closed || live === undefined)
92
+ return;
93
+ try {
94
+ follow();
95
+ if (live.state === 'running') {
96
+ unlisten(armed);
97
+ mixer.setLocked(false);
98
+ if (!desired)
99
+ live.suspend().catch(report);
100
+ }
101
+ else if (desired) {
102
+ arm();
103
+ mixer.setLocked(true);
104
+ }
105
+ }
106
+ catch (cause) {
107
+ report(cause);
108
+ }
109
+ }
110
+ /** An output that refused to start is waited for as a locked one is: the next touch asks again. */
111
+ function refused(cause) {
112
+ report(cause);
113
+ settle();
114
+ }
115
+ /** A touch or a key is what lets a page sound. A silent sample started inside it is what some phones ask for. */
116
+ const unlock = () => {
117
+ if (closed || live === undefined)
118
+ return;
119
+ try {
120
+ silent ??= live.createBuffer(1, 1, live.sampleRate);
121
+ const source = live.createBufferSource();
122
+ source.buffer = silent;
123
+ source.connect(live.destination);
124
+ source.start(0);
125
+ // A media element is let play by the touch it is started in.
126
+ if (desired)
127
+ for (const element of sounding)
128
+ if (element.paused)
129
+ element.play().catch(held);
130
+ live.resume().then(settle, refused);
131
+ }
132
+ catch (cause) {
133
+ report(cause);
134
+ }
135
+ };
136
+ function arm() {
137
+ const target = unlockTarget ?? page;
138
+ if (armed.length > 0 || target === undefined)
139
+ return;
140
+ for (const type of gestures)
141
+ listen(armed, target, type, unlock);
142
+ }
143
+ /** The way of one voice from what makes its sound to its bus: its gain, and its two sides once it leaves the middle. */
144
+ function makeStrip(input, bus, request) {
145
+ const gain = context.createGain(), time = context.currentTime;
146
+ let sides, line;
147
+ if (request.fadeIn > 0) {
148
+ gain.gain.setValueAtTime(0, time);
149
+ gain.gain.linearRampToValueAtTime(request.gain, time + request.fadeIn);
150
+ line = { from: 0, to: request.gain, start: time, end: time + request.fadeIn };
151
+ }
152
+ else
153
+ line = ramp(gain.gain, undefined, request.gain, 0);
154
+ /**
155
+ * A pan is a balance: towards one side the other side falls in a straight line, and the middle is the sound as it is.
156
+ * A voice in the middle needs no nodes for it. They are put in the first time it leaves the middle.
157
+ */
158
+ function place(pan) {
159
+ if (sides === undefined) {
160
+ if (pan === 0)
161
+ return;
162
+ const splitter = context.createChannelSplitter(2), merger = context.createChannelMerger(2), left = context.createGain(), right = context.createGain();
163
+ // One channel is heard on both sides before the sides are told apart.
164
+ gain.channelCount = 2;
165
+ gain.channelCountMode = 'explicit';
166
+ gain.channelInterpretation = 'speakers';
167
+ gain.disconnect();
168
+ gain.connect(splitter);
169
+ splitter.connect(left, 0);
170
+ splitter.connect(right, 1);
171
+ left.connect(merger, 0, 0);
172
+ right.connect(merger, 0, 1);
173
+ merger.connect(bus);
174
+ sides = { left, right, nodes: [splitter, left, right, merger] };
175
+ }
176
+ sides.left.gain.value = 1 - Math.max(0, pan);
177
+ sides.right.gain.value = 1 + Math.min(0, pan);
178
+ }
179
+ input.connect(gain);
180
+ gain.connect(bus);
181
+ place(request.pan);
182
+ return {
183
+ gain,
184
+ setGain(value, seconds) {
185
+ line = ramp(gain.gain, line, value, seconds);
186
+ },
187
+ setPan: place,
188
+ release() {
189
+ for (const node of [gain, ...(sides?.nodes ?? [])])
190
+ node.disconnect();
191
+ }
192
+ };
193
+ }
194
+ /** What a media element was refused: without a touch it waits for one; a pause that overtook it is nothing. */
195
+ function held(cause) {
196
+ const name = cause?.name;
197
+ if (name === 'NotAllowedError')
198
+ arm();
199
+ else if (name !== 'AbortError')
200
+ report(cause);
201
+ }
202
+ /** A media element keeps its own time. It is made to play while the output runs and to wait while it does not. */
203
+ function follow() {
204
+ const run = desired && (live === undefined || live.state === 'running');
205
+ for (const element of sounding) {
206
+ if (run && element.paused)
207
+ element.play().catch(held);
208
+ else if (!run && !element.paused)
209
+ element.pause();
210
+ }
211
+ }
212
+ function startStream(stream, bus, request, ended) {
213
+ const { element, node } = stream, strip = makeStrip(node, bus, request);
214
+ let over = false, timer;
215
+ function finish() {
216
+ if (over)
217
+ return;
218
+ over = true;
219
+ sounding.delete(element);
220
+ try {
221
+ element.removeEventListener('ended', finish);
222
+ element.pause();
223
+ if (timer !== undefined) {
224
+ timer.onended = null;
225
+ timer.stop();
226
+ timer.disconnect();
227
+ }
228
+ node.disconnect(strip.gain);
229
+ strip.release();
230
+ }
231
+ catch (cause) {
232
+ report(cause);
233
+ }
234
+ ended();
235
+ }
236
+ element.loop = request.loop;
237
+ element.playbackRate = request.rate;
238
+ // A rate is speed and pitch together, as it is for a decoded sound.
239
+ if ('preservesPitch' in element)
240
+ element.preservesPitch = false;
241
+ if (element.currentTime !== request.offset)
242
+ element.currentTime = request.offset;
243
+ element.addEventListener('ended', finish);
244
+ sounding.add(element);
245
+ follow();
246
+ return {
247
+ setGain: strip.setGain,
248
+ setRate(value) {
249
+ element.playbackRate = value;
250
+ },
251
+ setPan: strip.setPan,
252
+ stop(seconds) {
253
+ if (over)
254
+ return;
255
+ if (seconds <= 0) {
256
+ finish();
257
+ return;
258
+ }
259
+ // The end of a fade is a time on the clock of the output: a silent source that stops then tells it.
260
+ silent ??= context.createBuffer(1, 1, context.sampleRate);
261
+ timer = context.createBufferSource();
262
+ timer.buffer = silent;
263
+ timer.loop = true;
264
+ timer.connect(context.destination);
265
+ timer.onended = finish;
266
+ timer.start(0);
267
+ timer.stop(context.currentTime + seconds);
268
+ },
269
+ position: () => element.currentTime
270
+ };
271
+ }
272
+ const backend = {
273
+ get time() {
274
+ return context.currentTime;
275
+ },
276
+ async decode(bytes) {
277
+ // Decoding takes the buffer it is given away from its owner: it is given a copy.
278
+ const copy = bytes.slice().buffer;
279
+ const buffer = await new Promise((resolve, reject) => {
280
+ const result = context.decodeAudioData(copy, resolve, reject);
281
+ if (result !== undefined && typeof result.then === 'function')
282
+ result.then(resolve, reject);
283
+ });
284
+ const sound = {
285
+ duration: buffer.duration,
286
+ channels: buffer.numberOfChannels,
287
+ sampleRate: buffer.sampleRate,
288
+ release() {
289
+ buffers.delete(sound);
290
+ }
291
+ };
292
+ buffers.set(sound, buffer);
293
+ return sound;
294
+ },
295
+ async openStream(url) {
296
+ const Element = globalThis.Audio;
297
+ if (typeof Element !== 'function' || live === undefined)
298
+ throw new EgretError('AUDIO_HOST_UNAVAILABLE');
299
+ const element = new Element();
300
+ element.preload = 'auto';
301
+ // A file of another origin is asked for in the way that lets its samples into the graph, or not at all.
302
+ element.crossOrigin = 'anonymous';
303
+ await new Promise((resolve, reject) => {
304
+ const done = () => {
305
+ element.removeEventListener('loadedmetadata', loaded);
306
+ element.removeEventListener('error', failed);
307
+ };
308
+ const loaded = () => {
309
+ done();
310
+ resolve();
311
+ };
312
+ const failed = () => {
313
+ done();
314
+ reject(element.error ?? new EgretError('AUDIO_STREAM_FAILED'));
315
+ };
316
+ element.addEventListener('loadedmetadata', loaded);
317
+ element.addEventListener('error', failed);
318
+ element.src = url;
319
+ });
320
+ const node = live.createMediaElementSource(element);
321
+ const sound = {
322
+ duration: element.duration,
323
+ channels: node.channelCount,
324
+ sampleRate: live.sampleRate,
325
+ streamed: true,
326
+ release() {
327
+ streams.delete(sound);
328
+ sounding.delete(element);
329
+ element.pause();
330
+ element.removeAttribute('src');
331
+ element.load();
332
+ node.disconnect();
333
+ }
334
+ };
335
+ streams.set(sound, { element, node });
336
+ return sound;
337
+ },
338
+ createBus(parent) {
339
+ const node = context.createGain(), target = parent === undefined ? (limiter ?? context.destination) : nodes.get(parent);
340
+ if (target === undefined)
341
+ throw new EgretError('AUDIO_BACKEND_FAILED');
342
+ node.connect(target);
343
+ output ??= node;
344
+ let line;
345
+ const bus = {
346
+ setGain(value, seconds) {
347
+ line = ramp(node.gain, line, value, seconds);
348
+ },
349
+ release() {
350
+ nodes.delete(bus);
351
+ node.disconnect();
352
+ }
353
+ };
354
+ nodes.set(bus, node);
355
+ return bus;
356
+ },
357
+ start(request, ended) {
358
+ const bus = nodes.get(request.bus), stream = streams.get(request.sound);
359
+ if (bus === undefined)
360
+ throw new EgretError('AUDIO_BACKEND_FAILED');
361
+ if (stream !== undefined)
362
+ return startStream(stream, bus, request, ended);
363
+ const buffer = buffers.get(request.sound);
364
+ if (buffer === undefined)
365
+ throw new EgretError('AUDIO_BACKEND_FAILED');
366
+ const source = context.createBufferSource(), strip = makeStrip(source, bus, request);
367
+ let over = false;
368
+ source.buffer = buffer;
369
+ source.loop = request.loop;
370
+ source.playbackRate.value = request.rate;
371
+ source.onended = () => {
372
+ if (over)
373
+ return;
374
+ over = true;
375
+ source.onended = null;
376
+ try {
377
+ source.disconnect();
378
+ strip.release();
379
+ }
380
+ catch (cause) {
381
+ report(cause);
382
+ }
383
+ ended();
384
+ };
385
+ source.start(0, request.offset);
386
+ return {
387
+ setGain: strip.setGain,
388
+ setRate(value) {
389
+ source.playbackRate.value = value;
390
+ },
391
+ setPan: strip.setPan,
392
+ stop(seconds) {
393
+ if (over)
394
+ return;
395
+ source.stop(seconds > 0 ? context.currentTime + seconds : 0);
396
+ }
397
+ };
398
+ },
399
+ suspend() {
400
+ desired = false;
401
+ follow();
402
+ if (live !== undefined && live.state === 'running')
403
+ live.suspend().catch(report);
404
+ },
405
+ resume() {
406
+ desired = true;
407
+ follow();
408
+ // Asked even of an output that still runs: a suspension on its way would otherwise be the last word.
409
+ if (live !== undefined)
410
+ live.resume().then(settle, refused);
411
+ },
412
+ close() {
413
+ if (closed)
414
+ return;
415
+ closed = true;
416
+ unlisten(armed);
417
+ unlisten(pairs);
418
+ limiter?.disconnect();
419
+ if (live !== undefined && given === undefined)
420
+ live.close().catch(report);
421
+ }
422
+ };
423
+ let mixer;
424
+ try {
425
+ mixer = createAudioMixer({ ...configuration, backend, locked: live !== undefined && live.state !== 'running' });
426
+ }
427
+ catch (cause) {
428
+ if (live !== undefined && given === undefined)
429
+ live.close().catch(report);
430
+ throw cause;
431
+ }
432
+ if (live !== undefined) {
433
+ try {
434
+ listen(pairs, live, 'statechange', settle);
435
+ if (pauseWhenHidden && page !== undefined) {
436
+ const visibility = () => {
437
+ try {
438
+ if (page.visibilityState === 'hidden')
439
+ mixer.suspend('hidden');
440
+ else
441
+ mixer.resume('hidden');
442
+ }
443
+ catch (cause) {
444
+ report(cause);
445
+ }
446
+ };
447
+ listen(pairs, page, 'visibilitychange', visibility);
448
+ if (page.visibilityState === 'hidden')
449
+ mixer.suspend('hidden');
450
+ }
451
+ if (live.state !== 'running')
452
+ arm();
453
+ }
454
+ catch (cause) {
455
+ try {
456
+ mixer.dispose();
457
+ }
458
+ catch {
459
+ /* the first failure is the one told */
460
+ }
461
+ throw cause;
462
+ }
463
+ }
464
+ return Object.freeze({
465
+ mixer,
466
+ context,
467
+ output: output,
468
+ dispose() {
469
+ mixer.dispose();
470
+ }
471
+ });
472
+ }
473
+ //# sourceMappingURL=BrowserAudio.js.map
@@ -0,0 +1,65 @@
1
+ /** What the loop asks of an Engine: its clock's limit, time and frames. `F` is what `renderSharedFrame` takes. */
2
+ export interface FrameLoopEngine<F> {
3
+ readonly clock: {
4
+ readonly maxDeltaSeconds: number;
5
+ };
6
+ advanceTime(sourceSeconds: number): unknown;
7
+ renderSharedFrame(options: F): unknown;
8
+ }
9
+ /** What the loop asks of a Host: how many frames it holds that it has not finished. Both shared Hosts have it. */
10
+ export interface FrameLoopHost {
11
+ getStatus(): {
12
+ readonly pendingFrames: number;
13
+ };
14
+ }
15
+ export interface BrowserFrameLoopOptions<F> {
16
+ readonly engine: FrameLoopEngine<F>;
17
+ /** The frame to draw: its size and clear colour. A function is called for each frame that is drawn. */
18
+ readonly frame: F | (() => F);
19
+ /** The Host the Engine draws with. With it, a frame is skipped while the Host holds `maxPendingFrames`, instead of being refused. */
20
+ readonly host?: FrameLoopHost;
21
+ /** How many unfinished frames a Host takes; 2, as both shared Hosts take unless they are made with another number. */
22
+ readonly maxPendingFrames?: number;
23
+ /** One step of the game, called before each frame with the seconds since the step before: 0 at first, never more than `maxStepSeconds`. */
24
+ readonly update?: (deltaSeconds: number) => void;
25
+ /** The longest step, in seconds. A tab that was hidden comes back with one step of this length. Defaults to 0.1, and is never more than the Engine's clock takes. */
26
+ readonly maxStepSeconds?: number;
27
+ /**
28
+ * How much of a long gap is played back. A frame that took longer than `maxStepSeconds` is given as several
29
+ * steps of at most that length, up to this many seconds in all, before one frame is drawn; the rest of the gap
30
+ * is dropped. 0, the default, gives one step of the longest length, so a slow device plays slower instead of
31
+ * jumping. A tab that comes back from being hidden still loses the time it was hidden beyond this.
32
+ */
33
+ readonly catchUpSeconds?: number;
34
+ /** Told once of what stopped the loop. Without it the failure is thrown from the display's callback, where the console shows it. */
35
+ readonly onError?: (error: unknown) => void;
36
+ /** The display's frame callback and its cancellation; `requestAnimationFrame` and `cancelAnimationFrame` by default. */
37
+ readonly requestFrame?: (callback: (milliseconds: number) => void) => number;
38
+ readonly cancelFrame?: (handle: number) => void;
39
+ }
40
+ export type BrowserFrameLoopState = 'idle' | 'running' | 'failed' | 'closed';
41
+ export interface BrowserFrameLoopSnapshot {
42
+ readonly state: BrowserFrameLoopState;
43
+ /** Steps taken, frames drawn, and frames skipped because the Host was busy. */
44
+ readonly steps: number;
45
+ readonly frames: number;
46
+ readonly skipped: number;
47
+ /** The seconds of game time the loop has given the Engine's clock. */
48
+ readonly seconds: number;
49
+ readonly failure: unknown;
50
+ }
51
+ export interface BrowserFrameLoop {
52
+ readonly state: BrowserFrameLoopState;
53
+ /** Starts, or starts again after `stop`. The time spent stopped is not played back. */
54
+ start(): void;
55
+ stop(): void;
56
+ snapshot(): BrowserFrameLoopSnapshot;
57
+ dispose(): void;
58
+ }
59
+ /**
60
+ * The frame loop of a game in a page. On each frame the display shows, it advances the Engine's clock, which moves
61
+ * tweens and sequences, calls `update`, and draws one frame. It keeps a step short after the page was hidden, and it
62
+ * skips a frame, without failing, while the Host has not finished the frames it holds.
63
+ */
64
+ export declare function createBrowserFrameLoop<F>(options: BrowserFrameLoopOptions<F>): BrowserFrameLoop;
65
+ //# sourceMappingURL=BrowserFrameLoop.d.ts.map
@@ -0,0 +1,125 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const invalid = () => new EgretError('FRAME_LOOP_OPTIONS_INVALID');
4
+ const backpressure = (error) => {
5
+ const cause = error?.cause;
6
+ return typeof cause?.code === 'string' && cause.code.endsWith('_BACKPRESSURE');
7
+ };
8
+ /**
9
+ * The frame loop of a game in a page. On each frame the display shows, it advances the Engine's clock, which moves
10
+ * tweens and sequences, calls `update`, and draws one frame. It keeps a step short after the page was hidden, and it
11
+ * skips a frame, without failing, while the Host has not finished the frames it holds.
12
+ */
13
+ export function createBrowserFrameLoop(options) {
14
+ if (options === null || typeof options !== 'object')
15
+ throw invalid();
16
+ const { engine, frame, host, update, onError } = options, limit = options.maxPendingFrames ?? 2;
17
+ const request = options.requestFrame ?? ((callback) => requestAnimationFrame(callback));
18
+ const cancel = options.cancelFrame ?? ((handle) => cancelAnimationFrame(handle));
19
+ if (engine === null ||
20
+ typeof engine !== 'object' ||
21
+ typeof engine.advanceTime !== 'function' ||
22
+ typeof engine.renderSharedFrame !== 'function' ||
23
+ frame === undefined ||
24
+ frame === null ||
25
+ (host !== undefined && (host === null || typeof host !== 'object' || typeof host.getStatus !== 'function')) ||
26
+ !Number.isSafeInteger(limit) ||
27
+ limit < 1 ||
28
+ (update !== undefined && typeof update !== 'function') ||
29
+ (onError !== undefined && typeof onError !== 'function') ||
30
+ typeof request !== 'function' ||
31
+ typeof cancel !== 'function')
32
+ throw invalid();
33
+ const clockLimit = engine.clock?.maxDeltaSeconds, asked = options.maxStepSeconds ?? 0.1, catchUp = options.catchUpSeconds ?? 0;
34
+ if (typeof clockLimit !== 'number' ||
35
+ !(clockLimit > 0) ||
36
+ typeof asked !== 'number' ||
37
+ !(asked > 0) ||
38
+ typeof catchUp !== 'number' ||
39
+ !(catchUp >= 0) ||
40
+ !Number.isFinite(catchUp))
41
+ throw invalid();
42
+ const maxStep = Math.min(asked, clockLimit);
43
+ // Steps of one long frame are capped too, so a stalled page cannot spend a frame catching up forever.
44
+ const maxStepsPerFrame = Math.max(1, Math.ceil(Math.max(catchUp, maxStep) / maxStep));
45
+ let state = 'idle', handle, last;
46
+ let seconds = 0, steps = 0, frames = 0, skipped = 0, failure;
47
+ const tick = (milliseconds) => {
48
+ handle = undefined;
49
+ if (state !== 'running')
50
+ return;
51
+ try {
52
+ // The clock is given the loop's own seconds, which never jump. A long gap counts as one step of the longest
53
+ // length, or, with catchUpSeconds, as several such steps up to that much time.
54
+ const gap = last === undefined ? 0 : Math.max(0, (milliseconds - last) / 1000);
55
+ last = milliseconds;
56
+ let owed = catchUp > 0 ? Math.min(gap, Math.max(catchUp, maxStep)) : Math.min(gap, maxStep);
57
+ for (let step = 0; step < maxStepsPerFrame; step++) {
58
+ const delta = Math.min(maxStep, owed);
59
+ owed -= delta;
60
+ seconds += delta;
61
+ engine.advanceTime(seconds);
62
+ steps++;
63
+ update?.(delta);
64
+ // The update may have stopped or disposed the loop.
65
+ if (state !== 'running')
66
+ return;
67
+ if (!(owed > 1e-9))
68
+ break;
69
+ }
70
+ if (host !== undefined && host.getStatus().pendingFrames >= limit)
71
+ skipped++;
72
+ else {
73
+ try {
74
+ engine.renderSharedFrame(typeof frame === 'function' ? frame() : frame);
75
+ frames++;
76
+ }
77
+ catch (error) {
78
+ if (host !== undefined || !backpressure(error))
79
+ throw error;
80
+ skipped++;
81
+ }
82
+ }
83
+ handle = request(tick);
84
+ }
85
+ catch (error) {
86
+ state = 'failed';
87
+ failure = error;
88
+ if (onError === undefined)
89
+ throw error;
90
+ onError(error);
91
+ }
92
+ };
93
+ const stop = () => {
94
+ if (handle !== undefined) {
95
+ cancel(handle);
96
+ handle = undefined;
97
+ }
98
+ if (state === 'running')
99
+ state = 'idle';
100
+ };
101
+ const loop = {
102
+ get state() {
103
+ return state;
104
+ },
105
+ start() {
106
+ if (state === 'closed')
107
+ throw new EgretError('FRAME_LOOP_CLOSED');
108
+ if (state === 'running')
109
+ return;
110
+ // What stopped the loop is forgotten when it is started again; the gap since it ran is not a step.
111
+ state = 'running';
112
+ failure = undefined;
113
+ last = undefined;
114
+ handle = request(tick);
115
+ },
116
+ stop,
117
+ snapshot: () => Object.freeze({ state, steps, frames, skipped, seconds, failure }),
118
+ dispose() {
119
+ stop();
120
+ state = 'closed';
121
+ }
122
+ };
123
+ return Object.freeze(loop);
124
+ }
125
+ //# sourceMappingURL=BrowserFrameLoop.js.map