@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,663 @@
1
+ import { isImageData2D, isSharedGeometry2D, isSharedMaterial2D, isTexturedGeometry2D } from '@egret/contracts';
2
+ import { prepareEffects2D } from './sharedEffects2D.js';
3
+ import { Preparation, coordinate, clipPolygon2D, finishPolygonWinding2D } from './prepareRectangles2D.js';
4
+ import { TexturedPreparationBudget2D } from './texturedPreparationBudget2D.js';
5
+ import { noteOwnedPreparationFailure } from './ownedPreparationFailure2D.js';
6
+ import { decodeSharedSRGBByte, sharedBlendSpace2D, sharedPageChainBytes2D, sharedPageLevels2D } from './sharedColor2D.js';
7
+ export class SharedPreparationError extends Error {
8
+ reason;
9
+ constructor(reason) {
10
+ super('Shared preparation ' + reason);
11
+ this.reason = reason;
12
+ }
13
+ }
14
+ export function sharedFailure(reason) {
15
+ throw noteOwnedPreparationFailure(new SharedPreparationError(reason));
16
+ }
17
+ /** What one shared frame may hold at most, whatever a Host is configured to admit. */
18
+ export const SHARED_FRAME_REGIONS_2D = 4096, SHARED_FRAME_PAGE_BYTES_2D = 67108864;
19
+ const ATTRS = ['u', 'v', 'r', 'g', 'b', 'a', 'dr', 'dg', 'db'];
20
+ function unit(value) {
21
+ if (!Number.isFinite(value) || value < 0 || value > 1)
22
+ sharedFailure('precision');
23
+ return value === 0 ? 0 : value;
24
+ }
25
+ function uv(value) {
26
+ if (!Number.isFinite(value))
27
+ sharedFailure('precision');
28
+ return value === 0 ? 0 : value;
29
+ }
30
+ function add(used, value, limit) {
31
+ if (!Number.isSafeInteger(value) || value < 0 || value > limit - used)
32
+ sharedFailure('budget');
33
+ return used + value;
34
+ }
35
+ /** Undefined for a draw without a page, whose corners are not qualified. */
36
+ export function sharedUVDomain(draw, frame) {
37
+ if (draw.pageIndex === undefined)
38
+ return undefined;
39
+ const region = draw.region, page = frame.pages[draw.pageIndex].source, material = draw.material;
40
+ const width = material.samplingDomain === 'page' ? page.width : region.logicalWidth;
41
+ const height = material.samplingDomain === 'page' ? page.height : region.logicalHeight;
42
+ const periodic = material.samplingDomain === 'page' &&
43
+ (material.addressU !== 'clamp-to-edge' || material.addressV !== 'clamp-to-edge');
44
+ return { width, height, limit: periodic ? 8192 : 1048576 };
45
+ }
46
+ /** Check one corner using the resolved draw domain and f32 preparation without clamping or wrapping authored UVs. */
47
+ export function qualifySharedUVIn(pointU, pointV, domain) {
48
+ const limit = domain.limit, u = Math.fround(pointU), v = Math.fround(pointV), x = Math.fround(u * domain.width), y = Math.fround(v * domain.height);
49
+ if (!Number.isFinite(u) ||
50
+ !Number.isFinite(v) ||
51
+ !Number.isFinite(x) ||
52
+ !Number.isFinite(y) ||
53
+ Math.abs(x) > limit ||
54
+ Math.abs(y) > limit)
55
+ sharedFailure('precision');
56
+ }
57
+ /** The height, in backing pixels, under which a corner that turns against its polygon counts as collapsed. */
58
+ const SLIVER_HEIGHT = 1 / 1024;
59
+ function policyFor(budget) {
60
+ const sameXY = (a, b) => {
61
+ budget.admitTupleComparison();
62
+ return a.x === b.x && a.y === b.y;
63
+ };
64
+ const sameAttributes = (a, b) => {
65
+ budget.admitTupleComparison();
66
+ return (a.u === b.u &&
67
+ a.v === b.v &&
68
+ a.r === b.r &&
69
+ a.g === b.g &&
70
+ a.b === b.b &&
71
+ a.a === b.a &&
72
+ a.dr === b.dr &&
73
+ a.dg === b.dg &&
74
+ a.db === b.db);
75
+ };
76
+ const assertAppend = (length) => {
77
+ if (!Number.isSafeInteger(length) || length < 0 || length >= 64)
78
+ sharedFailure('budget');
79
+ };
80
+ const policy = {
81
+ maxCorners: 64,
82
+ before(a, b) {
83
+ budget.admitTupleComparison();
84
+ return a.x < b.x || (a.x === b.x && a.y < b.y);
85
+ },
86
+ sameTuple(a, b) {
87
+ return sameXY(a, b) && sameAttributes(a, b);
88
+ },
89
+ assertAppend
90
+ };
91
+ // `owned` marks corners this preparation created itself and nothing else reads: they are checked and
92
+ // made canonical where they are, in the same order, instead of being copied into new objects.
93
+ // What a clip gives back may be degenerate by a rounding error where a corner all but touches the clip's edge:
94
+ // its two crossings of that edge land on one place with weights a rounding apart, or a hair to either side of
95
+ // each other, which makes a turn against the polygon thinner than any pixel. Such a polygon is settled here
96
+ // instead of refusing the frame. Corners the caller wrote are held to the exact rules as before.
97
+ const settle = (preparation, points) => {
98
+ for (let again = true; again && points.length >= 3;) {
99
+ again = false;
100
+ const n = points.length;
101
+ const turn = (i) => {
102
+ const a = points[(i + n - 1) % n], b = points[i], c = points[(i + 1) % n];
103
+ return (b.x - a.x) * (c.y - b.y) - (b.y - a.y) * (c.x - b.x);
104
+ };
105
+ let widest = 0;
106
+ for (let i = 1; i < n; i++)
107
+ if (Math.abs(turn(i)) > Math.abs(turn(widest)))
108
+ widest = i;
109
+ if (turn(widest) === 0)
110
+ return;
111
+ let way;
112
+ for (let i = 0; i < n; i++) {
113
+ if (i === widest)
114
+ continue;
115
+ const a = points[(i + n - 1) % n], b = points[i], c = points[(i + 1) % n];
116
+ // A spike out to one corner and back to the same place covers nothing.
117
+ if (a.x === c.x && a.y === c.y) {
118
+ points.splice(i, 1);
119
+ again = true;
120
+ break;
121
+ }
122
+ const longest = Math.sqrt(Math.max((b.x - a.x) ** 2 + (b.y - a.y) ** 2, (c.x - b.x) ** 2 + (c.y - b.y) ** 2, (c.x - a.x) ** 2 + (c.y - a.y) ** 2));
123
+ if (!(Math.abs(turn(i)) <= longest * SLIVER_HEIGHT))
124
+ continue;
125
+ // Only a thin corner is asked the exact question, and only one that turns against the polygon goes.
126
+ way ??= preparation.sign(points[(widest + n - 1) % n], points[widest], points[(widest + 1) % n]);
127
+ const sign = preparation.sign(a, b, c);
128
+ if (sign !== 0 && sign !== way) {
129
+ points.splice(i, 1);
130
+ again = true;
131
+ break;
132
+ }
133
+ }
134
+ // Taking a corner out may bring two crossings of one place together.
135
+ for (let i = 0; !again && i < points.length; i++) {
136
+ const next = (i + 1) % points.length;
137
+ // Compared without the budget's count: an ordinary polygon is charged exactly what it was.
138
+ if (next !== i && points[i].x === points[next].x && points[i].y === points[next].y) {
139
+ points.splice(next, 1);
140
+ again = true;
141
+ }
142
+ }
143
+ }
144
+ };
145
+ const finish = (preparation, input, owned, clipped = false) => {
146
+ if (input.length > 64)
147
+ sharedFailure('budget');
148
+ const result = [];
149
+ for (const p of input) {
150
+ let value;
151
+ if (owned) {
152
+ const q = p;
153
+ q.x = coordinate(q.x);
154
+ q.y = coordinate(q.y);
155
+ q.u = uv(q.u);
156
+ q.v = uv(q.v);
157
+ q.r = unit(q.r);
158
+ q.g = unit(q.g);
159
+ q.b = unit(q.b);
160
+ q.a = unit(q.a);
161
+ q.dr = unit(q.dr);
162
+ q.dg = unit(q.dg);
163
+ q.db = unit(q.db);
164
+ value = q;
165
+ }
166
+ else
167
+ value = {
168
+ x: coordinate(p.x),
169
+ y: coordinate(p.y),
170
+ u: uv(p.u),
171
+ v: uv(p.v),
172
+ r: unit(p.r),
173
+ g: unit(p.g),
174
+ b: unit(p.b),
175
+ a: unit(p.a),
176
+ dr: unit(p.dr),
177
+ dg: unit(p.dg),
178
+ db: unit(p.db)
179
+ };
180
+ const previous = result[result.length - 1];
181
+ if (previous && sameXY(previous, value)) {
182
+ // The comparison is made, and charged, as it always was; only its refusal is spared a clip's own corners.
183
+ if (!sameAttributes(previous, value) && !clipped)
184
+ sharedFailure('precision');
185
+ }
186
+ else {
187
+ assertAppend(result.length);
188
+ result.push(value);
189
+ }
190
+ }
191
+ if (result.length > 1 && sameXY(result[0], result[result.length - 1])) {
192
+ if (!sameAttributes(result[0], result[result.length - 1]) && !clipped)
193
+ sharedFailure('precision');
194
+ result.pop();
195
+ }
196
+ if (!clipped) {
197
+ for (let i = 0; i < result.length; i++)
198
+ for (let j = i + 1; j < result.length; j++)
199
+ if (sameXY(result[i], result[j])) {
200
+ sameAttributes(result[i], result[j]);
201
+ sharedFailure('precision');
202
+ }
203
+ return result.length < 3 ? [] : finishPolygonWinding2D(preparation, result);
204
+ }
205
+ // A clip's own polygon is asked the same questions in the same order, so one that passes is charged exactly
206
+ // what it always was. Where it would have been refused, it is settled first and asked again.
207
+ let degenerate = false;
208
+ search: for (let i = 0; i < result.length; i++)
209
+ for (let j = i + 1; j < result.length; j++)
210
+ if (sameXY(result[i], result[j])) {
211
+ sameAttributes(result[i], result[j]);
212
+ degenerate = true;
213
+ break search;
214
+ }
215
+ if (!degenerate) {
216
+ if (result.length < 3)
217
+ return [];
218
+ let winding = 0;
219
+ for (let i = 0; i < result.length; i++) {
220
+ const sign = preparation.sign(result[i], result[(i + 1) % result.length], result[(i + 2) % result.length]);
221
+ if (sign !== 0) {
222
+ if (winding !== 0 && winding !== sign) {
223
+ degenerate = true;
224
+ break;
225
+ }
226
+ winding = sign;
227
+ }
228
+ }
229
+ if (!degenerate) {
230
+ if (winding === 0)
231
+ return [];
232
+ if (winding < 0)
233
+ result.reverse();
234
+ return result;
235
+ }
236
+ }
237
+ settle(preparation, result);
238
+ for (let i = 0; i < result.length; i++)
239
+ for (let j = i + 1; j < result.length; j++)
240
+ if (sameXY(result[i], result[j]))
241
+ sharedFailure('precision');
242
+ return result.length < 3 ? [] : finishPolygonWinding2D(preparation, result);
243
+ };
244
+ // The clip's own normalization: its input is what the clip made.
245
+ const normalize = (preparation, input) => finish(preparation, input, false, true);
246
+ const normalizeOwned = (preparation, input) => finish(preparation, input, true);
247
+ return { policy, normalize, normalizeOwned };
248
+ }
249
+ const attach = (p, q, weight, complementary, x, y) => {
250
+ const value = (key) => {
251
+ const n = complementary ? q[key] + weight * (p[key] - q[key]) : p[key] + weight * (q[key] - p[key]);
252
+ return key === 'u' || key === 'v' ? uv(n) : unit(n);
253
+ };
254
+ return {
255
+ x: coordinate(x),
256
+ y: coordinate(y),
257
+ u: value('u'),
258
+ v: value('v'),
259
+ r: value('r'),
260
+ g: value('g'),
261
+ b: value('b'),
262
+ a: value('a'),
263
+ dr: value('dr'),
264
+ dg: value('dg'),
265
+ db: value('db')
266
+ };
267
+ };
268
+ /** Moves an authored corner this preparation owns to backing space; both coordinates are read before either is written. */
269
+ function transform(p, m, ratio) {
270
+ const x = coordinate(coordinate(coordinate(m.a * p.x) + coordinate(m.c * p.y)) + m.tx);
271
+ const y = coordinate(coordinate(coordinate(m.b * p.x) + coordinate(m.d * p.y)) + m.ty);
272
+ const backingX = coordinate(x * ratio);
273
+ p.y = coordinate(y * ratio);
274
+ p.x = backingX;
275
+ }
276
+ const ORIGIN = { x: 0, y: 0 };
277
+ const NO_CLIPS = [];
278
+ /**
279
+ * Authentic completion is checked by Host; this helper still defends all table references. With `retention`,
280
+ * a draw whose every input is the same as in the last frame takes the geometry kept for it, once the charges
281
+ * recorded with that geometry fit what is left of the budget; any other draw is prepared here and kept.
282
+ * The frame's tables, every command's own numbers and every frame-wide charge are checked for every frame.
283
+ */
284
+ export function prepareSharedDraws2D(frame, width, height, options, retention) {
285
+ if (frame.profile !== 'egret.shared-frame2d/1' || sharedBlendSpace2D(frame) === undefined)
286
+ sharedFailure('profile');
287
+ if (frame.commands.length > options.maxCommands ||
288
+ frame.commands.length > 65536 ||
289
+ frame.pages.length > 64 ||
290
+ frame.regions.length > Math.min(SHARED_FRAME_REGIONS_2D, options.maxFrameRegions ?? SHARED_FRAME_REGIONS_2D) ||
291
+ frame.materials.length > 256 ||
292
+ frame.geometries.length > 4096)
293
+ sharedFailure('budget');
294
+ const pageLimit = Math.min(SHARED_FRAME_PAGE_BYTES_2D, options.maxFramePageBytes ?? SHARED_FRAME_PAGE_BYTES_2D);
295
+ const effects = prepareEffects2D(frame, options.pixelRatio, options.enableEffects === true);
296
+ const budget = new TexturedPreparationBudget2D(options);
297
+ let geometryBytes = 0, pageBytes = 0, clipsCount = 0;
298
+ for (const command of frame.commands)
299
+ if (command.kind === 'barrier' && command.effect)
300
+ clipsCount = add(clipsCount, command.effect.clips.length, options.maxClipRectangles);
301
+ // A page sampled by a draw whose material asks for smaller copies is uploaded with all its levels.
302
+ const pageLevels = frame.pages.map(() => 1);
303
+ for (const command of frame.commands)
304
+ if ((command.kind === 'image' || command.kind === 'mesh') &&
305
+ frame.materials[command.materialIndex]?.mipmapFilter === 'linear') {
306
+ const index = frame.regions[command.regionIndex]?.pageIndex, source = index === undefined ? undefined : frame.pages[index]?.source;
307
+ if (source !== undefined && isImageData2D(source))
308
+ pageLevels[index] = sharedPageLevels2D(source.width, source.height);
309
+ }
310
+ for (let index = 0; index < frame.pages.length; index++) {
311
+ const page = frame.pages[index];
312
+ if (!isImageData2D(page.source) ||
313
+ page.sourceRepresentation !== 'egret.srgb-straight-rgba8/1' ||
314
+ page.canonicalRepresentation !== 'egret.alpha8-capped-srgb-pma8/1')
315
+ sharedFailure('frame');
316
+ pageBytes = add(pageBytes, pageLevels[index] === 1
317
+ ? page.source.byteLength
318
+ : sharedPageChainBytes2D(page.source.width, page.source.height, pageLevels[index]), pageLimit);
319
+ }
320
+ for (const material of frame.materials) {
321
+ if (!isSharedMaterial2D(material))
322
+ sharedFailure('frame');
323
+ if (material.blend === 'add-preserve' && frame.outputAlpha !== 'opaque')
324
+ sharedFailure('profile');
325
+ }
326
+ for (const geometry of frame.geometries) {
327
+ if (!isTexturedGeometry2D(geometry) && !isSharedGeometry2D(geometry))
328
+ sharedFailure('frame');
329
+ geometryBytes = add(geometryBytes, geometry.logicalByteLength, options.maxFrameGeometryBytes);
330
+ }
331
+ for (const region of frame.regions) {
332
+ const page = frame.pages[region.pageIndex]?.source, p = region.packed;
333
+ if (!Number.isSafeInteger(region.pageIndex) ||
334
+ !page ||
335
+ ![
336
+ p.x,
337
+ p.y,
338
+ p.width,
339
+ p.height,
340
+ region.logicalWidth,
341
+ region.logicalHeight,
342
+ region.trimX,
343
+ region.trimY,
344
+ region.quarterTurn
345
+ ].every(Number.isSafeInteger) ||
346
+ p.x < 0 ||
347
+ p.y < 0 ||
348
+ p.width <= 0 ||
349
+ p.height <= 0 ||
350
+ p.x + p.width > page.width ||
351
+ p.y + p.height > page.height ||
352
+ region.logicalWidth <= 0 ||
353
+ region.logicalHeight <= 0 ||
354
+ region.logicalWidth > 1048576 ||
355
+ region.logicalHeight > 1048576 ||
356
+ region.trimX < 0 ||
357
+ region.trimY < 0 ||
358
+ region.quarterTurn < 0 ||
359
+ region.quarterTurn > 3)
360
+ sharedFailure('frame');
361
+ const odd = region.quarterTurn === 1 || region.quarterTurn === 3;
362
+ if (region.trimX + (odd ? p.height : p.width) > region.logicalWidth ||
363
+ region.trimY + (odd ? p.width : p.height) > region.logicalHeight)
364
+ sharedFailure('frame');
365
+ }
366
+ for (let i = 0; i < frame.commands.length; i++) {
367
+ const command = frame.commands[i];
368
+ if (command.ordinal !== i || !Number.isSafeInteger(command.occurrenceId) || command.occurrenceId < 0)
369
+ sharedFailure('frame');
370
+ if (command.kind === 'barrier')
371
+ continue;
372
+ if (!frame.materials[command.materialIndex])
373
+ sharedFailure('frame');
374
+ clipsCount = add(clipsCount, command.clips.length, options.maxClipRectangles);
375
+ if (command.kind !== 'rect' && !frame.regions[command.regionIndex])
376
+ sharedFailure('frame');
377
+ if (command.kind === 'mesh') {
378
+ const geometry = frame.geometries[command.geometryIndex];
379
+ if (!geometry)
380
+ sharedFailure('frame');
381
+ budget.admitSourceTriangles(geometry.triangleCount);
382
+ }
383
+ }
384
+ const entries = [];
385
+ let upload = 0;
386
+ const retained = retention ? [] : undefined;
387
+ retention?.begin(frame.commands.length, width, height, options.pixelRatio, options);
388
+ // One clip policy and one predicate ledger serve every command; the ledger's per-command count restarts at each draw.
389
+ // The inactive context only states that every polygon handed to clipping is owned by this call, so a
390
+ // step that leaves a polygon unchanged returns it instead of a copy. No clip rectangle is cached.
391
+ const owned = { options, budget, active: false, entries: undefined };
392
+ const { policy, normalize, normalizeOwned } = policyFor(budget), preparation = new Preparation(options, budget, true, owned);
393
+ const axisX = { x: 0, y: 0 }, axisY = { x: 0, y: 0 };
394
+ let lastColor = -1, red = 0, green = 0, blue = 0;
395
+ let viewport, ratio = 0;
396
+ // The state of the command being prepared, read by `accept` below.
397
+ let command, m, clips = NO_CLIPS, polygons = [], vertexReservation = 0;
398
+ // What the corners of the command's texture coordinates are qualified against; undefined for a draw without a page.
399
+ let uvDomain;
400
+ // Both SHARED Hosts authenticate the frame before this private helper owns its budget.
401
+ // Shared polygons retain attributed corners and charge the same XY comparisons as TEXTURED meshes.
402
+ const intersect = (polygon, clip) => preparation.tryContainedClip(polygon, clip, 'mesh') ??
403
+ clipPolygon2D(preparation, polygon, clip, normalize, attach, policy, 'mesh');
404
+ // A quad of a matrix without rotation or shear, whose corners stay apart once placed, needs none of the general
405
+ // path's tests to be known: its three signs agree and its four corners are distinct, so normalizing keeps them in
406
+ // order, reversed when the placed winding is negative. The general path's charges for those tests (seven predicates
407
+ // and ten corner comparisons) are made at once; when they do not fit, or anything else differs, the general path runs
408
+ // instead and decides the first failure itself. The result is the same polygon, made of the same corner objects.
409
+ const QUAD_COST = { preparedVertices: 0, predicates: 7, tupleComparisons: 10 };
410
+ const axisQuad = (points) => {
411
+ if (m.b !== 0 || m.c !== 0 || m.a === 0 || m.d === 0)
412
+ return undefined;
413
+ const p0 = points[0], p1 = points[1], p2 = points[2], p3 = points[3];
414
+ // The corners as the rectangle path makes them: top-left, top-right, bottom-right, bottom-left, with x<right and y<bottom.
415
+ if (!(p0.x < p1.x) || p1.x !== p2.x || p3.x !== p0.x || !(p0.y < p2.y) || p1.y !== p0.y || p3.y !== p2.y)
416
+ return undefined;
417
+ if (QUAD_COST.predicates > options.maxClipEdgeTests - preparation.edgeTests)
418
+ return undefined;
419
+ // Placed, the corners keep the same x for the same authored x and the same y for the same authored y.
420
+ // A corner placed out of range is left to the general path, which reports it after the charges it makes first.
421
+ let x0, x1, y0, y1;
422
+ try {
423
+ x0 = placeX(p0.x);
424
+ x1 = placeX(p1.x);
425
+ y0 = placeY(p0.y);
426
+ y1 = placeY(p2.y);
427
+ }
428
+ catch {
429
+ return undefined;
430
+ }
431
+ if (x0 === x1 || y0 === y1)
432
+ return undefined;
433
+ const sign = x1 > x0 === y1 > y0 ? 1 : -1, rank = m.a > 0 === m.d > 0 ? 1 : -1;
434
+ if (sign !== rank || !budget.tryReplayStageCost(QUAD_COST))
435
+ return undefined;
436
+ preparation.edgeTests += QUAD_COST.predicates;
437
+ p0.x = x0;
438
+ p0.y = y0;
439
+ p1.x = x1;
440
+ p1.y = y0;
441
+ p2.x = x1;
442
+ p2.y = y1;
443
+ p3.x = x0;
444
+ p3.y = y1;
445
+ for (const q of points) {
446
+ q.x = coordinate(q.x);
447
+ q.y = coordinate(q.y);
448
+ q.u = uv(q.u);
449
+ q.v = uv(q.v);
450
+ q.r = unit(q.r);
451
+ q.g = unit(q.g);
452
+ q.b = unit(q.b);
453
+ q.a = unit(q.a);
454
+ q.dr = unit(q.dr);
455
+ q.dg = unit(q.dg);
456
+ q.db = unit(q.db);
457
+ }
458
+ return sign < 0 ? [p3, p2, p1, p0] : [p0, p1, p2, p3];
459
+ };
460
+ // The same steps as `transform` for a matrix without rotation or shear: the cross terms are zero.
461
+ const placeX = (x) => coordinate(coordinate(coordinate(coordinate(m.a * x) + coordinate(m.c * 0)) + m.tx) * ratio);
462
+ const placeY = (y) => coordinate(coordinate(coordinate(coordinate(m.b * 0) + coordinate(m.d * y)) + m.ty) * ratio);
463
+ // `points` are fresh authored corners; they become the backing-space corners in place.
464
+ const accept = (points) => {
465
+ if (uvDomain !== undefined)
466
+ for (const p of points)
467
+ qualifySharedUVIn(p.u, p.v, uvDomain);
468
+ let polygon = points.length === 4 ? axisQuad(points) : undefined;
469
+ if (polygon === undefined) {
470
+ const authored = preparation.sign(points[0], points[1], points[2]);
471
+ if (authored === 0)
472
+ return;
473
+ axisX.x = m.a;
474
+ axisX.y = m.b;
475
+ axisY.x = m.c;
476
+ axisY.y = m.d;
477
+ const rank = preparation.sign(ORIGIN, axisX, axisY);
478
+ if (rank === 0)
479
+ return;
480
+ for (const p of points)
481
+ transform(p, m, ratio);
482
+ const sign = preparation.sign(points[0], points[1], points[2]);
483
+ if (sign === 0)
484
+ return;
485
+ if (sign !== authored * rank) {
486
+ // A matrix that presses a shape thinner than any pixel, as a scale on its way through nothing does, leaves
487
+ // triangles that the rounding of their corners turns over. Such a triangle covers nothing and is not drawn;
488
+ // one with any height that has turned over is refused as before.
489
+ const a = points[0], b = points[1], c = points[2], ux = b.x - a.x, uy = b.y - a.y, vx = c.x - a.x, vy = c.y - a.y, wx = c.x - b.x, wy = c.y - b.y, longest = Math.sqrt(Math.max(ux * ux + uy * uy, vx * vx + vy * vy, wx * wx + wy * wy));
490
+ if (!(Math.abs(ux * vy - uy * vx) <= longest * SLIVER_HEIGHT))
491
+ sharedFailure('precision');
492
+ return;
493
+ }
494
+ polygon = normalizeOwned(preparation, points);
495
+ }
496
+ for (const clip of clips)
497
+ polygon = intersect(polygon, clip);
498
+ polygon = intersect(polygon, viewport);
499
+ if (uvDomain !== undefined)
500
+ for (const p of polygon)
501
+ qualifySharedUVIn(p.u, p.v, uvDomain);
502
+ if (polygon.length < 3 || command.opacity === 0)
503
+ return;
504
+ const count = (polygon.length - 2) * 3;
505
+ budget.admitPreparedVertices(count);
506
+ vertexReservation += count;
507
+ polygons.push(polygon);
508
+ };
509
+ try {
510
+ for (const entry of frame.commands) {
511
+ if (entry.kind === 'barrier') {
512
+ entries.push({ kind: 'barrier', ordinal: entry.ordinal, occurrenceId: entry.occurrenceId });
513
+ retained?.push(undefined);
514
+ continue;
515
+ }
516
+ command = entry;
517
+ const material = frame.materials[command.materialIndex], region = command.kind === 'rect' ? undefined : frame.regions[command.regionIndex], pageIndex = region?.pageIndex;
518
+ preparation.edgeTests = 0;
519
+ m = command.matrix;
520
+ ratio = coordinate(options.pixelRatio);
521
+ coordinate(m.a);
522
+ coordinate(m.b);
523
+ coordinate(m.c);
524
+ coordinate(m.d);
525
+ coordinate(m.tx);
526
+ coordinate(m.ty);
527
+ unit(command.opacity);
528
+ // A kept draw with these inputs gives its geometry, if its charges fit. Otherwise the draw is prepared below, as without retention.
529
+ const page = pageIndex === undefined ? undefined : frame.pages[pageIndex].source, geometry = command.kind === 'mesh' ? frame.geometries[command.geometryIndex] : undefined;
530
+ const found = retention?.find(command.ordinal, command, material, region, page, geometry);
531
+ if (found !== undefined && found.polygons !== undefined && budget.tryReplayStageCost(found.geometryCost)) {
532
+ // The record of the last frame is given again while it would be the same in every field that is read.
533
+ let kept = retention.rest(found, command, pageIndex);
534
+ if (kept === undefined) {
535
+ kept = {
536
+ kind: 'draw',
537
+ command,
538
+ material,
539
+ region,
540
+ pageIndex,
541
+ polygons: found.polygons,
542
+ vertexReservation: found.vertexReservation
543
+ };
544
+ retention.give(found, kept);
545
+ }
546
+ retention.carry(command.ordinal, found, command, region);
547
+ retained.push(found);
548
+ upload = add(upload, 52 * found.vertexReservation + 128, Number.MAX_SAFE_INTEGER);
549
+ entries.push(kept);
550
+ continue;
551
+ }
552
+ const verticesBefore = budget.preparedVerticesCharged, predicatesBefore = budget.predicatesCharged, tuplesBefore = budget.tupleComparisonsCharged;
553
+ clips = command.clips.length === 0 ? NO_CLIPS : command.clips.map(clip => preparation.rectangle(clip));
554
+ // The viewport corners are the same for every command; they are checked when the first draw reaches them.
555
+ viewport ??= [
556
+ { x: 0, y: 0 },
557
+ { x: coordinate(width), y: 0 },
558
+ { x: coordinate(width), y: coordinate(height) },
559
+ { x: 0, y: coordinate(height) }
560
+ ];
561
+ polygons = [];
562
+ vertexReservation = 0;
563
+ uvDomain = sharedUVDomain({ region, material, pageIndex }, frame);
564
+ if (command.kind === 'mesh') {
565
+ const g = frame.geometries[command.geometryIndex], shared = isSharedGeometry2D(g);
566
+ for (let i = 0; i < g.indexCount; i += 3) {
567
+ const points = [];
568
+ for (let k = 0; k < 3; k++) {
569
+ const n = g.indices[i + k], p = 2 * n, c = 4 * n, d = 3 * n;
570
+ points.push({
571
+ x: coordinate(g.positions[p]),
572
+ y: coordinate(g.positions[p + 1]),
573
+ u: uv(g.uvs[p]),
574
+ v: uv(g.uvs[p + 1]),
575
+ r: unit(g.lightColors[c]),
576
+ g: unit(g.lightColors[c + 1]),
577
+ b: unit(g.lightColors[c + 2]),
578
+ a: unit(g.lightColors[c + 3]),
579
+ dr: shared ? unit(g.darkColors[d]) : 0,
580
+ dg: shared ? unit(g.darkColors[d + 1]) : 0,
581
+ db: shared ? unit(g.darkColors[d + 2]) : 0
582
+ });
583
+ }
584
+ accept(points);
585
+ }
586
+ }
587
+ else {
588
+ const rect = command.rect, right = coordinate(rect.x + rect.width), bottom = coordinate(rect.y + rect.height);
589
+ coordinate(rect.x);
590
+ coordinate(rect.y);
591
+ coordinate(rect.width);
592
+ coordinate(rect.height);
593
+ const color = command.kind === 'rect' ? command.fillColor : 0xffffff, a = command.kind === 'rect' ? unit(command.fillAlpha) : 1;
594
+ // Decoding is a pure function of the colour; consecutive draws of one colour decode it once.
595
+ if (color !== lastColor) {
596
+ red = decodeSharedSRGBByte(color >>> 16);
597
+ green = decodeSharedSRGBByte(color >>> 8);
598
+ blue = decodeSharedSRGBByte(color);
599
+ lastColor = color;
600
+ }
601
+ const points = [];
602
+ for (let corner = 0; corner < 4; corner++) {
603
+ // Corner order: top-left, top-right, bottom-right, bottom-left.
604
+ let u = corner === 1 || corner === 2 ? 1 : 0, v = corner >= 2 ? 1 : 0;
605
+ if (region && material.samplingDomain === 'page') {
606
+ const p = region.packed, odd = region.quarterTurn === 1 || region.quarterTurn === 3, w = odd ? p.height : p.width, h = odd ? p.width : p.height, s = u * w, t = v * h;
607
+ const x = region.quarterTurn === 1 ? h - t : region.quarterTurn === 2 ? w - s : region.quarterTurn === 3 ? t : s;
608
+ const y = region.quarterTurn === 1 ? s : region.quarterTurn === 2 ? h - t : region.quarterTurn === 3 ? w - s : t;
609
+ const page = frame.pages[pageIndex].source;
610
+ u = (p.x + x) / page.width;
611
+ v = (p.y + y) / page.height;
612
+ }
613
+ points.push({
614
+ x: corner === 1 || corner === 2 ? right : rect.x,
615
+ y: corner >= 2 ? bottom : rect.y,
616
+ u,
617
+ v,
618
+ r: red,
619
+ g: green,
620
+ b: blue,
621
+ a,
622
+ dr: 0,
623
+ dg: 0,
624
+ db: 0
625
+ });
626
+ }
627
+ accept(points);
628
+ }
629
+ upload = add(upload, 52 * vertexReservation + 128, Number.MAX_SAFE_INTEGER);
630
+ const made = {
631
+ kind: 'draw',
632
+ command,
633
+ material,
634
+ region,
635
+ pageIndex,
636
+ polygons,
637
+ vertexReservation
638
+ };
639
+ entries.push(made);
640
+ retained?.push(retention.keep(command.ordinal, found, command, material, region, page, geometry, made, budget.preparedVerticesCharged - verticesBefore, budget.predicatesCharged - predicatesBefore, budget.tupleComparisonsCharged - tuplesBefore));
641
+ }
642
+ }
643
+ catch (cause) {
644
+ retention?.abandon();
645
+ throw cause;
646
+ }
647
+ retention?.commit();
648
+ // The region table is uploaded with the frame: 48 bytes for each of its regions.
649
+ return {
650
+ effects,
651
+ frame,
652
+ width,
653
+ height,
654
+ entries,
655
+ budget,
656
+ geometryBytes,
657
+ pageBytes,
658
+ pageLevels,
659
+ upload: upload + 48 * frame.regions.length + effects.uniformBytes,
660
+ ...(retention ? { retention, retained: retained } : {})
661
+ };
662
+ }
663
+ //# sourceMappingURL=prepareSharedDraws2D.js.map
@@ -0,0 +1,17 @@
1
+ /** The one owner of the optional copy that joins the rows of a batch. */
2
+ export interface PreparedBatchScratchPlan2D {
3
+ readonly draws: unknown[];
4
+ logicalDraws: readonly unknown[] | undefined;
5
+ readonly logicalSpans: unknown[];
6
+ bytes: number;
7
+ released: boolean;
8
+ }
9
+ /** CPU concat ownership only. The Host retains the original GPU retirement proof. */
10
+ export declare class PreparedBatchScratch2D {
11
+ private retained;
12
+ available(): number;
13
+ reserve(plan: PreparedBatchScratchPlan2D, bytes: number): boolean;
14
+ refund(plan: PreparedBatchScratchPlan2D, bytes: number): void;
15
+ release(plan: PreparedBatchScratchPlan2D): void;
16
+ }
17
+ //# sourceMappingURL=preparedBatches2D.d.ts.map