@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,568 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const failures = new WeakSet();
4
+ export function glFailure(code, cause) {
5
+ const failure = new EgretError(code, { cause });
6
+ failures.add(failure);
7
+ return failure;
8
+ }
9
+ export function isGLFailure(value) {
10
+ return typeof value === 'object' && value !== null && failures.has(value);
11
+ }
12
+ const METHODS = [
13
+ 'getContextAttributes',
14
+ 'getError',
15
+ 'isContextLost',
16
+ 'getParameter',
17
+ 'getShaderPrecisionFormat',
18
+ 'getFramebufferAttachmentParameter',
19
+ 'checkFramebufferStatus',
20
+ 'bindFramebuffer',
21
+ 'bindBuffer',
22
+ 'bufferData',
23
+ 'bufferSubData',
24
+ 'getBufferSubData',
25
+ 'readPixels',
26
+ 'shaderSource',
27
+ 'attachShader',
28
+ 'getShaderParameter',
29
+ 'getProgramParameter',
30
+ 'getShaderInfoLog',
31
+ 'getProgramInfoLog',
32
+ 'getUniformBlockIndex',
33
+ 'getActiveUniformBlockParameter',
34
+ 'getUniformIndices',
35
+ 'getActiveUniforms',
36
+ 'getUniformLocation',
37
+ 'useProgram',
38
+ 'clientWaitSync',
39
+ 'activeTexture',
40
+ 'bindTexture',
41
+ 'bindRenderbuffer',
42
+ 'bindVertexArray',
43
+ 'bindSampler',
44
+ 'bindBufferRange',
45
+ 'enable',
46
+ 'disable',
47
+ 'colorMask',
48
+ 'depthMask',
49
+ 'depthFunc',
50
+ 'frontFace',
51
+ 'clearDepth',
52
+ 'clearColor',
53
+ 'clear',
54
+ 'viewport',
55
+ 'scissor',
56
+ 'depthRange',
57
+ 'blendEquationSeparate',
58
+ 'blendFuncSeparate',
59
+ 'pixelStorei',
60
+ 'texParameteri',
61
+ 'texStorage2D',
62
+ 'texSubImage2D',
63
+ 'renderbufferStorage',
64
+ 'framebufferTexture2D',
65
+ 'framebufferRenderbuffer',
66
+ 'drawBuffers',
67
+ 'readBuffer',
68
+ 'compileShader',
69
+ 'linkProgram',
70
+ 'detachShader',
71
+ 'uniformBlockBinding',
72
+ 'uniform1i',
73
+ 'uniform1f',
74
+ 'uniform2f',
75
+ 'enableVertexAttribArray',
76
+ 'disableVertexAttribArray',
77
+ 'vertexAttribPointer',
78
+ 'vertexAttribDivisor',
79
+ 'drawArrays',
80
+ 'drawElements',
81
+ 'flush'
82
+ ];
83
+ const KINDS = [
84
+ 'Buffer',
85
+ 'Texture',
86
+ 'Renderbuffer',
87
+ 'Framebuffer',
88
+ 'Shader',
89
+ 'Program',
90
+ 'VertexArray',
91
+ 'Sync'
92
+ ];
93
+ /** One context generation owns every returned native object before another native call. */
94
+ export class GLNativeSession {
95
+ context;
96
+ gate;
97
+ diagnostics;
98
+ timing;
99
+ gl;
100
+ owners = new Set();
101
+ invalidated = false;
102
+ cleanupFailure;
103
+ recordOwners;
104
+ timingSerial = null;
105
+ calls = new Map();
106
+ qualifiedColorTargets = new WeakSet();
107
+ qualifiedDepthTargets = new WeakMap();
108
+ constructor(context, gate, diagnostics, timing) {
109
+ this.context = context;
110
+ this.gate = gate;
111
+ this.diagnostics = diagnostics;
112
+ this.timing = timing;
113
+ const captured = Object.create(null);
114
+ // Capture only the finite methods used by this executor. Never enumerate a native context.
115
+ for (const name of [
116
+ ...METHODS,
117
+ ...KINDS.flatMap(kind => [kind === 'Sync' ? 'fenceSync' : 'create' + kind, 'delete' + kind])
118
+ ]) {
119
+ const candidate = context[name];
120
+ gate();
121
+ if (typeof candidate !== 'function')
122
+ throw new TypeError(name);
123
+ const raw = candidate.bind(context);
124
+ this.calls.set(name, raw);
125
+ // Specialize once so ordinary native draws and binds never read the clock.
126
+ const call = timing && name === 'texSubImage2D'
127
+ ? (...args) => {
128
+ const start = this.recordOwners ? this.startTiming() : undefined;
129
+ try {
130
+ return raw(...args);
131
+ }
132
+ finally {
133
+ this.finishTiming('texture-upload', start);
134
+ }
135
+ }
136
+ : raw;
137
+ Object.defineProperty(captured, name, {
138
+ value: (...args) => {
139
+ gate();
140
+ const value = call(...args);
141
+ // Observe the real page write before the existing post-call gate can throw.
142
+ if (name === 'texSubImage2D' && this.diagnostics) {
143
+ const state = this.diagnostics, bytes = args[4] * args[5] * 4;
144
+ if (state.totals.pageWriteCalls === Number.MAX_SAFE_INTEGER ||
145
+ bytes > Number.MAX_SAFE_INTEGER - state.totals.pageWriteBytes)
146
+ state.saturated = true;
147
+ state.totals.pageWriteCalls = Math.min(Number.MAX_SAFE_INTEGER, state.totals.pageWriteCalls + 1);
148
+ state.totals.pageWriteBytes = Math.min(Number.MAX_SAFE_INTEGER, state.totals.pageWriteBytes + bytes);
149
+ }
150
+ gate();
151
+ return value;
152
+ }
153
+ });
154
+ }
155
+ // Constants are fixed WebGL2 specification tokens, independent of mutable context properties.
156
+ const constants = {
157
+ NO_ERROR: 0,
158
+ OUT_OF_MEMORY: 1285,
159
+ CONTEXT_LOST_WEBGL: 37442,
160
+ ARRAY_BUFFER: 34962,
161
+ ELEMENT_ARRAY_BUFFER: 34963,
162
+ UNIFORM_BUFFER: 35345,
163
+ PIXEL_PACK_BUFFER: 35051,
164
+ PIXEL_UNPACK_BUFFER: 35052,
165
+ DYNAMIC_DRAW: 35048,
166
+ STREAM_READ: 35041,
167
+ TEXTURE_2D: 3553,
168
+ TEXTURE0: 33984,
169
+ TEXTURE1: 33985,
170
+ TEXTURE_MIN_FILTER: 10241,
171
+ TEXTURE_MAG_FILTER: 10240,
172
+ TEXTURE_WRAP_S: 10242,
173
+ TEXTURE_WRAP_T: 10243,
174
+ TEXTURE_BASE_LEVEL: 33084,
175
+ TEXTURE_MAX_LEVEL: 33085,
176
+ NEAREST: 9728,
177
+ LINEAR: 9729,
178
+ CLAMP_TO_EDGE: 33071,
179
+ RGBA: 6408,
180
+ RGBA8: 32856,
181
+ SRGB8_ALPHA8: 35907,
182
+ SRGB: 35904,
183
+ UNSIGNED_NORMALIZED: 35863,
184
+ UNSIGNED_BYTE: 5121,
185
+ UNSIGNED_INT: 5125,
186
+ FLOAT: 5126,
187
+ FRAMEBUFFER: 36160,
188
+ DRAW_FRAMEBUFFER: 36009,
189
+ READ_FRAMEBUFFER: 36008,
190
+ RENDERBUFFER: 36161,
191
+ FRAMEBUFFER_COMPLETE: 36053,
192
+ COLOR_ATTACHMENT0: 36064,
193
+ DEPTH_ATTACHMENT: 36096,
194
+ BACK: 1029,
195
+ FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING: 33296,
196
+ FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE: 33297,
197
+ FRAMEBUFFER_ATTACHMENT_RED_SIZE: 33298,
198
+ FRAMEBUFFER_ATTACHMENT_GREEN_SIZE: 33299,
199
+ FRAMEBUFFER_ATTACHMENT_BLUE_SIZE: 33300,
200
+ FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE: 33301,
201
+ DEPTH_COMPONENT32F: 36012,
202
+ COLOR_BUFFER_BIT: 16384,
203
+ DEPTH_BUFFER_BIT: 256,
204
+ VERTEX_SHADER: 35633,
205
+ FRAGMENT_SHADER: 35632,
206
+ COMPILE_STATUS: 35713,
207
+ LINK_STATUS: 35714,
208
+ HIGH_FLOAT: 36338,
209
+ MAX_TEXTURE_SIZE: 3379,
210
+ MAX_RENDERBUFFER_SIZE: 34024,
211
+ MAX_VIEWPORT_DIMS: 3386,
212
+ MAX_VERTEX_ATTRIBS: 34921,
213
+ MAX_UNIFORM_BLOCK_SIZE: 35376,
214
+ UNIFORM_BUFFER_OFFSET_ALIGNMENT: 35380,
215
+ MAX_UNIFORM_BUFFER_BINDINGS: 35375,
216
+ MAX_VERTEX_UNIFORM_BLOCKS: 35371,
217
+ MAX_FRAGMENT_UNIFORM_BLOCKS: 35373,
218
+ MAX_TEXTURE_IMAGE_UNITS: 34930,
219
+ UNIFORM_BLOCK_DATA_SIZE: 35392,
220
+ UNIFORM_OFFSET: 35387,
221
+ INVALID_INDEX: 4294967295,
222
+ PACK_ALIGNMENT: 3333,
223
+ PACK_ROW_LENGTH: 3330,
224
+ PACK_SKIP_ROWS: 3331,
225
+ PACK_SKIP_PIXELS: 3332,
226
+ UNPACK_ALIGNMENT: 3317,
227
+ UNPACK_ROW_LENGTH: 3314,
228
+ UNPACK_SKIP_ROWS: 3315,
229
+ UNPACK_SKIP_PIXELS: 3316,
230
+ UNPACK_IMAGE_HEIGHT: 32878,
231
+ UNPACK_SKIP_IMAGES: 32877,
232
+ UNPACK_FLIP_Y_WEBGL: 37440,
233
+ UNPACK_PREMULTIPLY_ALPHA_WEBGL: 37441,
234
+ UNPACK_COLORSPACE_CONVERSION_WEBGL: 37443,
235
+ NONE: 0,
236
+ BLEND: 3042,
237
+ DEPTH_TEST: 2929,
238
+ STENCIL_TEST: 2960,
239
+ SCISSOR_TEST: 3089,
240
+ CULL_FACE: 2884,
241
+ DITHER: 3024,
242
+ RASTERIZER_DISCARD: 35977,
243
+ SAMPLE_ALPHA_TO_COVERAGE: 32926,
244
+ SAMPLE_COVERAGE: 32928,
245
+ POLYGON_OFFSET_FILL: 32823,
246
+ FUNC_ADD: 32774,
247
+ ONE: 1,
248
+ ZERO: 0,
249
+ ONE_MINUS_SRC_ALPHA: 771,
250
+ ONE_MINUS_SRC_COLOR: 769,
251
+ DST_COLOR: 774,
252
+ GREATER: 516,
253
+ CCW: 2305,
254
+ TRIANGLES: 4,
255
+ SYNC_GPU_COMMANDS_COMPLETE: 37143,
256
+ ALREADY_SIGNALED: 37146,
257
+ TIMEOUT_EXPIRED: 37147,
258
+ CONDITION_SATISFIED: 37148,
259
+ WAIT_FAILED: 37149
260
+ };
261
+ Object.assign(captured, constants);
262
+ this.gl = captured;
263
+ }
264
+ startTiming() {
265
+ if (!this.timing)
266
+ return undefined;
267
+ try {
268
+ const value = performance.now();
269
+ return Number.isFinite(value) ? value : undefined;
270
+ }
271
+ catch {
272
+ return undefined;
273
+ }
274
+ }
275
+ finishTiming(phase, start) {
276
+ // Optional observations never alter the native result or resource ownership.
277
+ if (start !== undefined)
278
+ try {
279
+ this.timing(phase, start, this.timingSerial);
280
+ }
281
+ catch { }
282
+ }
283
+ /** Observe original owner transitions; established unknown remains a once-only obligation. */
284
+ observeResource(owner) {
285
+ const diagnostics = this.diagnostics;
286
+ if (!diagnostics)
287
+ return;
288
+ const page = owner.page === true && owner.value !== undefined && (owner.outcome === 'owned' || owner.outcome === 'unknown');
289
+ if (page !== !!owner.diagnosticPageOwned) {
290
+ diagnostics.pageBytes += (page ? 1 : -1) * owner.bytes;
291
+ owner.diagnosticPageOwned = page;
292
+ diagnostics.highPageBytes = Math.max(diagnostics.highPageBytes, diagnostics.pageBytes);
293
+ }
294
+ const unknown = owner.outcome === 'unknown' && owner.accounting === 'native';
295
+ if (unknown && !owner.diagnosticUnknown) {
296
+ const state = diagnostics.unknown, bytes = state.knownLogicalBytes + owner.bytes, objects = state.objects + 1;
297
+ if (bytes > Number.MAX_SAFE_INTEGER || objects > Number.MAX_SAFE_INTEGER)
298
+ state.saturated = true;
299
+ state.knownLogicalBytes = Math.min(Number.MAX_SAFE_INTEGER, bytes);
300
+ state.objects = Math.min(Number.MAX_SAFE_INTEGER, objects);
301
+ state.highKnownLogicalBytes = Math.max(state.highKnownLogicalBytes, state.knownLogicalBytes);
302
+ state.highObjects = Math.max(state.highObjects, state.objects);
303
+ owner.diagnosticUnknown = true;
304
+ }
305
+ }
306
+ create(kind, bytes = 0, parameter, page) {
307
+ this.gate();
308
+ const owner = {
309
+ kind,
310
+ bytes,
311
+ value: undefined,
312
+ outcome: 'owned',
313
+ accounting: 'native',
314
+ page: page !== undefined
315
+ };
316
+ // The slot exists before the native call; registration cannot lose a returned object.
317
+ this.owners.add(owner);
318
+ this.recordOwners?.push(owner);
319
+ const call = this.calls.get(kind === 'Sync' ? 'fenceSync' : 'create' + kind);
320
+ let value;
321
+ try {
322
+ value = kind === 'Sync' ? call(37143, 0) : kind === 'Shader' ? call(parameter) : call();
323
+ }
324
+ catch (cause) {
325
+ owner.outcome = 'unknown';
326
+ owner.cleanupCause = cause;
327
+ this.cleanupFailure ??= { cause };
328
+ this.observeResource(owner);
329
+ throw cause;
330
+ }
331
+ if (value !== null && typeof value === 'object')
332
+ owner.value = value;
333
+ else {
334
+ owner.outcome = 'deleted';
335
+ this.owners.delete(owner);
336
+ throw new Error('WebGL2 allocation returned null: ' + kind);
337
+ }
338
+ if (page) {
339
+ page.reservedPageBytes -= bytes;
340
+ if (this.diagnostics)
341
+ this.diagnostics.reservedPageBytes -= bytes;
342
+ }
343
+ this.observeResource(owner);
344
+ this.gate();
345
+ return owner;
346
+ }
347
+ cleanup(owner) {
348
+ if (owner.outcome !== 'owned')
349
+ return owner.outcome !== 'unknown';
350
+ if (!owner.value) {
351
+ owner.outcome = 'deleted';
352
+ this.observeResource(owner);
353
+ this.owners.delete(owner);
354
+ return true;
355
+ }
356
+ if (this.invalidated) {
357
+ owner.outcome = 'context-invalidated';
358
+ this.observeResource(owner);
359
+ this.owners.delete(owner);
360
+ return true;
361
+ }
362
+ // Mark before invoking externally controlled code; a thrown deletion is never retried/refunded.
363
+ owner.outcome = 'unknown';
364
+ try {
365
+ this.calls.get('delete' + owner.kind)(owner.value);
366
+ const lost = this.calls.get('isContextLost')();
367
+ const query = this.calls.get('getError');
368
+ let error;
369
+ if (this.timing && owner.kind === 'Sync') {
370
+ const start = this.startTiming();
371
+ try {
372
+ error = query();
373
+ }
374
+ finally {
375
+ this.finishTiming('sync-delete-error-query', start);
376
+ }
377
+ }
378
+ else
379
+ error = query();
380
+ if (lost === true) {
381
+ this.invalidated = true;
382
+ owner.outcome = 'context-invalidated';
383
+ }
384
+ else if (error === 0)
385
+ owner.outcome = 'deleted';
386
+ else
387
+ owner.cleanupCause = error;
388
+ }
389
+ catch (cause) {
390
+ owner.cleanupCause = cause;
391
+ }
392
+ this.observeResource(owner);
393
+ if (owner.outcome !== 'unknown')
394
+ this.owners.delete(owner);
395
+ else
396
+ this.cleanupFailure ??= { cause: owner.cleanupCause };
397
+ return owner.outcome !== 'unknown';
398
+ }
399
+ lose() {
400
+ this.invalidated = true;
401
+ for (const owner of this.owners)
402
+ if (owner.outcome === 'owned') {
403
+ owner.outcome = 'context-invalidated';
404
+ this.observeResource(owner);
405
+ this.owners.delete(owner);
406
+ }
407
+ }
408
+ cleanupAll() {
409
+ let safe = true;
410
+ for (const owner of this.owners)
411
+ if (!this.cleanup(owner))
412
+ safe = false;
413
+ return safe;
414
+ }
415
+ unknown() {
416
+ let bytes = 0, objects = 0;
417
+ for (const owner of this.owners)
418
+ if (owner.outcome === 'unknown' && owner.accounting === 'native') {
419
+ bytes += owner.bytes;
420
+ objects++;
421
+ }
422
+ return { bytes, objects };
423
+ }
424
+ check() {
425
+ const value = this.gl.getError();
426
+ if (value !== 0)
427
+ throw glFailure(value === 1285 ? 'WEBGL2_OUT_OF_MEMORY' : value === 37442 ? 'WEBGL2_CONTEXT_LOST' : 'WEBGL2_VALIDATION', value);
428
+ }
429
+ program(vertex, fragment) {
430
+ const gl = this.gl, v = this.create('Shader', 0, gl.VERTEX_SHADER), f = this.create('Shader', 0, gl.FRAGMENT_SHADER);
431
+ for (const [owner, source] of [
432
+ [v, vertex],
433
+ [f, fragment]
434
+ ]) {
435
+ const shader = owner.value;
436
+ gl.shaderSource(shader, source);
437
+ gl.compileShader(shader);
438
+ if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS))
439
+ throw new Error(gl.getShaderInfoLog(shader) ?? 'Shader compilation');
440
+ }
441
+ const p = this.create('Program'), program = p.value;
442
+ gl.attachShader(program, v.value);
443
+ gl.attachShader(program, f.value);
444
+ gl.linkProgram(program);
445
+ if (!gl.getProgramParameter(program, gl.LINK_STATUS))
446
+ throw new Error(gl.getProgramInfoLog(program) ?? 'Program link');
447
+ gl.detachShader(program, v.value);
448
+ gl.detachShader(program, f.value);
449
+ const vSafe = this.cleanup(v), fSafe = this.cleanup(f);
450
+ if (!vSafe || !fSafe)
451
+ throw glFailure('WEBGL2_CLOSE_UNSAFE', this.cleanupFailure?.cause);
452
+ return program;
453
+ }
454
+ block(program, name, members, bytes, binding = 0) {
455
+ const gl = this.gl, index = gl.getUniformBlockIndex(program, name);
456
+ if (index === gl.INVALID_INDEX ||
457
+ gl.getActiveUniformBlockParameter(program, index, gl.UNIFORM_BLOCK_DATA_SIZE) !== bytes)
458
+ throw glFailure('WEBGL2_CONTEXT_LIMIT');
459
+ const indices = gl.getUniformIndices(program, [...members]);
460
+ if (!indices || indices.some(value => value === gl.INVALID_INDEX))
461
+ throw glFailure('WEBGL2_CONTEXT_LIMIT');
462
+ const offsets = gl.getActiveUniforms(program, indices, gl.UNIFORM_OFFSET);
463
+ if (offsets.length !== members.length || offsets.some((value, i) => value !== i * 16))
464
+ throw glFailure('WEBGL2_CONTEXT_LIMIT');
465
+ gl.uniformBlockBinding(program, index, binding);
466
+ }
467
+ workingAttachment(color, depth) {
468
+ // The host owns level-zero immutable color storage and allocates depth once per owner.
469
+ // Weak keys keep the proof in this generation without retaining released targets.
470
+ if (depth === null) {
471
+ if (this.qualifiedColorTargets.has(color)) {
472
+ this.check();
473
+ return;
474
+ }
475
+ this.attachment(true);
476
+ this.qualifiedColorTargets.add(color);
477
+ return;
478
+ }
479
+ let qualified = this.qualifiedDepthTargets.get(color);
480
+ if (qualified?.has(depth)) {
481
+ this.check();
482
+ return;
483
+ }
484
+ this.attachment(true);
485
+ if (!qualified)
486
+ this.qualifiedDepthTargets.set(color, (qualified = new WeakSet()));
487
+ qualified.add(depth);
488
+ }
489
+ attachment(working) {
490
+ const gl = this.gl, attachment = working ? gl.COLOR_ATTACHMENT0 : gl.BACK;
491
+ const start = this.recordOwners ? this.startTiming() : undefined;
492
+ try {
493
+ for (const [name, expected] of [
494
+ [gl.FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING, working ? gl.SRGB : gl.LINEAR],
495
+ [gl.FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE, gl.UNSIGNED_NORMALIZED],
496
+ [gl.FRAMEBUFFER_ATTACHMENT_RED_SIZE, 8],
497
+ [gl.FRAMEBUFFER_ATTACHMENT_GREEN_SIZE, 8],
498
+ [gl.FRAMEBUFFER_ATTACHMENT_BLUE_SIZE, 8],
499
+ [gl.FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE, 8]
500
+ ])
501
+ if (gl.getFramebufferAttachmentParameter(gl.FRAMEBUFFER, attachment, name) !== expected)
502
+ throw glFailure('WEBGL2_FORMAT_UNSUPPORTED');
503
+ if (working && gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE)
504
+ throw glFailure('WEBGL2_FORMAT_UNSUPPORTED');
505
+ }
506
+ finally {
507
+ this.finishTiming(working ? 'working-framebuffer-validation' : 'default-framebuffer-validation', start);
508
+ }
509
+ this.check();
510
+ }
511
+ reset(width, height) {
512
+ const gl = this.gl;
513
+ for (const cap of [
514
+ gl.BLEND,
515
+ gl.DEPTH_TEST,
516
+ gl.STENCIL_TEST,
517
+ gl.SCISSOR_TEST,
518
+ gl.CULL_FACE,
519
+ gl.DITHER,
520
+ gl.RASTERIZER_DISCARD,
521
+ gl.SAMPLE_ALPHA_TO_COVERAGE,
522
+ gl.SAMPLE_COVERAGE,
523
+ gl.POLYGON_OFFSET_FILL
524
+ ])
525
+ gl.disable(cap);
526
+ gl.colorMask(true, true, true, true);
527
+ gl.depthMask(false);
528
+ gl.depthRange(0, 1);
529
+ gl.viewport(0, 0, width, height);
530
+ gl.scissor(0, 0, width, height);
531
+ gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_ADD);
532
+ gl.activeTexture(gl.TEXTURE0);
533
+ gl.bindSampler(0, null);
534
+ gl.bindBuffer(gl.PIXEL_UNPACK_BUFFER, null);
535
+ gl.bindBuffer(gl.PIXEL_PACK_BUFFER, null);
536
+ for (const name of [
537
+ gl.UNPACK_ROW_LENGTH,
538
+ gl.UNPACK_SKIP_ROWS,
539
+ gl.UNPACK_SKIP_PIXELS,
540
+ gl.UNPACK_IMAGE_HEIGHT,
541
+ gl.UNPACK_SKIP_IMAGES,
542
+ gl.PACK_ROW_LENGTH,
543
+ gl.PACK_SKIP_ROWS,
544
+ gl.PACK_SKIP_PIXELS
545
+ ])
546
+ gl.pixelStorei(name, 0);
547
+ gl.pixelStorei(gl.UNPACK_ALIGNMENT, 1);
548
+ gl.pixelStorei(gl.PACK_ALIGNMENT, 1);
549
+ gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
550
+ gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, false);
551
+ gl.pixelStorei(gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, gl.NONE);
552
+ }
553
+ texture(owner, width, height, working) {
554
+ const gl = this.gl;
555
+ gl.bindTexture(gl.TEXTURE_2D, owner.value);
556
+ gl.texStorage2D(gl.TEXTURE_2D, 1, working ? gl.SRGB8_ALPHA8 : gl.RGBA8, width, height);
557
+ for (const [name, value] of [
558
+ [gl.TEXTURE_MIN_FILTER, gl.NEAREST],
559
+ [gl.TEXTURE_MAG_FILTER, gl.NEAREST],
560
+ [gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE],
561
+ [gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE],
562
+ [gl.TEXTURE_BASE_LEVEL, 0],
563
+ [gl.TEXTURE_MAX_LEVEL, 0]
564
+ ])
565
+ gl.texParameteri(gl.TEXTURE_2D, name, value);
566
+ }
567
+ }
568
+ //# sourceMappingURL=webgl2Native.js.map
@@ -0,0 +1,132 @@
1
+ import type { SharedRenderFrame2D, SharedRenderHostAdapter } from '@egret/contracts';
2
+ import type { SharedDeviceSessionStatus, SharedHostResourceStatus } from './sharedDeviceSession.js';
3
+ import type { SharedFrameUpload, SharedFrameUploadOptions } from './sharedFrameUpload.js';
4
+ export type WebGL2HostState = 'new' | 'starting' | 'active' | 'lost' | 'restoring' | 'stopped' | 'failed' | 'closing' | 'closed';
5
+ export type WebGL2HostErrorCode = 'WEBGL2_OPTIONS_INVALID' | 'WEBGL2_CONTEXT_UNAVAILABLE' | 'WEBGL2_CONTEXT_ATTRIBUTES_UNSUPPORTED' | 'WEBGL2_FORMAT_UNSUPPORTED' | 'WEBGL2_START_FAILED' | 'WEBGL2_START_CANCELLED' | 'WEBGL2_NOT_STARTED' | 'WEBGL2_STOPPED' | 'WEBGL2_CLOSED' | 'WEBGL2_FAILED' | 'WEBGL2_REENTRANT' | 'WEBGL2_FRAME_PROFILE_UNSUPPORTED' | 'WEBGL2_FRAME_INVALID' | 'WEBGL2_BACKING_LIMIT' | 'WEBGL2_GEOMETRY_RANGE' | 'WEBGL2_PRECISION_UNSUPPORTED' | 'WEBGL2_FRAME_BUDGET' | 'WEBGL2_BACKPRESSURE' | 'WEBGL2_CONTEXT_LIMIT' | 'WEBGL2_SERIAL_EXHAUSTED' | 'WEBGL2_GENERATION_EXHAUSTED' | 'WEBGL2_RENDER_FAILED' | 'WEBGL2_VALIDATION' | 'WEBGL2_OUT_OF_MEMORY' | 'WEBGL2_CONTEXT_LOST' | 'WEBGL2_CONTEXT_RESTORING' | 'WEBGL2_RESTORE_FAILED' | 'WEBGL2_RESTORE_TIMEOUT' | 'WEBGL2_READBACK_DISABLED' | 'WEBGL2_READBACK_PENDING' | 'WEBGL2_READBACK_FAILED' | 'WEBGL2_SYNC_FAILED' | 'WEBGL2_SYNC_TIMEOUT' | 'WEBGL2_DIAGNOSTIC_CALLBACK_FAILED' | 'WEBGL2_CLOSE_UNSAFE' | 'WEBGL2_UPLOAD_INVALID' | 'WEBGL2_UPLOAD_OPTIONS_INVALID' | 'WEBGL2_UPLOAD_NOT_READY' | 'WEBGL2_UPLOAD_USED' | 'WEBGL2_UPLOAD_DISPOSED' | 'WEBGL2_UPLOAD_ABORTED' | 'WEBGL2_UPLOAD_EXPIRED' | 'WEBGL2_UPLOAD_STALE' | 'WEBGL2_LAYER_EFFECT_INVALID' | 'WEBGL2_LAYER_INVALID' | 'WEBGL2_LAYER_BUDGET' | 'WEBGL2_LAYER_NOT_READY' | 'WEBGL2_LAYER_PENDING' | 'WEBGL2_LAYER_DISPOSED';
6
+ export interface WebGL2HostFailure {
7
+ readonly code: WebGL2HostErrorCode;
8
+ readonly serial: number | null;
9
+ readonly generation: number;
10
+ readonly phase: 'startup' | 'frame' | 'readback' | 'context' | 'restore' | 'cleanup' | 'callback';
11
+ readonly cause: unknown;
12
+ }
13
+ export interface WebGL2HostDiagnostic extends WebGL2HostFailure {
14
+ readonly severity: 'error';
15
+ }
16
+ export interface WebGL2HostStatus {
17
+ readonly state: WebGL2HostState;
18
+ readonly generation: number;
19
+ readonly lastSerial: number;
20
+ readonly pendingFrames: number;
21
+ readonly pendingUploadBytes: number;
22
+ readonly pendingReadbackBytes: number;
23
+ readonly firstFailure: WebGL2HostFailure | null;
24
+ readonly generationFailure: WebGL2HostFailure | null;
25
+ readonly callbackFailureCount: number;
26
+ readonly lastCallbackFailure: WebGL2HostFailure | null;
27
+ readonly cleanupOutcome: 'not-started' | 'pending' | 'safe' | 'unsafe';
28
+ }
29
+ export interface SharedWebGL2Readback {
30
+ readonly generation: number;
31
+ readonly serial: number;
32
+ readonly frameId: number;
33
+ readonly width: number;
34
+ readonly height: number;
35
+ readonly format: 'rgba8unorm';
36
+ readonly sourceFormat: 'rgba8unorm';
37
+ readonly colorSpace: 'srgb';
38
+ readonly alphaMode: 'premultiplied' | 'opaque';
39
+ readonly bytes: Uint8Array;
40
+ }
41
+ export interface SharedWebGL2HostStatus {
42
+ readonly resources: SharedHostResourceStatus;
43
+ readonly host: WebGL2HostStatus;
44
+ readonly pendingGeometryBytes: number;
45
+ readonly pendingColorBytes: number;
46
+ readonly pendingCanonicalBytes: number;
47
+ readonly retention: {
48
+ readonly idleBytes: number;
49
+ readonly idleEntries: number;
50
+ readonly reservedBytes: number;
51
+ readonly reservedEntries: number;
52
+ readonly unknownBytes: number;
53
+ readonly unknownEntries: number;
54
+ readonly unknownNativeBytes: number;
55
+ readonly unknownNativeObjects: number;
56
+ };
57
+ }
58
+ export interface SharedWebGL2Layer2D {
59
+ readonly state: 'empty' | 'ready' | 'stale' | 'disposed';
60
+ /** Bake a transparent Engine capture. The current revision remains usable until the replacement completes. */
61
+ update(frame: SharedRenderFrame2D): Promise<void>;
62
+ dispose(): void;
63
+ }
64
+ type LayerRGB = readonly [number, number, number];
65
+ export interface SharedWebGL2LayerEffect2D {
66
+ /** Half-open rectangle in logical frame coordinates. */
67
+ readonly bounds: {
68
+ readonly x: number;
69
+ readonly y: number;
70
+ readonly width: number;
71
+ readonly height: number;
72
+ };
73
+ readonly multiply?: LayerRGB;
74
+ readonly add?: LayerRGB;
75
+ }
76
+ export interface SharedWebGL2LayerPlacement2D {
77
+ readonly layer: SharedWebGL2Layer2D;
78
+ /** Destination bounds in logical frame coordinates, before the host pixel ratio. */
79
+ readonly x: number;
80
+ readonly y: number;
81
+ readonly width: number;
82
+ readonly height: number;
83
+ readonly effect?: SharedWebGL2LayerEffect2D;
84
+ }
85
+ export interface SharedWebGL2LayerStatus {
86
+ /** Logical RGBA8 bytes for live targets, including pending and pinned superseded revisions. */
87
+ readonly residentBytes: number;
88
+ readonly readyLayers: number;
89
+ readonly pendingLayers: number;
90
+ }
91
+ export type SharedWebGL2TimingPhase = 'texture-prepare' | 'texture-upload' | 'working-framebuffer-validation' | 'default-framebuffer-validation' | 'submit' | 'fence-poll' | 'completion-error-query' | 'retire' | 'sync-delete-error-query';
92
+ export interface SharedWebGL2TimingSample {
93
+ readonly generation: number;
94
+ /** Null before a frame is assigned a submission serial. */
95
+ readonly serial: number | null;
96
+ readonly phase: SharedWebGL2TimingPhase;
97
+ readonly startMs: number;
98
+ readonly durationMs: number;
99
+ }
100
+ export interface SharedWebGL2FrameTiming {
101
+ readonly totals: Readonly<Record<SharedWebGL2TimingPhase, {
102
+ readonly count: number;
103
+ readonly totalMs: number;
104
+ readonly maxMs: number;
105
+ }>>;
106
+ /** Latest 2,048 samples in completion order. Staged samples without a serial are generation-only. */
107
+ readonly recent: readonly SharedWebGL2TimingSample[];
108
+ readonly dropped: number;
109
+ }
110
+ export interface SharedWebGL2Host extends SharedRenderHostAdapter {
111
+ readonly surface: HTMLCanvasElement;
112
+ start(): Promise<void>;
113
+ stop(): void;
114
+ close(): Promise<void>;
115
+ whenIdle(): Promise<void>;
116
+ whenReady(): Promise<void>;
117
+ requestReadback(): Promise<SharedWebGL2Readback>;
118
+ getStatus(): WebGL2HostStatus;
119
+ getSharedStatus(): SharedWebGL2HostStatus;
120
+ /** Bounded CPU elapsed timings, or null when measurement is disabled. */
121
+ getSharedFrameTiming(): SharedWebGL2FrameTiming | null;
122
+ getSessionStatus(): SharedDeviceSessionStatus<WebGL2HostFailure>;
123
+ stageSharedFrame(frame: SharedRenderFrame2D, options?: SharedFrameUploadOptions): SharedFrameUpload;
124
+ setTimeout(callback: () => void, delayMs: number): () => void;
125
+ }
126
+ export interface SharedLayerWebGL2Host extends SharedWebGL2Host {
127
+ createSharedLayer2D(): SharedWebGL2Layer2D;
128
+ renderSharedFrameWithLayers(frame: SharedRenderFrame2D, layers: readonly SharedWebGL2LayerPlacement2D[]): undefined;
129
+ getSharedLayerStatus(): SharedWebGL2LayerStatus;
130
+ }
131
+ export {};
132
+ //# sourceMappingURL=webgl2Types.d.ts.map