@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,781 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // First-party WGSL shader library for the WebGPU world3d renderer. WGSL has
3
+ // no preprocessor, so each material variant is assembled from feature flags.
4
+ // The lighting model mirrors the GLSL library in shaders3D.ts.
5
+ export const MAX_MORPH_INFLUENCES_WGSL_3D = 8;
6
+ /** Bytes of the per-draw Object uniform block; also its dynamic-offset stride. */
7
+ export const OBJECT_BLOCK_BYTES_3D = 256;
8
+ /** Bytes of the per-material uniform block. */
9
+ export const MATERIAL_BLOCK_BYTES_3D = 256;
10
+ const FRAME = /* wgsl */ `
11
+ struct Frame {
12
+ viewProjection: mat4x4f,
13
+ view: mat4x4f,
14
+ cameraPosition: vec4f,
15
+ fogColor: vec4f,
16
+ fogParams: vec4f,
17
+ ambient: vec4f,
18
+ hemisphereSky: vec4f,
19
+ hemisphereGround: vec4f,
20
+ lightCounts: vec4f,
21
+ directionalDirection: array<vec4f, 4>,
22
+ directionalColor: array<vec4f, 4>,
23
+ pointPosition: array<vec4f, 8>,
24
+ pointColor: array<vec4f, 8>,
25
+ spotPosition: array<vec4f, 4>,
26
+ spotDirection: array<vec4f, 4>,
27
+ spotColor: array<vec4f, 4>,
28
+ spotCone: array<vec4f, 4>,
29
+ shadowMatrix: array<mat4x4f, 4>,
30
+ shadowRect: array<vec4f, 4>,
31
+ shadowParams: array<vec4f, 4>,
32
+ output: vec4f,
33
+ cascadeSplits: vec4f,
34
+ cascadeInfo: vec4f,
35
+ pointShadow: vec4f,
36
+ clipPlanes: array<vec4f, 4>,
37
+ clipInfo: vec4f,
38
+ tileGrid: vec4f, // tiles across, tiles down, tile edge in pixels, viewport origin x
39
+ tileInfo: vec4f, // x: tiled point lights (0 = none), y: header base, z: index base, w: viewport origin y
40
+ }
41
+ @group(0) @binding(0) var<uniform> frame: Frame;
42
+ @group(0) @binding(8) var<storage, read> tiledLights: array<vec4f>;
43
+ @group(0) @binding(1) var shadowMap: texture_depth_2d;
44
+ @group(0) @binding(2) var shadowSampler: sampler_comparison;
45
+ @group(0) @binding(3) var environmentMap: texture_cube<f32>;
46
+ @group(0) @binding(4) var environmentSampler: sampler;
47
+ @group(0) @binding(5) var sceneColor: texture_2d<f32>;
48
+ @group(0) @binding(6) var sceneColorSampler: sampler;
49
+ @group(0) @binding(7) var sceneDepthMap: texture_depth_2d;
50
+ // Distance from the camera plane to the solid scene behind this pixel and to the surface itself;
51
+ // hooks may read them. Without a depth image the scene counts as far away.
52
+ var<private> sceneDistance: f32 = 1.0e9;
53
+ var<private> surfaceDistance: f32 = 0.0;
54
+ // This pixel's place on the output, counted from the top row.
55
+ var<private> surfacePixel: vec2f = vec2f(0.0);
56
+ `;
57
+ const DEPTH_FRAME = /* wgsl */ `
58
+ struct Frame {
59
+ viewProjection: mat4x4f,
60
+ view: mat4x4f,
61
+ }
62
+ @group(0) @binding(0) var<uniform> frame: Frame;
63
+ `;
64
+ const SHARED = /* wgsl */ `
65
+ struct Material {
66
+ color: vec4f,
67
+ emissive: vec4f,
68
+ surface: vec4f, // metallic, roughness, normal scale, occlusion strength
69
+ specular: vec4f, // rgb and shininess
70
+ params: vec4f, // alpha cutoff, environment scale, clearcoat strength, clearcoat roughness
71
+ uvRow0: vec4f, // uv' = (dot(uvRow0.xyz, (uv, 1)), dot(uvRow1.xyz, (uv, 1)))
72
+ uvRow1: vec4f,
73
+ sprite: vec4f, // rotation, size attenuation flag, mirror image distortion and strength
74
+ custom: array<vec4f, 4>, // parameters of the optional fragment hook
75
+ sheen: vec4f, // color scaled by strength, roughness
76
+ extra: vec4f, // light map intensity, transmission, index of refraction, thickness
77
+ attenuation: vec4f, // color after the attenuation distance; w: that distance (0 = none)
78
+ splat: vec4f, // how often each ground layer repeats
79
+ }
80
+ @group(1) @binding(0) var<uniform> material: Material;
81
+ @group(1) @binding(1) var mapTexture: texture_2d<f32>;
82
+ @group(1) @binding(2) var mapSampler: sampler;
83
+ @group(1) @binding(3) var normalTexture: texture_2d<f32>;
84
+ @group(1) @binding(4) var normalSampler: sampler;
85
+ @group(1) @binding(5) var metallicRoughnessTexture: texture_2d<f32>;
86
+ @group(1) @binding(6) var metallicRoughnessSampler: sampler;
87
+ @group(1) @binding(7) var occlusionTexture: texture_2d<f32>;
88
+ @group(1) @binding(8) var occlusionSampler: sampler;
89
+ @group(1) @binding(9) var emissiveTexture: texture_2d<f32>;
90
+ @group(1) @binding(10) var emissiveSampler: sampler;
91
+ @group(1) @binding(11) var lightTexture: texture_2d<f32>;
92
+ @group(1) @binding(12) var lightSampler: sampler;
93
+ @group(1) @binding(13) var reflectionTexture: texture_2d<f32>;
94
+ @group(1) @binding(14) var reflectionSampler: sampler;
95
+
96
+ struct Object {
97
+ model: mat4x4f,
98
+ normal0: vec4f,
99
+ normal1: vec4f,
100
+ normal2: vec4f,
101
+ bind: mat4x4f,
102
+ morph: vec4i, // vertex count, channels per target, active count
103
+ morphIndices: array<vec4i, 2>,
104
+ morphWeights: array<vec4f, 2>,
105
+ }
106
+ @group(2) @binding(0) var<uniform> object: Object;
107
+ @group(3) @binding(0) var<storage, read> bones: array<mat4x4f>;
108
+ @group(3) @binding(1) var<storage, read> morphData: array<vec4f>;
109
+ `;
110
+ function vertexSource(f) {
111
+ const inputs = ['@location(0) position: vec3f', '@builtin(vertex_index) vertexIndex: u32'];
112
+ if (f.normal)
113
+ inputs.push('@location(1) normal: vec3f');
114
+ if (f.uv)
115
+ inputs.push('@location(2) uv: vec2f');
116
+ if (f.tangent)
117
+ inputs.push('@location(3) tangent: vec4f');
118
+ if (f.vertexColor)
119
+ inputs.push('@location(4) color: vec4f');
120
+ if (f.uv1)
121
+ inputs.push('@location(7) uv1: vec2f');
122
+ if (f.skinning || f.skinInstancing)
123
+ inputs.push('@location(5) joints: vec4u', '@location(6) weights: vec4f');
124
+ if (f.skinInstancing)
125
+ inputs.push('@location(13) instanceAnimation: vec4f', '@location(14) instanceAnimation2: vec4f', '@location(15) instanceLook: vec4f');
126
+ if (f.instancing)
127
+ inputs.push('@location(8) instance0: vec4f', '@location(9) instance1: vec4f', '@location(10) instance2: vec4f', '@location(11) instance3: vec4f');
128
+ if (f.instanceColor)
129
+ inputs.push('@location(12) instanceColor: vec4f');
130
+ return /* wgsl */ `
131
+ struct VertexInput {
132
+ ${inputs.join(',\n ')},
133
+ }
134
+ struct VertexOutput {
135
+ @builtin(position) clip: vec4f,
136
+ @location(0) worldPosition: vec3f,
137
+ @location(1) normal: vec3f,
138
+ @location(2) uv: vec2f,
139
+ @location(3) tangent: vec4f,
140
+ @location(4) color: vec4f,
141
+ @location(5) uv1: vec2f,
142
+ }
143
+ fn morphDelta(targetIndex: i32, channel: i32, vertexIndex: u32) -> vec3f {
144
+ let texel = (targetIndex * object.morph.y + channel) * object.morph.x + i32(vertexIndex);
145
+ return morphData[texel].xyz;
146
+ }
147
+ ${f.skinInstancing
148
+ ? /* wgsl */ `
149
+ // The bones table holds every frame of every clip. The fourth float of an instance carries what all
150
+ // instances share: matrices per frame, and the bone that may turn.
151
+ fn bakedBone(joint: u32, frame: f32, packed: f32) -> mat4x4f {
152
+ return bones[u32(frame) * (u32(packed) % 2048u) + joint];
153
+ }
154
+ // One table entry for an instance: between two frames of its clip, and of a second clip when it has one.
155
+ fn bakedBlend(joint: u32, a: vec4f, b: vec4f) -> mat4x4f {
156
+ var pose = bakedBone(joint, a.x, a.w) * (1.0 - a.z) + bakedBone(joint, a.y, a.w) * a.z;
157
+ if (b.w > 0.0) { pose = pose * (1.0 - b.w) + (bakedBone(joint, b.x, a.w) * (1.0 - b.z) + bakedBone(joint, b.y, a.w) * b.z) * b.w; }
158
+ return pose;
159
+ }
160
+ fn bakedJoint(joint: u32, a: vec4f, b: vec4f, look: vec4f) -> mat4x4f {
161
+ var pose = bakedBlend(joint, a, b);
162
+ let bone = i32(u32(a.w) / 2048u) - 1;
163
+ if (i32(joint) == bone) {
164
+ // Turn the bone about its joint, whose place in the bind pose is kept in frame 0.
165
+ let pivot = bakedBone(joint, 0.0, a.w)[3].xyz;
166
+ let v = look.xyz;
167
+ let w = look.w;
168
+ let turn = mat3x3f(1.0 - 2.0 * (v.y * v.y + v.z * v.z), 2.0 * (v.x * v.y + v.z * w), 2.0 * (v.x * v.z - v.y * w),
169
+ 2.0 * (v.x * v.y - v.z * w), 1.0 - 2.0 * (v.x * v.x + v.z * v.z), 2.0 * (v.y * v.z + v.x * w),
170
+ 2.0 * (v.x * v.z + v.y * w), 2.0 * (v.y * v.z - v.x * w), 1.0 - 2.0 * (v.x * v.x + v.y * v.y));
171
+ pose = pose * mat4x4f(vec4f(turn[0], 0.0), vec4f(turn[1], 0.0), vec4f(turn[2], 0.0), vec4f(pivot - turn * pivot, 1.0));
172
+ }
173
+ return pose;
174
+ }`
175
+ : ''}
176
+
177
+ @vertex
178
+ fn vertexMain(input: VertexInput) -> VertexOutput {
179
+ var position = input.position;
180
+ var normal = ${f.normal ? 'input.normal' : 'vec3f(0.0, 0.0, 1.0)'};
181
+ ${f.morph && f.skinInstancing
182
+ ? /* wgsl */ `
183
+ // Baked instances read their morph weights from the last entry of their frames.
184
+ let bakedWeights = bakedBlend(u32(input.instanceAnimation.w) % 2048u - 1u, input.instanceAnimation, input.instanceAnimation2);
185
+ for (var i = 0; i < object.morph.z; i++) {
186
+ position += morphDelta(i, 0, input.vertexIndex) * bakedWeights[i / 4][i % 4];
187
+ ${f.morphNormals && (!f.depthOnly || f.customVertexWgsl !== undefined) ? 'normal += morphDelta(i, 1, input.vertexIndex) * bakedWeights[i / 4][i % 4];' : ''}
188
+ }`
189
+ : f.morph
190
+ ? /* wgsl */ `
191
+ for (var i = 0; i < object.morph.z; i++) {
192
+ let targetIndex = object.morphIndices[i / 4][i % 4];
193
+ let weight = object.morphWeights[i / 4][i % 4];
194
+ position += morphDelta(targetIndex, 0, input.vertexIndex) * weight;
195
+ ${f.morphNormals && (!f.depthOnly || f.customVertexWgsl !== undefined) ? 'normal += morphDelta(targetIndex, 1, input.vertexIndex) * weight;' : ''}
196
+ }`
197
+ : ''}
198
+ var model = object.model;
199
+ var normalMatrix = mat3x3f(object.normal0.xyz, object.normal1.xyz, object.normal2.xyz);
200
+ ${f.skinning
201
+ ? /* wgsl */ `
202
+ let skin = input.weights.x * bones[input.joints.x] + input.weights.y * bones[input.joints.y]
203
+ + input.weights.z * bones[input.joints.z] + input.weights.w * bones[input.joints.w];
204
+ model = skin * object.bind;
205
+ normalMatrix = mat3x3f(model[0].xyz, model[1].xyz, model[2].xyz);`
206
+ : ''}
207
+ var spriteTurn = 0.0;
208
+ ${f.gpuParticles
209
+ ? /* wgsl */ `
210
+ // The instance slots carry a particle's start and birth, velocity and life, sizes and angles;
211
+ // where it is now follows from the time alone.
212
+ let particleLife = max(input.instance1.w, 0.0001);
213
+ var particleTime = material.custom[0].x - input.instance0.w;
214
+ var particleAlive = true;
215
+ if (material.custom[0].y > 0.5) { particleTime = particleTime - floor(particleTime / particleLife) * particleLife; }
216
+ else { particleAlive = particleTime >= 0.0 && particleTime <= particleLife; }
217
+ let particleAge = clamp(particleTime / particleLife, 0.0, 1.0);
218
+ var particleTravel = particleTime;
219
+ if (material.custom[1].w > 0.0001) { particleTravel = (1.0 - exp(-material.custom[1].w * particleTime)) / material.custom[1].w; }
220
+ var particleCenter = input.instance0.xyz + input.instance1.xyz * particleTravel + material.custom[1].xyz * (0.5 * particleTime * particleTime);
221
+ if (material.custom[3].y > 0.5) {
222
+ // A floor: find when the particle comes down on it, then let it leave again slower, once. Drag is not applied on this path.
223
+ let pull = material.custom[1].xyz;
224
+ let launch = input.instance1.xyz;
225
+ let a = 0.5 * pull.y;
226
+ let b = launch.y;
227
+ let c = input.instance0.y - material.custom[3].z;
228
+ var hit = -1.0;
229
+ if (c == 0.0 && (b < 0.0 || (b == 0.0 && a < 0.0))) { hit = 0.0; }
230
+ else if (abs(a) > 0.000001) {
231
+ let discriminant = b * b - 4.0 * a * c;
232
+ if (discriminant > 0.0) {
233
+ let root = sqrt(discriminant);
234
+ if (b < 0.0) { hit = 2.0 * c / (root - b); } else { hit = (-b - root) / (2.0 * a); }
235
+ }
236
+ } else if (b < 0.0) { hit = -c / b; }
237
+ particleCenter = input.instance0.xyz + launch * particleTime + pull * (0.5 * particleTime * particleTime);
238
+ if (c >= 0.0 && hit >= 0.0 && particleTime >= hit) {
239
+ let landed = input.instance0.xyz + launch * hit + pull * (0.5 * hit * hit);
240
+ let away = (launch + pull * hit) * vec3f(material.custom[3].w, -material.custom[3].w, material.custom[3].w);
241
+ let since = particleTime - hit;
242
+ particleCenter = landed + away * since + pull * (0.5 * since * since);
243
+ particleCenter.y = max(particleCenter.y, material.custom[3].z);
244
+ }
245
+ }
246
+ // Particles left behind in the world carry world positions and ignore the emitter's transform.
247
+ if (material.custom[3].x > 0.5) { model = mat4x4f(vec4f(1.0, 0.0, 0.0, 0.0), vec4f(0.0, 1.0, 0.0, 0.0), vec4f(0.0, 0.0, 1.0, 0.0), vec4f(0.0, 0.0, 0.0, 1.0)); }
248
+ let particleSize = mix(input.instance2.x, input.instance2.y, particleAge);
249
+ model = model * mat4x4f(vec4f(particleSize, 0.0, 0.0, 0.0), vec4f(0.0, particleSize, 0.0, 0.0), vec4f(0.0, 0.0, particleSize, 0.0), vec4f(particleCenter, 1.0));
250
+ spriteTurn = input.instance2.z + input.instance2.w * particleTime;`
251
+ : ''}
252
+ ${f.instancing && !f.gpuParticles
253
+ ? /* wgsl */ `
254
+ let instance = mat4x4f(input.instance0, input.instance1, input.instance2, input.instance3);
255
+ model = model * instance;
256
+ normalMatrix = normalMatrix * mat3x3f(instance[0].xyz, instance[1].xyz, instance[2].xyz);`
257
+ : ''}
258
+ ${f.skinInstancing
259
+ ? /* wgsl */ `
260
+ // Each instance is posed in its own space before its transform places it.
261
+ let first = input.instanceAnimation;
262
+ let second = input.instanceAnimation2;
263
+ model = model * (input.weights.x * bakedJoint(input.joints.x, first, second, input.instanceLook) + input.weights.y * bakedJoint(input.joints.y, first, second, input.instanceLook)
264
+ + input.weights.z * bakedJoint(input.joints.z, first, second, input.instanceLook) + input.weights.w * bakedJoint(input.joints.w, first, second, input.instanceLook));
265
+ normalMatrix = mat3x3f(model[0].xyz, model[1].xyz, model[2].xyz);`
266
+ : ''}
267
+ var world = model * vec4f(position, 1.0);
268
+ ${f.customVertexWgsl !== undefined ? `world = vec4f(customVertex(world.xyz, position, normal, ${f.uv ? 'input.uv' : 'vec2f(0.0)'}, ${f.vertexColor ? 'input.color' : 'vec4f(1.0)'}), world.w);` : ''}
269
+ ${f.billboard
270
+ ? /* wgsl */ `
271
+ // Expand the quad along the camera's right and up axes around the node origin.
272
+ let origin = model * vec4f(0.0, 0.0, 0.0, 1.0);
273
+ let right = vec3f(frame.view[0].x, frame.view[1].x, frame.view[2].x);
274
+ let up = vec3f(frame.view[0].y, frame.view[1].y, frame.view[2].y);
275
+ var scale = vec2f(length(model[0].xyz), length(model[1].xyz));
276
+ if (material.sprite.y < 0.5) { scale *= -(frame.view * origin).z; }
277
+ let c = cos(material.sprite.x + spriteTurn);
278
+ let s = sin(material.sprite.x + spriteTurn);
279
+ let corner = position.xy * scale;
280
+ let turned = vec2f(c * corner.x - s * corner.y, s * corner.x + c * corner.y);
281
+ world = vec4f(origin.xyz + right * turned.x + up * turned.y, 1.0);
282
+ normal = vec3f(0.0, 0.0, 1.0);
283
+ normalMatrix = transpose(mat3x3f(frame.view[0].xyz, frame.view[1].xyz, frame.view[2].xyz));`
284
+ : ''}
285
+ var output: VertexOutput;
286
+ var clip = frame.viewProjection * world;
287
+ ${f.screenSpace ? '// Positions are already in normalized device coordinates; depth is remapped below.\n clip = vec4f(position.xy, -1.0, 1.0);' : ''}
288
+ // Matrices follow OpenGL clip conventions; WebGPU depth spans [0, 1].
289
+ output.clip = vec4f(clip.xy, (clip.z + clip.w) * 0.5, clip.w);
290
+ output.worldPosition = world.xyz;
291
+ output.normal = normalMatrix * normal;
292
+ let uv = vec3f(${f.uv ? 'input.uv' : 'vec2f(0.0)'}, 1.0);
293
+ output.uv = vec2f(dot(material.uvRow0.xyz, uv), dot(material.uvRow1.xyz, uv));
294
+ output.tangent = ${f.tangent ? 'vec4f(mat3x3f(model[0].xyz, model[1].xyz, model[2].xyz) * input.tangent.xyz, input.tangent.w)' : 'vec4f(1.0, 0.0, 0.0, 1.0)'};
295
+ output.color = ${f.vertexColor ? 'input.color' : 'vec4f(1.0)'};
296
+ output.uv1 = ${f.uv1 ? 'input.uv1' : 'vec2f(0.0)'};
297
+ ${f.instanceColor ? 'output.color *= input.instanceColor;' : ''}
298
+ ${f.gpuParticles
299
+ ? /* wgsl */ `
300
+ // From the instance's color to the shared end color over the particle's life, fading at both ends.
301
+ output.color = mix(input.instanceColor, material.custom[2], particleAge);
302
+ output.color.a *= smoothstep(0.0, max(material.custom[0].z, 0.0001), particleAge) * (1.0 - smoothstep(1.0 - max(material.custom[0].w, 0.0001), 1.0, particleAge));
303
+ if (!particleAlive) { output.clip = vec4f(2.0, 2.0, 2.0, 1.0); }`
304
+ : ''}
305
+ return output;
306
+ }
307
+ `;
308
+ }
309
+ function fragmentSource(f) {
310
+ const lit = f.shading !== 'unlit' && f.shading !== 'matcap';
311
+ if (f.depthOnly) {
312
+ return /* wgsl */ `
313
+ @fragment
314
+ fn fragmentMain(input: VertexOutput) {
315
+ var base = material.color * input.color;
316
+ ${f.map ? 'base *= textureSample(mapTexture, mapSampler, input.uv);' : ''}
317
+ ${f.alphaMask ? 'if (base.a < material.params.x) { discard; }' : ''}
318
+ ${f.alphaBlend ? 'if (base.a < 0.5) { discard; }' : ''}
319
+ }
320
+ `;
321
+ }
322
+ const shade = f.shading === 'lambert'
323
+ ? 'return s.albedo * radiance * nl;'
324
+ : // material.specular.w carries the band count for toon shading.
325
+ f.shading === 'toon'
326
+ ? 'return s.albedo * radiance * (ceil(nl * material.specular.w - 0.001) / max(material.specular.w, 1.0));'
327
+ : f.shading === 'phong'
328
+ ? /* wgsl */ `
329
+ let h = normalize(l + s.view);
330
+ let specular = pow(max(dot(s.normal, h), 0.0), max(material.specular.w, 1.0));
331
+ return (s.albedo + material.specular.rgb * specular) * radiance * nl;`
332
+ : /* wgsl */ `
333
+ let h = normalize(l + s.view);
334
+ let nv = max(dot(s.normal, s.view), 0.0001);
335
+ let nh = max(dot(s.normal, h), 0.0);
336
+ let vh = max(dot(s.view, h), 0.0);
337
+ let a = s.roughness * s.roughness;
338
+ let a2 = a * a;
339
+ let d = nh * nh * (a2 - 1.0) + 1.0;
340
+ let distribution = a2 / (PI * d * d);
341
+ let visibility = 0.5 / max(nl * sqrt(nv * nv * (1.0 - a2) + a2) + nv * sqrt(nl * nl * (1.0 - a2) + a2), 0.0001);
342
+ let fresnel = s.f0 + (1.0 - s.f0) * pow(1.0 - vh, 5.0);
343
+ let diffuse = s.albedo * (1.0 - s.metallic) * (1.0 - fresnel);
344
+ // Light units are scaled by PI so a unit white light fully lights a white diffuse surface.
345
+ var lit = diffuse + distribution * visibility * fresnel * PI;
346
+ if (material.sheen.r + material.sheen.g + material.sheen.b > 0.0) {
347
+ // Cloth lobe: an inverted Gaussian that brightens toward grazing angles.
348
+ let inverse = 1.0 / max(material.sheen.w, 0.07);
349
+ lit += material.sheen.rgb * ((2.0 + inverse) * pow(max(1.0 - nh * nh, 0.0), inverse * 0.5) / (2.0 * PI)) / (4.0 * (nl + nv - nl * nv)) * PI;
350
+ }
351
+ if (material.params.z > 0.0) {
352
+ // A second, dielectric lobe on top; the base layer loses what the coat reflects.
353
+ var ca = max(material.params.w, 0.045);
354
+ ca *= ca;
355
+ let ca2 = ca * ca;
356
+ let cd = nh * nh * (ca2 - 1.0) + 1.0;
357
+ let coatFresnel = (0.04 + 0.96 * pow(1.0 - vh, 5.0)) * material.params.z;
358
+ lit = lit * (1.0 - coatFresnel) + ca2 / (PI * cd * cd) * (0.25 / max(vh * vh, 0.0001)) * coatFresnel * PI;
359
+ }
360
+ return lit * radiance * nl;`;
361
+ return /* wgsl */ `
362
+ const PI = 3.141592653589793;
363
+ struct Surface {
364
+ albedo: vec3f,
365
+ normal: vec3f,
366
+ view: vec3f,
367
+ f0: vec3f,
368
+ roughness: f32,
369
+ metallic: f32,
370
+ }
371
+ fn shadowFactor(slot: i32, worldPosition: vec3f, normal: vec3f) -> f32 {
372
+ let params = frame.shadowParams[slot];
373
+ let clip = frame.shadowMatrix[slot] * vec4f(worldPosition + normal * params.y, 1.0);
374
+ if (clip.w <= 0.0) { return 1.0; }
375
+ let ndc = clip.xyz / clip.w * 0.5 + 0.5;
376
+ if (any(ndc < vec3f(0.0)) || any(ndc > vec3f(1.0))) { return 1.0; }
377
+ let rect = frame.shadowRect[slot];
378
+ let depth = ndc.z - params.x;
379
+ let corner = rect.xy + rect.zw;
380
+ let lower = min(rect.xy, corner) + params.z;
381
+ let upper = max(rect.xy, corner) - params.z;
382
+ var lit = 0.0;
383
+ // 3x3 taps on top of hardware comparison filtering.
384
+ for (var y = -1; y <= 1; y++) {
385
+ for (var x = -1; x <= 1; x++) {
386
+ let uv = clamp(rect.xy + ndc.xy * rect.zw + vec2f(f32(x), f32(y)) * params.z, lower, upper);
387
+ lit += textureSampleCompareLevel(shadowMap, shadowSampler, uv, depth);
388
+ }
389
+ }
390
+ return lit / 9.0;
391
+ }
392
+ // One unfiltered lookup for a point in the air, as fog marching needs many; the flag picks the cascade for that depth.
393
+ fn volumeShadow(first: i32, at: vec3f, cascaded: bool) -> f32 {
394
+ var slot = first;
395
+ if (cascaded) {
396
+ let viewDepth = -(frame.view * vec4f(at, 1.0)).z;
397
+ let count = i32(frame.cascadeInfo.y);
398
+ var cascade = 0;
399
+ for (var c = 0; c < 3; c++) { if (c < count - 1 && viewDepth > frame.cascadeSplits[c]) { cascade = c + 1; } }
400
+ if (viewDepth >= frame.cascadeSplits[cascade]) { return 1.0; }
401
+ slot += cascade;
402
+ }
403
+ let clip = frame.shadowMatrix[slot] * vec4f(at, 1.0);
404
+ if (clip.w <= 0.0) { return 1.0; }
405
+ let ndc = clip.xyz / clip.w * 0.5 + 0.5;
406
+ if (any(ndc < vec3f(0.0)) || any(ndc > vec3f(1.0))) { return 1.0; }
407
+ let rect = frame.shadowRect[slot];
408
+ return textureSampleCompareLevel(shadowMap, shadowSampler, rect.xy + ndc.xy * rect.zw, ndc.z - frame.shadowParams[slot].x);
409
+ }
410
+ fn pointShadowFactor(slot: i32, fromLight: vec3f, worldPosition: vec3f, normal: vec3f) -> f32 {
411
+ // Faces of the tetrahedron the four maps were rendered through.
412
+ let k = 0.5773502691896258;
413
+ let d1 = dot(fromLight, vec3f(-k, -k, k));
414
+ let d2 = dot(fromLight, vec3f(-k, k, -k));
415
+ let d3 = dot(fromLight, vec3f(k, -k, -k));
416
+ var face = 0;
417
+ var best = dot(fromLight, vec3f(k, k, k));
418
+ if (d1 > best) { best = d1; face = 1; }
419
+ if (d2 > best) { best = d2; face = 2; }
420
+ if (d3 > best) { face = 3; }
421
+ return shadowFactor(slot + face, worldPosition, normal);
422
+ }
423
+ fn cascadedShadowFactor(slot: i32, worldPosition: vec3f, normal: vec3f) -> f32 {
424
+ let viewDepth = -(frame.view * vec4f(worldPosition, 1.0)).z;
425
+ let count = i32(frame.cascadeInfo.y);
426
+ var cascade = 0;
427
+ for (var c = 0; c < 3; c++) { if (c < count - 1 && viewDepth > frame.cascadeSplits[c]) { cascade = c + 1; } }
428
+ let edge = frame.cascadeSplits[cascade];
429
+ if (viewDepth >= edge) { return 1.0; }
430
+ var visible = shadowFactor(slot + cascade, worldPosition, normal);
431
+ // Blend into the next cascade, or out to unshadowed past the last one.
432
+ let t = smoothstep(edge * (1.0 - frame.cascadeInfo.z), edge, viewDepth);
433
+ if (t > 0.0) {
434
+ var next = 1.0;
435
+ if (cascade < count - 1) { next = shadowFactor(slot + cascade + 1, worldPosition, normal); }
436
+ visible = mix(visible, next, t);
437
+ }
438
+ return visible;
439
+ }
440
+ fn rangeFalloff(dist: f32, range: f32) -> f32 {
441
+ let inverseSquare = 1.0 / max(dist * dist, 0.0001);
442
+ if (range <= 0.0) { return inverseSquare; }
443
+ let ratio = dist / range;
444
+ let window = clamp(1.0 - ratio * ratio * ratio * ratio, 0.0, 1.0);
445
+ return inverseSquare * window * window;
446
+ }
447
+ fn shade(s: Surface, l: vec3f, radiance: vec3f) -> vec3f {
448
+ let nl = max(dot(s.normal, l), 0.0);
449
+ if (nl <= 0.0) { return vec3f(0.0); }
450
+ ${lit ? shade : 'return vec3f(0.0);'}
451
+ }
452
+ fn toneMap(input: vec3f) -> vec3f {
453
+ var color = input * frame.output.z;
454
+ if (frame.output.w > 1.5) {
455
+ // Filmic curve fit commonly used for ACES-like output.
456
+ color = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3f(0.0), vec3f(1.0));
457
+ } else if (frame.output.w > 0.5) { color = color / (1.0 + color); }
458
+ return color;
459
+ }
460
+ fn encodeSrgb(input: vec3f) -> vec3f {
461
+ let color = clamp(input, vec3f(0.0), vec3f(1.0));
462
+ return mix(color * 12.92, 1.055 * pow(color, vec3f(1.0 / 2.4)) - 0.055, step(vec3f(0.0031308), color));
463
+ }
464
+ @fragment
465
+ fn fragmentMain(input: VertexOutput, @builtin(front_facing) frontFacing: bool) -> @location(0) vec4f {
466
+ // Implicit-derivative operations run first, before any non-uniform control flow.
467
+ surfacePixel = input.clip.xy;
468
+ let dpx = dpdx(input.worldPosition);
469
+ let dpy = dpdy(input.worldPosition);
470
+ let duvx = dpdx(input.uv);
471
+ let duvy = dpdy(input.uv);
472
+ var base = material.color * input.color;
473
+ ${f.mapFromTarget
474
+ ? /* wgsl */ `
475
+ let mapColor = textureSample(mapTexture, mapSampler, input.uv);
476
+ // Target pixels carry alpha-weighted RGB. Material shading uses straight color.
477
+ var straightColor = vec3f(0.0);
478
+ if (mapColor.a > 0.0) { straightColor = mapColor.rgb / mapColor.a; }
479
+ base *= vec4f(straightColor, mapColor.a);`
480
+ : f.map
481
+ ? 'base *= textureSample(mapTexture, mapSampler, input.uv);'
482
+ : ''}
483
+ ${f.splat
484
+ ? /* wgsl */ `
485
+ {
486
+ // Ground layers, each weighted by its channel of the weight map.
487
+ var share = textureSample(lightTexture, lightSampler, input.uv);
488
+ let total = share.r + share.g + share.b + share.a;
489
+ if (total > 0.0001) { share = share / total; } else { share = vec4f(1.0, 0.0, 0.0, 0.0); }
490
+ base = vec4f(base.rgb * (textureSample(mapTexture, mapSampler, input.uv * material.splat.x).rgb * share.r + textureSample(emissiveTexture, emissiveSampler, input.uv * material.splat.y).rgb * share.g
491
+ + textureSample(occlusionTexture, occlusionSampler, input.uv * material.splat.z).rgb * share.b + textureSample(metallicRoughnessTexture, metallicRoughnessSampler, input.uv * material.splat.w).rgb * share.a), base.a);
492
+ }`
493
+ : ''}
494
+ ${f.softDepth
495
+ ? /* wgsl */ `
496
+ {
497
+ // Fade out over the last stretch before the solid surface behind this pixel.
498
+ let stored = textureLoad(sceneDepthMap, vec2i(input.clip.xy), 0) * 2.0 - 1.0;
499
+ sceneDistance = frame.pointShadow.w / (stored + frame.pointShadow.z);
500
+ if (frame.lightCounts.w > 0.5) { sceneDistance = (frame.pointShadow.w - stored) / frame.pointShadow.z; }
501
+ surfaceDistance = -(frame.view * vec4f(input.worldPosition, 1.0)).z;
502
+ ${f.transmission ? '' : 'base.a *= clamp((sceneDistance - surfaceDistance) / max(material.emissive.w, 0.0001), 0.0, 1.0);'}
503
+ }`
504
+ : ''}
505
+ ${f.normalMap ? 'let normalSample = textureSample(normalTexture, normalSampler, input.uv).xyz;' : ''}
506
+ ${f.metallicRoughnessMap ? 'let mrSample = textureSample(metallicRoughnessTexture, metallicRoughnessSampler, input.uv);' : ''}
507
+ ${f.occlusionMap ? 'let occlusionSample = textureSample(occlusionTexture, occlusionSampler, ' + (f.occlusionUv1 ? 'input.uv1' : 'input.uv') + ').r;' : ''}
508
+ ${f.lightMap ? 'let lightSample = textureSample(lightTexture, lightSampler, ' + (f.lightUv1 ? 'input.uv1' : 'input.uv') + ').rgb;' : ''}
509
+ ${f.emissiveMap ? 'let emissiveSample = textureSample(emissiveTexture, emissiveSampler, ' + (f.emissiveUv1 ? 'input.uv1' : 'input.uv') + ').rgb;' : ''}
510
+ ${f.shading === 'matcap'
511
+ ? /* wgsl */ `
512
+ var matcapNormal = normalize(${f.normal ? 'input.normal' : 'cross(dpx, -dpy)'});
513
+ ${f.doubleSided ? 'if (!frontFacing) { matcapNormal = -matcapNormal; }' : ''}
514
+ let matcapView = normalize((frame.view * vec4f(matcapNormal, 0.0)).xyz);
515
+ let matcapSample = textureSampleLevel(emissiveTexture, emissiveSampler, matcapView.xy * 0.5 + 0.5, 0.0).rgb;`
516
+ : ''}
517
+ ${f.alphaMask ? 'if (base.a < material.params.x) { discard; }' : ''}
518
+ for (var plane = 0; plane < i32(frame.clipInfo.x); plane++) {
519
+ if (dot(input.worldPosition, frame.clipPlanes[plane].xyz) + frame.clipPlanes[plane].w < 0.0) { discard; }
520
+ }
521
+ var color = base.rgb${f.shading === 'matcap' ? ' * matcapSample' : ''};
522
+ ${lit
523
+ ? /* wgsl */ `
524
+ var s: Surface;
525
+ ${f.flatShading || !f.normal
526
+ ? 'var n = normalize(cross(dpy, dpx));'
527
+ : /* wgsl */ `var n = normalize(input.normal);
528
+ ${f.doubleSided ? 'if (!frontFacing) { n = -n; }' : ''}`}
529
+ ${f.normalMap
530
+ ? /* wgsl */ `
531
+ var mapped = normalSample * 2.0 - 1.0;
532
+ mapped = vec3f(mapped.xy * material.surface.z, mapped.z);
533
+ ${f.tangent
534
+ ? /* wgsl */ `
535
+ let t = normalize(input.tangent.xyz);
536
+ let b = cross(n, t) * input.tangent.w;`
537
+ : /* wgsl */ `
538
+ // Derive a cotangent frame from screen-space derivatives. Framebuffer Y
539
+ // points down in WebGPU, so the Y derivatives are negated first.
540
+ let dp2perp = cross(-dpy, n);
541
+ let dp1perp = cross(n, dpx);
542
+ var t = dp2perp * duvx.x - dp1perp * duvy.x;
543
+ var b = dp2perp * duvx.y - dp1perp * duvy.y;
544
+ let invmax = inverseSqrt(max(max(dot(t, t), dot(b, b)), 1e-12));
545
+ t *= invmax;
546
+ b *= invmax;`}
547
+ n = normalize(mat3x3f(t, b, n) * mapped);`
548
+ : ''}
549
+ ${f.customNormalWgsl !== undefined ? 'n = normalize(customNormal(n, input.worldPosition, ' + (f.uv ? 'input.uv' : 'vec2f(0.0)') + '));' : ''}
550
+ s.normal = n;
551
+ s.view = normalize(frame.cameraPosition.xyz - input.worldPosition);
552
+ s.albedo = base.rgb;
553
+ s.metallic = material.surface.x;
554
+ s.roughness = material.surface.y;
555
+ ${f.metallicRoughnessMap ? 's.metallic *= mrSample.b; s.roughness *= mrSample.g;' : ''}
556
+ s.roughness = clamp(s.roughness, 0.045, 1.0);
557
+ s.f0 = mix(vec3f(0.04), s.albedo, s.metallic);
558
+ var occlusion = 1.0;
559
+ ${f.occlusionMap ? 'occlusion = mix(1.0, occlusionSample, material.surface.w);' : ''}
560
+ ${f.transmission
561
+ ? /* wgsl */ `
562
+ // Light that passes through replaces that share of the diffuse reflection.
563
+ // What the surface reflects at this angle does not pass through it.
564
+ var through = material.extra.y * (1.0 - s.metallic) * (1.0 - (0.04 + 0.96 * pow(1.0 - max(dot(s.normal, s.view), 0.0), 5.0)));
565
+ var passed = vec3f(0.0);
566
+ {
567
+ let bent = refract(-s.view, s.normal, 1.0 / max(material.extra.z, 1.0));
568
+ let here = frame.viewProjection * vec4f(input.worldPosition, 1.0);
569
+ let there = frame.viewProjection * vec4f(input.worldPosition + bent * material.extra.w, 1.0);
570
+ let shift = (there.xy / max(there.w, 0.0001) - here.xy / here.w) * 0.5 * frame.clipInfo.zw;
571
+ let at = input.clip.xy / vec2f(textureDimensions(sceneColor)) + vec2f(shift.x, -shift.y);
572
+ // A rough surface scatters the view: average a spiral of taps that widens with roughness.
573
+ let spread = s.roughness * s.roughness * 0.25 / max(here.w, 1.0);
574
+ for (var i = 0; i < 12; i++) {
575
+ let turn = f32(i) * 2.399963;
576
+ let reach = sqrt((f32(i) + 0.5) / 12.0) * spread;
577
+ // The stored image is top row first, so an upward step is a downward one in it.
578
+ passed += textureSampleLevel(sceneColor, sceneColorSampler, clamp(at + vec2f(cos(turn), -sin(turn)) * reach, vec2f(0.0), vec2f(1.0)), 0.0).rgb;
579
+ }
580
+ passed /= 12.0;
581
+ }
582
+ // Tint of the material, deepened by the distance travelled inside it.
583
+ var tint = s.albedo;
584
+ // With a depth image the light's path through the material is the real gap to what lies behind.
585
+ let travelled = ${f.softDepth ? 'max(sceneDistance - surfaceDistance, 0.0)' : 'material.extra.w'};
586
+ if (material.attenuation.w > 0.0) { tint *= pow(max(material.attenuation.rgb, vec3f(0.0001)), vec3f(travelled / material.attenuation.w)); }
587
+ s.albedo *= 1.0 - through;
588
+ var clear = 1.0;`
589
+ : ''}
590
+ ${f.reflectionMap
591
+ ? /* wgsl */ `
592
+ var mirrorClear = 1.0;
593
+ // The mirror camera sees the scene flipped left to right; stored images are top row first.
594
+ let mirrorAt = frame.viewProjection * vec4f(input.worldPosition, 1.0);
595
+ let mirrorNdc = mirrorAt.xy / max(mirrorAt.w, 0.0001);
596
+ let mirrorUv = vec2f(0.5 - mirrorNdc.x * 0.5, 0.5 - mirrorNdc.y * 0.5) + vec2f(s.normal.x, -s.normal.z) * material.sprite.z;
597
+ let mirrored = textureSampleLevel(reflectionTexture, reflectionSampler, clamp(mirrorUv, vec2f(0.002), vec2f(0.998)), 0.0).rgb
598
+ * (s.f0 + (1.0 - s.f0) * pow(1.0 - max(dot(s.normal, s.view), 0.0), 5.0)) * material.sprite.w;`
599
+ : ''}
600
+ var diffuseAlbedo = s.albedo;
601
+ ${f.shading === 'standard' ? 'diffuseAlbedo *= 1.0 - s.metallic;' : ''}
602
+ var irradiance = frame.ambient.rgb + mix(frame.hemisphereGround.rgb, frame.hemisphereSky.rgb, s.normal.y * 0.5 + 0.5);
603
+ ${f.environment ? 'irradiance += textureSampleLevel(environmentMap, environmentSampler, s.normal, frame.output.y).rgb * frame.output.x * material.params.y;' : ''}
604
+ ${f.lightMap ? 'irradiance += lightSample * material.extra.x;' : ''}
605
+ color = diffuseAlbedo * irradiance * occlusion;
606
+ ${f.environment && f.shading === 'standard' && !f.reflectionMap
607
+ ? /* wgsl */ `
608
+ {
609
+ let reflected = reflect(-s.view, s.normal);
610
+ let nv = max(dot(s.normal, s.view), 0.0);
611
+ let prefiltered = textureSampleLevel(environmentMap, environmentSampler, reflected, s.roughness * frame.output.y).rgb * frame.output.x * material.params.y;
612
+ // Analytic approximation of the split-sum environment BRDF.
613
+ let r = s.roughness * vec4f(-1.0, -0.0275, -0.572, 0.022) + vec4f(1.0, 0.0425, 1.04, -0.04);
614
+ let a004 = min(r.x * r.x, exp2(-9.28 * nv)) * r.x + r.y;
615
+ let scaleBias = vec2f(-1.04, 1.04) * a004 + r.zw;
616
+ color += prefiltered * (s.f0 * scaleBias.x + scaleBias.y) * occlusion;
617
+ }`
618
+ : ''}
619
+ let directionalCount = i32(frame.lightCounts.x);
620
+ let pointCount = i32(frame.lightCounts.y);
621
+ let spotCount = i32(frame.lightCounts.z);
622
+ for (var i = 0; i < directionalCount; i++) {
623
+ var visible = 1.0;
624
+ ${f.receiveShadow
625
+ ? `if (frame.directionalDirection[i].w >= 0.0) {
626
+ if (f32(i) == frame.cascadeInfo.x) { visible = cascadedShadowFactor(i32(frame.directionalDirection[i].w), input.worldPosition, s.normal); }
627
+ else { visible = shadowFactor(i32(frame.directionalDirection[i].w), input.worldPosition, s.normal); }
628
+ }`
629
+ : ''}
630
+ color += shade(s, -frame.directionalDirection[i].xyz, frame.directionalColor[i].rgb) * visible;
631
+ }
632
+ for (var i = 0; i < pointCount; i++) {
633
+ let toLight = frame.pointPosition[i].xyz - input.worldPosition;
634
+ let dist = length(toLight);
635
+ var visible = 1.0;
636
+ ${f.receiveShadow ? 'if (f32(i) == frame.pointShadow.x) { visible = pointShadowFactor(i32(frame.pointShadow.y), -toLight, input.worldPosition, s.normal); }' : ''}
637
+ color += shade(s, toLight / max(dist, 0.0001), frame.pointColor[i].rgb * rangeFalloff(dist, frame.pointPosition[i].w)) * visible;
638
+ }
639
+ // Point lights past the eight: only those whose range reaches this pixel's screen tile are visited.
640
+ if (frame.tileInfo.x > 0.5) {
641
+ let tileAt = clamp(vec2i((input.clip.xy - vec2f(frame.tileGrid.w, frame.tileInfo.w)) / frame.tileGrid.z), vec2i(0), vec2i(frame.tileGrid.xy) - vec2i(1));
642
+ let head = tiledLights[i32(frame.tileInfo.y) + tileAt.y * i32(frame.tileGrid.x) + tileAt.x];
643
+ let first = i32(head.x);
644
+ let tileCount = min(i32(head.y), 32);
645
+ for (var k = 0; k < tileCount; k++) {
646
+ let slot = first + k;
647
+ let lightIndex = i32(tiledLights[i32(frame.tileInfo.z) + slot / 4][slot % 4]);
648
+ let lightPosition = tiledLights[lightIndex * 2];
649
+ let lightColor = tiledLights[lightIndex * 2 + 1];
650
+ let toLight = lightPosition.xyz - input.worldPosition;
651
+ let dist = length(toLight);
652
+ if (dist >= lightPosition.w) { continue; }
653
+ color += shade(s, toLight / max(dist, 0.0001), lightColor.rgb * rangeFalloff(dist, lightPosition.w));
654
+ }
655
+ }
656
+ for (var i = 0; i < spotCount; i++) {
657
+ let toLight = frame.spotPosition[i].xyz - input.worldPosition;
658
+ let dist = length(toLight);
659
+ let l = toLight / max(dist, 0.0001);
660
+ let cone = smoothstep(frame.spotCone[i].x, frame.spotCone[i].y, dot(-l, frame.spotDirection[i].xyz));
661
+ var visible = 1.0;
662
+ ${f.receiveShadow ? 'if (cone > 0.0 && frame.spotDirection[i].w >= 0.0) { visible = shadowFactor(i32(frame.spotDirection[i].w), input.worldPosition, s.normal); }' : ''}
663
+ color += shade(s, l, frame.spotColor[i].rgb * rangeFalloff(dist, frame.spotPosition[i].w) * cone) * visible;
664
+ }`
665
+ : ''}
666
+ ${f.shading === 'matcap'
667
+ ? ''
668
+ : /* wgsl */ `
669
+ var emissive = material.emissive.rgb;
670
+ ${f.emissiveMap ? 'emissive *= emissiveSample;' : ''}
671
+ color += emissive;`}
672
+ ${f.customWgsl !== undefined
673
+ ? /* wgsl */ `
674
+ let customized = customFragment(vec4f(color, base.a), input.worldPosition, normalize(input.normal), input.uv);
675
+ color = customized.rgb;
676
+ base.a = customized.a;
677
+ ${f.transmission ? "// On a see-through material the hook's alpha is how much still passes: 0 covers what lies behind.\n through *= clamp(customized.a, 0.0, 1.0);" : ''}`
678
+ : ''}
679
+ ${f.fog
680
+ ? /* wgsl */ `
681
+ if (frame.fogParams.x > 0.5) {
682
+ let dist = length(frame.cameraPosition.xyz - input.worldPosition);
683
+ var fog = smoothstep(frame.fogParams.y, frame.fogParams.z, dist);
684
+ if (frame.fogParams.x > 1.5) { fog = 1.0 - exp(-frame.fogParams.y * frame.fogParams.y * dist * dist); }
685
+ color = mix(color, frame.fogColor.rgb, clamp(fog, 0.0, 1.0));
686
+ ${f.transmission ? 'clear = 1.0 - clamp(fog, 0.0, 1.0);' : ''}
687
+ ${f.reflectionMap ? 'mirrorClear = 1.0 - clamp(fog, 0.0, 1.0);' : ''}
688
+ }`
689
+ : ''}
690
+ ${f.toneMapped ? 'color = toneMap(color);' : ''}
691
+ ${f.transmission
692
+ ? /* wgsl */ `
693
+ // The stored scene is display-ready, so it joins after tone mapping; the canvas holds it sRGB-encoded.
694
+ ${f.linearOutput ? '' : 'passed = mix(passed / 12.92, pow((passed + 0.055) / 1.055, vec3f(2.4)), step(vec3f(0.04045), passed));'}
695
+ color += passed * tint * through * clear;`
696
+ : ''}
697
+ ${f.reflectionMap ? 'color += mirrored * mirrorClear;' : ''}
698
+ ${f.linearOutput ? 'color = max(color, vec3f(0.0));' : 'color = encodeSrgb(color);'}
699
+ ${f.premultipliedAlpha ? 'color *= base.a;' : ''}
700
+ return vec4f(color, ${f.alphaBlend ? 'base.a' : '1.0'});
701
+ }
702
+ `;
703
+ }
704
+ /** Assemble the complete WGSL module for one material variant. */
705
+ export function buildMaterialWgsl3D(features) {
706
+ return ((features.depthOnly ? DEPTH_FRAME : FRAME) +
707
+ SHARED +
708
+ (features.customVertexWgsl ?? '') +
709
+ '\n' +
710
+ vertexSource(features) +
711
+ (features.customWgsl ?? '') +
712
+ '\n' +
713
+ (features.customNormalWgsl ?? '') +
714
+ '\n' +
715
+ fragmentSource(features));
716
+ }
717
+ /** Stable cache key for a feature set. */
718
+ export function shaderFeatureKey3D(features) {
719
+ let key = features.shading;
720
+ for (const name of Object.keys(features).sort()) {
721
+ if (name !== 'shading' && features[name] === true)
722
+ key += ' ' + name;
723
+ }
724
+ if (features.customKey !== undefined)
725
+ key += ' custom:' + features.customKey;
726
+ return key;
727
+ }
728
+ /** Full-screen triangle sampling a cube map along the view ray, drawn at the far plane. */
729
+ export const SKYBOX_WGSL_3D = /* wgsl */ `
730
+ struct Sky {
731
+ inverseViewProjection: mat4x4f,
732
+ output: vec4f, // x: intensity, y: 1 keeps linear output, z: exposure, w: tone mapping
733
+ }
734
+ @group(0) @binding(0) var<uniform> sky: Sky;
735
+ @group(0) @binding(1) var skyMap: texture_cube<f32>;
736
+ @group(0) @binding(2) var skySampler: sampler;
737
+ struct SkyOutput {
738
+ @builtin(position) clip: vec4f,
739
+ @location(0) direction: vec3f,
740
+ }
741
+ @vertex
742
+ fn vertexMain(@builtin(vertex_index) index: u32) -> SkyOutput {
743
+ let corner = vec2f(f32((index << 1u) & 2u), f32(index & 2u)) * 2.0 - 1.0;
744
+ let far = sky.inverseViewProjection * vec4f(corner, 1.0, 1.0);
745
+ let near = sky.inverseViewProjection * vec4f(corner, -1.0, 1.0);
746
+ var output: SkyOutput;
747
+ output.direction = far.xyz / far.w - near.xyz / near.w;
748
+ output.clip = vec4f(corner, 1.0, 1.0);
749
+ return output;
750
+ }
751
+ @fragment
752
+ fn fragmentMain(input: SkyOutput) -> @location(0) vec4f {
753
+ var color = textureSample(skyMap, skySampler, normalize(input.direction)).rgb * sky.output.x * sky.output.z;
754
+ if (sky.output.w > 1.5) { color = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3f(0.0), vec3f(1.0)); }
755
+ else if (sky.output.w > 0.5) { color = color / (1.0 + color); }
756
+ if (sky.output.y < 0.5) { color = clamp(color, vec3f(0.0), vec3f(1.0)); color = mix(color * 12.92, 1.055 * pow(color, vec3f(1.0 / 2.4)) - 0.055, step(vec3f(0.0031308), color)); }
757
+ return vec4f(color, 1.0);
758
+ }
759
+ `;
760
+ /** Downsample one mip level into the next with a linear filter. */
761
+ export const MIPMAP_WGSL_3D = /* wgsl */ `
762
+ @group(0) @binding(0) var source: texture_2d<f32>;
763
+ @group(0) @binding(1) var sourceSampler: sampler;
764
+ struct MipOutput {
765
+ @builtin(position) clip: vec4f,
766
+ @location(0) uv: vec2f,
767
+ }
768
+ @vertex
769
+ fn vertexMain(@builtin(vertex_index) index: u32) -> MipOutput {
770
+ let corner = vec2f(f32((index << 1u) & 2u), f32(index & 2u));
771
+ var output: MipOutput;
772
+ output.uv = vec2f(corner.x, 1.0 - corner.y);
773
+ output.clip = vec4f(corner * 2.0 - 1.0, 0.0, 1.0);
774
+ return output;
775
+ }
776
+ @fragment
777
+ fn fragmentMain(input: MipOutput) -> @location(0) vec4f {
778
+ return textureSample(source, sourceSampler, input.uv);
779
+ }
780
+ `;
781
+ //# sourceMappingURL=wgsl3D.js.map