@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,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,18 @@
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
+ export declare function encodeSharedSRGB(value: number): number;
7
+ /** Plain Host-owned observation only; no allocator, callback or resource authority. */
8
+ export interface SharedPageCopyDiagnostics2D {
9
+ canonicalBytes: number;
10
+ scratchBytes: number;
11
+ highCanonicalBytes: number;
12
+ highScratchBytes: number;
13
+ highTemporaryBytes: number;
14
+ saturated: boolean;
15
+ }
16
+ /** One actual source copy and one tight canonical output; callers reserve that peak first. */
17
+ export declare function copySharedPagePixels(image: ImageData2D, diagnostics?: SharedPageCopyDiagnostics2D): Uint8Array<ArrayBuffer>;
18
+ //# sourceMappingURL=sharedColor2D.d.ts.map
@@ -0,0 +1,68 @@
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
+ export function encodeSharedSRGB(value) {
12
+ return value <= 0.0031308 ? 12.92 * value : 1.055 * value ** (1 / 2.4) - 0.055;
13
+ }
14
+ const caps = Object.freeze(Array.from({ length: 256 }, (_, alpha) => {
15
+ let code = 0;
16
+ while (code < 255 && decodeSharedSRGB((code + 1) / 255) <= alpha / 255)
17
+ code++;
18
+ return code;
19
+ }));
20
+ // All alpha and channel inputs are bytes. Precompute the exact scalar rule once.
21
+ const premultipliedSrgb = new Uint8Array(256 * 256);
22
+ for (let alpha = 0; alpha < 256; alpha++) {
23
+ const a = alpha / 255, cap = caps[alpha];
24
+ for (let code = 0; code < 256; code++)
25
+ premultipliedSrgb[(alpha << 8) | code] = Math.min(cap, Math.floor(255 * encodeSharedSRGB(a * decodeSharedSRGB(code / 255)) + 0.5));
26
+ }
27
+ function sampleCopy(diagnostics) {
28
+ diagnostics.highCanonicalBytes = Math.max(diagnostics.highCanonicalBytes, diagnostics.canonicalBytes);
29
+ diagnostics.highScratchBytes = Math.max(diagnostics.highScratchBytes, diagnostics.scratchBytes);
30
+ const excess = diagnostics.canonicalBytes > Number.MAX_SAFE_INTEGER - diagnostics.scratchBytes;
31
+ if (excess)
32
+ diagnostics.saturated = true;
33
+ diagnostics.highTemporaryBytes = Math.max(diagnostics.highTemporaryBytes, excess ? Number.MAX_SAFE_INTEGER : diagnostics.canonicalBytes + diagnostics.scratchBytes);
34
+ }
35
+ /** One actual source copy and one tight canonical output; callers reserve that peak first. */
36
+ export function copySharedPagePixels(image, diagnostics) {
37
+ let source, output;
38
+ try {
39
+ source = copyImageData2DPixels(image);
40
+ if (diagnostics) {
41
+ diagnostics.scratchBytes += source.byteLength;
42
+ sampleCopy(diagnostics);
43
+ }
44
+ output = new Uint8Array(source.byteLength);
45
+ if (diagnostics) {
46
+ diagnostics.canonicalBytes += output.byteLength;
47
+ sampleCopy(diagnostics);
48
+ }
49
+ for (let offset = 0; offset < source.length; offset += 4) {
50
+ const alpha = source[offset + 3], row = alpha << 8;
51
+ output[offset] = premultipliedSrgb[row | source[offset]];
52
+ output[offset + 1] = premultipliedSrgb[row | source[offset + 1]];
53
+ output[offset + 2] = premultipliedSrgb[row | source[offset + 2]];
54
+ output[offset + 3] = alpha;
55
+ }
56
+ return output;
57
+ }
58
+ catch (cause) {
59
+ if (diagnostics && output)
60
+ diagnostics.canonicalBytes -= output.byteLength;
61
+ throw cause;
62
+ }
63
+ finally {
64
+ if (diagnostics && source)
65
+ diagnostics.scratchBytes -= source.byteLength;
66
+ }
67
+ }
68
+ //# 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
@@ -0,0 +1,118 @@
1
+ import { decodeSRGBByte } from './srgbBytes.js';
2
+ /** The bytes of one group's uniform: 36 vectors of four floats. */
3
+ export const EFFECT_UNIFORM_BYTES = 576;
4
+ function fail() {
5
+ throw new RangeError('Shared effect limits or geometry are unsupported');
6
+ }
7
+ function inverse(m, rect, ratio) {
8
+ const det = m.a * m.d - m.b * m.c;
9
+ if (!Number.isFinite(det) || Math.abs(det) < 1e-12)
10
+ fail();
11
+ const a = m.d / det, b = -m.b / det, c = -m.c / det, d = m.a / det;
12
+ const values = [
13
+ a / ratio,
14
+ b / ratio,
15
+ c / ratio,
16
+ d / ratio,
17
+ -a * m.tx - c * m.ty,
18
+ -b * m.tx - d * m.ty,
19
+ rect.x,
20
+ rect.y,
21
+ rect.width,
22
+ rect.height,
23
+ 0,
24
+ 0
25
+ ].map(Math.fround);
26
+ if (values.some(v => !Number.isFinite(v)) || values[8] <= 0 || values[9] <= 0)
27
+ fail();
28
+ return values;
29
+ }
30
+ /** All admission precedes target/buffer allocation. Clips execute at group composition. */
31
+ export function prepareEffects2D(frame, ratio, enabled) {
32
+ const groups = [], stack = [];
33
+ let depth = 0;
34
+ for (const command of frame.commands) {
35
+ if (command.kind !== 'barrier') {
36
+ if (stack.length && frame.materials[command.materialIndex]?.blend === 'add-preserve')
37
+ fail();
38
+ continue;
39
+ }
40
+ if (command.reason === 'effect-enter') {
41
+ if (!enabled || !command.effect || groups.length >= 8 || stack.length >= 4)
42
+ fail();
43
+ const e = command.effect, radius = Math.min(16, Math.ceil(e.blurRadius * ratio));
44
+ if (!Number.isInteger(radius) || radius < 0 || radius > 16 || e.clips.length > 8)
45
+ fail();
46
+ const uniform = new Float32Array(EFFECT_UNIFORM_BYTES / 4);
47
+ uniform[0] = radius;
48
+ uniform[2] = e.clips.length;
49
+ let spread = 0;
50
+ // Vector 28: whether there is a colour matrix, the kind of spread, its radius and its strength; 29: its colour in linear
51
+ // light and its alpha; 30: its offset in backing pixels, inner and knockout; 31-35: the matrix, by rows, and its offsets.
52
+ if (e.colorMatrix !== undefined) {
53
+ if (e.colorMatrix.length !== 20 || e.colorMatrix.some(v => !Number.isFinite(v)))
54
+ fail();
55
+ uniform[112] = 1;
56
+ for (let row = 0; row < 4; row++) {
57
+ for (let k = 0; k < 4; k++)
58
+ uniform[124 + row * 4 + k] = e.colorMatrix[row * 5 + k];
59
+ uniform[140 + row] = e.colorMatrix[row * 5 + 4] / 255;
60
+ }
61
+ }
62
+ if (e.glow !== undefined) {
63
+ const g = e.glow;
64
+ spread =
65
+ g.kind === 'outline'
66
+ ? Math.min(16, Math.max(1, Math.round(g.spread * ratio)))
67
+ : Math.min(16, Math.ceil(g.spread * ratio));
68
+ if (!Number.isInteger(spread) || spread < 0 || !Number.isInteger(g.color) || g.color < 0 || g.color > 0xffffff)
69
+ fail();
70
+ uniform[113] = g.kind === 'outline' ? 2 : 1;
71
+ uniform[114] = spread;
72
+ uniform[115] = g.strength;
73
+ uniform[116] = decodeSRGBByte(g.color >> 16);
74
+ uniform[117] = decodeSRGBByte(g.color >> 8);
75
+ uniform[118] = decodeSRGBByte(g.color);
76
+ uniform[119] = g.alpha;
77
+ uniform[120] = Math.round(g.offsetX * ratio);
78
+ uniform[121] = Math.round(g.offsetY * ratio);
79
+ uniform[122] = g.inner ? 1 : 0;
80
+ uniform[123] = g.knockout ? 1 : 0;
81
+ }
82
+ if (e.maskPageIndex !== undefined) {
83
+ if (!Number.isInteger(e.maskPageIndex) || !frame.pages[e.maskPageIndex] || !e.maskRect)
84
+ fail();
85
+ uniform[3] = 1;
86
+ uniform.set(inverse(e.matrix, e.maskRect, ratio), 4);
87
+ }
88
+ for (let i = 0; i < e.clips.length; i++) {
89
+ const clip = e.clips[i];
90
+ uniform.set(inverse(clip.matrix, clip.rect, ratio), 16 + i * 12);
91
+ }
92
+ const index = groups.length;
93
+ groups.push({
94
+ enter: command.ordinal,
95
+ exit: -1,
96
+ depth: stack.length + 1,
97
+ maskPageIndex: e.maskPageIndex,
98
+ radius,
99
+ spread: e.glow === undefined ? -1 : spread,
100
+ uniform
101
+ });
102
+ stack.push({ id: command.boundaryId, index });
103
+ depth = Math.max(depth, stack.length);
104
+ }
105
+ else if (command.reason === 'effect-exit') {
106
+ const top = stack.pop();
107
+ if (!top || top.id !== command.boundaryId)
108
+ fail();
109
+ groups[top.index] = { ...groups[top.index], exit: command.ordinal };
110
+ }
111
+ else if (command.effect !== undefined)
112
+ fail();
113
+ }
114
+ if (stack.length)
115
+ fail();
116
+ return { groups, depth, targetCount: 2 * depth, uniformBytes: groups.length * EFFECT_UNIFORM_BYTES };
117
+ }
118
+ //# sourceMappingURL=sharedEffects2D.js.map