@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,40 @@
1
+ import type { Video } from '@egret/engine/video';
2
+ import type { AssetManager } from '@egret/runtime';
3
+ /** One file of a film offered in several: its address and, when known, its media type. */
4
+ export interface BrowserVideoSource {
5
+ readonly src: string;
6
+ readonly type?: string;
7
+ }
8
+ /** A browser video to make: its assets, its source or stream or element, and whether it loops, is muted and how loud. */
9
+ export interface BrowserVideoOptions {
10
+ /** The Engine's assets, which lease each picture as a texture. */
11
+ readonly assets: AssetManager;
12
+ /** A file to play, or a stream such as a canvas's or a camera's, or a video element of the page's own. One of the three. */
13
+ /**
14
+ * One address, or the same film in several files to choose from, as `<source>` elements give them: the first the
15
+ * browser can play is played, and one that fails to load gives way to the next. A file's `type` (`video/webm`, say)
16
+ * lets the browser pass over what it cannot play without loading it.
17
+ */
18
+ readonly src?: string | readonly (string | BrowserVideoSource)[];
19
+ readonly stream?: MediaStream;
20
+ readonly element?: HTMLVideoElement;
21
+ readonly loop?: boolean;
22
+ /** Defaults to true: a page plays a muted video without waiting for a press. */
23
+ readonly muted?: boolean;
24
+ readonly volume?: number;
25
+ /** Pictures wider than this are scaled down to it before they become textures, to keep each upload small. Defaults to 1280. */
26
+ readonly maxWidth?: number;
27
+ /** For a file from another origin that allows it. */
28
+ readonly crossOrigin?: 'anonymous' | 'use-credentials';
29
+ }
30
+ /** A video played by a video element, its pictures leased as textures. */
31
+ export interface BrowserVideo extends Video {
32
+ /** The page's video element the pictures are read from. */
33
+ readonly element: HTMLVideoElement;
34
+ }
35
+ /**
36
+ * A video played by a page's video element and shown as a display object. Each picture the element presents is drawn
37
+ * into a canvas of the size it is shown at, read back, and leased as a texture; a picture not yet changed is not read.
38
+ */
39
+ export declare function createBrowserVideo(options: BrowserVideoOptions): BrowserVideo;
40
+ //# sourceMappingURL=BrowserVideo.d.ts.map
@@ -0,0 +1,237 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ import { createImageData2D } from '@egret/contracts';
4
+ import { createVideo } from '@egret/engine/video';
5
+ const invalid = () => new EgretError('VIDEO_OPTIONS_INVALID');
6
+ /** A list of files: not empty, no more than 16, each an address or an address and a type that are not empty. */
7
+ function choices(list) {
8
+ return (Array.isArray(list) &&
9
+ list.length > 0 &&
10
+ list.length <= 16 &&
11
+ list.every(item => typeof item === 'string'
12
+ ? item.length > 0
13
+ : item !== null &&
14
+ typeof item === 'object' &&
15
+ typeof item.src === 'string' &&
16
+ item.src.length > 0 &&
17
+ (item.type === undefined || (typeof item.type === 'string' && item.type.length > 0))));
18
+ }
19
+ /**
20
+ * A video played by a page's video element and shown as a display object. Each picture the element presents is drawn
21
+ * into a canvas of the size it is shown at, read back, and leased as a texture; a picture not yet changed is not read.
22
+ */
23
+ export function createBrowserVideo(options) {
24
+ if (options === null || typeof options !== 'object')
25
+ throw invalid();
26
+ const { assets, src, stream, element: given, loop = false, muted = true, volume = 1, maxWidth = 1280, crossOrigin } = options;
27
+ const kinds = [src, stream, given].filter(value => value !== undefined).length;
28
+ if (kinds !== 1 ||
29
+ (src !== undefined && !(typeof src === 'string' ? src.length > 0 : choices(src))) ||
30
+ (stream !== undefined && (typeof MediaStream === 'undefined' || !(stream instanceof MediaStream))) ||
31
+ (given !== undefined && !(given instanceof HTMLVideoElement)) ||
32
+ typeof loop !== 'boolean' ||
33
+ typeof muted !== 'boolean' ||
34
+ typeof volume !== 'number' ||
35
+ !(volume >= 0 && volume <= 1) ||
36
+ !Number.isSafeInteger(maxWidth) ||
37
+ maxWidth < 1 ||
38
+ maxWidth > 4096 ||
39
+ (crossOrigin !== undefined && crossOrigin !== 'anonymous' && crossOrigin !== 'use-credentials'))
40
+ throw invalid();
41
+ const element = given ?? document.createElement('video');
42
+ element.playsInline = true;
43
+ element.preload = 'auto';
44
+ element.loop = loop;
45
+ element.muted = muted;
46
+ element.volume = volume;
47
+ if (crossOrigin !== undefined)
48
+ element.crossOrigin = crossOrigin;
49
+ let state = 'loading', fresh = false, frameTime = NaN, callback, closed = false;
50
+ const surface = document.createElement('canvas'), context = surface.getContext('2d', { willReadFrequently: true });
51
+ if (context === null)
52
+ throw new EgretError('VIDEO_UNAVAILABLE');
53
+ /** Where the element presents a new picture: each presented frame where the browser says so, otherwise each change of time. */
54
+ const presented = typeof element.requestVideoFrameCallback === 'function';
55
+ const watchFrames = () => {
56
+ if (closed || !presented)
57
+ return;
58
+ callback = element.requestVideoFrameCallback((_now, metadata) => {
59
+ fresh = true;
60
+ frameTime = metadata.mediaTime;
61
+ watchFrames();
62
+ });
63
+ };
64
+ const size = () => {
65
+ const w = element.videoWidth, h = element.videoHeight;
66
+ if (w === 0 || h === 0)
67
+ return { width: 0, height: 0 };
68
+ const scale = Math.min(1, maxWidth / w);
69
+ return { width: Math.max(1, Math.round(w * scale)), height: Math.max(1, Math.round(h * scale)) };
70
+ };
71
+ const events = [
72
+ [
73
+ 'loadeddata',
74
+ () => {
75
+ if (state === 'loading')
76
+ state = element.paused ? 'ready' : 'playing';
77
+ fresh = true;
78
+ frameTime = element.currentTime;
79
+ }
80
+ ],
81
+ [
82
+ 'playing',
83
+ () => {
84
+ state = 'playing';
85
+ }
86
+ ],
87
+ [
88
+ 'pause',
89
+ () => {
90
+ if (state !== 'ended' && state !== 'failed')
91
+ state = 'paused';
92
+ }
93
+ ],
94
+ [
95
+ 'ended',
96
+ () => {
97
+ state = 'ended';
98
+ }
99
+ ],
100
+ [
101
+ 'error',
102
+ () => {
103
+ state = 'failed';
104
+ }
105
+ ],
106
+ [
107
+ 'seeked',
108
+ () => {
109
+ fresh = true;
110
+ frameTime = element.currentTime;
111
+ }
112
+ ],
113
+ [
114
+ 'timeupdate',
115
+ () => {
116
+ if (!presented) {
117
+ fresh = true;
118
+ frameTime = element.currentTime;
119
+ }
120
+ }
121
+ ]
122
+ ];
123
+ for (const [name, listener] of events)
124
+ element.addEventListener(name, listener);
125
+ if (typeof src === 'string')
126
+ element.src = src;
127
+ else if (src !== undefined)
128
+ for (const item of src) {
129
+ const child = document.createElement('source');
130
+ if (typeof item === 'string')
131
+ child.src = item;
132
+ else {
133
+ child.src = item.src;
134
+ if (item.type !== undefined)
135
+ child.type = item.type;
136
+ }
137
+ element.appendChild(child);
138
+ }
139
+ else if (stream !== undefined)
140
+ element.srcObject = stream;
141
+ if (element.readyState >= 2) {
142
+ state = element.paused ? 'ready' : 'playing';
143
+ fresh = true;
144
+ frameTime = element.currentTime;
145
+ }
146
+ watchFrames();
147
+ const source = {
148
+ get state() {
149
+ return state;
150
+ },
151
+ get width() {
152
+ return size().width;
153
+ },
154
+ get height() {
155
+ return size().height;
156
+ },
157
+ get duration() {
158
+ return element.duration;
159
+ },
160
+ get currentTime() {
161
+ return element.currentTime;
162
+ },
163
+ get loop() {
164
+ return element.loop;
165
+ },
166
+ set loop(value) {
167
+ element.loop = value;
168
+ },
169
+ get muted() {
170
+ return element.muted;
171
+ },
172
+ set muted(value) {
173
+ element.muted = value;
174
+ },
175
+ get volume() {
176
+ return element.volume;
177
+ },
178
+ set volume(value) {
179
+ element.volume = value;
180
+ },
181
+ readFrame() {
182
+ if (!fresh || element.readyState < 2)
183
+ return undefined;
184
+ const { width, height } = size();
185
+ if (width === 0)
186
+ return undefined;
187
+ fresh = false;
188
+ if (surface.width !== width || surface.height !== height) {
189
+ surface.width = width;
190
+ surface.height = height;
191
+ }
192
+ context.drawImage(element, 0, 0, width, height);
193
+ const data = context.getImageData(0, 0, width, height).data;
194
+ return {
195
+ image: createImageData2D({
196
+ width,
197
+ height,
198
+ pixels: new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
199
+ }),
200
+ time: frameTime
201
+ };
202
+ },
203
+ async play() {
204
+ if (state === 'ended')
205
+ state = 'paused';
206
+ await element.play();
207
+ },
208
+ pause() {
209
+ element.pause();
210
+ },
211
+ seek(seconds) {
212
+ if (state === 'ended')
213
+ state = 'paused';
214
+ element.currentTime = seconds;
215
+ },
216
+ dispose() {
217
+ closed = true;
218
+ if (callback !== undefined && typeof element.cancelVideoFrameCallback === 'function')
219
+ element.cancelVideoFrameCallback(callback);
220
+ for (const [name, listener] of events)
221
+ element.removeEventListener(name, listener);
222
+ element.pause();
223
+ // A page's own element is left as it was given; one made here lets go of what it was playing.
224
+ if (given === undefined) {
225
+ element.removeAttribute('src');
226
+ element.replaceChildren();
227
+ element.srcObject = null;
228
+ element.load();
229
+ }
230
+ surface.width = 0;
231
+ surface.height = 0;
232
+ }
233
+ };
234
+ const video = createVideo({ assets, source });
235
+ return Object.freeze(Object.create(video, { element: { value: element, enumerable: true } }));
236
+ }
237
+ //# sourceMappingURL=BrowserVideo.js.map
@@ -0,0 +1,32 @@
1
+ import type { Scope } from '@egret/runtime';
2
+ import type { FontContentLoader } from '@egret/engine/resources';
3
+ import type { ParagraphProvider } from '@egret/engine/paragraph';
4
+ import type { CanvasKitParagraphModule } from './CanvasKitParagraphProvider.js';
5
+ /** A set of fonts loaded for paragraphs: its key and families; dispose of it when done. */
6
+ export interface ParagraphFontSet {
7
+ readonly key: string;
8
+ readonly fontFamilies: readonly string[];
9
+ readonly isDisposed: boolean;
10
+ /** Retires new demand immediately; native cleanup waits for in-flight shaping. */
11
+ dispose(): void;
12
+ readonly closed: Promise<void>;
13
+ }
14
+ /** Loads font sets for CanvasKit paragraphs. */
15
+ export interface CanvasKitFontSetProvider extends ParagraphProvider {
16
+ load(scope: Scope, loader: FontContentLoader, roots: readonly string[]): Promise<ParagraphFontSet>;
17
+ getStatus(): Readonly<{
18
+ closed: boolean;
19
+ sets: number;
20
+ fontBytes: number;
21
+ pendingJobs: number;
22
+ }>;
23
+ close(): Promise<void>;
24
+ }
25
+ /** A CanvasKit font set provider to make: its CanvasKit and build identity. */
26
+ export interface CanvasKitFontSetProviderOptions {
27
+ readonly canvasKit: CanvasKitParagraphModule;
28
+ readonly buildIdentity?: string;
29
+ }
30
+ /** A stable cache provider routes immutable generations; it never mutates a live native font table. */
31
+ export declare function createCanvasKitFontSetProvider(options: CanvasKitFontSetProviderOptions): CanvasKitFontSetProvider;
32
+ //# sourceMappingURL=CanvasKitFontSetProvider.d.ts.map
@@ -0,0 +1,215 @@
1
+ import { EgretError } from '@egret/runtime';
2
+ import { createCanvasKitParagraphProviderOwned, decodeCanvasKitFont, canvasKitParagraphCapabilities } from './CanvasKitParagraphProvider.js';
3
+ let nextRouter = 0;
4
+ const fault = (code, cause) => new EgretError('PARAGRAPH_FONT_SET_' + code, { cause });
5
+ /** A stable cache provider routes immutable generations; it never mutates a live native font table. */
6
+ export function createCanvasKitFontSetProvider(options) {
7
+ const canvasKit = options.canvasKit, buildIdentity = options.buildIdentity;
8
+ if (buildIdentity !== undefined &&
9
+ (typeof buildIdentity !== 'string' || !buildIdentity.length || buildIdentity.length > 512))
10
+ throw fault('OPTIONS');
11
+ const capabilities = Object.freeze({ ...canvasKitParagraphCapabilities(canvasKit), fontSets: true });
12
+ const identity = 'egret.canvaskit-font-sets.v1:' + ++nextRouter;
13
+ // Native face wrappers are shared only inside this router and retained by live providers.
14
+ // The manager still owns source bytes; this table never loads or caches another resource.
15
+ const faces = new Map();
16
+ const borrowFont = (font) => {
17
+ let record = faces.get(font.identity);
18
+ if (record &&
19
+ (record.bytes.length !== font.data.length || record.bytes.some((value, index) => value !== font.data[index])))
20
+ throw fault('IDENTITY_COLLISION');
21
+ if (!record) {
22
+ const face = decodeCanvasKitFont(canvasKit, font.data);
23
+ if (face === null)
24
+ throw fault('DECODE_REFUSED');
25
+ record = { face, references: 0, bytes: font.data };
26
+ faces.set(font.identity, record);
27
+ }
28
+ record.references++;
29
+ const owned = record;
30
+ let released = false;
31
+ return {
32
+ face: owned.face,
33
+ release() {
34
+ if (released)
35
+ return;
36
+ released = true;
37
+ if (--owned.references === 0) {
38
+ faces.delete(font.identity);
39
+ owned.face.delete();
40
+ }
41
+ }
42
+ };
43
+ };
44
+ const entries = new Map();
45
+ let sequence = 0, closed = false, fontBytes = 0, closing;
46
+ const failures = [];
47
+ const finish = (entry) => {
48
+ if (!entry.retired || entry.jobs || entry.finished)
49
+ return;
50
+ entry.finished = true;
51
+ entries.delete(entry.key);
52
+ fontBytes -= entry.bytes;
53
+ try {
54
+ entry.native?.dispose();
55
+ }
56
+ catch (cause) {
57
+ entry.failure ??= cause;
58
+ }
59
+ finally {
60
+ entry.native = undefined;
61
+ }
62
+ if (entry.failure !== undefined) {
63
+ failures.push(entry.failure);
64
+ entry.reject(entry.failure);
65
+ }
66
+ else
67
+ entry.resolve();
68
+ };
69
+ const retire = (entry) => {
70
+ if (!entry.retired) {
71
+ entry.retired = true;
72
+ try {
73
+ entry.group.dispose();
74
+ }
75
+ catch (cause) {
76
+ entry.failure = cause;
77
+ }
78
+ }
79
+ finish(entry);
80
+ };
81
+ const active = (key) => {
82
+ const entry = entries.get(key);
83
+ if (entry?.group.isDisposed)
84
+ retire(entry);
85
+ return closed || !entry || entry.retired || !entry.native ? undefined : entry;
86
+ };
87
+ const provider = Object.freeze({
88
+ identity,
89
+ capabilities,
90
+ hasFontSet(key) {
91
+ if (this !== provider)
92
+ throw fault('PROVIDER');
93
+ return active(key) !== undefined;
94
+ },
95
+ getStatus() {
96
+ if (this !== provider)
97
+ throw fault('PROVIDER');
98
+ return Object.freeze({
99
+ closed,
100
+ sets: entries.size,
101
+ fontBytes,
102
+ pendingJobs: [...entries.values()].reduce((sum, e) => sum + e.jobs, 0)
103
+ });
104
+ },
105
+ async load(scope, loader, roots) {
106
+ if (this !== provider || closed)
107
+ throw fault('CLOSED');
108
+ if (entries.size >= 8)
109
+ throw fault('LIMIT');
110
+ const group = loader.load(scope, roots);
111
+ if (closed || entries.size >= 8) {
112
+ group.dispose();
113
+ throw fault(closed ? 'CLOSED' : 'LIMIT');
114
+ }
115
+ let resolve, reject;
116
+ const done = new Promise((yes, no) => {
117
+ resolve = yes;
118
+ reject = no;
119
+ });
120
+ void done.catch(() => { });
121
+ const entry = {
122
+ key: identity + ':' + ++sequence,
123
+ group,
124
+ native: undefined,
125
+ bytes: 0,
126
+ jobs: 1,
127
+ retired: false,
128
+ finished: false,
129
+ closed: done,
130
+ resolve,
131
+ reject,
132
+ failure: undefined
133
+ };
134
+ entries.set(entry.key, entry);
135
+ void group.closed.then(() => retire(entry), cause => {
136
+ entry.failure = cause;
137
+ retire(entry);
138
+ });
139
+ try {
140
+ await group.ready;
141
+ if (closed || entry.retired || group.isDisposed)
142
+ throw fault('CANCELLED');
143
+ const fonts = group.getFonts(), size = fonts.reduce((sum, font) => sum + font.byteLength, 0);
144
+ if (fontBytes + size > 67108864)
145
+ throw fault('LIMIT');
146
+ // Reserve retained bytes before host native callbacks can reenter.
147
+ fontBytes += size;
148
+ entry.bytes = size;
149
+ entry.native = createCanvasKitParagraphProviderOwned({
150
+ canvasKit,
151
+ ...(buildIdentity === undefined ? {} : { buildIdentity }),
152
+ fonts: fonts.map(font => ({ family: font.family, identity: font.identity, data: font.copyBytes() }))
153
+ }, borrowFont);
154
+ if (closed || entry.retired || group.isDisposed)
155
+ throw fault('CANCELLED');
156
+ const handle = Object.freeze({
157
+ key: entry.key,
158
+ fontFamilies: Object.freeze(fonts.map(font => font.family)),
159
+ closed: done,
160
+ get isDisposed() {
161
+ return entry.retired || group.isDisposed;
162
+ },
163
+ dispose() {
164
+ retire(entry);
165
+ }
166
+ });
167
+ return handle;
168
+ }
169
+ catch (cause) {
170
+ retire(entry);
171
+ throw cause;
172
+ }
173
+ finally {
174
+ entry.jobs--;
175
+ finish(entry);
176
+ }
177
+ },
178
+ async prepare(request, context) {
179
+ if (this !== provider)
180
+ throw fault('PROVIDER');
181
+ const key = request.fontSet, entry = key === undefined ? undefined : active(key);
182
+ if (!entry)
183
+ throw fault('RETIRED');
184
+ entry.jobs++;
185
+ try {
186
+ const result = await entry.native.prepare(request, context);
187
+ if (context.signal.aborted || active(entry.key) !== entry)
188
+ throw fault('CANCELLED');
189
+ return result;
190
+ }
191
+ finally {
192
+ entry.jobs--;
193
+ finish(entry);
194
+ }
195
+ },
196
+ close() {
197
+ if (this !== provider)
198
+ throw fault('PROVIDER');
199
+ if (!closing) {
200
+ closed = true;
201
+ const current = [...entries.values()];
202
+ for (const entry of current)
203
+ retire(entry);
204
+ closing = Promise.allSettled(current.map(entry => entry.closed)).then(() => {
205
+ if (failures.length)
206
+ throw new AggregateError(failures, 'Font-set cleanup failed');
207
+ });
208
+ void closing.catch(() => { });
209
+ }
210
+ return closing;
211
+ }
212
+ });
213
+ return provider;
214
+ }
215
+ //# sourceMappingURL=CanvasKitFontSetProvider.js.map
@@ -0,0 +1,173 @@
1
+ import type { NativeGeometryParagraph } from './canvasKitParagraphGeometry.js';
2
+ import type { ParagraphProvider } from '@egret/engine/paragraph';
3
+ interface NativeOwned {
4
+ delete(): void;
5
+ }
6
+ export interface NativeTypeface extends NativeOwned {
7
+ }
8
+ interface NativeFontProvider extends NativeOwned {
9
+ _registerFont(face: NativeTypeface, alias: number): void;
10
+ }
11
+ interface NativeLine {
12
+ readonly left?: number;
13
+ readonly startIndex: number;
14
+ readonly endIndex: number;
15
+ readonly baseline: number;
16
+ readonly ascent: number;
17
+ readonly descent: number;
18
+ readonly height: number;
19
+ readonly width: number;
20
+ }
21
+ interface NativeRun {
22
+ readonly typeface: NativeTypeface;
23
+ readonly size: number;
24
+ readonly scaleX?: number;
25
+ readonly offsets?: Uint32Array;
26
+ readonly glyphs: Uint16Array;
27
+ readonly positions: Float32Array;
28
+ }
29
+ interface NativeShapedLine {
30
+ readonly runs: readonly NativeRun[];
31
+ }
32
+ interface NativeParagraph extends NativeOwned, NativeGeometryParagraph {
33
+ layout(width: number): void;
34
+ getLineMetrics(): readonly NativeLine[];
35
+ getHeight(): number;
36
+ getShapedLines(): readonly NativeShapedLine[];
37
+ unresolvedCodepoints(): readonly number[];
38
+ didExceedMaxLines?(): boolean;
39
+ hasLineEllipsis?(index: number): boolean;
40
+ }
41
+ interface NativeBuilder extends NativeOwned {
42
+ addText(text: string): void;
43
+ build(): NativeParagraph | null;
44
+ pushStyle?(style: object): void;
45
+ pop?(): void;
46
+ }
47
+ interface NativeFont extends NativeOwned {
48
+ setSubpixel(enabled: boolean): void;
49
+ setHinting(hinting: unknown): void;
50
+ setEdging(edging: unknown): void;
51
+ getGlyphBounds(glyphs: Uint16Array): Float32Array;
52
+ }
53
+ interface NativeCanvas {
54
+ clear(color: Float32Array): void;
55
+ scale(x: number, y: number): void;
56
+ translate(x: number, y: number): void;
57
+ drawParagraph(paragraph: NativeParagraph, x: number, y: number): void;
58
+ readPixels(x: number, y: number, info: {
59
+ width: number;
60
+ height: number;
61
+ colorType: unknown;
62
+ alphaType: unknown;
63
+ colorSpace: unknown;
64
+ }): Uint8Array | null;
65
+ }
66
+ interface NativeSurface {
67
+ getCanvas(): NativeCanvas;
68
+ flush(): void;
69
+ dispose(): void;
70
+ }
71
+ /** Minimal host-injected CanvasKit port. The adapter performs no module loading. */
72
+ export interface CanvasKitParagraphModule {
73
+ readonly Typeface: {
74
+ MakeTypefaceFromData(bytes: Uint8Array): NativeTypeface | null;
75
+ _MakeTypefaceFromData?(pointer: number, length: number): NativeTypeface | null;
76
+ };
77
+ readonly TypefaceFontProvider: {
78
+ Make(): NativeFontProvider | null;
79
+ };
80
+ readonly ParagraphBuilder: {
81
+ readonly prototype?: {
82
+ readonly pushStyle?: unknown;
83
+ readonly pop?: unknown;
84
+ };
85
+ MakeFromFontProvider(style: object, fonts: NativeFontProvider): NativeBuilder | null;
86
+ };
87
+ readonly ParagraphStyle: new (style: object) => object;
88
+ readonly TextStyle?: new (style: object) => object;
89
+ readonly Paragraph?: {
90
+ readonly prototype: {
91
+ readonly didExceedMaxLines?: unknown;
92
+ readonly hasLineEllipsis?: unknown;
93
+ readonly getGlyphInfoAt?: unknown;
94
+ readonly getShapedLines?: unknown;
95
+ };
96
+ };
97
+ readonly EgretParagraphLayoutVersion?: number;
98
+ readonly Font: new (face: NativeTypeface, size: number, scaleX: number, skewX: number) => NativeFont;
99
+ readonly TextDirection: {
100
+ readonly LTR: unknown;
101
+ readonly RTL: unknown;
102
+ };
103
+ readonly TextAlign: {
104
+ readonly Left: unknown;
105
+ readonly Right?: unknown;
106
+ readonly Center?: unknown;
107
+ readonly Justify?: unknown;
108
+ };
109
+ readonly FontHinting: {
110
+ readonly Slight: unknown;
111
+ };
112
+ readonly FontEdging: {
113
+ readonly AntiAlias: unknown;
114
+ };
115
+ readonly ColorType: {
116
+ readonly RGBA_8888: unknown;
117
+ };
118
+ readonly AlphaType: {
119
+ readonly Unpremul: unknown;
120
+ };
121
+ readonly ColorSpace: {
122
+ readonly SRGB: unknown;
123
+ };
124
+ readonly TRANSPARENT: Float32Array;
125
+ readonly HEAPU8: Uint8Array;
126
+ Color4f(red: number, green: number, blue: number, alpha: number): Float32Array;
127
+ MakeSurface(width: number, height: number): NativeSurface | null;
128
+ _malloc(bytes: number): number;
129
+ _free(pointer: number): void;
130
+ }
131
+ /** One font for CanvasKit paragraphs: its family, bytes and identity. */
132
+ export interface CanvasKitParagraphFont {
133
+ readonly family: string;
134
+ readonly data: Uint8Array;
135
+ /** Caller-declared immutable font identity, preferably the original byte SHA-256. */
136
+ readonly identity: string;
137
+ }
138
+ /** A CanvasKit paragraph provider to make: its CanvasKit, build identity and fonts. */
139
+ export interface CanvasKitParagraphProviderOptions {
140
+ readonly canvasKit: CanvasKitParagraphModule;
141
+ /** Host-declared build identity; omission identifies only this module instance. */
142
+ readonly buildIdentity?: string;
143
+ readonly fonts: readonly CanvasKitParagraphFont[];
144
+ }
145
+ /** Lays out and draws paragraphs with CanvasKit; dispose of it when done. */
146
+ export interface CanvasKitParagraphProvider extends ParagraphProvider {
147
+ /** Explicitly retires this provider's font wrappers; caches borrow the provider. */
148
+ dispose(): void;
149
+ }
150
+ /**
151
+ * CPU raster adapter using standard CanvasKit paragraph APIs and explicit font bytes.
152
+ * Hosts select a qualified native build; final-line and layout controls share its glyph plan.
153
+ * No private qualification snapshot or its 1024-byte/16-line envelope is used.
154
+ */
155
+ /** Internal capability port shared by fixed and generation-aware adapters. */
156
+ export declare function canvasKitParagraphCapabilities(ck: CanvasKitParagraphModule): Readonly<{
157
+ styledRuns: boolean;
158
+ textGeometry: boolean;
159
+ textAlign: boolean;
160
+ maxLines: boolean;
161
+ }>;
162
+ /** Lays out and draws paragraphs with CanvasKit and the fonts it is given. */
163
+ export declare function createCanvasKitParagraphProvider(options: CanvasKitParagraphProviderOptions): CanvasKitParagraphProvider;
164
+ /** Internal native ownership port; the public fixed-font API is unchanged. */
165
+ export interface NativeFontBorrow {
166
+ readonly face: NativeTypeface;
167
+ release(): void;
168
+ }
169
+ /** CanvasKit's raw binding takes ownership of the allocation, including a null decode result. */
170
+ export declare function decodeCanvasKitFont(ck: CanvasKitParagraphModule, data: Uint8Array): NativeTypeface | null;
171
+ export declare function createCanvasKitParagraphProviderOwned(options: CanvasKitParagraphProviderOptions, borrowFont?: (font: CanvasKitParagraphFont) => NativeFontBorrow): CanvasKitParagraphProvider;
172
+ export {};
173
+ //# sourceMappingURL=CanvasKitParagraphProvider.d.ts.map