@egret/engine 0.0.0-stage → 7.0.1-rc.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (575) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +464 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +15 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +43 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +233 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +29 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +411 -0
  57. package/dist/cameraTypes.d.ts +114 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +33 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +42 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +34 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +134 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +37 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +292 -0
  145. package/dist/particleTypes.d.ts +107 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +331 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,112 @@
1
+ import { createAssetType } from '@egret/runtime';
2
+ import { World3DError } from '../../rendering/world3d/core3D.js';
3
+ import { Object3D } from '../../rendering/world3d/Object3D.js';
4
+ import { deserializeScene3D } from '../../rendering/world3d/Serialize3D.js';
5
+ import { CubeTexture3D, Texture3D } from '../../rendering/world3d/Texture3D.js';
6
+ import { loadCubeTexture3D, loadGltfFromUrl3D, loadTexture3D } from './loaders3D.js';
7
+ function isRecord(value) {
8
+ return typeof value === 'object' && value !== null;
9
+ }
10
+ /** A loaded glTF file. The reference id is the file URL. */
11
+ export const GLTF_ASSET_3D = createAssetType('world3d.gltf', (value) => isRecord(value) &&
12
+ value['scene'] instanceof Object3D &&
13
+ Array.isArray(value['animations']) &&
14
+ typeof value['dispose'] === 'function');
15
+ /** A 2D texture loaded from an image or KTX2 file. The reference id is the file URL. */
16
+ export const TEXTURE_ASSET_3D = createAssetType('world3d.texture', (value) => value instanceof Texture3D);
17
+ /**
18
+ * A cube texture. The reference id is a URL containing `{face}`, replaced by
19
+ * px, nx, py, ny, pz and nz in turn.
20
+ */
21
+ export const CUBE_TEXTURE_ASSET_3D = createAssetType('world3d.cubeTexture', (value) => value instanceof CubeTexture3D);
22
+ /** A scene document written by serializeScene3D. The reference id is the JSON file URL. */
23
+ export const SCENE_ASSET_3D = createAssetType('world3d.scene', (value) => isRecord(value) &&
24
+ value['root'] instanceof Object3D &&
25
+ Array.isArray(value['geometries']) &&
26
+ typeof value['dispose'] === 'function');
27
+ const CUBE_FACES = ['px', 'nx', 'py', 'ny', 'pz', 'nz'];
28
+ /** Mirror an Engine cancellation signal onto a browser AbortSignal for fetch. */
29
+ function abortSignal(signal) {
30
+ const controller = new AbortController();
31
+ const abort = () => controller.abort(signal.reason);
32
+ if (signal.aborted)
33
+ abort();
34
+ else
35
+ signal.addEventListener('abort', abort, { once: true });
36
+ return { signal: controller.signal, detach: () => signal.removeEventListener('abort', abort) };
37
+ }
38
+ async function guarded(context, load) {
39
+ const bridge = abortSignal(context.signal);
40
+ try {
41
+ const value = await load(bridge.signal);
42
+ // A load that finished after cancellation must not leak its resources.
43
+ if (context.signal.aborted) {
44
+ value.dispose();
45
+ throw new World3DError('WORLD3D_RESOURCE_FAILED', 'load cancelled', context.signal.reason);
46
+ }
47
+ return value;
48
+ }
49
+ finally {
50
+ bridge.detach();
51
+ }
52
+ }
53
+ /**
54
+ * Register the World3D asset providers on an AssetManager. Call once per
55
+ * Engine, then acquire with `assets.acquire(createAssetRef(GLTF_ASSET_3D, url))`.
56
+ */
57
+ export function registerWorld3DAssets(assets, options = {}) {
58
+ const url = (ref) => (options.resolveUrl ? options.resolveUrl(ref.id) : ref.id);
59
+ const limits = options.maxBytes === undefined ? {} : { maxBytes: options.maxBytes };
60
+ const ktx2 = options.transcodeKtx2 ? { transcodeKtx2: options.transcodeKtx2 } : {};
61
+ const dispose = (value) => value.dispose();
62
+ assets.register(GLTF_ASSET_3D, {
63
+ load: (ref, context) => guarded(context, signal => loadGltfFromUrl3D(url(ref), {
64
+ signal,
65
+ ...limits,
66
+ ...ktx2,
67
+ ...(options.decodeMeshopt ? { decodeMeshopt: options.decodeMeshopt } : {}),
68
+ ...(options.decodeDraco ? { decodeDraco: options.decodeDraco } : {})
69
+ })),
70
+ dispose
71
+ });
72
+ assets.register(TEXTURE_ASSET_3D, {
73
+ load: (ref, context) => guarded(context, signal => loadTexture3D(url(ref), { ...options.texture, signal, ...limits, ...ktx2 })),
74
+ dispose
75
+ });
76
+ assets.register(CUBE_TEXTURE_ASSET_3D, {
77
+ load: (ref, context) => {
78
+ const template = url(ref);
79
+ if (!template.includes('{face}'))
80
+ return Promise.reject(new World3DError('WORLD3D_INPUT_INVALID', 'cube texture id needs {face}: ' + ref.id));
81
+ return guarded(context, signal => loadCubeTexture3D(CUBE_FACES.map(face => template.replace('{face}', face)), { ...options.cubeTexture, signal, ...limits }));
82
+ },
83
+ dispose
84
+ });
85
+ assets.register(SCENE_ASSET_3D, {
86
+ load: (ref, context) => guarded(context, async (signal) => {
87
+ const target = url(ref);
88
+ let response;
89
+ try {
90
+ response = await fetch(target, { signal });
91
+ }
92
+ catch (cause) {
93
+ throw new World3DError('WORLD3D_RESOURCE_FAILED', target, cause);
94
+ }
95
+ if (!response.ok)
96
+ throw new World3DError('WORLD3D_RESOURCE_FAILED', target + ' (HTTP ' + response.status + ')');
97
+ const text = await response.text();
98
+ if (options.maxBytes !== undefined && text.length > options.maxBytes)
99
+ throw new World3DError('WORLD3D_BUDGET', target);
100
+ let saved;
101
+ try {
102
+ saved = JSON.parse(text);
103
+ }
104
+ catch (cause) {
105
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'scene document: ' + target, cause);
106
+ }
107
+ return deserializeScene3D(saved, options.resolveTexture ? { resolveTexture: options.resolveTexture } : {});
108
+ }),
109
+ dispose
110
+ });
111
+ }
112
+ //# sourceMappingURL=assets3D.js.map
@@ -0,0 +1,47 @@
1
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
2
+ import { type CustomPost3D } from './post3D.js';
3
+ export interface AtmosphereOptions3D {
4
+ /** Fog color, 0xRRGGBB. Default a pale blue-grey. */
5
+ readonly fogColor?: number;
6
+ /** Fog thickness per world unit at `fogHeight`; 0 turns fog off. Default 0.01. */
7
+ readonly fogDensity?: number;
8
+ /** World height at which the fog has its stated density. Default 0. */
9
+ readonly fogHeight?: number;
10
+ /** How quickly the fog thins with height, per world unit; 0 gives uniform fog. Default 0.08. */
11
+ readonly fogFalloff?: number;
12
+ /** Brightness of the light shafts; 0 turns them off. Default 0.6. */
13
+ readonly shaftIntensity?: number;
14
+ /** How far the shafts reach across the screen, 0 to 1. Default 0.6. */
15
+ readonly shaftLength?: number;
16
+ }
17
+ /**
18
+ * Height fog and light shafts for `renderer.postProcess.custom`. Call
19
+ * `update(camera, sunDirection)` every frame before rendering: the hook needs
20
+ * to know where the camera and the sun are.
21
+ */
22
+ export declare class Atmosphere3D {
23
+ #private;
24
+ readonly post: CustomPost3D;
25
+ constructor(options?: AtmosphereOptions3D);
26
+ get fogDensity(): number;
27
+ set fogDensity(value: number);
28
+ get fogFalloff(): number;
29
+ set fogFalloff(value: number);
30
+ get fogHeight(): number;
31
+ set fogHeight(value: number);
32
+ get shaftIntensity(): number;
33
+ set shaftIntensity(value: number);
34
+ get shaftLength(): number;
35
+ set shaftLength(value: number);
36
+ /** Linear RGB fog color. */
37
+ setFogColor(r: number, g: number, b: number): void;
38
+ /**
39
+ * Refresh the camera and sun data. `sunDirection` is the direction the
40
+ * sunlight travels in, as a directional light's world direction; pass
41
+ * undefined when there is no sun, which leaves only the fog.
42
+ */
43
+ update(camera: Camera3D, sunDirection?: ArrayLike<number>): void;
44
+ private amount;
45
+ }
46
+ export declare function createAtmosphere3D(options?: AtmosphereOptions3D): Atmosphere3D;
47
+ //# sourceMappingURL=atmosphere3D.d.ts.map
@@ -0,0 +1,178 @@
1
+ import { World3DError, requireFinite3D } from '../../rendering/world3d/core3D.js';
2
+ import { colorFromHex } from '../../rendering/world3d/math3D.js';
3
+ import { createCustomPost3D } from './post3D.js';
4
+ // uniforms: [0] fog rgb, density; [1] falloff, base height, sky distance, shaft intensity;
5
+ // [2] sun uv, sun visibility, shaft length; [3] the camera's world Y axis in view space, camera height.
6
+ const GLSL = /* glsl */ `
7
+ vec3 customPost(vec3 color, vec2 uv) {
8
+ vec4 fog = uPostCustom[0], shape = uPostCustom[1], sun = uPostCustom[2], up = uPostCustom[3];
9
+ vec3 view = unprojectDepth(uv, rawDepth(uv));
10
+ float reach = length(view);
11
+ if (fog.a > 0.0) {
12
+ // Density falls off exponentially with height; its integral along the ray has a closed form.
13
+ float rise = dot(up.xyz, view), slope = shape.x * rise;
14
+ float thin = abs(slope) > 0.0001 ? (1.0 - exp(-slope)) / slope : 1.0;
15
+ float depth = fog.a * exp(-shape.x * (up.w - shape.y)) * reach * thin;
16
+ color = mix(fog.rgb, color, exp(-max(depth, 0.0)));
17
+ }
18
+ if (shape.w > 0.0 && sun.z > 0.0) {
19
+ // March from the pixel toward the sun, gathering how much open sky lies on the way.
20
+ vec2 stride = (sun.xy - uv) * (sun.w / 24.0);
21
+ // Counted from the top row, as the other backend does, so both dither alike.
22
+ vec2 pixel = vec2(uv.x, 1.0 - uv.y) * vec2(textureSize(uDepth, 0));
23
+ float jitter = fract(52.9829189 * fract(dot(pixel, vec2(0.06711056, 0.00583715))));
24
+ vec2 at = uv + stride * jitter;
25
+ float light = 0.0, weight = 1.0;
26
+ for (int i = 0; i < 24; i++) {
27
+ at += stride;
28
+ float open = step(shape.z, sceneDepth(clamp(at, vec2(0.001), vec2(0.999))));
29
+ float nearSun = 1.0 - smoothstep(0.0, 0.7, distance(at, sun.xy));
30
+ light += open * nearSun * weight;
31
+ weight *= 0.95;
32
+ }
33
+ color += vec3(1.0, 0.93, 0.78) * (light / 24.0 * shape.w * sun.z);
34
+ }
35
+ return color;
36
+ }
37
+ `;
38
+ const WGSL = /* wgsl */ `
39
+ fn customPost(color: vec3f, uv: vec2f) -> vec3f {
40
+ let fog = params.custom[0];
41
+ let shape = params.custom[1];
42
+ // Texture rows run top-down here, so the sun's height on screen is flipped.
43
+ let sun = vec4f(params.custom[2].x, 1.0 - params.custom[2].y, params.custom[2].zw);
44
+ let up = params.custom[3];
45
+ var result = color;
46
+ let view = unprojectDepth(uv, rawDepth(uv));
47
+ let reach = length(view);
48
+ if (fog.a > 0.0) {
49
+ // Density falls off exponentially with height; its integral along the ray has a closed form.
50
+ let rise = dot(up.xyz, view);
51
+ let slope = shape.x * rise;
52
+ var thin = 1.0;
53
+ if (abs(slope) > 0.0001) { thin = (1.0 - exp(-slope)) / slope; }
54
+ let depth = fog.a * exp(-shape.x * (up.w - shape.y)) * reach * thin;
55
+ result = mix(fog.rgb, result, exp(-max(depth, 0.0)));
56
+ }
57
+ if (shape.w > 0.0 && sun.z > 0.0) {
58
+ // March from the pixel toward the sun, gathering how much open sky lies on the way.
59
+ let size = vec2f(textureDimensions(depthTexture));
60
+ let stride = (sun.xy - uv) * (sun.w / 24.0);
61
+ let jitter = fract(52.9829189 * fract(dot(uv * size, vec2f(0.06711056, 0.00583715))));
62
+ var at = uv + stride * jitter;
63
+ var light = 0.0;
64
+ var weight = 1.0;
65
+ for (var i = 0; i < 24; i++) {
66
+ at += stride;
67
+ let open = step(shape.z, sceneDepth(clamp(at, vec2f(0.001), vec2f(0.999))));
68
+ let nearSun = 1.0 - smoothstep(0.0, 0.7, distance(at, sun.xy));
69
+ light += open * nearSun * weight;
70
+ weight *= 0.95;
71
+ }
72
+ result += vec3f(1.0, 0.93, 0.78) * (light / 24.0 * shape.w * sun.z);
73
+ }
74
+ return result;
75
+ }
76
+ `;
77
+ /**
78
+ * Height fog and light shafts for `renderer.postProcess.custom`. Call
79
+ * `update(camera, sunDirection)` every frame before rendering: the hook needs
80
+ * to know where the camera and the sun are.
81
+ */
82
+ export class Atmosphere3D {
83
+ post;
84
+ #scratch = [0, 0, 0];
85
+ constructor(options = {}) {
86
+ this.post = createCustomPost3D({ key: 'world3d-atmosphere', glsl: GLSL, wgsl: WGSL });
87
+ colorFromHex(this.post.uniforms, options.fogColor ?? 0xb4c4d4);
88
+ this.fogDensity = options.fogDensity ?? 0.01;
89
+ this.fogHeight = options.fogHeight ?? 0;
90
+ this.fogFalloff = options.fogFalloff ?? 0.08;
91
+ this.shaftIntensity = options.shaftIntensity ?? 0.6;
92
+ this.shaftLength = options.shaftLength ?? 0.6;
93
+ }
94
+ get fogDensity() {
95
+ return this.post.uniforms[3];
96
+ }
97
+ set fogDensity(value) {
98
+ this.post.uniforms[3] = this.amount(value, 'fogDensity');
99
+ }
100
+ get fogFalloff() {
101
+ return this.post.uniforms[4];
102
+ }
103
+ set fogFalloff(value) {
104
+ this.post.uniforms[4] = this.amount(value, 'fogFalloff');
105
+ }
106
+ get fogHeight() {
107
+ return this.post.uniforms[5];
108
+ }
109
+ set fogHeight(value) {
110
+ this.post.uniforms[5] = requireFinite3D(value, 'fogHeight');
111
+ }
112
+ get shaftIntensity() {
113
+ return this.post.uniforms[7];
114
+ }
115
+ set shaftIntensity(value) {
116
+ this.post.uniforms[7] = this.amount(value, 'shaftIntensity');
117
+ }
118
+ get shaftLength() {
119
+ return this.post.uniforms[11];
120
+ }
121
+ set shaftLength(value) {
122
+ const length = this.amount(value, 'shaftLength');
123
+ if (length > 1)
124
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'shaftLength');
125
+ this.post.uniforms[11] = length;
126
+ }
127
+ /** Linear RGB fog color. */
128
+ setFogColor(r, g, b) {
129
+ this.post.uniforms[0] = requireFinite3D(r, 'color');
130
+ this.post.uniforms[1] = requireFinite3D(g, 'color');
131
+ this.post.uniforms[2] = requireFinite3D(b, 'color');
132
+ }
133
+ /**
134
+ * Refresh the camera and sun data. `sunDirection` is the direction the
135
+ * sunlight travels in, as a directional light's world direction; pass
136
+ * undefined when there is no sun, which leaves only the fog.
137
+ */
138
+ update(camera, sunDirection) {
139
+ camera.updateViewMatrices();
140
+ const u = this.post.uniforms, world = camera.matrixWorld;
141
+ // World up expressed in view space is the second row of the camera's rotation.
142
+ const sx = Math.hypot(world[0], world[1], world[2]) || 1, sy = Math.hypot(world[4], world[5], world[6]) || 1, sz = Math.hypot(world[8], world[9], world[10]) || 1;
143
+ u[12] = world[1] / sx;
144
+ u[13] = world[5] / sy;
145
+ u[14] = world[9] / sz;
146
+ u[15] = world[13];
147
+ u[6] = camera.far * 0.98;
148
+ u[10] = 0;
149
+ if (!sunDirection)
150
+ return;
151
+ const dx = requireFinite3D(sunDirection[0], 'sunDirection'), dy = requireFinite3D(sunDirection[1], 'sunDirection'), dz = requireFinite3D(sunDirection[2], 'sunDirection'), length = Math.hypot(dx, dy, dz);
152
+ if (length < 1e-9)
153
+ return;
154
+ // The sun sits far away against the light's travel; project that point to the screen.
155
+ const far = camera.far * 0.5, at = this.#scratch;
156
+ at[0] = world[12] - (dx / length) * far;
157
+ at[1] = world[13] - (dy / length) * far;
158
+ at[2] = world[14] - (dz / length) * far;
159
+ const forward = -(world[8] * -dx + world[9] * -dy + world[10] * -dz) / (length * sz);
160
+ if (forward <= 0.05)
161
+ return;
162
+ camera.worldToScreenPoint(at, at);
163
+ u[8] = at[0] * 0.5 + 0.5;
164
+ u[9] = at[1] * 0.5 + 0.5;
165
+ // Fade the shafts out as the sun leaves the view.
166
+ const off = Math.max(Math.abs(at[0]), Math.abs(at[1]));
167
+ u[10] = Math.min(1, forward * 2) * Math.max(0, Math.min(1, (1.8 - off) / 0.8));
168
+ }
169
+ amount(value, field) {
170
+ if (requireFinite3D(value, field) < 0)
171
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
172
+ return value;
173
+ }
174
+ }
175
+ export function createAtmosphere3D(options = {}) {
176
+ return new Atmosphere3D(options);
177
+ }
178
+ //# sourceMappingURL=atmosphere3D.js.map
@@ -0,0 +1,142 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
3
+ import type { Light3D } from '../../rendering/world3d/Light3D.js';
4
+ import type { Mesh3D } from '../../rendering/world3d/Mesh3D.js';
5
+ import type { Scene3D } from '../../rendering/world3d/Object3D.js';
6
+ import type { RenderList3D } from '../../rendering/world3d/RenderList3D.js';
7
+ import type { PostProcessSettings3D } from './post3D.js';
8
+ import type { CompressedFormat3D, RenderTarget3D } from '../../rendering/world3d/Texture3D.js';
9
+ export type ToneMapping3D = 'none' | 'reinhard' | 'aces';
10
+ /** Half-float targets keep scene-referred light until composition. */
11
+ export declare function outputToneMapping3D(toneMapping: ToneMapping3D, target?: RenderTarget3D): ToneMapping3D;
12
+ export interface Renderer3DInfo {
13
+ frame: number;
14
+ drawCalls: number;
15
+ triangles: number;
16
+ visited: number;
17
+ culled: number;
18
+ /** Point and spot lights left out of the last frame because more were lit than the renderer draws. */
19
+ lightsDropped: number;
20
+ /** Point lights past the eight lit through the tiled list in the last frame. */
21
+ lightsTiled: number;
22
+ shadowMaps: number;
23
+ programs: number;
24
+ geometries: number;
25
+ textures: number;
26
+ }
27
+ /** What both world3d backends provide; views and tools depend on this only. */
28
+ export interface Renderer3D extends Disposable {
29
+ readonly canvas: HTMLCanvasElement | OffscreenCanvas;
30
+ readonly info: Renderer3DInfo;
31
+ toneMapping: ToneMapping3D;
32
+ exposure: number;
33
+ shadowsEnabled: boolean;
34
+ /** Bloom, color grading and FXAA; set `enabled` to turn the chain on. */
35
+ readonly postProcess: PostProcessSettings3D;
36
+ /**
37
+ * Part of the output to draw into, as [x, y, width, height] in 0 to 1 with
38
+ * the origin at the bottom left; undefined draws everywhere. Set the
39
+ * camera's aspect to match. Used for split screens and inset views.
40
+ */
41
+ viewport: readonly [number, number, number, number] | undefined;
42
+ /**
43
+ * Clear the whole output to the scene background before drawing. Turn it
44
+ * off for the second and later views of one frame; depth is always cleared.
45
+ */
46
+ autoClear: boolean;
47
+ /** Draw to the canvas, or into `target`. Returns false when the device is lost. */
48
+ render(scene: Scene3D, camera: Camera3D, target?: RenderTarget3D): boolean;
49
+ setSize(width: number, height: number, pixelRatio?: number): void;
50
+ resizeToDisplaySize(pixelRatio?: number): boolean;
51
+ /** True when textures in this compressed format can be used on this device. */
52
+ supportsCompressedFormat(format: CompressedFormat3D): boolean;
53
+ /** RGBA8 pixels of a render target, top row first, in the sRGB encoding. */
54
+ readRenderTargetPixels(target: RenderTarget3D): Promise<Uint8Array>;
55
+ }
56
+ /** Size in floats of the Frame uniform block. */
57
+ export declare const FRAME_BLOCK_FLOATS_3D = 360;
58
+ /** Offsets, in floats, of the Frame block members. */
59
+ export declare const FRAME_OFFSETS_3D: Readonly<{
60
+ readonly viewProjection: 0;
61
+ readonly view: 16;
62
+ readonly cameraPosition: 32;
63
+ readonly fogColor: 36;
64
+ readonly fogParams: 40;
65
+ readonly ambient: 44;
66
+ readonly hemisphereSky: 48;
67
+ readonly hemisphereGround: 52;
68
+ readonly lightCounts: 56;
69
+ readonly directionalDirection: 60;
70
+ readonly directionalColor: 76;
71
+ readonly pointPosition: 92;
72
+ readonly pointColor: 124;
73
+ readonly spotPosition: 156;
74
+ readonly spotDirection: 172;
75
+ readonly spotColor: 188;
76
+ readonly spotCone: 204;
77
+ readonly shadowMatrix: 220;
78
+ readonly shadowRect: 284;
79
+ readonly shadowParams: 300;
80
+ readonly output: 316;
81
+ readonly cascadeSplits: 320;
82
+ readonly cascadeInfo: 324;
83
+ readonly pointShadow: 328;
84
+ readonly clipPlanes: 332;
85
+ readonly clipInfo: 348;
86
+ readonly tileGrid: 352;
87
+ readonly tileInfo: 356;
88
+ }>;
89
+ export interface FrameOutput3D {
90
+ readonly exposure: number;
91
+ readonly toneMapping: ToneMapping3D;
92
+ /** Highest mip level of the bound environment cube, or 0 without one. */
93
+ readonly environmentMaxMip: number;
94
+ }
95
+ /** Fill camera, fog, light and output members. Shadow members are written by planShadows3D. */
96
+ export declare function writeFrameBlock3D(data: Float32Array, scene: Scene3D, camera: Camera3D, list: RenderList3D, shadowSlots: ReadonlyMap<Light3D, number>, output: FrameOutput3D): void;
97
+ export interface ShadowPlan3D {
98
+ readonly light: Light3D;
99
+ readonly slot: number;
100
+ /** Tile origin and edge in atlas texels; the origin is the lower-left corner in GL conventions. */
101
+ readonly x: number;
102
+ readonly y: number;
103
+ readonly tile: number;
104
+ /** Light view-projection with OpenGL clip conventions (z in [-1, 1]). */
105
+ readonly matrix: Float32Array;
106
+ /** Casters whose bounds intersect this light's volume. */
107
+ readonly casters: Mesh3D[];
108
+ }
109
+ /** View-space far distance of each cascade, blending uniform and logarithmic spacing. */
110
+ export declare function cascadeSplits3D(near: number, far: number, count: number, lambda: number): number[];
111
+ /**
112
+ * Assign shadow-casting lights to quarter tiles of a square atlas, compute
113
+ * their matrices and caster lists, and write the shadow members of the block.
114
+ * A cascaded directional light takes one tile per cascade, each fitted to a
115
+ * slice of the camera frustum. `flipY` selects top-left atlas addressing for
116
+ * backends whose texture origin is the top row.
117
+ */
118
+ export declare function planShadows3D(data: Float32Array, list: RenderList3D, atlasSize: number, enabled: boolean, flipY: boolean, slots: Map<Light3D, number>, camera?: Camera3D): ShadowPlan3D[];
119
+ /**
120
+ * The tiled light list: point lights past the eight a frame lights directly, and for each screen tile the lights
121
+ * whose range reaches into it. One RGBA32F table of `TILED_LIGHTS_3D.width` texels a row: lights from texel 0
122
+ * (two texels each: position and range, then colour), tile headers from `headerBase` (first index and count),
123
+ * then light indices four to a texel from `indexBase`.
124
+ */
125
+ export declare const TILED_LIGHTS_3D: Readonly<{
126
+ readonly width: 512;
127
+ readonly rows: 17;
128
+ readonly maxLights: 256;
129
+ readonly headerBase: 512;
130
+ readonly maxTiles: 4096;
131
+ readonly indexBase: number;
132
+ readonly maxIndices: 16384;
133
+ readonly maxPerTile: 32;
134
+ }>;
135
+ /**
136
+ * Fills `table` with the lights and their tiles for a viewport of `width` by `height` pixels, and the tile members
137
+ * of the frame block. With no lights the frame block says so and the table is left alone. `yDown` is true where
138
+ * fragment coordinates count rows from the top (WebGPU), false where from the bottom (WebGL2). `originX` and
139
+ * `originY` are where the viewport starts in fragment coordinates.
140
+ */
141
+ export declare function writeTiledLights3D(data: Float32Array, table: Float32Array, lights: readonly Light3D[], viewProjection: ArrayLike<number>, width: number, height: number, yDown: boolean, originX?: number, originY?: number): number;
142
+ //# sourceMappingURL=frame3D.d.ts.map