@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,331 @@
1
+ import { qualifySharedUVIn, sharedFailure, sharedUVDomain } from './prepareSharedDraws2D.js';
2
+ import { packedOrientation } from './packedOrientation.js';
3
+ /**
4
+ * One vertex is thirteen f32 values: x y u v r g b a dr dg db slot opacity. `slot` is the place of the
5
+ * draw's region in its window of the region table, and `opacity` the opacity of the draw; both are the
6
+ * same at every vertex of a draw, so that draws which differ only in them share a batch.
7
+ */
8
+ export const SHARED_VERTEX_BYTES_2D = 52;
9
+ /**
10
+ * The region table holds twelve u32 values for every region of a frame, in frame order: logical width and
11
+ * height, trim x and y; content width and height, packed x and y; quarter turn, the index of the region's
12
+ * page in the frame, and the width and height of that page. A draw reads it through a window of 341
13
+ * consecutive regions, the most that fit the 16,384 bytes every WebGL2 context gives one uniform block.
14
+ */
15
+ export const SHARED_REGION_WINDOW_2D = 341, SHARED_REGION_WINDOW_BYTES_2D = 16368;
16
+ /**
17
+ * A batch samples at most this many pages. Words 12 to 19 of its block name them: the word of a texture
18
+ * unit is the index in the frame of the page that unit holds, and 0xffffffff for a unit that holds none.
19
+ * A vertex finds its page's unit by the page index in its region's row of the region table.
20
+ */
21
+ export const SHARED_BATCH_PAGES_2D = 8, SHARED_NO_PAGE_2D = 0xffffffff;
22
+ const ROW = SHARED_VERTEX_BYTES_2D / 4, BLOCK = 128, NO_PAGES = Object.freeze([]);
23
+ /** The height, in backing pixels, under which a triangle that turns the wrong way counts as collapsed. */
24
+ const SLIVER_HEIGHT = 1 / 1024;
25
+ // One polygon's represented corners. Packing is synchronous and calls no caller code, so the storage is shared.
26
+ let corners = new Float32Array(64 * ROW);
27
+ const address = (value) => (value === 'repeat' ? 1 : value === 'mirror-repeat' ? 2 : 0);
28
+ /** The region table of one frame. Every region is written, whether or not a draw of the frame uses it. */
29
+ export function packSharedRegions2D(frame) {
30
+ const regions = frame.regions, table = new Uint32Array(12 * regions.length);
31
+ for (let i = 0, o = 0; i < regions.length; i++, o += 12) {
32
+ const region = regions[i], p = region.packed, odd = region.quarterTurn === 1 || region.quarterTurn === 3, page = frame.pages[region.pageIndex].source;
33
+ table[o] = region.logicalWidth;
34
+ table[o + 1] = region.logicalHeight;
35
+ table[o + 2] = region.trimX;
36
+ table[o + 3] = region.trimY;
37
+ table[o + 4] = odd ? p.height : p.width;
38
+ table[o + 5] = odd ? p.width : p.height;
39
+ table[o + 6] = p.x;
40
+ table[o + 7] = p.y;
41
+ table[o + 8] = region.quarterTurn;
42
+ table[o + 9] = region.pageIndex;
43
+ table[o + 10] = page.width;
44
+ table[o + 11] = page.height;
45
+ }
46
+ return table;
47
+ }
48
+ /** Writes the block of one draw at float index `f` of a buffer seen as floats and as words. Every word it does not write is zero. */
49
+ function writeBlock(floats, words, f, width, height, draw) {
50
+ // Float and word indices of this draw's block: twelve floats, then twenty words from byte 48.
51
+ // The block holds what is the same for a whole batch. The third float, once the opacity, stays zero: the
52
+ // opacity is in each vertex. Of the first eleven words, once the region, the first eight name the pages
53
+ // of the texture units and the next three stay zero: the region is in the region table.
54
+ const w = f + 12, material = draw.material, light = material.light, dark = material.dark;
55
+ if (light.length === 4 && dark.length === 3) {
56
+ floats[f] = width;
57
+ floats[f + 1] = height;
58
+ floats[f + 2] = 0;
59
+ floats[f + 3] = 0;
60
+ floats[f + 4] = light[0];
61
+ floats[f + 5] = light[1];
62
+ floats[f + 6] = light[2];
63
+ floats[f + 7] = light[3];
64
+ floats[f + 8] = dark[0];
65
+ floats[f + 9] = dark[1];
66
+ floats[f + 10] = dark[2];
67
+ floats[f + 11] = 0;
68
+ }
69
+ else
70
+ floats.subarray(f, f + 12).set([width, height, 0, 0, ...light, ...dark, 0]);
71
+ if (draw.region) {
72
+ // A draw as it is packed samples one page, held by the first unit. The page's size is in the row of
73
+ // its region, so that draws of pages of different sizes have equal blocks.
74
+ words[w] = draw.pageIndex;
75
+ for (let unit = 1; unit < SHARED_BATCH_PAGES_2D; unit++)
76
+ words[w + unit] = SHARED_NO_PAGE_2D;
77
+ const strategy = material.filter === 'nearest'
78
+ ? 0
79
+ : material.samplingDomain === 'page'
80
+ ? 1
81
+ : material.regionIsolation === 'strict'
82
+ ? 3
83
+ : 2;
84
+ words[w + 11] = material.samplingDomain === 'page' ? 1 : 0;
85
+ words[w + 12] = address(material.addressU);
86
+ words[w + 13] = address(material.addressV);
87
+ words[w + 14] = material.filter === 'linear' ? 1 : 0;
88
+ words[w + 15] = material.regionIsolation === 'strict' ? 1 : 0;
89
+ words[w + 18] = draw.command.kind === 'mesh' ? 2 : 1;
90
+ words[w + 19] = strategy;
91
+ }
92
+ else {
93
+ // Solid draws have canonical unused sampling fields, never a white page.
94
+ words[w + 16] = 1;
95
+ words[w + 17] = 1;
96
+ }
97
+ }
98
+ /** Blocks are allocated this many at a time: draws next to each other mostly share one. */
99
+ const BLOCKS = 32;
100
+ /**
101
+ * Backing coordinates stay backing coordinates until the fixed vertex shader. A draw whose geometry was kept
102
+ * from the last frame takes the rows kept with it, once the charges recorded with those rows fit: the rows of
103
+ * a draw depend on its geometry alone, except the place of its region and its opacity, which are written anew.
104
+ * A kept draw that rested, whose record preparation gave again, is packed once and its packed record kept:
105
+ * the next frame is given that record, while the draw goes on resting, for the charges alone.
106
+ */
107
+ export function packSharedDraws2D(prepared) {
108
+ // The vertex rows packed in one call share one allocation; each draw's `data` is a view of its own range,
109
+ // with the same length and bytes as a separate array. A kept packed record has rows of its own.
110
+ const result = [], frame = prepared.frame, budget = prepared.budget;
111
+ const retention = prepared.retention, retained = prepared.retained, entries = prepared.entries;
112
+ // A fan of n corners yields at most n-2 triangles; collapsed ones are dropped below and leave the tail unused.
113
+ let capacity = 0;
114
+ for (let entry = 0; entry < entries.length; entry++) {
115
+ const draw = entries[entry];
116
+ if (draw.kind === 'barrier')
117
+ continue;
118
+ const kept = retained?.[entry];
119
+ if (kept !== undefined && kept.rested && kept.rows !== undefined)
120
+ continue;
121
+ for (const polygon of draw.polygons)
122
+ if (polygon.length > 2)
123
+ capacity += (polygon.length - 2) * 3;
124
+ }
125
+ let rows = new Float32Array(capacity * ROW), used = 0;
126
+ // The block of a draw is the block of the draw packed before it in the same way, kept or not, when
127
+ // that draw has the same material, page and kind: every input of the two blocks is then the same.
128
+ let blockBytes, blockFloats, blockWords, block = 0, blockEnd = 0;
129
+ const blockOf = (draw, beside) => {
130
+ const other = beside?.prepared;
131
+ if (other !== undefined &&
132
+ other.material === draw.material &&
133
+ other.pageIndex === draw.pageIndex &&
134
+ other.command.kind === draw.command.kind)
135
+ return beside.uniform;
136
+ if (block === blockEnd) {
137
+ const blocks = new ArrayBuffer(BLOCKS * BLOCK);
138
+ blockBytes = new Uint8Array(blocks);
139
+ blockFloats = new Float32Array(blocks);
140
+ blockWords = new Uint32Array(blocks);
141
+ block = 0;
142
+ blockEnd = BLOCKS * BLOCK;
143
+ }
144
+ writeBlock(blockFloats, blockWords, block >> 2, prepared.width, prepared.height, draw);
145
+ block += BLOCK;
146
+ return blockBytes.subarray(block - BLOCK, block);
147
+ };
148
+ // A kept record never shares the block of a record that is not kept, which would hold a whole allocation of blocks for it.
149
+ const keptBlockOf = (draw, beside) => {
150
+ const other = beside?.prepared;
151
+ if (other !== undefined &&
152
+ other.material === draw.material &&
153
+ other.pageIndex === draw.pageIndex &&
154
+ other.command.kind === draw.command.kind)
155
+ return beside.uniform;
156
+ const own = new ArrayBuffer(BLOCK);
157
+ writeBlock(new Float32Array(own), new Uint32Array(own), 0, prepared.width, prepared.height, draw);
158
+ return new Uint8Array(own);
159
+ };
160
+ let fresh, rested;
161
+ // The arrays of the one page of a draw, by page: a draw reads its array and never writes it.
162
+ const pagesOf = [];
163
+ for (let entry = 0; entry < entries.length; entry++) {
164
+ const draw = entries[entry];
165
+ if (draw.kind === 'barrier') {
166
+ result.push({ barrier: true, ordinal: draw.ordinal });
167
+ continue;
168
+ }
169
+ const kept = retained?.[entry], keptRows = kept?.rows;
170
+ if (keptRows !== undefined && kept.rested) {
171
+ if (budget.tryReplayStageCost(kept.rowsCost)) {
172
+ // The record of a draw that rested since it was packed has this command, this page and these rows.
173
+ let packed = kept.packed;
174
+ if (packed === undefined || packed.prepared !== draw) {
175
+ const index = draw.command.kind === 'rect' ? 0 : draw.command.regionIndex, slot = index % SHARED_REGION_WINDOW_2D, opacity = draw.command.opacity;
176
+ let data = keptRows;
177
+ // The kept rows have the place and the opacity of the frame that packed them. Kept rows are never written.
178
+ if (data.length > 0 && (data[11] !== slot || !Object.is(data[12], Math.fround(opacity)))) {
179
+ data = data.slice();
180
+ for (let o = 11; o < data.length; o += ROW) {
181
+ data[o] = slot;
182
+ data[o + 1] = opacity;
183
+ }
184
+ }
185
+ let pages = NO_PAGES;
186
+ if (draw.region) {
187
+ const known = rested?.pages;
188
+ pages =
189
+ known !== undefined && known.length === 1 && known[0] === draw.pageIndex ? known : [draw.pageIndex];
190
+ }
191
+ packed = {
192
+ prepared: draw,
193
+ data,
194
+ vertexCount: kept.vertexCount,
195
+ uniform: keptBlockOf(draw, rested),
196
+ regionWindow: draw.region ? Math.floor(index / SHARED_REGION_WINDOW_2D) : -1,
197
+ pages
198
+ };
199
+ // Without room to keep it, the record is this frame's alone and is made again for the next.
200
+ if (retention.keepPacked(kept, packed))
201
+ rested = packed;
202
+ }
203
+ else
204
+ rested = packed;
205
+ result.push(packed);
206
+ continue;
207
+ }
208
+ // The charges do not fit: the draw is packed as if nothing were kept, and refuses where it would have.
209
+ // No room was counted for it, so the draws from here on are packed into a new allocation with that
210
+ // room; the draws before it keep their views of the old one.
211
+ let own = 0;
212
+ for (const polygon of draw.polygons)
213
+ if (polygon.length > 2)
214
+ own += (polygon.length - 2) * 3;
215
+ rows = new Float32Array(rows.length - used + own * ROW);
216
+ used = 0;
217
+ }
218
+ const opacity = draw.command.opacity, index = draw.command.kind === 'rect' ? 0 : draw.command.regionIndex;
219
+ const slot = index % SHARED_REGION_WINDOW_2D, regionWindow = draw.region ? Math.floor(index / SHARED_REGION_WINDOW_2D) : -1;
220
+ let pages = NO_PAGES;
221
+ if (draw.region) {
222
+ const known = pagesOf[draw.pageIndex];
223
+ if (known === undefined)
224
+ pagesOf[draw.pageIndex] = pages = [draw.pageIndex];
225
+ else
226
+ pages = known;
227
+ }
228
+ const first = used;
229
+ let vertices = 0;
230
+ const predicatesBefore = budget.predicatesCharged;
231
+ if (keptRows !== undefined && !kept.rested && budget.tryReplayStageCost(kept.rowsCost)) {
232
+ rows.set(keptRows, used);
233
+ vertices = kept.vertexCount;
234
+ for (let o = used + 11, end = used + keptRows.length; o < end; o += ROW) {
235
+ rows[o] = slot;
236
+ rows[o + 1] = opacity;
237
+ }
238
+ used += keptRows.length;
239
+ }
240
+ else {
241
+ const uvDomain = sharedUVDomain(draw, frame);
242
+ for (const polygon of draw.polygons) {
243
+ const count = polygon.length;
244
+ if (count * ROW > corners.length)
245
+ corners = new Float32Array(count * ROW);
246
+ for (let i = 0, o = 0; i < count; i++, o += ROW) {
247
+ const p = polygon[i];
248
+ // A typed store rounds to f32 exactly as Math.fround does.
249
+ corners[o] = p.x;
250
+ corners[o + 1] = p.y;
251
+ corners[o + 2] = p.u;
252
+ corners[o + 3] = p.v;
253
+ corners[o + 4] = p.r;
254
+ corners[o + 5] = p.g;
255
+ corners[o + 6] = p.b;
256
+ corners[o + 7] = p.a;
257
+ corners[o + 8] = p.dr;
258
+ corners[o + 9] = p.dg;
259
+ corners[o + 10] = p.db;
260
+ corners[o + 11] = slot;
261
+ corners[o + 12] = opacity;
262
+ // Every value is finite exactly when their sum is: a NaN or an infinity carries into it, and thirteen
263
+ // finite f32 values cannot add up to an infinity in f64.
264
+ if (!Number.isFinite(corners[o] +
265
+ corners[o + 1] +
266
+ corners[o + 2] +
267
+ corners[o + 3] +
268
+ corners[o + 4] +
269
+ corners[o + 5] +
270
+ corners[o + 6] +
271
+ corners[o + 7] +
272
+ corners[o + 8] +
273
+ corners[o + 9] +
274
+ corners[o + 10] +
275
+ corners[o + 11] +
276
+ corners[o + 12]))
277
+ sharedFailure('precision');
278
+ // Qualification reads the two represented texture coordinates.
279
+ if (uvDomain !== undefined)
280
+ qualifySharedUVIn(corners[o + 2], corners[o + 3], uvDomain);
281
+ }
282
+ for (let i = 1; i + 1 < count; i++) {
283
+ const b = i * ROW, c = b + ROW;
284
+ // Preparation normalizes clockwise backing-space polygons. A
285
+ // represented reversal refuses; a represented collapse stays a barrier.
286
+ const sign = packedOrientation(corners[0], corners[1], corners[b], corners[b + 1], corners[c], corners[c + 1], budget);
287
+ if (!Number.isFinite(sign))
288
+ sharedFailure('precision');
289
+ if (sign === 0)
290
+ continue;
291
+ if (sign < 0) {
292
+ // A reversal thinner than a thousandth of a pixel is a collapse that rounding tipped over, as where a
293
+ // corner of a turned rectangle all but touches the edge of the view and its two crossings of that edge
294
+ // land a rounding error apart. It covers nothing, so it is left out like a collapse; a reversal with
295
+ // any body to it still refuses.
296
+ const ux = corners[b] - corners[0], uy = corners[b + 1] - corners[1], vx = corners[c] - corners[0], vy = corners[c + 1] - corners[1], wx = vx - ux, wy = vy - uy;
297
+ const longest = Math.sqrt(Math.max(ux * ux + uy * uy, vx * vx + vy * vy, wx * wx + wy * wy));
298
+ if (!(Math.abs(ux * vy - uy * vx) <= longest * SLIVER_HEIGHT))
299
+ sharedFailure('precision');
300
+ continue;
301
+ }
302
+ for (let k = 0; k < ROW; k++) {
303
+ rows[used + k] = corners[k];
304
+ rows[used + ROW + k] = corners[b + k];
305
+ rows[used + 2 * ROW + k] = corners[c + k];
306
+ }
307
+ used += 3 * ROW;
308
+ vertices += 3;
309
+ }
310
+ }
311
+ }
312
+ // The orientation of each triangle is the one charge of this stage.
313
+ if (kept !== undefined && keptRows === undefined)
314
+ retention.keepRows(kept, rows.subarray(first, used), vertices, {
315
+ preparedVertices: 0,
316
+ predicates: budget.predicatesCharged - predicatesBefore,
317
+ tupleComparisons: 0
318
+ });
319
+ fresh = {
320
+ prepared: draw,
321
+ data: rows.subarray(first, used),
322
+ vertexCount: vertices,
323
+ uniform: blockOf(draw, fresh),
324
+ regionWindow,
325
+ pages
326
+ };
327
+ result.push(fresh);
328
+ }
329
+ return result;
330
+ }
331
+ //# sourceMappingURL=packSharedDraws2D.js.map
@@ -0,0 +1,4 @@
1
+ import type { PreparationBudget2D } from './prepareRectangles2D.js';
2
+ /** Conventional orientation of represented coordinates; dependency root stays DOM-free. */
3
+ export declare function packedOrientation(ax: number, ay: number, bx: number, by: number, cx: number, cy: number, budget?: PreparationBudget2D): number;
4
+ //# sourceMappingURL=packedOrientation.d.ts.map
@@ -0,0 +1,7 @@
1
+ import { orient2d } from 'robust-predicates';
2
+ /** Conventional orientation of represented coordinates; dependency root stays DOM-free. */
3
+ export function packedOrientation(ax, ay, bx, by, cx, cy, budget) {
4
+ budget?.admitPredicate();
5
+ return -Math.sign(orient2d(ax, ay, bx, by, cx, cy));
6
+ }
7
+ //# sourceMappingURL=packedOrientation.js.map
@@ -0,0 +1,92 @@
1
+ import type { ClipRectangle2D } from '@egret/contracts';
2
+ export interface PreparedPoint2D {
3
+ readonly x: number;
4
+ readonly y: number;
5
+ }
6
+ /** Private structural seam; the opted-in dispatcher supplies one first-party ledger. */
7
+ export interface PreparationBudget2D {
8
+ admitPreparedVertices(count: number): void;
9
+ admitPredicate(): void;
10
+ tryReplayStageCost?(cost: PreparedStageCost2D): boolean;
11
+ }
12
+ /** Private polygon policy; omission retains the legacy XY cache and corner limit. */
13
+ export interface PolygonClipPolicy2D<P extends PreparedPoint2D> {
14
+ readonly maxCorners: number;
15
+ before(first: P, second: P): boolean;
16
+ sameTuple(first: P, second: P): boolean;
17
+ assertAppend(currentLength: number): void;
18
+ }
19
+ /** What a clip already prepared in this call would have cost; replaying it charges the same budget. */
20
+ export interface PreparedStageCost2D {
21
+ readonly preparedVertices: number;
22
+ readonly predicates: number;
23
+ readonly tupleComparisons: number;
24
+ }
25
+ export interface RectanglePreparationOptions {
26
+ readonly pixelRatio: number;
27
+ readonly maxPreparedVertices: number;
28
+ readonly maxClipEdgeTests: number;
29
+ }
30
+ interface ClipRectanglePreparationEntry2D {
31
+ readonly polygon: readonly PreparedPoint2D[];
32
+ readonly predicates: number;
33
+ }
34
+ interface ContainedClipStackBounds2D {
35
+ readonly left: number;
36
+ readonly top: number;
37
+ readonly right: number;
38
+ readonly bottom: number;
39
+ readonly count: number;
40
+ }
41
+ /** Call-local scratch supplied only by the opted-in ordinary TEXTURED dispatcher. */
42
+ export interface ClipRectanglePreparationContext2D {
43
+ readonly options: RectanglePreparationOptions;
44
+ readonly budget: PreparationBudget2D;
45
+ active: boolean;
46
+ entries: Map<ClipRectangle2D, ClipRectanglePreparationEntry2D> | undefined;
47
+ }
48
+ /** Drop all clip references before packing, including on an original preparation failure. */
49
+ export declare function clearClipRectangleContext2D(context: ClipRectanglePreparationContext2D | undefined): void;
50
+ /** Adapter-owned mapping keeps these numeric errors private to preparation. */
51
+ export declare class GeometryPreparationError extends Error {
52
+ readonly reason: 'range' | 'precision' | 'budget';
53
+ constructor(reason: 'range' | 'precision' | 'budget', cause?: unknown);
54
+ }
55
+ export declare const POLYGON_LIMIT = 1024;
56
+ export declare function coordinate(value: number): number;
57
+ export declare function same(a: PreparedPoint2D, b: PreparedPoint2D): boolean;
58
+ export declare function before(a: PreparedPoint2D, b: PreparedPoint2D): boolean;
59
+ export declare class Preparation {
60
+ private readonly options;
61
+ private readonly budget?;
62
+ private readonly containedClipping;
63
+ edgeTests: number;
64
+ private readonly reuseContainedSubjects;
65
+ constructor(options: RectanglePreparationOptions, budget?: PreparationBudget2D | undefined, containedClipping?: boolean, clipContext?: ClipRectanglePreparationContext2D);
66
+ private determinant;
67
+ /** Intersect only already qualified canonical clip bounds, with the viewport last. */
68
+ containedClipStackBounds(clips: readonly (readonly PreparedPoint2D[])[], viewport: readonly PreparedPoint2D[]): ContainedClipStackBounds2D | undefined;
69
+ /** Charge a wholly contained stack at once without merging any actual cuts. */
70
+ tryContainedClipStack(subject: readonly PreparedPoint2D[], bounds: ContainedClipStackBounds2D | undefined, normalization: 'rectangle' | 'image' | 'mesh'): boolean;
71
+ /** Only the ordinary TEXTURED Host enables this for its own normalized polygons and ledger. */
72
+ tryContainedClip<P extends PreparedPoint2D>(subject: P[], clip: readonly PreparedPoint2D[], normalization: 'rectangle' | 'image' | 'mesh'): P[] | undefined;
73
+ /** Known first-party normalization may skip one unchanged canonical half-plane. */
74
+ tryContainedEdge<P extends PreparedPoint2D>(subject: P[], clip: readonly PreparedPoint2D[], edge: number, normalization: 'rectangle' | 'image' | 'mesh'): P[] | undefined;
75
+ /** Use exact comparisons for the classification stage of an owned axis edge. */
76
+ classifyOwnedAxisEdge(subject: readonly PreparedPoint2D[], a: PreparedPoint2D, b: PreparedPoint2D): number[] | undefined;
77
+ sign(a: PreparedPoint2D, b: PreparedPoint2D, c: PreparedPoint2D): number;
78
+ normalize(input: readonly PreparedPoint2D[]): PreparedPoint2D[];
79
+ corners(input: ClipRectangle2D): PreparedPoint2D[];
80
+ rectangle(input: ClipRectangle2D): PreparedPoint2D[];
81
+ /** Reuse only successful first-party clip rectangles, never the subject or viewport. */
82
+ clipRectangle(input: ClipRectangle2D, context?: ClipRectanglePreparationContext2D): readonly PreparedPoint2D[];
83
+ crossing<P extends PreparedPoint2D>(a: PreparedPoint2D, b: PreparedPoint2D, first: P, second: P, attach: CrossingAttributes<P>, policy?: PolygonClipPolicy2D<P>): P;
84
+ intersect(subject: PreparedPoint2D[], clip: readonly PreparedPoint2D[], normalized?: boolean): PreparedPoint2D[];
85
+ }
86
+ /** Policy wrappers keep their collinear/duplicate rules; this finish preserves sign order and full points. */
87
+ export declare function finishPolygonWinding2D<P extends PreparedPoint2D>(preparation: Preparation, points: P[]): P[];
88
+ export type CrossingAttributes<P extends PreparedPoint2D> = (p: P, q: P, weight: number, complementary: boolean, x: number, y: number) => P;
89
+ /** Shared traversal preserves determinant order; callers own attribute normalization. */
90
+ export declare function clipPolygon2D<P extends PreparedPoint2D>(preparation: Preparation, subject: P[], clip: readonly PreparedPoint2D[], normalize: (preparation: Preparation, input: readonly P[]) => P[], attach: CrossingAttributes<P>, policy?: PolygonClipPolicy2D<P>, normalization?: 'rectangle' | 'image' | 'mesh'): P[];
91
+ export {};
92
+ //# sourceMappingURL=prepareRectangles2D.d.ts.map