@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,30 @@
1
+ const SCRATCH_LIMIT = 8388608;
2
+ /** CPU concat ownership only. The Host retains the original GPU retirement proof. */
3
+ export class PreparedBatchScratch2D {
4
+ retained = 0;
5
+ available() {
6
+ return SCRATCH_LIMIT - this.retained;
7
+ }
8
+ reserve(plan, bytes) {
9
+ if (!Number.isSafeInteger(bytes) || bytes <= 0 || bytes > this.available())
10
+ return false;
11
+ this.retained += bytes;
12
+ plan.bytes += bytes;
13
+ return true;
14
+ }
15
+ refund(plan, bytes) {
16
+ this.retained -= bytes;
17
+ plan.bytes -= bytes;
18
+ }
19
+ release(plan) {
20
+ if (plan.released)
21
+ return;
22
+ plan.released = true;
23
+ this.retained -= plan.bytes;
24
+ plan.bytes = 0;
25
+ plan.logicalDraws = undefined;
26
+ plan.draws.length = 0;
27
+ plan.logicalSpans.length = 0;
28
+ }
29
+ }
30
+ //# sourceMappingURL=preparedBatches2D.js.map
@@ -0,0 +1,44 @@
1
+ import type { PackedSharedDraw2D, PackedSharedEntry2D } from './packSharedDraws2D.js';
2
+ import type { PreparedBatchScratch2D } from './preparedBatches2D.js';
3
+ export interface PreparedSharedBatchPlan2D {
4
+ readonly draws: PackedSharedDraw2D[];
5
+ logicalDraws: readonly PackedSharedEntry2D[] | undefined;
6
+ readonly logicalSpans: {
7
+ first: number;
8
+ count: number;
9
+ }[];
10
+ bytes: number;
11
+ released: boolean;
12
+ transferred: boolean;
13
+ }
14
+ /** What the batches of a frame ask of the records a Host keeps between frames. */
15
+ export interface KeptSharedBatches2D {
16
+ beginBatches(): void;
17
+ findBatch(ordinal: number): KeptSharedBatch2D | undefined;
18
+ carryBatch(batch: KeptSharedBatch2D): void;
19
+ roomForBatch(draws: number, joinedBytes: number): boolean;
20
+ keepBatch(members: (PackedSharedDraw2D | undefined)[], lengths: Uint32Array<ArrayBuffer>, pages: Int32Array<ArrayBuffer>, joined: PackedSharedDraw2D): void;
21
+ commitBatches(): void;
22
+ }
23
+ interface KeptSharedBatch2D {
24
+ readonly members: (PackedSharedDraw2D | undefined)[];
25
+ readonly lengths: Uint32Array<ArrayBuffer>;
26
+ readonly pages: Int32Array<ArrayBuffer>;
27
+ joined: PackedSharedDraw2D;
28
+ }
29
+ /**
30
+ * No logical charge is refunded when a physical upload is concatenated.
31
+ *
32
+ * With `kept`, a batch joined here is kept, and the batch that begins at the same place in the next frame is
33
+ * not joined again if it is certain that joining would take the same number of draws, each with as many
34
+ * rows as the kept batch has for it, and would be given the same room. The rows of every draw that is
35
+ * another record than the batch holds are then written over the rows the batch had for it, in the kept array
36
+ * itself, and nothing is written for a draw that is the same record. The batches are the same draws, with
37
+ * the same rows, as without `kept`.
38
+ *
39
+ * So the rows of a batch given with `kept` are only good until the next call with the same `kept`. A caller
40
+ * that reads them later than that must not pass `kept`.
41
+ */
42
+ export declare function prepareSharedBatches2D(input: readonly PackedSharedEntry2D[], maxBufferSize: number, scratch: PreparedBatchScratch2D, kept?: KeptSharedBatches2D): PreparedSharedBatchPlan2D;
43
+ export {};
44
+ //# sourceMappingURL=preparedSharedBatches2D.d.ts.map
@@ -0,0 +1,247 @@
1
+ import { SHARED_BATCH_PAGES_2D, SHARED_NO_PAGE_2D } from './packSharedDraws2D.js';
2
+ /**
3
+ * What two draws of one batch have in common, whatever lies between them. It holds of a draw and itself,
4
+ * either way round, and of the first and third of three draws when it holds of the first two and the last two.
5
+ */
6
+ function alike(a, b) {
7
+ const x = a.prepared, y = b.prepared, xc = x.command, yc = y.command;
8
+ // Regions of one window of the region table share a batch, whatever their page and opacity: the
9
+ // region's slot and the opacity are in each vertex, and the page in the region's row. The caller
10
+ // counts the pages. A draw with a region and one without never share a batch.
11
+ if (xc.kind !== yc.kind ||
12
+ x.material !== y.material ||
13
+ (x.pageIndex === undefined) !== (y.pageIndex === undefined) ||
14
+ a.regionWindow !== b.regionWindow ||
15
+ xc.clips.length !== yc.clips.length)
16
+ return false;
17
+ if (xc.clips !== yc.clips)
18
+ for (let i = 0; i < xc.clips.length; i++) {
19
+ const l = xc.clips[i], r = yc.clips[i];
20
+ for (const key of ['a', 'b', 'c', 'd', 'tx', 'ty'])
21
+ if (!Object.is(l.matrix[key], r.matrix[key]))
22
+ return false;
23
+ for (const key of ['x', 'y', 'width', 'height'])
24
+ if (!Object.is(l.rect[key], r.rect[key]))
25
+ return false;
26
+ }
27
+ // Every uniform byte is part of compatibility, including future fixed padding, except the eight words
28
+ // from byte 48 that name the pages of the texture units. Draws next to each other may share one block.
29
+ const p = a.uniform, q = b.uniform;
30
+ if (p === q)
31
+ return true;
32
+ for (let i = 0; i < 48; i++)
33
+ if (p[i] !== q[i])
34
+ return false;
35
+ for (let i = 80; i < 128; i++)
36
+ if (p[i] !== q[i])
37
+ return false;
38
+ return true;
39
+ }
40
+ /** Whether `b`, which follows `previous`, joins the batch that `a` began. */
41
+ function compatible(a, b, previous) {
42
+ return b.prepared.command.ordinal === previous.prepared.command.ordinal + 1 && b.vertexCount !== 0 && alike(a, b);
43
+ }
44
+ const NO_ROWS = new Float32Array(0);
45
+ /**
46
+ * What a kept batch holds of one of its draws. A record whose rows are a whole allocation is held itself: a
47
+ * draw at rest has that same record in the next frame. The rows of any other record are a part of the rows
48
+ * of its frame, which holding it would keep alive, so nothing is held for it; in the first place a record
49
+ * without rows stands for it, because the draws of the next frame are compared with the first.
50
+ */
51
+ function held(draw, first) {
52
+ if (draw.data.byteLength === draw.data.buffer.byteLength)
53
+ return draw;
54
+ return first
55
+ ? {
56
+ prepared: draw.prepared,
57
+ data: NO_ROWS,
58
+ vertexCount: draw.vertexCount,
59
+ uniform: draw.uniform,
60
+ regionWindow: draw.regionWindow,
61
+ pages: draw.pages
62
+ }
63
+ : undefined;
64
+ }
65
+ // The places and offsets of the draws of a kept batch that are other records than the batch holds. Batching is synchronous and calls no caller code.
66
+ let changed = new Uint32Array(64);
67
+ /**
68
+ * No logical charge is refunded when a physical upload is concatenated.
69
+ *
70
+ * With `kept`, a batch joined here is kept, and the batch that begins at the same place in the next frame is
71
+ * not joined again if it is certain that joining would take the same number of draws, each with as many
72
+ * rows as the kept batch has for it, and would be given the same room. The rows of every draw that is
73
+ * another record than the batch holds are then written over the rows the batch had for it, in the kept array
74
+ * itself, and nothing is written for a draw that is the same record. The batches are the same draws, with
75
+ * the same rows, as without `kept`.
76
+ *
77
+ * So the rows of a batch given with `kept` are only good until the next call with the same `kept`. A caller
78
+ * that reads them later than that must not pass `kept`.
79
+ */
80
+ export function prepareSharedBatches2D(input, maxBufferSize, scratch, kept) {
81
+ const plan = {
82
+ draws: [],
83
+ logicalDraws: input,
84
+ logicalSpans: [],
85
+ bytes: 0,
86
+ released: false,
87
+ transferred: false
88
+ };
89
+ try {
90
+ kept?.beginBatches();
91
+ for (let start = 0; start < input.length;) {
92
+ const first = input[start];
93
+ if ('barrier' in first || first.vertexCount === 0) {
94
+ start++;
95
+ continue;
96
+ }
97
+ const ceiling = Math.min(maxBufferSize, scratch.available());
98
+ const before = kept?.findBatch(first.prepared.command.ordinal);
99
+ if (before !== undefined) {
100
+ const members = before.members, lengths = before.lengths, pages = before.pages, count = members.length, old = before.joined, total = old.data.byteLength, ordinal = first.prepared.command.ordinal;
101
+ // Joining took these `count` draws. It takes as many again, into the same places of the same array, if
102
+ // every draw that is another record is like the first, follows the draw before it, and has as many
103
+ // rows and the same page as the batch has at its place; and if there is the room.
104
+ // A first draw that is another record must be like the one before it, for the draws that are the same records to be like it.
105
+ let same = start + count <= input.length && total <= ceiling && (first === members[0] || alike(members[0], first)), differ = 0;
106
+ for (let i = 0, offset = 0; same && i < count; i++) {
107
+ const next = input[start + i], length = lengths[i];
108
+ if (next !== members[i]) {
109
+ if ('barrier' in next ||
110
+ next.data.length !== length ||
111
+ (next.prepared.pageIndex ?? -1) !== pages[i] ||
112
+ next.prepared.command.ordinal !== ordinal + i ||
113
+ !alike(first, next)) {
114
+ same = false;
115
+ break;
116
+ }
117
+ if (2 * differ + 2 > changed.length) {
118
+ const grown = new Uint32Array(2 * changed.length);
119
+ grown.set(changed);
120
+ changed = grown;
121
+ }
122
+ changed[2 * differ] = i;
123
+ changed[2 * differ + 1] = offset;
124
+ differ++;
125
+ }
126
+ offset += length;
127
+ }
128
+ if (same && start + count < input.length) {
129
+ // Joining ended at the last of these draws. It ends there again unless the draw after them now joins.
130
+ const next = input[start + count];
131
+ if (!('barrier' in next) &&
132
+ compatible(first, next, input[start + count - 1]) &&
133
+ next.data.byteLength <= ceiling - total) {
134
+ const page = next.prepared.pageIndex;
135
+ same = page !== undefined && !old.pages.includes(page) && old.pages.length === SHARED_BATCH_PAGES_2D;
136
+ }
137
+ }
138
+ if (same && scratch.reserve(plan, total)) {
139
+ for (let i = 0; i < differ; i++) {
140
+ const place = changed[2 * i], next = input[start + place];
141
+ if (next.data.length > 0)
142
+ old.data.set(next.data, changed[2 * i + 1]);
143
+ members[place] = held(next, place === 0);
144
+ }
145
+ // The joined draw names the record of the first draw; its block and pages are as they were.
146
+ const joined = old.prepared === first.prepared
147
+ ? old
148
+ : {
149
+ prepared: first.prepared,
150
+ data: old.data,
151
+ vertexCount: old.vertexCount,
152
+ uniform: old.uniform,
153
+ regionWindow: old.regionWindow,
154
+ pages: old.pages
155
+ };
156
+ before.joined = joined;
157
+ kept.carryBatch(before);
158
+ plan.draws.push(joined);
159
+ plan.logicalSpans.push({ first: start, count });
160
+ start += count;
161
+ continue;
162
+ }
163
+ }
164
+ let end = start + 1, bytes = first.data.byteLength, previous = first;
165
+ // The pages of the batch in the order they first appear, which is the order of their texture units.
166
+ let pages = first.pages;
167
+ while (end < input.length) {
168
+ const next = input[end];
169
+ if ('barrier' in next || !compatible(first, next, previous) || next.data.byteLength > ceiling - bytes)
170
+ break;
171
+ const page = next.prepared.pageIndex;
172
+ if (page !== undefined && !pages.includes(page)) {
173
+ if (pages.length === SHARED_BATCH_PAGES_2D)
174
+ break;
175
+ pages = [...pages, page];
176
+ }
177
+ bytes += next.data.byteLength;
178
+ previous = next;
179
+ end++;
180
+ }
181
+ if (end === start + 1 || !scratch.reserve(plan, bytes)) {
182
+ plan.draws.push(first);
183
+ plan.logicalSpans.push({ first: start, count: 1 });
184
+ start++;
185
+ continue;
186
+ }
187
+ let data;
188
+ try {
189
+ data = new Float32Array(bytes / 4);
190
+ let offset = 0;
191
+ for (let i = start; i < end; i++) {
192
+ const source = input[i].data;
193
+ data.set(source, offset);
194
+ offset += source.length;
195
+ }
196
+ }
197
+ catch {
198
+ data = undefined;
199
+ }
200
+ if (data) {
201
+ // A batch of one page keeps the block of its first draw. One of several pages has a block of its own.
202
+ let uniform = first.uniform;
203
+ if (pages.length > 1) {
204
+ uniform = first.uniform.slice();
205
+ const units = new Uint32Array(uniform.buffer, 48, SHARED_BATCH_PAGES_2D);
206
+ for (let unit = 0; unit < SHARED_BATCH_PAGES_2D; unit++)
207
+ units[unit] = unit < pages.length ? pages[unit] : SHARED_NO_PAGE_2D;
208
+ }
209
+ const joined = {
210
+ prepared: first.prepared,
211
+ data,
212
+ vertexCount: data.length / 13,
213
+ uniform,
214
+ regionWindow: first.regionWindow,
215
+ pages
216
+ };
217
+ plan.draws.push(joined);
218
+ plan.logicalSpans.push({ first: start, count: end - start });
219
+ if (kept !== undefined && kept.roomForBatch(end - start, bytes)) {
220
+ const count = end - start, members = new Array(count), lengths = new Uint32Array(count), memberPages = new Int32Array(count);
221
+ for (let i = 0; i < count; i++) {
222
+ const draw = input[start + i];
223
+ members[i] = held(draw, i === 0);
224
+ lengths[i] = draw.data.length;
225
+ memberPages[i] = draw.prepared.pageIndex ?? -1;
226
+ }
227
+ kept.keepBatch(members, lengths, memberPages, joined);
228
+ }
229
+ }
230
+ else {
231
+ scratch.refund(plan, bytes);
232
+ for (let i = start; i < end; i++) {
233
+ plan.draws.push(input[i]);
234
+ plan.logicalSpans.push({ first: i, count: 1 });
235
+ }
236
+ }
237
+ start = end;
238
+ }
239
+ kept?.commitBatches();
240
+ return plan;
241
+ }
242
+ catch (cause) {
243
+ scratch.release(plan);
244
+ throw cause;
245
+ }
246
+ }
247
+ //# sourceMappingURL=preparedSharedBatches2D.js.map
@@ -0,0 +1,52 @@
1
+ import type { ImageData2D } from '@egret/contracts';
2
+ /** Selected sRGB transfer. Alpha and tint coefficients are never gamma converted. */
3
+ export declare function decodeSharedSRGB(value: number): number;
4
+ /** The linear-light value of an sRGB byte, from the written table: the same number in every JavaScript engine. */
5
+ export declare function decodeSharedSRGBByte(code: number): number;
6
+ /** The recipe and target a frame records for each blend space. */
7
+ export declare const SHARED_BLEND_RECIPES_2D: Readonly<{
8
+ linear: Readonly<{
9
+ readonly colorRecipe: 'egret.linear-srgb-pma/1';
10
+ readonly targetRepresentation: 'egret.srgb-pma8-target/1';
11
+ }>;
12
+ srgb: Readonly<{
13
+ readonly colorRecipe: 'egret.srgb-pma/1';
14
+ readonly targetRepresentation: 'egret.encoded-srgb-pma8-target/1';
15
+ }>;
16
+ }>;
17
+ /** The blend space of a frame whose recipe and target agree, or undefined. */
18
+ export declare function sharedBlendSpace2D(frame: {
19
+ readonly colorRecipe: string;
20
+ readonly targetRepresentation: string;
21
+ }): 'linear' | 'srgb' | undefined;
22
+ /**
23
+ * The 0-to-1 value a target of the blend space holds for a channel byte of a colour: its linear light, or the
24
+ * byte as it is written in a target that mixes the codes.
25
+ */
26
+ export declare function sharedTargetChannel2D(space: 'linear' | 'srgb', code: number): number;
27
+ export declare function encodeSharedSRGB(value: number): number;
28
+ /**
29
+ * How many levels a page of this size has when it carries its smaller copies: the page itself, then each copy
30
+ * half as large, rounded down and never below one texel, down to one texel.
31
+ */
32
+ export declare function sharedPageLevels2D(width: number, height: number): number;
33
+ /** The size of each level of a page, and where its bytes start in the page's bytes. */
34
+ export declare function sharedPageLevelLayout2D(width: number, height: number, levels: number): {
35
+ width: number;
36
+ height: number;
37
+ offset: number;
38
+ }[];
39
+ /** The bytes of a page with `levels` levels: the page's own, then those of each smaller copy after it. */
40
+ export declare function sharedPageChainBytes2D(width: number, height: number, levels: number): number;
41
+ /** Plain Host-owned observation only; no allocator, callback or resource authority. */
42
+ export interface SharedPageCopyDiagnostics2D {
43
+ canonicalBytes: number;
44
+ scratchBytes: number;
45
+ highCanonicalBytes: number;
46
+ highScratchBytes: number;
47
+ highTemporaryBytes: number;
48
+ saturated: boolean;
49
+ }
50
+ /** One actual source copy and one tight canonical output; callers reserve that peak first. */
51
+ export declare function copySharedPagePixels(image: ImageData2D, diagnostics?: SharedPageCopyDiagnostics2D, levels?: number): Uint8Array<ArrayBuffer>;
52
+ //# sourceMappingURL=sharedColor2D.d.ts.map
@@ -0,0 +1,191 @@
1
+ import { copyImageData2DPixels } from '@egret/contracts';
2
+ import { decodeSRGBByte } from './srgbBytes.js';
3
+ /** Selected sRGB transfer. Alpha and tint coefficients are never gamma converted. */
4
+ export function decodeSharedSRGB(value) {
5
+ return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
6
+ }
7
+ /** The linear-light value of an sRGB byte, from the written table: the same number in every JavaScript engine. */
8
+ export function decodeSharedSRGBByte(code) {
9
+ return decodeSRGBByte(code);
10
+ }
11
+ /** The recipe and target a frame records for each blend space. */
12
+ export const SHARED_BLEND_RECIPES_2D = Object.freeze({
13
+ linear: Object.freeze({
14
+ colorRecipe: 'egret.linear-srgb-pma/1',
15
+ targetRepresentation: 'egret.srgb-pma8-target/1'
16
+ }),
17
+ srgb: Object.freeze({
18
+ colorRecipe: 'egret.srgb-pma/1',
19
+ targetRepresentation: 'egret.encoded-srgb-pma8-target/1'
20
+ })
21
+ });
22
+ /** The blend space of a frame whose recipe and target agree, or undefined. */
23
+ export function sharedBlendSpace2D(frame) {
24
+ for (const space of ['linear', 'srgb']) {
25
+ const recipe = SHARED_BLEND_RECIPES_2D[space];
26
+ if (frame.colorRecipe === recipe.colorRecipe && frame.targetRepresentation === recipe.targetRepresentation)
27
+ return space;
28
+ }
29
+ return undefined;
30
+ }
31
+ /**
32
+ * The 0-to-1 value a target of the blend space holds for a channel byte of a colour: its linear light, or the
33
+ * byte as it is written in a target that mixes the codes.
34
+ */
35
+ export function sharedTargetChannel2D(space, code) {
36
+ return space === 'srgb' ? (code & 255) / 255 : decodeSRGBByte(code);
37
+ }
38
+ export function encodeSharedSRGB(value) {
39
+ return value <= 0.0031308 ? 12.92 * value : 1.055 * value ** (1 / 2.4) - 0.055;
40
+ }
41
+ const caps = Object.freeze(Array.from({ length: 256 }, (_, alpha) => {
42
+ let code = 0;
43
+ while (code < 255 && decodeSharedSRGB((code + 1) / 255) <= alpha / 255)
44
+ code++;
45
+ return code;
46
+ }));
47
+ // All alpha and channel inputs are bytes. Precompute the exact scalar rule once.
48
+ const premultipliedSrgb = new Uint8Array(256 * 256);
49
+ for (let alpha = 0; alpha < 256; alpha++) {
50
+ const a = alpha / 255, cap = caps[alpha];
51
+ for (let code = 0; code < 256; code++)
52
+ premultipliedSrgb[(alpha << 8) | code] = Math.min(cap, Math.floor(255 * encodeSharedSRGB(a * decodeSharedSRGB(code / 255)) + 0.5));
53
+ }
54
+ /**
55
+ * How many levels a page of this size has when it carries its smaller copies: the page itself, then each copy
56
+ * half as large, rounded down and never below one texel, down to one texel.
57
+ */
58
+ export function sharedPageLevels2D(width, height) {
59
+ return 1 + Math.floor(Math.log2(Math.max(width, height)));
60
+ }
61
+ /** The size of each level of a page, and where its bytes start in the page's bytes. */
62
+ export function sharedPageLevelLayout2D(width, height, levels) {
63
+ const layout = [];
64
+ let offset = 0;
65
+ for (let level = 0; level < levels; level++) {
66
+ const w = Math.max(1, width >> level), h = Math.max(1, height >> level);
67
+ layout.push({ width: w, height: h, offset });
68
+ offset += 4 * w * h;
69
+ }
70
+ return layout;
71
+ }
72
+ /** The bytes of a page with `levels` levels: the page's own, then those of each smaller copy after it. */
73
+ export function sharedPageChainBytes2D(width, height, levels) {
74
+ const layout = sharedPageLevelLayout2D(width, height, levels), last = layout[layout.length - 1];
75
+ return last.offset + 4 * last.width * last.height;
76
+ }
77
+ const encodedCode = (value, alpha) => Math.min(caps[alpha], Math.floor(255 * encodeSharedSRGB(value) + 0.5));
78
+ /**
79
+ * Writes each smaller level from the one before it. A texel of a level is the mean of the two by two texels of
80
+ * the level above it that it covers, in linear light with alpha premultiplied, then encoded as the page is.
81
+ * A level above that is one texel wide or high gives that texel twice. An odd last row or column of a level
82
+ * is left out of the next, as a GPU leaves it out when it makes the levels itself.
83
+ */
84
+ function fillSharedLevels2D(chain, width, height, levels) {
85
+ const layout = sharedPageLevelLayout2D(width, height, levels);
86
+ for (let level = 1; level < levels; level++) {
87
+ const above = layout[level - 1], here = layout[level];
88
+ for (let y = 0; y < here.height; y++) {
89
+ const y0 = Math.min(2 * y, above.height - 1), y1 = Math.min(2 * y + 1, above.height - 1);
90
+ for (let x = 0; x < here.width; x++) {
91
+ const x0 = Math.min(2 * x, above.width - 1), x1 = Math.min(2 * x + 1, above.width - 1);
92
+ const taps = [
93
+ above.offset + 4 * (y0 * above.width + x0),
94
+ above.offset + 4 * (y0 * above.width + x1),
95
+ above.offset + 4 * (y1 * above.width + x0),
96
+ above.offset + 4 * (y1 * above.width + x1)
97
+ ];
98
+ let alpha = 0;
99
+ for (const tap of taps)
100
+ alpha += chain[tap + 3];
101
+ const a = Math.floor(alpha / 4 + 0.5), out = here.offset + 4 * (y * here.width + x);
102
+ for (let channel = 0; channel < 3; channel++) {
103
+ let sum = 0;
104
+ for (const tap of taps)
105
+ sum += decodeSRGBByte(chain[tap + channel]);
106
+ chain[out + channel] = encodedCode(sum / 4, a);
107
+ }
108
+ chain[out + 3] = a;
109
+ }
110
+ }
111
+ }
112
+ }
113
+ function sampleCopy(diagnostics) {
114
+ diagnostics.highCanonicalBytes = Math.max(diagnostics.highCanonicalBytes, diagnostics.canonicalBytes);
115
+ diagnostics.highScratchBytes = Math.max(diagnostics.highScratchBytes, diagnostics.scratchBytes);
116
+ const excess = diagnostics.canonicalBytes > Number.MAX_SAFE_INTEGER - diagnostics.scratchBytes;
117
+ if (excess)
118
+ diagnostics.saturated = true;
119
+ diagnostics.highTemporaryBytes = Math.max(diagnostics.highTemporaryBytes, excess ? Number.MAX_SAFE_INTEGER : diagnostics.canonicalBytes + diagnostics.scratchBytes);
120
+ }
121
+ function writePremultipliedPixel(source, output, offset, alpha) {
122
+ const row = alpha << 8;
123
+ output[offset] = premultipliedSrgb[row | source[offset]];
124
+ output[offset + 1] = premultipliedSrgb[row | source[offset + 1]];
125
+ output[offset + 2] = premultipliedSrgb[row | source[offset + 2]];
126
+ output[offset + 3] = alpha;
127
+ }
128
+ // Four separated neighboring pairs select a loop. Every pixel in the chosen loop still uses its own alpha.
129
+ function hasEndpointRuns(source, start, end) {
130
+ if (end - start < 32)
131
+ return false;
132
+ const stride = Math.floor((end - start) / 16) * 4;
133
+ for (let sample = 0; sample < 4; sample++) {
134
+ const offset = start + sample * stride + 3;
135
+ const alpha = source[offset];
136
+ if ((alpha !== 0 && alpha !== 255) || source[offset + 4] !== alpha)
137
+ return false;
138
+ }
139
+ return true;
140
+ }
141
+ /** One actual source copy and one tight canonical output; callers reserve that peak first. */
142
+ export function copySharedPagePixels(image, diagnostics, levels = 1) {
143
+ let source, output;
144
+ try {
145
+ source = copyImageData2DPixels(image);
146
+ if (diagnostics) {
147
+ diagnostics.scratchBytes += source.byteLength;
148
+ sampleCopy(diagnostics);
149
+ }
150
+ output = new Uint8Array(levels === 1 ? source.byteLength : sharedPageChainBytes2D(image.width, image.height, levels));
151
+ if (diagnostics) {
152
+ diagnostics.canonicalBytes += output.byteLength;
153
+ sampleCopy(diagnostics);
154
+ }
155
+ const sourceWords = new Uint32Array(source.buffer, source.byteOffset, source.length / 4);
156
+ const outputWords = new Uint32Array(output.buffer, output.byteOffset, sourceWords.length);
157
+ const blockBytes = 1024 * 4;
158
+ for (let start = 0; start < source.length; start += blockBytes) {
159
+ const end = Math.min(start + blockBytes, source.length);
160
+ if (!hasEndpointRuns(source, start, end)) {
161
+ for (let offset = start; offset < end; offset += 4) {
162
+ writePremultipliedPixel(source, output, offset, source[offset + 3]);
163
+ }
164
+ continue;
165
+ }
166
+ for (let offset = start; offset < end; offset += 4) {
167
+ const alpha = source[offset + 3];
168
+ // Transparent black is already zero. Whole-word copying preserves byte order on either endianness.
169
+ if (alpha === 0)
170
+ continue;
171
+ if (alpha === 255)
172
+ outputWords[offset / 4] = sourceWords[offset / 4];
173
+ else
174
+ writePremultipliedPixel(source, output, offset, alpha);
175
+ }
176
+ }
177
+ if (levels > 1)
178
+ fillSharedLevels2D(output, image.width, image.height, levels);
179
+ return output;
180
+ }
181
+ catch (cause) {
182
+ if (diagnostics && output)
183
+ diagnostics.canonicalBytes -= output.byteLength;
184
+ throw cause;
185
+ }
186
+ finally {
187
+ if (diagnostics && source)
188
+ diagnostics.scratchBytes -= source.byteLength;
189
+ }
190
+ }
191
+ //# sourceMappingURL=sharedColor2D.js.map
@@ -0,0 +1,23 @@
1
+ import type { SharedRenderFrame2D } from '@egret/contracts';
2
+ /** A schedule contains no native handles and borrows only immutable captured data. */
3
+ /** `spread` is the radius in backing pixels of a glow or outline, whose alpha a pass spreads into the group's scratch target, or -1 for neither. */
4
+ export interface PreparedEffect2D {
5
+ readonly enter: number;
6
+ readonly exit: number;
7
+ readonly depth: number;
8
+ readonly maskPageIndex: number | undefined;
9
+ readonly radius: number;
10
+ readonly spread: number;
11
+ readonly uniform: Float32Array<ArrayBuffer>;
12
+ }
13
+ /** The bytes of one group's uniform: 36 vectors of four floats. */
14
+ export declare const EFFECT_UNIFORM_BYTES = 576;
15
+ export interface PreparedEffects2D {
16
+ readonly groups: readonly PreparedEffect2D[];
17
+ readonly depth: number;
18
+ readonly targetCount: number;
19
+ readonly uniformBytes: number;
20
+ }
21
+ /** All admission precedes target/buffer allocation. Clips execute at group composition. */
22
+ export declare function prepareEffects2D(frame: SharedRenderFrame2D, ratio: number, enabled: boolean): PreparedEffects2D;
23
+ //# sourceMappingURL=sharedEffects2D.d.ts.map