@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,246 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
4
+ const refuse = (detail) => new EgretError('BITMAP_FONT_INVALID', { cause: new TypeError(detail) });
5
+ const fonts = new WeakSet();
6
+ /** Whether a value is a font this entry read. */
7
+ export const isBitmapFont = (value) => typeof value === 'object' && value !== null && fonts.has(value);
8
+ const draft = () => ({
9
+ face: '',
10
+ size: undefined,
11
+ lineHeight: undefined,
12
+ base: undefined,
13
+ pages: new Map(),
14
+ glyphs: [],
15
+ kernings: []
16
+ });
17
+ /** A whole number from the attribute of a line or an element. */
18
+ function whole(fields, key, where, fallback) {
19
+ const raw = fields[key];
20
+ if (raw === undefined && fallback !== undefined)
21
+ return fallback;
22
+ const value = typeof raw === 'string' && /^\s*-?\d+\s*$/.test(raw) ? Number(raw) : raw;
23
+ if (!Number.isSafeInteger(value))
24
+ throw refuse(where + ': ' + key);
25
+ return value;
26
+ }
27
+ function glyphOf(fields, where, keys) {
28
+ const id = whole(fields, 'id', where), x = whole(fields, keys.x, where), y = whole(fields, keys.y, where), width = whole(fields, keys.width, where), height = whole(fields, keys.height, where);
29
+ if (id < 0 || id > 0x10ffff || x < 0 || y < 0 || width < 0 || height < 0)
30
+ throw refuse(where + ': a character out of range');
31
+ return Object.freeze({
32
+ id,
33
+ x,
34
+ y,
35
+ width,
36
+ height,
37
+ xOffset: whole(fields, keys.xOffset, where, 0),
38
+ yOffset: whole(fields, keys.yOffset, where, 0),
39
+ xAdvance: whole(fields, keys.xAdvance, where),
40
+ page: whole(fields, 'page', where, 0)
41
+ });
42
+ }
43
+ const BMFONT_KEYS = {
44
+ x: 'x',
45
+ y: 'y',
46
+ width: 'width',
47
+ height: 'height',
48
+ xOffset: 'xoffset',
49
+ yOffset: 'yoffset',
50
+ xAdvance: 'xadvance'
51
+ };
52
+ const PLAIN_KEYS = {
53
+ x: 'x',
54
+ y: 'y',
55
+ width: 'width',
56
+ height: 'height',
57
+ xOffset: 'xOffset',
58
+ yOffset: 'yOffset',
59
+ xAdvance: 'xAdvance'
60
+ };
61
+ /** Takes in one tag of the text or XML form: its attributes as strings. */
62
+ function take(into, tag, fields, where) {
63
+ if (tag === 'info') {
64
+ into.face = fields['face'] ?? '';
65
+ if (fields['size'] !== undefined)
66
+ into.size = Math.abs(whole(fields, 'size', where));
67
+ }
68
+ else if (tag === 'common') {
69
+ into.lineHeight = whole(fields, 'lineHeight', where);
70
+ into.base = whole(fields, 'base', where);
71
+ }
72
+ else if (tag === 'page') {
73
+ const id = whole(fields, 'id', where), file = fields['file'];
74
+ if (file === undefined || into.pages.has(id))
75
+ throw refuse(where + ': page');
76
+ into.pages.set(id, file);
77
+ }
78
+ else if (tag === 'char')
79
+ into.glyphs.push(glyphOf(fields, where, BMFONT_KEYS));
80
+ else if (tag === 'kerning')
81
+ into.kernings.push([whole(fields, 'first', where), whole(fields, 'second', where), whole(fields, 'amount', where)]);
82
+ }
83
+ function readText(source) {
84
+ const into = draft();
85
+ source.split(/\r\n|\r|\n/).forEach((line, index) => {
86
+ const tag = /^\s*(\w+)/.exec(line)?.[1];
87
+ if (tag === undefined)
88
+ return;
89
+ const fields = {};
90
+ for (const match of line.matchAll(/(\w+)=("[^"]*"|\S*)/g))
91
+ fields[match[1]] = match[2].startsWith('"') ? match[2].slice(1, -1) : match[2];
92
+ take(into, tag, fields, 'line ' + (index + 1));
93
+ });
94
+ return into;
95
+ }
96
+ const ENTITIES = { quot: '"', amp: '&', lt: '<', gt: '>', apos: "'" };
97
+ function unescape(value) {
98
+ return value.replace(/&(#x[0-9a-fA-F]+|#\d+|\w+);/g, (all, name) => {
99
+ if (name.startsWith('#')) {
100
+ const code = name[1] === 'x' ? parseInt(name.slice(2), 16) : parseInt(name.slice(1), 10);
101
+ return code <= 0x10ffff ? String.fromCodePoint(code) : all;
102
+ }
103
+ return ENTITIES[name] ?? all;
104
+ });
105
+ }
106
+ function readXml(source) {
107
+ const text = source.replace(/<!--[\s\S]*?-->/g, '');
108
+ if (!/<font[\s>]/.test(text))
109
+ throw refuse('xml: no font element');
110
+ const into = draft();
111
+ let count = 0;
112
+ for (const match of text.matchAll(/<(info|common|page|char|kerning)\b([^>]*)>/g)) {
113
+ const fields = {};
114
+ for (const attribute of match[2].matchAll(/(\w+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g))
115
+ fields[attribute[1]] = unescape(attribute[2] ?? attribute[3]);
116
+ take(into, match[1], fields, match[1] + ' element ' + ++count);
117
+ }
118
+ return into;
119
+ }
120
+ function readJson(value) {
121
+ const into = draft(), info = value['info'], common = value['common'], pages = value['pages'], chars = value['chars'], kernings = value['kernings'] ?? [];
122
+ if (!record(common) ||
123
+ !Array.isArray(pages) ||
124
+ !Array.isArray(chars) ||
125
+ !Array.isArray(kernings) ||
126
+ (info !== undefined && !record(info)))
127
+ throw refuse('json: common, pages and chars');
128
+ if (record(info)) {
129
+ if (info['face'] !== undefined && typeof info['face'] !== 'string')
130
+ throw refuse('json: info.face');
131
+ into.face = info['face'] ?? '';
132
+ if (info['size'] !== undefined)
133
+ into.size = Math.abs(whole(info, 'size', 'json info'));
134
+ }
135
+ into.lineHeight = whole(common, 'lineHeight', 'json common');
136
+ into.base = whole(common, 'base', 'json common');
137
+ pages.forEach((file, index) => {
138
+ if (typeof file !== 'string')
139
+ throw refuse('json: page ' + index);
140
+ into.pages.set(index, file);
141
+ });
142
+ chars.forEach((char, index) => {
143
+ if (!record(char))
144
+ throw refuse('json: char ' + index);
145
+ into.glyphs.push(glyphOf(char, 'json char ' + index, BMFONT_KEYS));
146
+ });
147
+ kernings.forEach((pair, index) => {
148
+ if (!record(pair))
149
+ throw refuse('json: kerning ' + index);
150
+ const where = 'json kerning ' + index;
151
+ into.kernings.push([whole(pair, 'first', where), whole(pair, 'second', where), whole(pair, 'amount', where)]);
152
+ });
153
+ return into;
154
+ }
155
+ /** Egret's own form, from its texture merger: one page, each character a frame named by the character. */
156
+ function readEgret(value) {
157
+ const into = draft(), file = value['file'], frames = value['frames'];
158
+ if (typeof file !== 'string' || !record(frames))
159
+ throw refuse('egret: file and frames');
160
+ into.pages.set(0, file);
161
+ let tallest = 0;
162
+ for (const [name, frame] of Object.entries(frames)) {
163
+ if ([...name].length !== 1 || !record(frame))
164
+ throw refuse('egret: frame ' + JSON.stringify(name));
165
+ const where = 'egret frame ' + JSON.stringify(name), width = whole(frame, 'w', where), height = whole(frame, 'h', where);
166
+ // A trimmed frame keeps the size it had before it was trimmed: that is its advance, and the tallest is the height of a line.
167
+ const sourceW = whole(frame, 'sourceW', where, width), sourceH = whole(frame, 'sourceH', where, height);
168
+ into.glyphs.push(glyphOf({
169
+ id: name.codePointAt(0),
170
+ x: frame['x'],
171
+ y: frame['y'],
172
+ width,
173
+ height,
174
+ xOffset: frame['offX'] ?? 0,
175
+ yOffset: frame['offY'] ?? 0,
176
+ xAdvance: sourceW
177
+ }, where, PLAIN_KEYS));
178
+ tallest = Math.max(tallest, sourceH);
179
+ }
180
+ into.lineHeight = tallest;
181
+ into.base = tallest;
182
+ return into;
183
+ }
184
+ function finish(into, format) {
185
+ const { lineHeight, base } = into;
186
+ if (lineHeight === undefined || base === undefined || lineHeight <= 0)
187
+ throw refuse(format + ': the height of a line');
188
+ if (into.pages.size === 0 || [...into.pages.keys()].some(id => id < 0 || id >= into.pages.size))
189
+ throw refuse(format + ': pages numbered from 0 without a gap');
190
+ const pages = Object.freeze(Array.from({ length: into.pages.size }, (_, id) => into.pages.get(id)));
191
+ const byCode = new Map();
192
+ for (const glyph of into.glyphs) {
193
+ if (byCode.has(glyph.id))
194
+ throw refuse(format + ': character ' + glyph.id + ' twice');
195
+ if (glyph.page < 0 || glyph.page >= pages.length)
196
+ throw refuse(format + ': character ' + glyph.id + ' on no page');
197
+ byCode.set(glyph.id, glyph);
198
+ }
199
+ const pairs = new Map();
200
+ for (const [first, second, amount] of into.kernings) {
201
+ const key = first * 0x110000 + second;
202
+ if (first < 0 || second < 0 || first > 0x10ffff || second > 0x10ffff || pairs.has(key))
203
+ throw refuse(format + ': kerning ' + first + ',' + second);
204
+ pairs.set(key, amount);
205
+ }
206
+ const glyphs = Object.freeze([...byCode.values()].sort((a, b) => a.id - b.id));
207
+ const font = Object.freeze({
208
+ face: into.face,
209
+ size: into.size ?? lineHeight,
210
+ lineHeight,
211
+ base,
212
+ pages,
213
+ glyphs,
214
+ format,
215
+ glyph: (codePoint) => byCode.get(codePoint),
216
+ kerning: (first, second) => pairs.get(first * 0x110000 + second) ?? 0
217
+ });
218
+ fonts.add(font);
219
+ return font;
220
+ }
221
+ /**
222
+ * Reads a bitmap font: the text, XML or JSON forms of BMFont (from AngelCode's generator, Hiero, Glyph Designer, Littera and the like),
223
+ * or Egret's own JSON of frames. A string is read as XML when it starts with `<`, as JSON when it starts with `{`, and as text otherwise;
224
+ * white space and a byte order mark before it are left out.
225
+ */
226
+ export function parseBitmapFont(source) {
227
+ if (typeof source === 'string') {
228
+ const text = source.trimStart();
229
+ if (text.startsWith('<'))
230
+ return finish(readXml(text), 'xml');
231
+ if (!text.startsWith('{'))
232
+ return finish(readText(text), 'text');
233
+ let value;
234
+ try {
235
+ value = JSON.parse(text);
236
+ }
237
+ catch (cause) {
238
+ throw new EgretError('BITMAP_FONT_INVALID', { cause });
239
+ }
240
+ return parseBitmapFont(value);
241
+ }
242
+ if (!record(source))
243
+ throw refuse('a string or an object');
244
+ return 'frames' in source ? finish(readEgret(source), 'egret') : finish(readJson(source), 'json');
245
+ }
246
+ //# sourceMappingURL=bitmapFontParse.js.map
@@ -0,0 +1,112 @@
1
+ import type { AssetLease, DisplayObjectContainer, Mesh2D, Texture } from '@egret/runtime';
2
+ /** One character of a bitmap font: where it is on its page, where it is drawn from the pen, and how far the pen goes on. */
3
+ export interface BitmapGlyph {
4
+ /** The Unicode code point. */
5
+ readonly id: number;
6
+ /** Its rectangle on its page, in pixels. */
7
+ readonly x: number;
8
+ readonly y: number;
9
+ readonly width: number;
10
+ readonly height: number;
11
+ /** Where it is drawn from the pen: across, and down from the top of the line. */
12
+ readonly xOffset: number;
13
+ readonly yOffset: number;
14
+ /** How far the pen moves on after it. */
15
+ readonly xAdvance: number;
16
+ /** The index of its page. */
17
+ readonly page: number;
18
+ }
19
+ /** A bitmap font read from a file: frozen, with its characters and the kerning between pairs of them. */
20
+ export interface BitmapFont {
21
+ /** The name of the face, where the file says it. */
22
+ readonly face: string;
23
+ /** The size it was made at, where the file says it. */
24
+ readonly size: number;
25
+ /** From the top of one line to the top of the next. */
26
+ readonly lineHeight: number;
27
+ /** From the top of a line to the baseline. */
28
+ readonly base: number;
29
+ /** The file names of the pages, in the order of their indices. */
30
+ readonly pages: readonly string[];
31
+ /** Every character, in the order of their code points. */
32
+ readonly glyphs: readonly BitmapGlyph[];
33
+ /** The format the font was read from. */
34
+ readonly format: 'text' | 'xml' | 'json' | 'egret';
35
+ glyph(codePoint: number): BitmapGlyph | undefined;
36
+ /** What is added to the advance of `first` when `second` follows it; 0 for a pair it does not name. */
37
+ kerning(first: number, second: number): number;
38
+ }
39
+ /** How bitmap text is laid out: its width, alignment, spacing and kerning, and the character to fall back on. */
40
+ export interface BitmapTextLayoutOptions {
41
+ /** Lines are broken to fit this width: after spaces, and between ideographs. A word wider than it is broken between its characters. */
42
+ readonly maxWidth?: number;
43
+ /** Where each line lies within the widest line, or within `maxWidth` when there is one. Defaults to `left`. */
44
+ readonly align?: 'left' | 'center' | 'right';
45
+ /** Added after each character but the last of a line. Defaults to 0. */
46
+ readonly letterSpacing?: number;
47
+ /** Added between lines. Defaults to 0. */
48
+ readonly lineSpacing?: number;
49
+ /** Whether the kerning of the font is used. Defaults to true. */
50
+ readonly kerning?: boolean;
51
+ /** The character drawn for one the font does not have; none draws nothing and moves the pen by nothing. Defaults to `?` where the font has it. */
52
+ readonly fallback?: string | null;
53
+ }
54
+ /** One character placed: its rectangle in the text and its rectangle on its page. */
55
+ export interface BitmapTextGlyph {
56
+ readonly codePoint: number;
57
+ readonly page: number;
58
+ readonly line: number;
59
+ readonly x: number;
60
+ readonly y: number;
61
+ readonly width: number;
62
+ readonly height: number;
63
+ readonly sourceX: number;
64
+ readonly sourceY: number;
65
+ }
66
+ /** One laid out line of bitmap text: its characters, width and place. */
67
+ export interface BitmapTextLine {
68
+ readonly text: string;
69
+ /** From the left of its first character's advance to the end of its last, spaces at its end left out. */
70
+ readonly width: number;
71
+ /** Where it starts across, as aligned, and the top of it. */
72
+ readonly x: number;
73
+ readonly y: number;
74
+ }
75
+ /** Text laid out in a font, from its top left. */
76
+ export interface BitmapTextLayout {
77
+ /** The widest line, or `maxWidth` when there is one. */
78
+ readonly width: number;
79
+ readonly height: number;
80
+ readonly lines: readonly BitmapTextLine[];
81
+ readonly glyphs: readonly BitmapTextGlyph[];
82
+ /** Characters the font does not have, the fallback drawn for them or not. */
83
+ readonly missing: number;
84
+ }
85
+ /** Bitmap text to make: its font, pages, text and color, and how it is laid out. */
86
+ export interface BitmapTextOptions extends BitmapTextLayoutOptions {
87
+ readonly font: BitmapFont;
88
+ /** A leased texture for each page of the font, in the order of its pages. */
89
+ readonly pages: readonly AssetLease<Texture>[];
90
+ readonly text?: string;
91
+ /** The tint the texture is multiplied by, 0xRRGGBB as it is seen: white in the pages shows as this colour. Defaults to white. */
92
+ readonly color?: number;
93
+ }
94
+ /** Text drawn in a bitmap font, as one mesh for each page it uses. */
95
+ export interface BitmapText {
96
+ readonly state: 'active' | 'closed';
97
+ readonly display: DisplayObjectContainer;
98
+ text: string;
99
+ color: number;
100
+ maxWidth: number | undefined;
101
+ align: 'left' | 'center' | 'right';
102
+ letterSpacing: number;
103
+ lineSpacing: number;
104
+ readonly width: number;
105
+ readonly height: number;
106
+ /** The layout as last drawn. */
107
+ readonly layout: BitmapTextLayout;
108
+ /** The meshes, one for each page used, in the order of the pages. */
109
+ readonly meshes: readonly Mesh2D[];
110
+ dispose(): void;
111
+ }
112
+ //# sourceMappingURL=bitmapFontTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=bitmapFontTypes.js.map
@@ -0,0 +1,26 @@
1
+ import { Scope } from '@egret/runtime';
2
+ import type { AssetGroupOperations, AssetRef, Bitmap, EngineContext, Texture } from '@egret/runtime';
3
+ import type { Diagnostic } from '@egret/contracts';
4
+ /** Whether a bitmap resource slot is idle, loading a replacement, ready, failed, conflicted or disposed. */
5
+ export type BitmapResourceSlotState = 'idle' | 'pending' | 'ready' | 'failed' | 'conflicted' | 'disposed';
6
+ /** Owns only replacement leases; the exact initial Bitmap binding remains borrowed. */
7
+ export interface BitmapResourceSlot {
8
+ readonly state: BitmapResourceSlotState;
9
+ replace(ref: AssetRef<Texture>): Promise<void>;
10
+ cancel(reason?: unknown): void;
11
+ dispose(): void;
12
+ }
13
+ type Operations = Parameters<NonNullable<EngineContext['registerBitmapResourceTarget']>>[1];
14
+ export interface BitmapResourceSlotContext {
15
+ assertOpen(): void;
16
+ isEngineScope(scope: unknown): scope is Scope;
17
+ report(diagnostic: Diagnostic): void;
18
+ captureCleanup(cause: unknown): void;
19
+ }
20
+ export interface BitmapResourceSlotOwner {
21
+ create(scope: unknown, bitmap: unknown): BitmapResourceSlot;
22
+ close(): void;
23
+ }
24
+ export declare function createBitmapResourceSlotOwner(context: BitmapResourceSlotContext, acquisitions: AssetGroupOperations, targets: WeakMap<Bitmap, Operations>): BitmapResourceSlotOwner;
25
+ export {};
26
+ //# sourceMappingURL=bitmapResourceSlot.d.ts.map