@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,84 @@
1
+ import { createRetentionLedger } from './sharedRetentionLedger.js';
2
+ /** Preserve WebGPU descriptor admission while sharing callback-free lease ownership. */
3
+ export function createWebGPURetentionPool(session, diagnostics) {
4
+ const ledger = createRetentionLedger(session, diagnostics);
5
+ function validateRequest(request) {
6
+ if (!Number.isSafeInteger(request.id) ||
7
+ request.id < 0 ||
8
+ !Number.isSafeInteger(request.byteLength) ||
9
+ request.byteLength <= 0 ||
10
+ request.byteLength % 4 !== 0)
11
+ throw new TypeError('Invalid retention request');
12
+ if (request.kind === 'buffer') {
13
+ if ((request.role !== 'vertex' && request.role !== 'index' && request.role !== 'uniform') ||
14
+ (request.usage !== 40 && request.usage !== 24 && request.usage !== 72))
15
+ throw new TypeError('Invalid buffer request');
16
+ }
17
+ else if ((request.kind !== 'color' && request.kind !== 'depth') ||
18
+ !Number.isSafeInteger(request.width) ||
19
+ !Number.isSafeInteger(request.height) ||
20
+ request.width <= 0 ||
21
+ request.height <= 0 ||
22
+ request.byteLength !== 4 * request.width * request.height ||
23
+ request.sampleCount !== 1 ||
24
+ request.mipLevelCount !== 1 ||
25
+ request.depthOrArrayLayers !== 1 ||
26
+ (request.kind === 'color'
27
+ ? request.format !== 'rgba8unorm-srgb' || request.usage !== 20 || request.recipe !== 'egret.srgb-pma8-target/1'
28
+ : request.format !== 'depth32float' ||
29
+ request.usage !== 16 ||
30
+ request.recipe !== 'egret.shared-reverse-depth/1')) {
31
+ throw new TypeError('Invalid target request');
32
+ }
33
+ }
34
+ function keyOf(value) {
35
+ return value.kind === 'buffer'
36
+ ? 'buffer:' + value.usage + ':' + value.byteLength
37
+ : value.kind +
38
+ ':' +
39
+ value.width +
40
+ ':' +
41
+ value.height +
42
+ ':' +
43
+ value.format +
44
+ ':' +
45
+ value.usage +
46
+ ':' +
47
+ value.sampleCount +
48
+ ':' +
49
+ value.mipLevelCount +
50
+ ':' +
51
+ value.depthOrArrayLayers +
52
+ ':' +
53
+ value.recipe;
54
+ }
55
+ function keyed(input) {
56
+ const request = Object.freeze({ ...input });
57
+ validateRequest(request);
58
+ return { request, key: keyOf(request) };
59
+ }
60
+ return {
61
+ plan(requests) {
62
+ ledger.assertActive();
63
+ const rows = [];
64
+ for (let i = 0; i < requests.length; i++) {
65
+ const row = keyed(requests[i]);
66
+ if (row.request.id !== i)
67
+ throw new TypeError('Nonsequential buffer request');
68
+ rows.push(row);
69
+ }
70
+ return ledger.plan(rows);
71
+ },
72
+ claim: plan => ledger.claim(plan),
73
+ registerCreated: (request, resource) => ledger.registerCreated(keyed(request), resource),
74
+ reserveReturns: leases => ledger.reserveReturns(leases),
75
+ publishReturns: plan => ledger.publishReturns(plan),
76
+ cancelReturns: plan => ledger.cancelReturns(plan),
77
+ detach: handle => ledger.detach(handle),
78
+ destroyed: (handle, succeeded) => ledger.settled(handle, succeeded ? 'destroyed' : 'unknown'),
79
+ contextInvalidated: handle => ledger.settled(handle, 'context-invalidated'),
80
+ invalidate: () => ledger.invalidate(),
81
+ detachIdleForClose: () => ledger.detachIdleForClose()
82
+ };
83
+ }
84
+ //# sourceMappingURL=webgpuRetentionPool.js.map
@@ -0,0 +1,7 @@
1
+ import type { SharedMaterial2D } from '@egret/contracts';
2
+ export declare const SHARED_BLENDS: readonly ['normal', 'add-accumulate', 'add-preserve', 'multiply-factor', 'screen', 'erase'];
3
+ /** The pipelines of a draw without a region, of a batch of one page, and of a batch of several pages. */
4
+ export declare const SHARED_PIPELINE_KINDS: readonly ['solid', 'sampled', 'paged'];
5
+ /** All shaders and promises are immediately owned by the Host's captured startup boundaries. */
6
+ export declare function createSharedWebGPUPipeline(shader: (d: GPUShaderModuleDescriptor) => GPUShaderModule, pipeline: (d: GPURenderPipelineDescriptor) => Promise<GPURenderPipeline>, kind: (typeof SHARED_PIPELINE_KINDS)[number], blend: SharedMaterial2D['blend']): Promise<GPURenderPipeline>;
7
+ //# sourceMappingURL=webgpuSharedPass.d.ts.map
@@ -0,0 +1,211 @@
1
+ export const SHARED_BLENDS = [
2
+ 'normal',
3
+ 'add-accumulate',
4
+ 'add-preserve',
5
+ 'multiply-factor',
6
+ 'screen',
7
+ 'erase'
8
+ ];
9
+ // The 128-byte block holds what is the same for every draw of a batch. `pageUnits0` and `pageUnits1` name the
10
+ // pages of the eight texture units: the index of the page in the frame, or 0xffffffff for a unit without one.
11
+ // The last two values of `viewport`, the first three of `domain` and the first two of `pageExecution` are zero:
12
+ // the opacity is in each vertex, the region in the region table, and the page's size in the region's row.
13
+ const BLOCK = `struct DrawUniform {
14
+ viewport: vec4<f32>, materialLight: vec4<f32>, materialDark: vec4<f32>,
15
+ pageUnits0: vec4<u32>, pageUnits1: vec4<u32>, domain: vec4<u32>,
16
+ samplerPolicy: vec4<u32>, pageExecution: vec4<u32>,
17
+ }
18
+ @group(0) @binding(0) var<uniform> draw: DrawUniform;
19
+ `;
20
+ const TINT = `fn tint(value: vec4<f32>, light: vec4<f32>, dark: vec3<f32>, opacity: f32) -> vec4<f32> {
21
+ let a = clamp(value.a, 0.0, 1.0);
22
+ // A numerical guard after native sampling, not a per-tap recipe change.
23
+ let p = clamp(value.rgb, vec3<f32>(0.0), vec3<f32>(a));
24
+ let v = p * light.rgb + (vec3<f32>(a) - p) * dark;
25
+ let factor = opacity * light.a * draw.materialLight.a;
26
+ return vec4<f32>(factor * (v * draw.materialLight.rgb + (vec3<f32>(a) - v) * draw.materialDark.rgb), factor * a);
27
+ }
28
+ `;
29
+ // A draw without a region has no region table to read.
30
+ const SOLID = BLOCK +
31
+ TINT +
32
+ `struct VertexOutput {
33
+ @builtin(position) position: vec4<f32>, @location(0) uv: vec2<f32>,
34
+ @location(1) light: vec4<f32>, @location(2) dark: vec3<f32>, @location(3) @interpolate(flat) opacity: f32,
35
+ }
36
+ @vertex fn vertexMain(@location(0) position: vec2<f32>, @location(1) uv: vec2<f32>,
37
+ @location(2) light: vec4<f32>, @location(3) dark: vec3<f32>, @location(4) slotOpacity: vec2<f32>) -> VertexOutput {
38
+ var result: VertexOutput;
39
+ result.position = vec4<f32>(2.0 * position.x / draw.viewport.x - 1.0,
40
+ 1.0 - 2.0 * position.y / draw.viewport.y, 0.0, 1.0);
41
+ result.uv = uv; result.light = light; result.dark = dark; result.opacity = slotOpacity.y; return result;
42
+ }
43
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4<f32> { return tint(vec4<f32>(1.0), input.light, input.dark, input.opacity); }
44
+ `;
45
+ // The vertex stage of a sampled draw reads its region from the bound window of the region table, three
46
+ // vec4<u32> for each of 341 regions, and hands it to every fragment of the triangle unchanged. The row names
47
+ // the region's page; `page` is the texture unit that holds that page, and the page's width and height.
48
+ // A batch of one page has that page in the first unit, and its pipeline looks for no other.
49
+ const header = (paged) => BLOCK +
50
+ TINT +
51
+ `struct RegionWindow { regions: array<vec4<u32>, 1023> }
52
+ @group(1) @binding(0) var<uniform> regionWindow: RegionWindow;
53
+ struct VertexOutput {
54
+ @builtin(position) position: vec4<f32>, @location(0) uv: vec2<f32>,
55
+ @location(1) light: vec4<f32>, @location(2) dark: vec3<f32>, @location(3) @interpolate(flat) opacity: f32,
56
+ @location(4) @interpolate(flat) logicalTrim: vec4<u32>, @location(5) @interpolate(flat) contentOrigin: vec4<u32>,
57
+ @location(6) @interpolate(flat) quarterTurn: u32, @location(7) @interpolate(flat) page: vec3<u32>,
58
+ }
59
+ @vertex fn vertexMain(@location(0) position: vec2<f32>, @location(1) uv: vec2<f32>,
60
+ @location(2) light: vec4<f32>, @location(3) dark: vec3<f32>, @location(4) slotOpacity: vec2<f32>) -> VertexOutput {
61
+ var result: VertexOutput;
62
+ result.position = vec4<f32>(2.0 * position.x / draw.viewport.x - 1.0,
63
+ 1.0 - 2.0 * position.y / draw.viewport.y, 0.0, 1.0);
64
+ result.uv = uv; result.light = light; result.dark = dark; result.opacity = slotOpacity.y;
65
+ let row = 3u * u32(slotOpacity.x);
66
+ result.logicalTrim = regionWindow.regions[row]; result.contentOrigin = regionWindow.regions[row + 1u];
67
+ let last = regionWindow.regions[row + 2u];
68
+ result.quarterTurn = last.x;
69
+ var unit = 0u;${paged
70
+ ? `
71
+ for (var i = 1u; i < 4u; i++) { if (draw.pageUnits0[i] == last.y) { unit = i; } }
72
+ for (var i = 0u; i < 4u; i++) { if (draw.pageUnits1[i] == last.y) { unit = i + 4u; } }`
73
+ : ''}
74
+ result.page = vec3<u32>(unit, last.zw); return result;
75
+ }
76
+ `;
77
+ // Every read of a page goes through one of these two functions. Both sample an explicit level, so neither
78
+ // needs the derivatives that only uniform control flow provides. The pipeline of a batch of one page has one
79
+ // page texture and reads it directly; the pipeline of a batch of several pages has eight and selects by unit.
80
+ const units = (read) => ` switch unit {
81
+ ${[1, 2, 3, 4, 5, 6, 7].map(unit => ` case ${unit}u: { return ${read('page' + unit)}; }`).join('\n')}
82
+ default: { return ${read('page0')}; }
83
+ }`;
84
+ const pages = (paged) => `@group(0) @binding(1) var page0: texture_2d<f32>;
85
+ @group(0) @binding(2) var pageSampler: sampler;
86
+ ${paged ? [1, 2, 3, 4, 5, 6, 7].map(unit => `@group(0) @binding(${2 + unit}) var page${unit}: texture_2d<f32>;`).join('\n') + '\n' : ''}fn pageLoad(unit: u32, at: vec2<i32>) -> vec4<f32> {
87
+ ${paged ? units(page => `textureLoad(${page}, at, 0)`) : ' return textureLoad(page0, at, 0);'}
88
+ }
89
+ fn pageSample(unit: u32, at: vec2<f32>) -> vec4<f32> {
90
+ ${paged ? units(page => `textureSampleLevel(${page}, pageSampler, at, 0.0)`) : ' return textureSampleLevel(page0, pageSampler, at, 0.0);'}
91
+ }
92
+ `;
93
+ const SAMPLED = `fn addressed(value: i32, extent: i32, mode: u32) -> i32 {
94
+ if (mode == 0u) { return clamp(value, 0, extent - 1); }
95
+ if (mode == 1u) { return ((value % extent) + extent) % extent; }
96
+ let period = 2 * extent; let index = ((value % period) + period) % period;
97
+ return select(index, period - 1 - index, index >= extent);
98
+ }
99
+ fn regionTap(logical: vec2<i32>, input: VertexOutput) -> vec4<f32> {
100
+ let index = clamp(logical, vec2<i32>(0), vec2<i32>(input.logicalTrim.xy) - vec2<i32>(1));
101
+ let local = index - vec2<i32>(input.logicalTrim.zw);
102
+ let size = vec2<i32>(input.contentOrigin.xy);
103
+ if (any(local < vec2<i32>(0)) || any(local >= size)) { return vec4<f32>(0.0); }
104
+ var packed = local;
105
+ switch input.quarterTurn {
106
+ case 1u: { packed = vec2<i32>(size.y - 1 - local.y, local.x); }
107
+ case 2u: { packed = size - vec2<i32>(1) - local; }
108
+ case 3u: { packed = vec2<i32>(local.y, size.x - 1 - local.x); }
109
+ default: {}
110
+ }
111
+ return pageLoad(input.page.x, vec2<i32>(input.contentOrigin.zw) + packed);
112
+ }
113
+ fn sampled(input: VertexOutput) -> vec4<f32> {
114
+ let uv = input.uv;
115
+ let pageSize = vec2<f32>(input.page.yz);
116
+ if (draw.domain.w == 1u) {
117
+ if (draw.samplerPolicy.z == 1u) { return pageSample(input.page.x, uv); }
118
+ let q = uv * pageSize;
119
+ let index = vec2<i32>(floor(q));
120
+ return pageLoad(input.page.x, vec2<i32>(addressed(index.x, i32(input.page.y), draw.samplerPolicy.x),
121
+ addressed(index.y, i32(input.page.z), draw.samplerPolicy.y)));
122
+ }
123
+ let extent = vec2<f32>(input.logicalTrim.xy);
124
+ // Clamp only after fragment interpolation, before any integer conversion.
125
+ let q = clamp(uv * extent, vec2<f32>(0.0), extent);
126
+ if (draw.samplerPolicy.z == 0u) { return regionTap(vec2<i32>(floor(q)), input); }
127
+ if (draw.samplerPolicy.w == 1u) {
128
+ let shifted = q - vec2<f32>(0.5); let base = vec2<i32>(floor(shifted)); let w = fract(shifted);
129
+ return mix(mix(regionTap(base, input), regionTap(base + vec2<i32>(1, 0), input), w.x),
130
+ mix(regionTap(base + vec2<i32>(0, 1), input), regionTap(base + vec2<i32>(1, 1), input), w.x), w.y);
131
+ }
132
+ let r = clamp(q, vec2<f32>(0.5), extent - vec2<f32>(0.5));
133
+ let trim = vec2<f32>(input.logicalTrim.zw); let size = vec2<f32>(input.contentOrigin.xy);
134
+ let c = clamp(r, trim + vec2<f32>(0.5), trim + size - vec2<f32>(0.5));
135
+ let coverage = min(vec2<f32>(1.0), min(max(vec2<f32>(0.0), r - trim + vec2<f32>(0.5)),
136
+ max(vec2<f32>(0.0), trim + size + vec2<f32>(0.5) - r)));
137
+ let local = c - trim; var packed = local;
138
+ switch input.quarterTurn {
139
+ case 1u: { packed = vec2<f32>(size.y - local.y, local.x); }
140
+ case 2u: { packed = size - local; }
141
+ case 3u: { packed = vec2<f32>(local.y, size.x - local.x); }
142
+ default: {}
143
+ }
144
+ return pageSample(input.page.x, (vec2<f32>(input.contentOrigin.zw) + packed) / pageSize)
145
+ * (coverage.x * coverage.y);
146
+ }
147
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4<f32> { return tint(sampled(input), input.light, input.dark, input.opacity); }
148
+ `;
149
+ function blendState(blend) {
150
+ const alpha = { operation: 'add', srcFactor: 'one', dstFactor: 'one-minus-src-alpha' };
151
+ if (blend === 'add-accumulate')
152
+ return {
153
+ color: { operation: 'add', srcFactor: 'one', dstFactor: 'one' },
154
+ alpha: { operation: 'add', srcFactor: 'one', dstFactor: 'one' }
155
+ };
156
+ // What is drawn takes away from what is there, by its alpha, and adds nothing.
157
+ if (blend === 'erase')
158
+ return {
159
+ color: { operation: 'add', srcFactor: 'zero', dstFactor: 'one-minus-src-alpha' },
160
+ alpha: { operation: 'add', srcFactor: 'zero', dstFactor: 'one-minus-src-alpha' }
161
+ };
162
+ if (blend === 'add-preserve')
163
+ return {
164
+ color: { operation: 'add', srcFactor: 'one', dstFactor: 'one' },
165
+ alpha: { operation: 'add', srcFactor: 'zero', dstFactor: 'one' }
166
+ };
167
+ return {
168
+ color: {
169
+ operation: 'add',
170
+ srcFactor: blend === 'multiply-factor' ? 'dst' : 'one',
171
+ dstFactor: blend === 'screen' ? 'one-minus-src' : 'one-minus-src-alpha'
172
+ },
173
+ alpha
174
+ };
175
+ }
176
+ /** The pipelines of a draw without a region, of a batch of one page, and of a batch of several pages. */
177
+ export const SHARED_PIPELINE_KINDS = ['solid', 'sampled', 'paged'];
178
+ /** All shaders and promises are immediately owned by the Host's captured startup boundaries. */
179
+ export function createSharedWebGPUPipeline(shader, pipeline, kind, blend) {
180
+ const module = shader({
181
+ code: kind === 'solid' ? SOLID : header(kind === 'paged') + pages(kind === 'paged') + SAMPLED
182
+ });
183
+ return pipeline({
184
+ layout: 'auto',
185
+ vertex: {
186
+ module,
187
+ entryPoint: 'vertexMain',
188
+ buffers: [
189
+ {
190
+ arrayStride: 52,
191
+ stepMode: 'vertex',
192
+ attributes: [
193
+ { shaderLocation: 0, offset: 0, format: 'float32x2' },
194
+ { shaderLocation: 1, offset: 8, format: 'float32x2' },
195
+ { shaderLocation: 2, offset: 16, format: 'float32x4' },
196
+ { shaderLocation: 3, offset: 32, format: 'float32x3' },
197
+ { shaderLocation: 4, offset: 44, format: 'float32x2' }
198
+ ]
199
+ }
200
+ ]
201
+ },
202
+ fragment: {
203
+ module,
204
+ entryPoint: 'fragmentMain',
205
+ targets: [{ format: 'rgba8unorm-srgb', writeMask: 15, blend: blendState(blend) }]
206
+ },
207
+ primitive: { topology: 'triangle-list', frontFace: 'ccw', cullMode: 'none', unclippedDepth: false },
208
+ multisample: { count: 1, alphaToCoverageEnabled: false }
209
+ });
210
+ }
211
+ //# sourceMappingURL=webgpuSharedPass.js.map
@@ -0,0 +1,3 @@
1
+ /** Integer target loads and one explicit output transfer; the canvas view is ordinary UNORM. */
2
+ export declare function createSharedResolvePipeline(shader: (d: GPUShaderModuleDescriptor) => GPUShaderModule, pipeline: (d: GPURenderPipelineDescriptor) => Promise<GPURenderPipeline>, format: 'rgba8unorm' | 'bgra8unorm', opaque: boolean): Promise<GPURenderPipeline>;
3
+ //# sourceMappingURL=webgpuSharedResolvePass.d.ts.map
@@ -0,0 +1,29 @@
1
+ /** Integer target loads and one explicit output transfer; the canvas view is ordinary UNORM. */
2
+ export function createSharedResolvePipeline(shader, pipeline, format, opaque) {
3
+ const module = shader({
4
+ code: `@group(0) @binding(0) var workingTexture: texture_2d<f32>;
5
+ fn encoded(c: vec3<f32>) -> vec3<f32> {
6
+ return select(12.92 * c, 1.055 * pow(c, vec3<f32>(1.0 / 2.4)) - vec3<f32>(0.055), c > vec3<f32>(0.0031308));
7
+ }
8
+ @vertex fn vertexMain(@builtin(vertex_index) index: u32) -> @builtin(position) vec4<f32> {
9
+ let positions = array<vec2<f32>, 3>(vec2<f32>(-1.0, -1.0), vec2<f32>(3.0, -1.0), vec2<f32>(-1.0, 3.0));
10
+ return vec4<f32>(positions[index], 0.0, 1.0);
11
+ }
12
+ @fragment fn fragmentMain(@builtin(position) position: vec4<f32>) -> @location(0) vec4<f32> {
13
+ let value = textureLoad(workingTexture, vec2<i32>(position.xy), 0);
14
+ let a = clamp(value.a, 0.0, 1.0); let c = clamp(value.rgb, vec3<f32>(0.0), vec3<f32>(a));
15
+ ` +
16
+ (opaque
17
+ ? 'return vec4<f32>(encoded(clamp(value.rgb, vec3<f32>(0.0), vec3<f32>(1.0))), 1.0);'
18
+ : 'if (a == 0.0) { return vec4<f32>(0.0); } return vec4<f32>(a * encoded(c / a), a);') +
19
+ '\n}'
20
+ });
21
+ return pipeline({
22
+ layout: 'auto',
23
+ vertex: { module, entryPoint: 'vertexMain' },
24
+ fragment: { module, entryPoint: 'fragmentMain', targets: [{ format, writeMask: 15 }] },
25
+ primitive: { topology: 'triangle-list', frontFace: 'ccw', cullMode: 'none' },
26
+ multisample: { count: 1, alphaToCoverageEnabled: false }
27
+ });
28
+ }
29
+ //# sourceMappingURL=webgpuSharedResolvePass.js.map
@@ -0,0 +1,68 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import { Object3D } from '../../rendering/world3d/Object3D.js';
3
+ export interface AudioListenerOptions3D {
4
+ /** Reuse an existing context; otherwise one is created. */
5
+ readonly context?: AudioContext;
6
+ readonly volume?: number;
7
+ }
8
+ /** Ears of the scene. Attach it to the camera (or pass the camera to update()). */
9
+ export declare class AudioListener3D extends Object3D implements Disposable {
10
+ #private;
11
+ readonly context: AudioContext;
12
+ /** Everything this listener hears passes through this gain. */
13
+ readonly output: GainNode;
14
+ constructor(options?: AudioListenerOptions3D);
15
+ get volume(): number;
16
+ set volume(value: number);
17
+ /** Browsers start audio suspended until a user gesture; call this from one. */
18
+ resume(): Promise<void>;
19
+ /** Fetch and decode a sound file into a buffer that any number of sources can share. */
20
+ load(url: string, signal?: AbortSignal): Promise<AudioBuffer>;
21
+ /** @internal */ register(source: PositionalAudio3D): void;
22
+ /** @internal */ unregister(source: PositionalAudio3D): void;
23
+ /** Copy this node's world pose to the audio listener and every source's to its panner. */
24
+ update(): void;
25
+ dispose(): void;
26
+ }
27
+ export interface PositionalAudioOptions3D {
28
+ readonly buffer?: AudioBuffer;
29
+ readonly loop?: boolean;
30
+ readonly volume?: number;
31
+ /** Distance at which the volume starts to fall. */
32
+ readonly refDistance?: number;
33
+ /** Distance beyond which the volume no longer falls ('linear': reaches zero). */
34
+ readonly maxDistance?: number;
35
+ readonly rolloffFactor?: number;
36
+ readonly distanceModel?: DistanceModelType;
37
+ /** Cone, in degrees, for directional sources pointing along the node's -Z axis. */
38
+ readonly coneInnerAngle?: number;
39
+ readonly coneOuterAngle?: number;
40
+ readonly coneOuterGain?: number;
41
+ readonly playbackRate?: number;
42
+ /** false plays without spatialization, for music and interface sounds. */
43
+ readonly spatial?: boolean;
44
+ }
45
+ /** A sound placed in the scene. Each play() starts a fresh voice; several may overlap. */
46
+ export declare class PositionalAudio3D extends Object3D implements Disposable {
47
+ #private;
48
+ readonly listener: AudioListener3D;
49
+ readonly gain: GainNode;
50
+ readonly panner: PannerNode | undefined;
51
+ buffer: AudioBuffer | undefined;
52
+ loop: boolean;
53
+ playbackRate: number;
54
+ constructor(listener: AudioListener3D, options?: PositionalAudioOptions3D);
55
+ get volume(): number;
56
+ set volume(value: number);
57
+ get isPlaying(): boolean;
58
+ /** Start a voice after `delaySeconds`, from `offsetSeconds` into the buffer. */
59
+ play(delaySeconds?: number, offsetSeconds?: number): AudioBufferSourceNode;
60
+ /** Stop every voice of this source. */
61
+ stop(): void;
62
+ /** @internal Copy the node's world pose to the panner. */
63
+ updatePanner(): void;
64
+ dispose(): void;
65
+ }
66
+ export declare function createAudioListener3D(options?: AudioListenerOptions3D): AudioListener3D;
67
+ export declare function createPositionalAudio3D(listener: AudioListener3D, options?: PositionalAudioOptions3D): PositionalAudio3D;
68
+ //# sourceMappingURL=Audio3D.d.ts.map
@@ -0,0 +1,212 @@
1
+ import { World3DError } from '../../rendering/world3d/core3D.js';
2
+ import { Object3D } from '../../rendering/world3d/Object3D.js';
3
+ /** Ears of the scene. Attach it to the camera (or pass the camera to update()). */
4
+ export class AudioListener3D extends Object3D {
5
+ context;
6
+ /** Everything this listener hears passes through this gain. */
7
+ output;
8
+ #ownsContext;
9
+ #sources = new Set();
10
+ #disposed = false;
11
+ constructor(options = {}) {
12
+ super();
13
+ const Context = globalThis.AudioContext;
14
+ if (!options.context && typeof Context !== 'function')
15
+ throw new World3DError('WORLD3D_CONTEXT_UNAVAILABLE', 'Web Audio');
16
+ this.context = options.context ?? new Context();
17
+ this.#ownsContext = !options.context;
18
+ this.output = this.context.createGain();
19
+ this.output.gain.value = options.volume ?? 1;
20
+ this.output.connect(this.context.destination);
21
+ }
22
+ get volume() {
23
+ return this.output.gain.value;
24
+ }
25
+ set volume(value) {
26
+ this.output.gain.value = Math.max(0, value);
27
+ }
28
+ /** Browsers start audio suspended until a user gesture; call this from one. */
29
+ resume() {
30
+ return this.context.state === 'suspended' ? this.context.resume() : Promise.resolve();
31
+ }
32
+ /** Fetch and decode a sound file into a buffer that any number of sources can share. */
33
+ async load(url, signal) {
34
+ let response;
35
+ try {
36
+ response = await fetch(url, signal ? { signal } : {});
37
+ }
38
+ catch (cause) {
39
+ throw new World3DError('WORLD3D_RESOURCE_FAILED', url, cause);
40
+ }
41
+ if (!response.ok)
42
+ throw new World3DError('WORLD3D_RESOURCE_FAILED', url + ' (HTTP ' + response.status + ')');
43
+ try {
44
+ return await this.context.decodeAudioData(await response.arrayBuffer());
45
+ }
46
+ catch (cause) {
47
+ throw new World3DError('WORLD3D_RESOURCE_FAILED', 'audio decode: ' + url, cause);
48
+ }
49
+ }
50
+ /** @internal */ register(source) {
51
+ this.#sources.add(source);
52
+ }
53
+ /** @internal */ unregister(source) {
54
+ this.#sources.delete(source);
55
+ }
56
+ /** Copy this node's world pose to the audio listener and every source's to its panner. */
57
+ update() {
58
+ if (this.#disposed)
59
+ return;
60
+ this.updateWorldMatrices();
61
+ const m = this.matrixWorld, listener = this.context.listener, time = this.context.currentTime;
62
+ const fx = -m[8], fy = -m[9], fz = -m[10], ux = m[4], uy = m[5], uz = m[6];
63
+ if (listener.positionX) {
64
+ listener.positionX.setValueAtTime(m[12], time);
65
+ listener.positionY.setValueAtTime(m[13], time);
66
+ listener.positionZ.setValueAtTime(m[14], time);
67
+ listener.forwardX.setValueAtTime(fx, time);
68
+ listener.forwardY.setValueAtTime(fy, time);
69
+ listener.forwardZ.setValueAtTime(fz, time);
70
+ listener.upX.setValueAtTime(ux, time);
71
+ listener.upY.setValueAtTime(uy, time);
72
+ listener.upZ.setValueAtTime(uz, time);
73
+ }
74
+ else {
75
+ // Older engines only have the setter methods.
76
+ const legacy = listener;
77
+ legacy.setPosition(m[12], m[13], m[14]);
78
+ legacy.setOrientation(fx, fy, fz, ux, uy, uz);
79
+ }
80
+ for (const source of this.#sources)
81
+ source.updatePanner();
82
+ }
83
+ dispose() {
84
+ if (this.#disposed)
85
+ return;
86
+ this.#disposed = true;
87
+ for (const source of [...this.#sources])
88
+ source.dispose();
89
+ this.output.disconnect();
90
+ if (this.#ownsContext)
91
+ void this.context.close().catch(() => undefined);
92
+ }
93
+ }
94
+ /** A sound placed in the scene. Each play() starts a fresh voice; several may overlap. */
95
+ export class PositionalAudio3D extends Object3D {
96
+ listener;
97
+ gain;
98
+ panner;
99
+ buffer;
100
+ loop;
101
+ playbackRate;
102
+ #voices = new Set();
103
+ #disposed = false;
104
+ constructor(listener, options = {}) {
105
+ super();
106
+ if (!(listener instanceof AudioListener3D))
107
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'listener');
108
+ this.listener = listener;
109
+ const context = listener.context;
110
+ this.buffer = options.buffer;
111
+ this.loop = options.loop ?? false;
112
+ this.playbackRate = options.playbackRate ?? 1;
113
+ this.gain = context.createGain();
114
+ this.gain.gain.value = options.volume ?? 1;
115
+ if (options.spatial ?? true) {
116
+ const panner = (this.panner = context.createPanner());
117
+ panner.panningModel = 'HRTF';
118
+ panner.distanceModel = options.distanceModel ?? 'inverse';
119
+ panner.refDistance = options.refDistance ?? 1;
120
+ panner.maxDistance = options.maxDistance ?? 10000;
121
+ panner.rolloffFactor = options.rolloffFactor ?? 1;
122
+ panner.coneInnerAngle = options.coneInnerAngle ?? 360;
123
+ panner.coneOuterAngle = options.coneOuterAngle ?? 360;
124
+ panner.coneOuterGain = options.coneOuterGain ?? 0;
125
+ this.gain.connect(panner);
126
+ panner.connect(listener.output);
127
+ }
128
+ else
129
+ this.gain.connect(listener.output);
130
+ listener.register(this);
131
+ }
132
+ get volume() {
133
+ return this.gain.gain.value;
134
+ }
135
+ set volume(value) {
136
+ this.gain.gain.value = Math.max(0, value);
137
+ }
138
+ get isPlaying() {
139
+ return this.#voices.size > 0;
140
+ }
141
+ /** Start a voice after `delaySeconds`, from `offsetSeconds` into the buffer. */
142
+ play(delaySeconds = 0, offsetSeconds = 0) {
143
+ if (this.#disposed)
144
+ throw new World3DError('WORLD3D_DISPOSED', 'audio');
145
+ if (!this.buffer)
146
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'audio buffer');
147
+ const context = this.listener.context, voice = context.createBufferSource();
148
+ voice.buffer = this.buffer;
149
+ voice.loop = this.loop;
150
+ voice.playbackRate.value = this.playbackRate;
151
+ voice.connect(this.gain);
152
+ voice.onended = () => {
153
+ voice.disconnect();
154
+ this.#voices.delete(voice);
155
+ };
156
+ this.#voices.add(voice);
157
+ this.updatePanner();
158
+ voice.start(context.currentTime + Math.max(0, delaySeconds), Math.max(0, offsetSeconds));
159
+ return voice;
160
+ }
161
+ /** Stop every voice of this source. */
162
+ stop() {
163
+ for (const voice of this.#voices) {
164
+ voice.onended = null;
165
+ try {
166
+ voice.stop();
167
+ }
168
+ catch {
169
+ /* not started yet */
170
+ }
171
+ voice.disconnect();
172
+ }
173
+ this.#voices.clear();
174
+ }
175
+ /** @internal Copy the node's world pose to the panner. */
176
+ updatePanner() {
177
+ const panner = this.panner;
178
+ if (!panner || this.#disposed)
179
+ return;
180
+ this.updateWorldMatrices();
181
+ const m = this.matrixWorld, time = this.listener.context.currentTime;
182
+ if (panner.positionX) {
183
+ panner.positionX.setValueAtTime(m[12], time);
184
+ panner.positionY.setValueAtTime(m[13], time);
185
+ panner.positionZ.setValueAtTime(m[14], time);
186
+ panner.orientationX.setValueAtTime(-m[8], time);
187
+ panner.orientationY.setValueAtTime(-m[9], time);
188
+ panner.orientationZ.setValueAtTime(-m[10], time);
189
+ }
190
+ else {
191
+ const legacy = panner;
192
+ legacy.setPosition(m[12], m[13], m[14]);
193
+ legacy.setOrientation(-m[8], -m[9], -m[10]);
194
+ }
195
+ }
196
+ dispose() {
197
+ if (this.#disposed)
198
+ return;
199
+ this.stop();
200
+ this.#disposed = true;
201
+ this.gain.disconnect();
202
+ this.panner?.disconnect();
203
+ this.listener.unregister(this);
204
+ }
205
+ }
206
+ export function createAudioListener3D(options = {}) {
207
+ return new AudioListener3D(options);
208
+ }
209
+ export function createPositionalAudio3D(listener, options = {}) {
210
+ return new PositionalAudio3D(listener, options);
211
+ }
212
+ //# sourceMappingURL=Audio3D.js.map