@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,459 @@
1
+ import { World3DError } from '../../rendering/world3d/core3D.js';
2
+ import { mat4Invert } from '../../rendering/world3d/math3D.js';
3
+ export function createCustomPost3D(input) {
4
+ if (!input || typeof input.key !== 'string' || input.key.length === 0 || /[\s|/]/.test(input.key))
5
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'post key');
6
+ if (input.glsl === undefined && input.wgsl === undefined)
7
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'post source');
8
+ const uniforms = new Float32Array(16);
9
+ if (input.uniforms)
10
+ uniforms.set(Array.from(input.uniforms).slice(0, 16));
11
+ return Object.freeze({
12
+ key: input.key,
13
+ ...(input.glsl === undefined ? {} : { glsl: input.glsl }),
14
+ ...(input.wgsl === undefined ? {} : { wgsl: input.wgsl }),
15
+ uniforms
16
+ });
17
+ }
18
+ export function postViewFromCamera3D(camera) {
19
+ // Oblique projections encode X and Y in clip depth. Unproject the full
20
+ // homogeneous clip position instead of assuming depth depends on Z alone.
21
+ const inverseProjection = new Float32Array(16);
22
+ if (!mat4Invert(inverseProjection, camera.projectionMatrix))
23
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'post-processing projection is singular');
24
+ return { inverseProjection };
25
+ }
26
+ /** True when the settings ask for outlines. */
27
+ export function outlineActive3D(settings) {
28
+ return settings.outlineLayers !== 0 && settings.outlineThickness > 0;
29
+ }
30
+ /** Post uniform layout: a, b, flags, custom[4], outline and inverse projection. */
31
+ export const POST_PARAMS_FLOATS_3D = 48;
32
+ export function writePostParams3D(out, a, b, view, aoEnabled, width, height, custom, outline) {
33
+ out.fill(0);
34
+ out.set(a, 0);
35
+ out.set(b, 4);
36
+ out[9] = aoEnabled ? 1 : 0;
37
+ out[10] = 1 / width;
38
+ out[11] = 1 / height;
39
+ if (custom)
40
+ out.set(custom.uniforms, 12);
41
+ if (outline) {
42
+ out.set(outline.outlineColor, 28);
43
+ out[31] = outline.outlineThickness;
44
+ }
45
+ out.set(view.inverseProjection, 32);
46
+ }
47
+ export const POST3D_LIMITS = Object.freeze({ maxBloomLevels: 8 });
48
+ export function createPostProcessSettings3D() {
49
+ return {
50
+ enabled: false,
51
+ bloom: true,
52
+ bloomThreshold: 1,
53
+ bloomKnee: 0.5,
54
+ bloomIntensity: 0.6,
55
+ bloomLevels: 5,
56
+ fxaa: true,
57
+ saturation: 1,
58
+ contrast: 1,
59
+ brightness: 1,
60
+ vignette: 0,
61
+ ssao: false,
62
+ ssaoRadius: 0.5,
63
+ ssaoIntensity: 1,
64
+ ssaoBias: 0.025,
65
+ dof: false,
66
+ dofFocus: 10,
67
+ dofRange: 3,
68
+ dofRadius: 6,
69
+ custom: undefined,
70
+ outlineLayers: 0,
71
+ outlineColor: [1, 0.6, 0.1],
72
+ outlineThickness: 2
73
+ };
74
+ }
75
+ /** Number of bloom levels that fit the output size. */
76
+ export function bloomLevelCount3D(settings, width, height) {
77
+ if (!settings.bloom || !(settings.bloomIntensity > 0))
78
+ return 0;
79
+ const wanted = Math.min(Math.max(Math.floor(settings.bloomLevels) || 1, 1), POST3D_LIMITS.maxBloomLevels);
80
+ let levels = 0, w = width, h = height;
81
+ while (levels < wanted && w >= 4 && h >= 4) {
82
+ w >>= 1;
83
+ h >>= 1;
84
+ levels++;
85
+ }
86
+ return levels;
87
+ }
88
+ /** Composite parameters in the order both shader languages read them: two vec4. */
89
+ export function writeCompositeParams3D(out, settings, levels, toneMapping, encode) {
90
+ out[0] = levels > 0 ? settings.bloomIntensity / levels : 0;
91
+ out[1] = toneMapping === 'aces' ? 2 : toneMapping === 'reinhard' ? 1 : 0;
92
+ out[2] = encode ? 1 : 0;
93
+ out[3] = Math.min(Math.max(settings.vignette, 0), 1);
94
+ out[4] = Math.max(settings.saturation, 0);
95
+ out[5] = Math.max(settings.contrast, 0);
96
+ out[6] = Math.max(settings.brightness, 0);
97
+ out[7] = 0;
98
+ }
99
+ export const POST_VERTEX_GLSL_3D = /* glsl */ `#version 300 es
100
+ out vec2 vUv;
101
+ void main() {
102
+ vec2 p = vec2(float((gl_VertexID << 1) & 2), float(gl_VertexID & 2));
103
+ vUv = p;
104
+ gl_Position = vec4(p * 2.0 - 1.0, 0.0, 1.0);
105
+ }`;
106
+ const GLSL_HEAD = /* glsl */ `#version 300 es
107
+ precision highp float;
108
+ in vec2 vUv;
109
+ out vec4 outColor;
110
+ uniform sampler2D uSource;
111
+ uniform vec4 uA; // per pass, see below
112
+ uniform vec4 uB;
113
+ `;
114
+ const GLSL_DEPTH = /* glsl */ `
115
+ uniform highp sampler2D uDepth;
116
+ uniform mat4 uInverseProjection;
117
+ uniform vec4 uFlags; // y: ambient occlusion on; z, w: texel size
118
+ /** Stored depth, 0 at the near plane and 1 at the far plane. */
119
+ float rawDepth(vec2 uv) {
120
+ ivec2 size = textureSize(uDepth, 0);
121
+ return texelFetch(uDepth, clamp(ivec2(uv * vec2(size)), ivec2(0), size - 1), 0).r;
122
+ }
123
+ vec3 unprojectDepth(vec2 uv, float depth) {
124
+ vec4 view = uInverseProjection * vec4(uv * 2.0 - 1.0, depth * 2.0 - 1.0, 1.0);
125
+ return view.xyz / view.w;
126
+ }
127
+ /** Distance from the camera plane, in world units. */
128
+ float sceneDepth(vec2 uv) { return -unprojectDepth(uv, rawDepth(uv)).z; }
129
+ `;
130
+ /** uA: radius, intensity, bias. Writes occlusion (1 = open) to every channel. */
131
+ export const POST_SSAO_GLSL_3D = GLSL_HEAD +
132
+ GLSL_DEPTH +
133
+ /* glsl */ `
134
+ vec3 viewPosition(vec2 uv) {
135
+ return unprojectDepth(uv, rawDepth(uv));
136
+ }
137
+ void main() {
138
+ float depth = rawDepth(vUv);
139
+ vec3 p = unprojectDepth(vUv, depth);
140
+ // The surface normal comes from neighbouring depths, so no extra buffer is needed.
141
+ vec3 n = normalize(cross(dFdx(p), dFdy(p)));
142
+ float noise = fract(52.9829189 * fract(dot(gl_FragCoord.xy, vec2(0.06711056, 0.00583715)))) * 6.2831853;
143
+ // The view-space length of one texel gives a local search radius for any projection.
144
+ vec2 texel = uFlags.zw;
145
+ vec2 viewStep = vec2(length(unprojectDepth(vUv + vec2(texel.x, 0.0), depth) - p),
146
+ length(unprojectDepth(vUv + vec2(0.0, texel.y), depth) - p));
147
+ vec2 radiusUv = uA.x * texel / max(viewStep, vec2(0.000001));
148
+ float occlusion = 0.0, reach = uA.x * uA.x;
149
+ for (int i = 0; i < 12; i++) {
150
+ float angle = noise + float(i) * 2.399963;
151
+ vec3 v = viewPosition(vUv + vec2(cos(angle), sin(angle)) * ((float(i) + 0.5) / 12.0) * radiusUv) - p;
152
+ float d2 = dot(v, v);
153
+ occlusion += max(dot(n, v) * inversesqrt(d2 + 0.000001) - uA.z, 0.0) / (1.0 + d2 / reach) * step(d2, reach * 4.0);
154
+ }
155
+ float open = clamp(1.0 - uA.y * occlusion / 12.0 * 2.5, 0.0, 1.0);
156
+ // The far plane is sky: never occluded.
157
+ if (depth >= 0.99999) open = 1.0;
158
+ outColor = vec4(vec3(open), 1.0);
159
+ }`;
160
+ /** uA: xy source texel, z threshold, w knee. uB.x: 1 applies the brightness prefilter. */
161
+ export const POST_DOWN_GLSL_3D = GLSL_HEAD +
162
+ /* glsl */ `
163
+ void main() {
164
+ vec3 c = texture(uSource, vUv).rgb * 4.0;
165
+ c += texture(uSource, vUv + uA.xy).rgb + texture(uSource, vUv - uA.xy).rgb;
166
+ c += texture(uSource, vUv + vec2(uA.x, -uA.y)).rgb + texture(uSource, vUv + vec2(-uA.x, uA.y)).rgb;
167
+ c *= 0.125;
168
+ if (uB.x > 0.5) {
169
+ // Clamp runaway highlights so single pixels cannot flicker across the whole pyramid.
170
+ c = min(c, vec3(64.0));
171
+ float brightness = max(c.r, max(c.g, c.b)), knee = uA.z * uA.w;
172
+ float soft = clamp(brightness - uA.z + knee, 0.0, 2.0 * knee);
173
+ soft = soft * soft / (4.0 * knee + 0.0001);
174
+ c *= max(soft, brightness - uA.z) / max(brightness, 0.0001);
175
+ }
176
+ outColor = vec4(c, 1.0);
177
+ }`;
178
+ /** uA.xy: source texel. Drawn with additive blending onto the next larger level. */
179
+ export const POST_UP_GLSL_3D = GLSL_HEAD +
180
+ /* glsl */ `
181
+ void main() {
182
+ vec2 h = uA.xy;
183
+ vec3 c = texture(uSource, vUv + vec2(-2.0 * h.x, 0.0)).rgb + texture(uSource, vUv + vec2(2.0 * h.x, 0.0)).rgb
184
+ + texture(uSource, vUv + vec2(0.0, 2.0 * h.y)).rgb + texture(uSource, vUv + vec2(0.0, -2.0 * h.y)).rgb;
185
+ c += 2.0 * (texture(uSource, vUv + vec2(-h.x, h.y)).rgb + texture(uSource, vUv + vec2(h.x, h.y)).rgb
186
+ + texture(uSource, vUv + vec2(h.x, -h.y)).rgb + texture(uSource, vUv + vec2(-h.x, -h.y)).rgb);
187
+ outColor = vec4(c / 12.0, 1.0);
188
+ }`;
189
+ /** uA: focus distance, sharp half-range, largest radius in pixels. Blurs by distance from the focused zone. */
190
+ export const POST_DOF_GLSL_3D = GLSL_HEAD +
191
+ GLSL_DEPTH +
192
+ /* glsl */ `
193
+ float blurRadius(vec2 uv) { return clamp((abs(sceneDepth(uv) - uA.x) - uA.y) / max(uA.y, 0.001), 0.0, 1.0) * uA.z; }
194
+ void main() {
195
+ vec4 center = texture(uSource, vUv);
196
+ float radius = blurRadius(vUv);
197
+ vec3 sum = center.rgb;
198
+ float weight = 1.0;
199
+ // A sharp pixel gathers nothing, so focused objects keep crisp edges against a blurred backdrop.
200
+ if (radius > 0.5) {
201
+ for (int i = 0; i < 16; i++) {
202
+ float angle = float(i) * 2.399963;
203
+ vec2 uv = vUv + vec2(cos(angle), sin(angle)) * sqrt((float(i) + 0.5) / 16.0) * radius * uFlags.zw;
204
+ // Sharp neighbours contribute little, which keeps them from smearing into the blur.
205
+ float w = mix(0.15, 1.0, clamp(blurRadius(uv) / radius, 0.0, 1.0));
206
+ sum += texture(uSource, uv).rgb * w;
207
+ weight += w;
208
+ }
209
+ }
210
+ outColor = vec4(sum / weight, center.a);
211
+ }`;
212
+ /** uA: bloom scale, tone mapping, sRGB encode, vignette. uB: saturation, contrast, brightness. */
213
+ export function postCompositeGlsl3D(customPost) {
214
+ return (GLSL_HEAD.replace('#version 300 es\n', '#version 300 es\n' + (customPost === undefined ? '' : '#define CUSTOM_POST\n')) +
215
+ GLSL_DEPTH +
216
+ /* glsl */ `
217
+ uniform sampler2D uBloom;
218
+ uniform sampler2D uAo;
219
+ uniform sampler2D uMask;
220
+ uniform vec4 uOutline; // rgb and width in pixels; 0 width is off
221
+ float maskAt(vec2 uv) { return texture(uMask, uv).r; }
222
+ vec3 sceneColor(vec2 uv) { return texture(uSource, uv).rgb; }
223
+ #ifdef CUSTOM_POST
224
+ uniform vec4 uPostCustom[4];
225
+ ${customPost ?? ''}
226
+ #endif
227
+ void main() {
228
+ vec4 scene = texture(uSource, vUv);
229
+ vec3 c = scene.rgb;
230
+ if (uFlags.y > 0.5) {
231
+ // Five taps hide the per-pixel sampling pattern of the occlusion pass.
232
+ vec2 t = uFlags.zw * 1.5;
233
+ c *= 0.2 * (texture(uAo, vUv).r + texture(uAo, vUv + t).r + texture(uAo, vUv - t).r + texture(uAo, vUv + vec2(t.x, -t.y)).r + texture(uAo, vUv + vec2(-t.x, t.y)).r);
234
+ }
235
+ if (uA.x > 0.0) c += texture(uBloom, vUv).rgb * uA.x;
236
+ #ifdef CUSTOM_POST
237
+ c = max(customPost(c, vUv), vec3(0.0));
238
+ #endif
239
+ c *= uB.z;
240
+ if (uA.y > 1.5) c = clamp((c * (2.51 * c + 0.03)) / (c * (2.43 * c + 0.59) + 0.14), 0.0, 1.0);
241
+ else if (uA.y > 0.5) c = c / (1.0 + c);
242
+ c = mix(vec3(dot(c, vec3(0.2126, 0.7152, 0.0722))), c, uB.x);
243
+ c = (c - 0.18) * uB.y + 0.18;
244
+ c *= 1.0 - uA.w * smoothstep(0.3, 0.75, distance(vUv, vec2(0.5)));
245
+ c = clamp(c, 0.0, 1.0);
246
+ if (uOutline.w > 0.0) {
247
+ // The outline is where the mask is present nearby but not at this pixel.
248
+ vec2 t = uFlags.zw * uOutline.w, d = t * 0.7071;
249
+ float around = max(max(maskAt(vUv + vec2(t.x, 0.0)), maskAt(vUv - vec2(t.x, 0.0))), max(maskAt(vUv + vec2(0.0, t.y)), maskAt(vUv - vec2(0.0, t.y))));
250
+ around = max(around, max(max(maskAt(vUv + d), maskAt(vUv - d)), max(maskAt(vUv + vec2(d.x, -d.y)), maskAt(vUv + vec2(-d.x, d.y)))));
251
+ c = mix(c, uOutline.rgb, clamp(around - maskAt(vUv), 0.0, 1.0));
252
+ }
253
+ if (uA.z > 0.5) c = mix(c * 12.92, 1.055 * pow(c, vec3(1.0 / 2.4)) - 0.055, step(vec3(0.0031308), c));
254
+ outColor = vec4(c, scene.a);
255
+ }`);
256
+ }
257
+ /** uA.xy: source texel; uA.z: 1 converts the sRGB-encoded result back to linear for an encoding target. */
258
+ export const POST_FXAA_GLSL_3D = GLSL_HEAD +
259
+ /* glsl */ `
260
+ float luma(vec3 c) { return dot(c, vec3(0.299, 0.587, 0.114)); }
261
+ void main() {
262
+ vec2 t = uA.xy;
263
+ vec4 middle = texture(uSource, vUv);
264
+ float nw = luma(texture(uSource, vUv + vec2(-t.x, -t.y)).rgb), ne = luma(texture(uSource, vUv + vec2(t.x, -t.y)).rgb);
265
+ float sw = luma(texture(uSource, vUv + vec2(-t.x, t.y)).rgb), se = luma(texture(uSource, vUv + vec2(t.x, t.y)).rgb), m = luma(middle.rgb);
266
+ float low = min(m, min(min(nw, ne), min(sw, se))), high = max(m, max(max(nw, ne), max(sw, se)));
267
+ vec3 result = middle.rgb;
268
+ // Skip flat regions: only edges with visible contrast are filtered.
269
+ if (high - low > max(0.0312, high * 0.125)) {
270
+ vec2 dir = vec2(-((nw + ne) - (sw + se)), (nw + sw) - (ne + se));
271
+ float reduce = max((nw + ne + sw + se) * 0.03125, 0.0078125);
272
+ dir = clamp(dir / (min(abs(dir.x), abs(dir.y)) + reduce), vec2(-8.0), vec2(8.0)) * t;
273
+ vec3 a = 0.5 * (texture(uSource, vUv + dir * (1.0 / 3.0 - 0.5)).rgb + texture(uSource, vUv + dir * (2.0 / 3.0 - 0.5)).rgb);
274
+ vec3 b = a * 0.5 + 0.25 * (texture(uSource, vUv - dir * 0.5).rgb + texture(uSource, vUv + dir * 0.5).rgb);
275
+ float lb = luma(b);
276
+ result = lb < low || lb > high ? a : b;
277
+ }
278
+ if (uA.z > 0.5) result = mix(result / 12.92, pow((result + 0.055) / 1.055, vec3(2.4)), step(vec3(0.04045), result));
279
+ outColor = vec4(result, middle.a);
280
+ }`;
281
+ const WGSL_HEAD = /* wgsl */ `
282
+ struct Params {
283
+ a: vec4f,
284
+ b: vec4f,
285
+ flags: vec4f, // y: ambient occlusion on; z, w: texel size
286
+ custom: array<vec4f, 4>,
287
+ outline: vec4f, // rgb and width in pixels; 0 width is off
288
+ inverseProjection: mat4x4f,
289
+ }
290
+ @group(0) @binding(0) var<uniform> params: Params;
291
+ @group(0) @binding(1) var source: texture_2d<f32>;
292
+ @group(0) @binding(2) var linearSampler: sampler;
293
+ @group(0) @binding(3) var bloom: texture_2d<f32>;
294
+ @group(0) @binding(4) var depthTexture: texture_depth_2d;
295
+ @group(0) @binding(5) var aoTexture: texture_2d<f32>;
296
+ @group(0) @binding(6) var maskTexture: texture_2d<f32>;
297
+ struct VertexOutput { @builtin(position) position: vec4f, @location(0) uv: vec2f }
298
+ @vertex fn vertexMain(@builtin(vertex_index) index: u32) -> VertexOutput {
299
+ let p = vec2f(f32((index << 1u) & 2u), f32(index & 2u));
300
+ var output: VertexOutput;
301
+ output.position = vec4f(p * 2.0 - 1.0, 0.0, 1.0);
302
+ // Texture rows run top-down, so V is flipped relative to clip space.
303
+ output.uv = vec2f(p.x, 1.0 - p.y);
304
+ return output;
305
+ }
306
+ fn tap(uv: vec2f) -> vec3f { return textureSampleLevel(source, linearSampler, uv, 0.0).rgb; }
307
+ fn sceneColor(uv: vec2f) -> vec3f { return tap(uv); }
308
+ /** Stored depth, 0 at the near plane and 1 at the far plane. */
309
+ fn rawDepth(uv: vec2f) -> f32 {
310
+ let size = vec2f(textureDimensions(depthTexture));
311
+ return textureLoad(depthTexture, vec2i(clamp(uv * size, vec2f(0.0), size - 1.0)), 0);
312
+ }
313
+ fn unprojectDepth(uv: vec2f, depth: f32) -> vec3f {
314
+ // Convert top-down texture UVs and stored [0,1] depth to the camera's clip space.
315
+ let clip = vec4f(uv.x * 2.0 - 1.0, 1.0 - uv.y * 2.0, depth * 2.0 - 1.0, 1.0);
316
+ let view = params.inverseProjection * clip;
317
+ return view.xyz / view.w;
318
+ }
319
+ /** Distance from the camera plane, in world units. */
320
+ fn sceneDepth(uv: vec2f) -> f32 { return -unprojectDepth(uv, rawDepth(uv)).z; }
321
+ `;
322
+ export const POST_SSAO_WGSL_3D = WGSL_HEAD +
323
+ /* wgsl */ `
324
+ fn viewPosition(uv: vec2f) -> vec3f {
325
+ return unprojectDepth(uv, rawDepth(uv));
326
+ }
327
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4f {
328
+ let depth = rawDepth(input.uv);
329
+ let p = unprojectDepth(input.uv, depth);
330
+ // Framebuffer Y points down, so the Y derivative is negated to keep the normal facing the camera.
331
+ let n = normalize(cross(dpdx(p), -dpdy(p)));
332
+ let noise = fract(52.9829189 * fract(dot(input.position.xy, vec2f(0.06711056, 0.00583715)))) * 6.2831853;
333
+ let texel = params.flags.zw;
334
+ let viewStep = vec2f(length(unprojectDepth(input.uv + vec2f(texel.x, 0.0), depth) - p),
335
+ length(unprojectDepth(input.uv + vec2f(0.0, texel.y), depth) - p));
336
+ let radiusUv = params.a.x * texel / max(viewStep, vec2f(0.000001));
337
+ let reach = params.a.x * params.a.x;
338
+ var occlusion = 0.0;
339
+ for (var i = 0; i < 12; i++) {
340
+ let angle = noise + f32(i) * 2.399963;
341
+ // The disc is mirrored in Y so both backends sample the same scene points.
342
+ let v = viewPosition(input.uv + vec2f(cos(angle), -sin(angle)) * ((f32(i) + 0.5) / 12.0) * radiusUv) - p;
343
+ let d2 = dot(v, v);
344
+ occlusion += max(dot(n, v) * inverseSqrt(d2 + 0.000001) - params.a.z, 0.0) / (1.0 + d2 / reach) * step(d2, reach * 4.0);
345
+ }
346
+ var open = clamp(1.0 - params.a.y * occlusion / 12.0 * 2.5, 0.0, 1.0);
347
+ if (depth >= 0.99999) { open = 1.0; }
348
+ return vec4f(vec3f(open), 1.0);
349
+ }`;
350
+ export const POST_DOWN_WGSL_3D = WGSL_HEAD +
351
+ /* wgsl */ `
352
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4f {
353
+ let o = params.a.xy;
354
+ var c = tap(input.uv) * 4.0 + tap(input.uv + o) + tap(input.uv - o) + tap(input.uv + vec2f(o.x, -o.y)) + tap(input.uv + vec2f(-o.x, o.y));
355
+ c *= 0.125;
356
+ if (params.b.x > 0.5) {
357
+ c = min(c, vec3f(64.0));
358
+ let brightness = max(c.r, max(c.g, c.b));
359
+ let knee = params.a.z * params.a.w;
360
+ var soft = clamp(brightness - params.a.z + knee, 0.0, 2.0 * knee);
361
+ soft = soft * soft / (4.0 * knee + 0.0001);
362
+ c *= max(soft, brightness - params.a.z) / max(brightness, 0.0001);
363
+ }
364
+ return vec4f(c, 1.0);
365
+ }`;
366
+ export const POST_UP_WGSL_3D = WGSL_HEAD +
367
+ /* wgsl */ `
368
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4f {
369
+ let h = params.a.xy;
370
+ let uv = input.uv;
371
+ var c = tap(uv + vec2f(-2.0 * h.x, 0.0)) + tap(uv + vec2f(2.0 * h.x, 0.0)) + tap(uv + vec2f(0.0, 2.0 * h.y)) + tap(uv + vec2f(0.0, -2.0 * h.y));
372
+ c += 2.0 * (tap(uv + vec2f(-h.x, h.y)) + tap(uv + vec2f(h.x, h.y)) + tap(uv + vec2f(h.x, -h.y)) + tap(uv + vec2f(-h.x, -h.y)));
373
+ return vec4f(c / 12.0, 1.0);
374
+ }`;
375
+ export const POST_DOF_WGSL_3D = WGSL_HEAD +
376
+ /* wgsl */ `
377
+ fn blurRadius(uv: vec2f) -> f32 { return clamp((abs(sceneDepth(uv) - params.a.x) - params.a.y) / max(params.a.y, 0.001), 0.0, 1.0) * params.a.z; }
378
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4f {
379
+ let center = textureSampleLevel(source, linearSampler, input.uv, 0.0);
380
+ let radius = blurRadius(input.uv);
381
+ var sum = center.rgb;
382
+ var weight = 1.0;
383
+ // A sharp pixel gathers nothing, so focused objects keep crisp edges against a blurred backdrop.
384
+ if (radius > 0.5) {
385
+ for (var i = 0; i < 16; i++) {
386
+ let angle = f32(i) * 2.399963;
387
+ let uv = input.uv + vec2f(cos(angle), -sin(angle)) * sqrt((f32(i) + 0.5) / 16.0) * radius * params.flags.zw;
388
+ // Sharp neighbours contribute little, which keeps them from smearing into the blur.
389
+ let w = mix(0.15, 1.0, clamp(blurRadius(uv) / radius, 0.0, 1.0));
390
+ sum += tap(uv) * w;
391
+ weight += w;
392
+ }
393
+ }
394
+ return vec4f(sum / weight, center.a);
395
+ }`;
396
+ export function postCompositeWgsl3D(customPost) {
397
+ return (WGSL_HEAD +
398
+ (customPost ?? '') +
399
+ /* wgsl */ `
400
+ fn occlusionTap(uv: vec2f) -> f32 { return textureSampleLevel(aoTexture, linearSampler, uv, 0.0).r; }
401
+ fn maskAt(uv: vec2f) -> f32 { return textureSampleLevel(maskTexture, linearSampler, uv, 0.0).r; }
402
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4f {
403
+ let scene = textureSampleLevel(source, linearSampler, input.uv, 0.0);
404
+ var c = scene.rgb;
405
+ if (params.flags.y > 0.5) {
406
+ // Five taps hide the per-pixel sampling pattern of the occlusion pass.
407
+ let t = params.flags.zw * 1.5;
408
+ c *= 0.2 * (occlusionTap(input.uv) + occlusionTap(input.uv + t) + occlusionTap(input.uv - t) + occlusionTap(input.uv + vec2f(t.x, -t.y)) + occlusionTap(input.uv + vec2f(-t.x, t.y)));
409
+ }
410
+ c += textureSampleLevel(bloom, linearSampler, input.uv, 0.0).rgb * params.a.x;
411
+ ${customPost === undefined ? '' : 'c = max(customPost(c, input.uv), vec3f(0.0));'}
412
+ c *= params.b.z;
413
+ if (params.a.y > 1.5) { c = clamp((c * (2.51 * c + 0.03)) / (c * (2.43 * c + 0.59) + 0.14), vec3f(0.0), vec3f(1.0)); }
414
+ else if (params.a.y > 0.5) { c = c / (1.0 + c); }
415
+ c = mix(vec3f(dot(c, vec3f(0.2126, 0.7152, 0.0722))), c, params.b.x);
416
+ c = (c - 0.18) * params.b.y + 0.18;
417
+ c *= 1.0 - params.a.w * smoothstep(0.3, 0.75, distance(input.uv, vec2f(0.5)));
418
+ c = clamp(c, vec3f(0.0), vec3f(1.0));
419
+ if (params.outline.w > 0.0) {
420
+ // The outline is where the mask is present nearby but not at this pixel.
421
+ let t = params.flags.zw * params.outline.w;
422
+ let d = t * 0.7071;
423
+ let uv = input.uv;
424
+ var around = max(max(maskAt(uv + vec2f(t.x, 0.0)), maskAt(uv - vec2f(t.x, 0.0))), max(maskAt(uv + vec2f(0.0, t.y)), maskAt(uv - vec2f(0.0, t.y))));
425
+ around = max(around, max(max(maskAt(uv + d), maskAt(uv - d)), max(maskAt(uv + vec2f(d.x, -d.y)), maskAt(uv + vec2f(-d.x, d.y)))));
426
+ c = mix(c, params.outline.rgb, clamp(around - maskAt(uv), 0.0, 1.0));
427
+ }
428
+ if (params.a.z > 0.5) { c = mix(c * 12.92, 1.055 * pow(c, vec3f(1.0 / 2.4)) - 0.055, step(vec3f(0.0031308), c)); }
429
+ return vec4f(c, scene.a);
430
+ }`);
431
+ }
432
+ export const POST_FXAA_WGSL_3D = WGSL_HEAD +
433
+ /* wgsl */ `
434
+ fn luma(c: vec3f) -> f32 { return dot(c, vec3f(0.299, 0.587, 0.114)); }
435
+ @fragment fn fragmentMain(input: VertexOutput) -> @location(0) vec4f {
436
+ let t = params.a.xy;
437
+ let uv = input.uv;
438
+ let middle = textureSampleLevel(source, linearSampler, uv, 0.0);
439
+ let nw = luma(tap(uv + vec2f(-t.x, -t.y)));
440
+ let ne = luma(tap(uv + vec2f(t.x, -t.y)));
441
+ let sw = luma(tap(uv + vec2f(-t.x, t.y)));
442
+ let se = luma(tap(uv + vec2f(t.x, t.y)));
443
+ let m = luma(middle.rgb);
444
+ let low = min(m, min(min(nw, ne), min(sw, se)));
445
+ let high = max(m, max(max(nw, ne), max(sw, se)));
446
+ var result = middle.rgb;
447
+ if (high - low > max(0.0312, high * 0.125)) {
448
+ var dir = vec2f(-((nw + ne) - (sw + se)), (nw + sw) - (ne + se));
449
+ let reduce = max((nw + ne + sw + se) * 0.03125, 0.0078125);
450
+ dir = clamp(dir / (min(abs(dir.x), abs(dir.y)) + reduce), vec2f(-8.0), vec2f(8.0)) * t;
451
+ let a = 0.5 * (tap(uv + dir * (1.0 / 3.0 - 0.5)) + tap(uv + dir * (2.0 / 3.0 - 0.5)));
452
+ let b = a * 0.5 + 0.25 * (tap(uv - dir * 0.5) + tap(uv + dir * 0.5));
453
+ let lb = luma(b);
454
+ if (lb < low || lb > high) { result = a; } else { result = b; }
455
+ }
456
+ if (params.a.z > 0.5) { result = mix(result / 12.92, pow((result + 0.055) / 1.055, vec3f(2.4)), step(vec3f(0.04045), result)); }
457
+ return vec4f(result, middle.a);
458
+ }`;
459
+ //# sourceMappingURL=post3D.js.map
@@ -0,0 +1,24 @@
1
+ import { Material3D } from '../../rendering/world3d/Material3D.js';
2
+ import { RenderTarget3D } from '../../rendering/world3d/Texture3D.js';
3
+ import type { ToneMapping3D } from './frame3D.js';
4
+ import type { GpuResources3D } from './gpuResources3D.js';
5
+ import type { PostProcessSettings3D, PostView3D } from './post3D.js';
6
+ export declare class PostChainWebGL23D {
7
+ #private;
8
+ /** Half-float scene target the renderer draws into before run(). */
9
+ readonly scene: RenderTarget3D;
10
+ /** Target and flat white material for the outline mask. */
11
+ readonly mask: RenderTarget3D;
12
+ readonly maskMaterial: Material3D;
13
+ constructor(gl: WebGL2RenderingContext, resources: GpuResources3D);
14
+ private surface;
15
+ private pass;
16
+ /**
17
+ * Process `sceneTexture` into `output` (null for the canvas).
18
+ * `outputEncodes` is true when the output converts linear values to sRGB on write.
19
+ */
20
+ run(sceneTexture: WebGLTexture, depthTexture: WebGLTexture | undefined, maskTexture: WebGLTexture | undefined, view: PostView3D, width: number, height: number, output: WebGLFramebuffer | null, outputEncodes: boolean, settings: PostProcessSettings3D, toneMapping: ToneMapping3D, vao: WebGLVertexArrayObject | null): number;
21
+ /** Release GPU objects. Pass `lost` after a context loss, when they are already gone. */
22
+ dispose(lost?: boolean): void;
23
+ }
24
+ //# sourceMappingURL=postWebGL23D.d.ts.map