@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,388 @@
1
+ import { worldRenderSphere3D } from '../../rendering/world3d/AnimationTexture3D.js';
2
+ import { LIGHT3D_LIMITS } from '../../rendering/world3d/Light3D.js';
3
+ import { frustumFromMatrix, frustumIntersectsSphere, mat4Invert, mat4LookAt, mat4Multiply, mat4Orthographic, mat4Perspective, vec3TransformMat4 } from '../../rendering/world3d/math3D.js';
4
+ /** Half-float targets keep scene-referred light until composition. */
5
+ export function outputToneMapping3D(toneMapping, target) {
6
+ return target?.format === 'rgba16f' ? 'none' : toneMapping;
7
+ }
8
+ /** Size in floats of the Frame uniform block. */
9
+ export const FRAME_BLOCK_FLOATS_3D = 360;
10
+ /** Offsets, in floats, of the Frame block members. */
11
+ export const FRAME_OFFSETS_3D = Object.freeze({
12
+ viewProjection: 0,
13
+ view: 16,
14
+ cameraPosition: 32,
15
+ fogColor: 36,
16
+ fogParams: 40,
17
+ ambient: 44,
18
+ hemisphereSky: 48,
19
+ hemisphereGround: 52,
20
+ lightCounts: 56,
21
+ directionalDirection: 60,
22
+ directionalColor: 76,
23
+ pointPosition: 92,
24
+ pointColor: 124,
25
+ spotPosition: 156,
26
+ spotDirection: 172,
27
+ spotColor: 188,
28
+ spotCone: 204,
29
+ shadowMatrix: 220,
30
+ shadowRect: 284,
31
+ shadowParams: 300,
32
+ output: 316,
33
+ cascadeSplits: 320,
34
+ cascadeInfo: 324,
35
+ pointShadow: 328,
36
+ clipPlanes: 332,
37
+ clipInfo: 348,
38
+ tileGrid: 352,
39
+ tileInfo: 356
40
+ });
41
+ const F = FRAME_OFFSETS_3D;
42
+ /** Fill camera, fog, light and output members. Shadow members are written by planShadows3D. */
43
+ export function writeFrameBlock3D(data, scene, camera, list, shadowSlots, output) {
44
+ data.set(camera.viewProjectionMatrix, F.viewProjection);
45
+ data.set(camera.viewMatrix, F.view);
46
+ data.set(camera.matrixWorld.subarray(12, 15), F.cameraPosition);
47
+ const fog = scene.fog;
48
+ data.fill(0, F.fogColor, F.fogParams + 4);
49
+ if (fog) {
50
+ data.set(fog.color, F.fogColor);
51
+ if (fog.kind === 'linear') {
52
+ data[F.fogParams] = 1;
53
+ data[F.fogParams + 1] = fog.near;
54
+ data[F.fogParams + 2] = fog.far;
55
+ }
56
+ else {
57
+ data[F.fogParams] = 2;
58
+ data[F.fogParams + 1] = fog.density;
59
+ }
60
+ }
61
+ data.set(list.ambient, F.ambient);
62
+ data.set(list.hemisphereSky, F.hemisphereSky);
63
+ data.set(list.hemisphereGround, F.hemisphereGround);
64
+ data[F.lightCounts] = list.directionalLights.length;
65
+ data[F.lightCounts + 1] = list.pointLights.length;
66
+ data[F.lightCounts + 2] = list.spotLights.length;
67
+ // What a shader needs to turn stored depth back into distance: two projection terms and whether the view is orthographic.
68
+ data[F.lightCounts + 3] = camera.projectionMatrix[15] === 1 ? 1 : 0;
69
+ data[F.pointShadow + 2] = camera.projectionMatrix[10];
70
+ data[F.pointShadow + 3] = camera.projectionMatrix[14];
71
+ const direction = (light, offset) => {
72
+ // Lights shine along their local negative Z axis.
73
+ const m = light.matrixWorld, x = -m[8], y = -m[9], z = -m[10], length = Math.hypot(x, y, z) || 1;
74
+ data[offset] = x / length;
75
+ data[offset + 1] = y / length;
76
+ data[offset + 2] = z / length;
77
+ };
78
+ const color = (light, offset) => {
79
+ data[offset] = light.color[0] * light.intensity;
80
+ data[offset + 1] = light.color[1] * light.intensity;
81
+ data[offset + 2] = light.color[2] * light.intensity;
82
+ };
83
+ list.directionalLights.forEach((light, i) => {
84
+ direction(light, F.directionalDirection + i * 4);
85
+ data[F.directionalDirection + i * 4 + 3] = shadowSlots.get(light) ?? -1;
86
+ color(light, F.directionalColor + i * 4);
87
+ });
88
+ list.pointLights.forEach((light, i) => {
89
+ data.set(light.matrixWorld.subarray(12, 15), F.pointPosition + i * 4);
90
+ data[F.pointPosition + i * 4 + 3] = light.range;
91
+ color(light, F.pointColor + i * 4);
92
+ });
93
+ list.spotLights.forEach((light, i) => {
94
+ data.set(light.matrixWorld.subarray(12, 15), F.spotPosition + i * 4);
95
+ data[F.spotPosition + i * 4 + 3] = light.range;
96
+ direction(light, F.spotDirection + i * 4);
97
+ data[F.spotDirection + i * 4 + 3] = shadowSlots.get(light) ?? -1;
98
+ color(light, F.spotColor + i * 4);
99
+ const outer = Math.min(Math.max(light.angle, 0.001), Math.PI / 2), inner = outer * (1 - Math.min(Math.max(light.penumbra, 0), 1));
100
+ data[F.spotCone + i * 4] = Math.cos(outer);
101
+ // Keep the inner cosine strictly above the outer one so smoothstep stays defined.
102
+ data[F.spotCone + i * 4 + 1] = Math.max(Math.cos(inner), Math.cos(outer) + 1e-4);
103
+ });
104
+ const planes = scene.clippingPlanes, planeCount = Math.min(planes.length, 4);
105
+ for (let i = 0; i < planeCount; i++)
106
+ data.set(planes[i], F.clipPlanes + i * 4);
107
+ data[F.clipInfo] = planeCount;
108
+ data[F.output] = scene.environmentIntensity;
109
+ data[F.output + 1] = output.environmentMaxMip;
110
+ data[F.output + 2] = output.exposure;
111
+ data[F.output + 3] = output.toneMapping === 'aces' ? 2 : output.toneMapping === 'reinhard' ? 1 : 0;
112
+ }
113
+ const UP = [0, 1, 0], FORWARD_UP = [0, 0, 1], ORIGIN = [0, 0, 0];
114
+ const scratchWorld = new Float32Array(16), scratchView = new Float32Array(16), scratchProjection = new Float32Array(16), scratchFrustum = new Float32Array(24);
115
+ const scratchInverse = new Float32Array(16), scratchCorners = new Float32Array(24), scratchPoint = new Float32Array(3), scratchCenter = new Float32Array(3);
116
+ const NDC_CORNERS = [-1, -1, 1, -1, -1, 1, 1, 1];
117
+ const K = 1 / Math.sqrt(3);
118
+ /** Outward face directions of a regular tetrahedron; the shaders pick the face a direction is closest to. */
119
+ const TETRAHEDRON_FACES = [
120
+ [K, K, K],
121
+ [-K, -K, K],
122
+ [-K, K, -K],
123
+ [K, -K, -K]
124
+ ];
125
+ // Each face's region reaches 70.53 degrees from its axis; a little more leaves room for filtering.
126
+ const TETRAHEDRON_FOV = (144 * Math.PI) / 180;
127
+ /** View-space far distance of each cascade, blending uniform and logarithmic spacing. */
128
+ export function cascadeSplits3D(near, far, count, lambda) {
129
+ const splits = [], blend = Math.min(Math.max(lambda, 0), 1);
130
+ for (let i = 1; i <= count; i++) {
131
+ const fraction = i / count, uniform = near + (far - near) * fraction, logarithmic = near * Math.pow(far / near, fraction);
132
+ splits.push(uniform + (logarithmic - uniform) * blend);
133
+ }
134
+ return splits;
135
+ }
136
+ /**
137
+ * Assign shadow-casting lights to quarter tiles of a square atlas, compute
138
+ * their matrices and caster lists, and write the shadow members of the block.
139
+ * A cascaded directional light takes one tile per cascade, each fitted to a
140
+ * slice of the camera frustum. `flipY` selects top-left atlas addressing for
141
+ * backends whose texture origin is the top row.
142
+ */
143
+ export function planShadows3D(data, list, atlasSize, enabled, flipY, slots, camera) {
144
+ slots.clear();
145
+ // The last two floats of pointShadow belong to the camera, written with the rest of the frame.
146
+ data.fill(0, F.cascadeSplits, F.pointShadow + 2);
147
+ data[F.cascadeInfo] = -1;
148
+ data[F.pointShadow] = -1;
149
+ const plans = [];
150
+ if (!enabled || list.shadowCasters.length === 0)
151
+ return plans;
152
+ const tile = atlasSize >> 1;
153
+ let cascaded = false;
154
+ const emit = (light, matrix, normalBiasScale) => {
155
+ const slot = plans.length, shadow = light.shadow;
156
+ frustumFromMatrix(scratchFrustum, matrix);
157
+ const x = (slot & 1) * tile, y = (slot >> 1) * tile;
158
+ data.set(matrix, F.shadowMatrix + slot * 16);
159
+ data[F.shadowRect + slot * 4] = x / atlasSize;
160
+ data[F.shadowRect + slot * 4 + 1] = y / atlasSize;
161
+ data[F.shadowRect + slot * 4 + 2] = tile / atlasSize;
162
+ data[F.shadowRect + slot * 4 + 3] = (flipY ? -tile : tile) / atlasSize;
163
+ if (flipY)
164
+ data[F.shadowRect + slot * 4 + 1] = (y + tile) / atlasSize;
165
+ data[F.shadowParams + slot * 4] = shadow.bias;
166
+ data[F.shadowParams + slot * 4 + 1] = shadow.normalBias * normalBiasScale;
167
+ data[F.shadowParams + slot * 4 + 2] = Math.max(shadow.radius, 0) / atlasSize;
168
+ data[F.shadowParams + slot * 4 + 3] = 0;
169
+ const casters = [];
170
+ for (const mesh of list.shadowCasters) {
171
+ if (mesh.frustumCulled) {
172
+ const sphere = worldRenderSphere3D(mesh);
173
+ if (sphere && sphere[3] >= 0 && !frustumIntersectsSphere(scratchFrustum, sphere))
174
+ continue;
175
+ }
176
+ casters.push(mesh);
177
+ }
178
+ plans.push({ light, slot, x, y, tile, matrix, casters });
179
+ };
180
+ const lights = [...list.directionalLights, ...list.spotLights].filter(light => light.castShadow);
181
+ // One point light may cast shadows. It needs all four tiles: one per face of a
182
+ // tetrahedron around it, which covers every direction with ordinary perspective maps.
183
+ const point = list.pointLights.find(light => light.castShadow);
184
+ if (point && lights.length === 0) {
185
+ const m = point.matrixWorld, eye = [m[12], m[13], m[14]], shadow = point.shadow, far = point.range > 0 ? Math.min(point.range, shadow.far) : shadow.far;
186
+ slots.set(point, 0);
187
+ mat4Perspective(scratchProjection, TETRAHEDRON_FOV, 1, shadow.near, far);
188
+ for (const face of TETRAHEDRON_FACES) {
189
+ mat4LookAt(scratchWorld, eye, [eye[0] + face[0], eye[1] + face[1], eye[2] + face[2]], Math.abs(face[1]) > 0.9 ? FORWARD_UP : UP);
190
+ mat4Invert(scratchView, scratchWorld);
191
+ emit(point, mat4Multiply(new Float32Array(16), scratchProjection, scratchView), 1);
192
+ }
193
+ data[F.pointShadow] = list.pointLights.indexOf(point);
194
+ data[F.pointShadow + 1] = 0;
195
+ return plans;
196
+ }
197
+ for (const light of lights) {
198
+ const remaining = LIGHT3D_LIMITS.maxShadows - plans.length;
199
+ if (remaining <= 0)
200
+ break;
201
+ const shadow = light.shadow, m = light.matrixWorld;
202
+ // Pick an up vector that is not parallel to the light direction.
203
+ const up = Math.abs(m[9]) > 0.99 * Math.hypot(m[8], m[9], m[10]) ? FORWARD_UP : UP;
204
+ const cascades = Math.min(Math.max(Math.floor(shadow.cascades) || 1, 1), remaining);
205
+ if (light.lightType === 'directional' &&
206
+ cascades > 1 &&
207
+ !cascaded &&
208
+ camera &&
209
+ mat4Invert(scratchInverse, camera.viewProjectionMatrix)) {
210
+ cascaded = true;
211
+ slots.set(light, plans.length);
212
+ const length = Math.hypot(m[8], m[9], m[10]) || 1, dx = -m[8] / length, dy = -m[9] / length, dz = -m[10] / length;
213
+ const near = camera.near, far = Math.max(Math.min(camera.far, shadow.cascadeDistance), near * 1.001);
214
+ // Frustum corners on the near and far planes; any slice plane is a linear blend of the two.
215
+ for (let i = 0; i < 4; i++) {
216
+ for (let side = 0; side < 2; side++) {
217
+ scratchPoint[0] = NDC_CORNERS[i * 2];
218
+ scratchPoint[1] = NDC_CORNERS[i * 2 + 1];
219
+ scratchPoint[2] = side === 0 ? -1 : 1;
220
+ vec3TransformMat4(scratchPoint, scratchPoint, scratchInverse);
221
+ scratchCorners.set(scratchPoint, (side * 4 + i) * 3);
222
+ }
223
+ }
224
+ const splits = camera.projectionKind === 'orthographic'
225
+ ? cascadeSplits3D(near, far, cascades, 0)
226
+ : cascadeSplits3D(near, far, cascades, shadow.cascadeLambda);
227
+ // Rotation-only light frame used to snap cascade centers to whole texels.
228
+ mat4LookAt(scratchWorld, ORIGIN, [dx, dy, dz], up);
229
+ mat4Invert(scratchView, scratchWorld);
230
+ const rotation = scratchWorld.slice(), inverseRotation = scratchView.slice(), range = camera.far - near;
231
+ let firstRadius = 0, sliceNear = near;
232
+ splits.forEach((sliceFar, index) => {
233
+ const slice = [];
234
+ scratchCenter.fill(0);
235
+ for (const distance of [sliceNear, sliceFar]) {
236
+ const t = (distance - near) / range;
237
+ for (let i = 0; i < 4; i++) {
238
+ for (let axis = 0; axis < 3; axis++) {
239
+ const a = scratchCorners[i * 3 + axis], b = scratchCorners[(4 + i) * 3 + axis], value = a + (b - a) * t;
240
+ slice.push(value);
241
+ scratchCenter[axis] = scratchCenter[axis] + value / 8;
242
+ }
243
+ }
244
+ }
245
+ let radius = 0;
246
+ for (let i = 0; i < 8; i++)
247
+ radius = Math.max(radius, Math.hypot(slice[i * 3] - scratchCenter[0], slice[i * 3 + 1] - scratchCenter[1], slice[i * 3 + 2] - scratchCenter[2]));
248
+ // A bounding sphere keeps the volume size constant while the camera turns;
249
+ // rounding its radius and snapping its center stop shadow edges from crawling.
250
+ radius = Math.ceil(radius * 16) / 16;
251
+ const texel = (radius * 2) / tile;
252
+ vec3TransformMat4(scratchCenter, scratchCenter, inverseRotation);
253
+ scratchCenter[0] = Math.floor(scratchCenter[0] / texel) * texel;
254
+ scratchCenter[1] = Math.floor(scratchCenter[1] / texel) * texel;
255
+ vec3TransformMat4(scratchCenter, scratchCenter, rotation);
256
+ // Pull the eye back so casters between the light and the slice are still drawn.
257
+ const back = Math.max(shadow.far, radius) + radius;
258
+ const eye = [scratchCenter[0] - dx * back, scratchCenter[1] - dy * back, scratchCenter[2] - dz * back];
259
+ mat4LookAt(scratchWorld, eye, scratchCenter, up);
260
+ mat4Invert(scratchView, scratchWorld);
261
+ mat4Orthographic(scratchProjection, -radius, radius, -radius, radius, 0, back + radius);
262
+ if (index === 0)
263
+ firstRadius = radius;
264
+ data[F.cascadeSplits + index] = sliceFar;
265
+ emit(light, mat4Multiply(new Float32Array(16), scratchProjection, scratchView), radius / firstRadius);
266
+ sliceNear = sliceFar;
267
+ });
268
+ data[F.cascadeInfo] = list.directionalLights.indexOf(light);
269
+ data[F.cascadeInfo + 1] = cascades;
270
+ // Fraction of each cascade's far end that blends into the next one.
271
+ data[F.cascadeInfo + 2] = 0.1;
272
+ continue;
273
+ }
274
+ slots.set(light, plans.length);
275
+ const eye = [m[12], m[13], m[14]], target = [m[12] - m[8], m[13] - m[9], m[14] - m[10]];
276
+ mat4LookAt(scratchWorld, eye, target, up);
277
+ mat4Invert(scratchView, scratchWorld);
278
+ if (light.lightType === 'spot') {
279
+ const far = light.range > 0 ? Math.min(light.range, shadow.far) : shadow.far;
280
+ mat4Perspective(scratchProjection, Math.min(light.angle * 2, Math.PI * 0.98), 1, shadow.near, far);
281
+ }
282
+ else
283
+ mat4Orthographic(scratchProjection, -shadow.extent, shadow.extent, -shadow.extent, shadow.extent, shadow.near, shadow.far);
284
+ emit(light, mat4Multiply(new Float32Array(16), scratchProjection, scratchView), 1);
285
+ }
286
+ return plans;
287
+ }
288
+ /**
289
+ * The tiled light list: point lights past the eight a frame lights directly, and for each screen tile the lights
290
+ * whose range reaches into it. One RGBA32F table of `TILED_LIGHTS_3D.width` texels a row: lights from texel 0
291
+ * (two texels each: position and range, then colour), tile headers from `headerBase` (first index and count),
292
+ * then light indices four to a texel from `indexBase`.
293
+ */
294
+ export const TILED_LIGHTS_3D = Object.freeze({
295
+ width: 512,
296
+ rows: 17,
297
+ maxLights: 256,
298
+ headerBase: 512,
299
+ maxTiles: 4096,
300
+ indexBase: 512 + 4096,
301
+ maxIndices: 16384,
302
+ maxPerTile: 32
303
+ });
304
+ /**
305
+ * Fills `table` with the lights and their tiles for a viewport of `width` by `height` pixels, and the tile members
306
+ * of the frame block. With no lights the frame block says so and the table is left alone. `yDown` is true where
307
+ * fragment coordinates count rows from the top (WebGPU), false where from the bottom (WebGL2). `originX` and
308
+ * `originY` are where the viewport starts in fragment coordinates.
309
+ */
310
+ export function writeTiledLights3D(data, table, lights, viewProjection, width, height, yDown, originX = 0, originY = 0) {
311
+ const T = TILED_LIGHTS_3D;
312
+ const count = Math.min(lights.length, T.maxLights);
313
+ if (count === 0 || !(width > 0) || !(height > 0)) {
314
+ data.fill(0, F.tileGrid, F.tileInfo + 4);
315
+ return 0;
316
+ }
317
+ // Tiles of at least 32 pixels, larger where the viewport would need more tiles than the table holds.
318
+ let tile = 32;
319
+ while (Math.ceil(width / tile) * Math.ceil(height / tile) > T.maxTiles)
320
+ tile *= 2;
321
+ const tilesX = Math.ceil(width / tile), tilesY = Math.ceil(height / tile), tiles = tilesX * tilesY;
322
+ const lists = Array.from({ length: tiles }, () => []);
323
+ const m = viewProjection;
324
+ for (let i = 0; i < count; i++) {
325
+ const light = lights[i], w = light.matrixWorld, x = w[12], y = w[13], z = w[14], r = light.range;
326
+ table[i * 8] = x;
327
+ table[i * 8 + 1] = y;
328
+ table[i * 8 + 2] = z;
329
+ table[i * 8 + 3] = r;
330
+ table[i * 8 + 4] = light.color[0] * light.intensity;
331
+ table[i * 8 + 5] = light.color[1] * light.intensity;
332
+ table[i * 8 + 6] = light.color[2] * light.intensity;
333
+ table[i * 8 + 7] = 0;
334
+ // The screen rectangle of the light's bounding cube; a cube reaching behind the camera covers the screen.
335
+ let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity, behind = false, inFront = false;
336
+ for (let corner = 0; corner < 8; corner++) {
337
+ const cx = x + (corner & 1 ? r : -r), cy = y + (corner & 2 ? r : -r), cz = z + (corner & 4 ? r : -r);
338
+ const pw = m[3] * cx + m[7] * cy + m[11] * cz + m[15];
339
+ if (pw <= 1e-6) {
340
+ behind = true;
341
+ continue;
342
+ }
343
+ inFront = true;
344
+ const px = (m[0] * cx + m[4] * cy + m[8] * cz + m[12]) / pw, py = (m[1] * cx + m[5] * cy + m[9] * cz + m[13]) / pw;
345
+ minX = Math.min(minX, px);
346
+ maxX = Math.max(maxX, px);
347
+ minY = Math.min(minY, py);
348
+ maxY = Math.max(maxY, py);
349
+ }
350
+ if (!inFront)
351
+ continue;
352
+ if (behind)
353
+ (minX = -1), (minY = -1), (maxX = 1), (maxY = 1);
354
+ if (maxX < -1 || minX > 1 || maxY < -1 || minY > 1)
355
+ continue;
356
+ // Choose the fragment's coordinate origin before dividing by the tile size.
357
+ // Flipping tile indices would mirror the padding in a partial tile too.
358
+ const left = Math.max(0, Math.floor((((Math.max(minX, -1) + 1) / 2) * width) / tile)), right = Math.min(tilesX - 1, Math.floor((((Math.min(maxX, 1) + 1) / 2) * width) / tile)), ndcMinY = Math.max(minY, -1), ndcMaxY = Math.min(maxY, 1), firstY = (yDown ? 1 - ndcMaxY : 1 + ndcMinY) * 0.5 * height, lastY = (yDown ? 1 - ndcMinY : 1 + ndcMaxY) * 0.5 * height, firstRow = Math.floor(firstY / tile), lastRow = Math.min(tilesY - 1, Math.floor(lastY / tile));
359
+ for (let ty = firstRow; ty <= lastRow; ty++)
360
+ for (let tx = left; tx <= right; tx++) {
361
+ const list = lists[ty * tilesX + tx];
362
+ if (list.length < T.maxPerTile)
363
+ list.push(i);
364
+ }
365
+ }
366
+ let used = 0;
367
+ for (let t = 0; t < tiles; t++) {
368
+ const list = lists[t], take = Math.min(list.length, T.maxIndices - used);
369
+ const header = (T.headerBase + t) * 4;
370
+ table[header] = used;
371
+ table[header + 1] = take;
372
+ table[header + 2] = table[header + 3] = 0;
373
+ for (let k = 0; k < take; k++)
374
+ table[T.indexBase * 4 + used + k] = list[k];
375
+ used += take;
376
+ }
377
+ data[F.tileGrid] = tilesX;
378
+ data[F.tileGrid + 1] = tilesY;
379
+ data[F.tileGrid + 2] = tile;
380
+ // Where the viewport starts in fragment coordinates, so a viewport off the corner finds its tiles.
381
+ data[F.tileGrid + 3] = originX;
382
+ data[F.tileInfo] = count;
383
+ data[F.tileInfo + 1] = T.headerBase;
384
+ data[F.tileInfo + 2] = T.indexBase;
385
+ data[F.tileInfo + 3] = originY;
386
+ return count;
387
+ }
388
+ //# sourceMappingURL=frame3D.js.map
@@ -0,0 +1,98 @@
1
+ import type { Geometry3D } from '../../rendering/world3d/Geometry3D.js';
2
+ import type { InstancedMesh3D, Skeleton3D } from '../../rendering/world3d/Mesh3D.js';
3
+ import { type AnimationTexture3D } from '../../rendering/world3d/AnimationTexture3D.js';
4
+ import { RenderTarget3D } from '../../rendering/world3d/Texture3D.js';
5
+ import type { CompressedFormat3D } from '../../rendering/world3d/Texture3D.js';
6
+ import type { CubeTexture3D, Texture3D } from '../../rendering/world3d/Texture3D.js';
7
+ import type { ShaderSources3D } from './shaders3D.js';
8
+ export interface Program3D {
9
+ readonly id: number;
10
+ readonly program: WebGLProgram;
11
+ readonly uniforms: Readonly<Record<string, WebGLUniformLocation>>;
12
+ }
13
+ export interface ProgramRequest3D {
14
+ readonly key: string;
15
+ readonly sources: () => ShaderSources3D;
16
+ }
17
+ export interface GeometryGpu3D {
18
+ readonly vao: WebGLVertexArrayObject;
19
+ indexType: number;
20
+ indexed: boolean;
21
+ morph: {
22
+ readonly texture: WebGLTexture;
23
+ readonly width: number;
24
+ readonly attributes: number;
25
+ readonly vertexCount: number;
26
+ } | undefined;
27
+ }
28
+ export interface RenderTargetGpu3D {
29
+ readonly framebuffer: WebGLFramebuffer;
30
+ readonly color: WebGLTexture;
31
+ depth: WebGLRenderbuffer | undefined;
32
+ /** Depth attachment as a texture, for targets created with `depthTexture`. */
33
+ depthTexture: WebGLTexture | undefined;
34
+ version: number;
35
+ readonly unsubscribe: () => void;
36
+ }
37
+ export declare class GpuResources3D {
38
+ #private;
39
+ /** True when half-float color targets can be rendered to. */
40
+ readonly floatTargets: boolean;
41
+ constructor(gl: WebGL2RenderingContext);
42
+ get counts(): {
43
+ programs: number;
44
+ geometries: number;
45
+ textures: number;
46
+ };
47
+ program(key: string, sources: () => ShaderSources3D): Program3D;
48
+ preparePrograms(requests: readonly ProgramRequest3D[]): Promise<void>;
49
+ private requireProgramContext;
50
+ private startProgram;
51
+ private finishProgram;
52
+ private initializeProgram;
53
+ private upload;
54
+ private glType;
55
+ private buffer;
56
+ /** Bind every known attribute of a geometry into the currently bound vertex array. */
57
+ private bindAttributes;
58
+ /** Create or refresh GPU buffers for a geometry and return its vertex array. */
59
+ geometry(geometry: Geometry3D): GeometryGpu3D;
60
+ private buildMorph;
61
+ private dataTexture;
62
+ /** Vertex array whose element buffer lists every triangle edge, for wireframe drawing. */
63
+ wireframe(geometry: Geometry3D): {
64
+ vao: WebGLVertexArrayObject;
65
+ count: number;
66
+ type: number;
67
+ };
68
+ private releaseWire;
69
+ private releaseGeometry;
70
+ private instanceBuffer;
71
+ private uploadInstances;
72
+ /** Vertex array combining a geometry's attributes with per-instance transforms and colors. */
73
+ instances(mesh: InstancedMesh3D, frame: number): WebGLVertexArrayObject;
74
+ /** Float texture holding one 4x4 matrix per row (four RGBA texels). */
75
+ bones(skeleton: Skeleton3D, frame: number): WebGLTexture;
76
+ /** Float texture holding every baked frame: four texels per bone matrix, wrapped into rows of 2048. */
77
+ animations(source: AnimationTexture3D): WebGLTexture;
78
+ private applySampler;
79
+ private image;
80
+ private textureEntry;
81
+ /** Bind a 2D texture to a unit, uploading new content first when its version changed. */
82
+ bindTexture(unit: number, texture: Texture3D): void;
83
+ /** Internal format for a compressed format on this context, or undefined when its extension is missing. */
84
+ compressedFormat(format: CompressedFormat3D, srgb: boolean): number | undefined;
85
+ private compressedImage;
86
+ /** Bind a cube texture and return its highest mip level (used as a roughness scale). */
87
+ bindCube(unit: number, texture: CubeTexture3D): number;
88
+ /** Create or resize the framebuffer of a render target. */
89
+ target(target: RenderTarget3D): RenderTargetGpu3D;
90
+ private releaseTarget;
91
+ /** Retire per-mesh and per-skeleton data that has not been drawn recently. */
92
+ prune(frame: number): void;
93
+ /** Forget every GPU handle without deleting it; used after the context was lost. */
94
+ reset(): void;
95
+ /** Delete every GPU object owned by this cache. */
96
+ dispose(): void;
97
+ }
98
+ //# sourceMappingURL=gpuResources3D.d.ts.map