babylonjs-editor-tools-lite 0.0.0-stage → 5.5.4-alpha.1

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 (400) hide show
  1. package/MISSING_FEATURES.md +205 -0
  2. package/build/src/animation/animation-event.js +34 -0
  3. package/build/src/animation/animation-event.js.map +1 -0
  4. package/build/src/animation/animation-group.js +487 -0
  5. package/build/src/animation/animation-group.js.map +1 -0
  6. package/build/src/animation/animation.js +316 -0
  7. package/build/src/animation/animation.js.map +1 -0
  8. package/build/src/animation/parse.js +81 -0
  9. package/build/src/animation/parse.js.map +1 -0
  10. package/build/src/animation/property.js +223 -0
  11. package/build/src/animation/property.js.map +1 -0
  12. package/build/src/cinematic/cinematic.js +21 -0
  13. package/build/src/cinematic/cinematic.js.map +1 -0
  14. package/build/src/cinematic/events/apply-impulse.js +36 -0
  15. package/build/src/cinematic/events/apply-impulse.js.map +1 -0
  16. package/build/src/cinematic/events/event.js +4 -0
  17. package/build/src/cinematic/events/event.js.map +1 -0
  18. package/build/src/cinematic/events/set-enabled.js +7 -0
  19. package/build/src/cinematic/events/set-enabled.js.map +1 -0
  20. package/build/src/cinematic/generate.js +214 -0
  21. package/build/src/cinematic/generate.js.map +1 -0
  22. package/build/src/cinematic/guards.js +16 -0
  23. package/build/src/cinematic/guards.js.map +1 -0
  24. package/build/src/cinematic/parse.js +147 -0
  25. package/build/src/cinematic/parse.js.map +1 -0
  26. package/build/src/cinematic/sequences.js +226 -0
  27. package/build/src/cinematic/sequences.js.map +1 -0
  28. package/build/src/cinematic/tools.js +49 -0
  29. package/build/src/cinematic/tools.js.map +1 -0
  30. package/build/src/cinematic/typings.js +2 -0
  31. package/build/src/cinematic/typings.js.map +1 -0
  32. package/build/src/decorators/apply.js +251 -0
  33. package/build/src/decorators/apply.js.map +1 -0
  34. package/build/src/decorators/events.js +40 -0
  35. package/build/src/decorators/events.js.map +1 -0
  36. package/build/src/decorators/gui.js +18 -0
  37. package/build/src/decorators/gui.js.map +1 -0
  38. package/build/src/decorators/inspector.js +238 -0
  39. package/build/src/decorators/inspector.js.map +1 -0
  40. package/build/src/decorators/particle-systems.js +16 -0
  41. package/build/src/decorators/particle-systems.js.map +1 -0
  42. package/build/src/decorators/scene.js +76 -0
  43. package/build/src/decorators/scene.js.map +1 -0
  44. package/build/src/decorators/sound.js +15 -0
  45. package/build/src/decorators/sound.js.map +1 -0
  46. package/build/src/decorators/sprite.js +31 -0
  47. package/build/src/decorators/sprite.js.map +1 -0
  48. package/build/src/index.js +71 -0
  49. package/build/src/index.js.map +1 -0
  50. package/build/src/loading/brdf.js +9 -0
  51. package/build/src/loading/brdf.js.map +1 -0
  52. package/build/src/loading/camera.js +169 -0
  53. package/build/src/loading/camera.js.map +1 -0
  54. package/build/src/loading/container/container.js +318 -0
  55. package/build/src/loading/container/container.js.map +1 -0
  56. package/build/src/loading/container/entries.js +95 -0
  57. package/build/src/loading/container/entries.js.map +1 -0
  58. package/build/src/loading/database/database.js +241 -0
  59. package/build/src/loading/database/database.js.map +1 -0
  60. package/build/src/loading/database/indexdb.js +56 -0
  61. package/build/src/loading/database/indexdb.js.map +1 -0
  62. package/build/src/loading/database/preload.js +137 -0
  63. package/build/src/loading/database/preload.js.map +1 -0
  64. package/build/src/loading/environment.js +154 -0
  65. package/build/src/loading/environment.js.map +1 -0
  66. package/build/src/loading/gaussian-splatting.js +47 -0
  67. package/build/src/loading/gaussian-splatting.js.map +1 -0
  68. package/build/src/loading/geometry.js +305 -0
  69. package/build/src/loading/geometry.js.map +1 -0
  70. package/build/src/loading/light.js +259 -0
  71. package/build/src/loading/light.js.map +1 -0
  72. package/build/src/loading/loader.js +148 -0
  73. package/build/src/loading/loader.js.map +1 -0
  74. package/build/src/loading/material.js +116 -0
  75. package/build/src/loading/material.js.map +1 -0
  76. package/build/src/loading/materials/image-processing.js +363 -0
  77. package/build/src/loading/materials/image-processing.js.map +1 -0
  78. package/build/src/loading/materials/node.js +121 -0
  79. package/build/src/loading/materials/node.js.map +1 -0
  80. package/build/src/loading/materials/pbr.js +532 -0
  81. package/build/src/loading/materials/pbr.js.map +1 -0
  82. package/build/src/loading/materials/repack.js +287 -0
  83. package/build/src/loading/materials/repack.js.map +1 -0
  84. package/build/src/loading/materials/sky.js +287 -0
  85. package/build/src/loading/materials/sky.js.map +1 -0
  86. package/build/src/loading/materials/standard.js +194 -0
  87. package/build/src/loading/materials/standard.js.map +1 -0
  88. package/build/src/loading/mesh.js +418 -0
  89. package/build/src/loading/mesh.js.map +1 -0
  90. package/build/src/loading/node-particle-system-set.js +59 -0
  91. package/build/src/loading/node-particle-system-set.js.map +1 -0
  92. package/build/src/loading/physics.js +55 -0
  93. package/build/src/loading/physics.js.map +1 -0
  94. package/build/src/loading/rendering.js +55 -0
  95. package/build/src/loading/rendering.js.map +1 -0
  96. package/build/src/loading/scene-parser.js +506 -0
  97. package/build/src/loading/scene-parser.js.map +1 -0
  98. package/build/src/loading/script/apply.js +178 -0
  99. package/build/src/loading/script/apply.js.map +1 -0
  100. package/build/src/loading/script/preload/common.js +16 -0
  101. package/build/src/loading/script/preload/common.js.map +1 -0
  102. package/build/src/loading/script/preload/plugins/gui.js +11 -0
  103. package/build/src/loading/script/preload/plugins/gui.js.map +1 -0
  104. package/build/src/loading/script/preload/plugins/navmesh.js +121 -0
  105. package/build/src/loading/script/preload/plugins/navmesh.js.map +1 -0
  106. package/build/src/loading/script/preload/scene.js +14 -0
  107. package/build/src/loading/script/preload/scene.js.map +1 -0
  108. package/build/src/loading/script/preload.js +156 -0
  109. package/build/src/loading/script/preload.js.map +1 -0
  110. package/build/src/loading/shadows.js +124 -0
  111. package/build/src/loading/shadows.js.map +1 -0
  112. package/build/src/loading/sound.js +335 -0
  113. package/build/src/loading/sound.js.map +1 -0
  114. package/build/src/loading/sprite-manager.js +127 -0
  115. package/build/src/loading/sprite-manager.js.map +1 -0
  116. package/build/src/loading/sprite-map.js +15 -0
  117. package/build/src/loading/sprite-map.js.map +1 -0
  118. package/build/src/loading/texture.js +269 -0
  119. package/build/src/loading/texture.js.map +1 -0
  120. package/build/src/loading/transform-node.js +31 -0
  121. package/build/src/loading/transform-node.js.map +1 -0
  122. package/build/src/rendering/color-grading.js +190 -0
  123. package/build/src/rendering/color-grading.js.map +1 -0
  124. package/build/src/rendering/default/bloom.js +106 -0
  125. package/build/src/rendering/default/bloom.js.map +1 -0
  126. package/build/src/rendering/default/blur.js +186 -0
  127. package/build/src/rendering/default/blur.js.map +1 -0
  128. package/build/src/rendering/default/chromatic-aberration.js +75 -0
  129. package/build/src/rendering/default/chromatic-aberration.js.map +1 -0
  130. package/build/src/rendering/default/depth-of-field.js +170 -0
  131. package/build/src/rendering/default/depth-of-field.js.map +1 -0
  132. package/build/src/rendering/default/fxaa.js +36 -0
  133. package/build/src/rendering/default/fxaa.js.map +1 -0
  134. package/build/src/rendering/default/glow-layer.js +550 -0
  135. package/build/src/rendering/default/glow-layer.js.map +1 -0
  136. package/build/src/rendering/default/grain.js +45 -0
  137. package/build/src/rendering/default/grain.js.map +1 -0
  138. package/build/src/rendering/default/image-processing.js +860 -0
  139. package/build/src/rendering/default/image-processing.js.map +1 -0
  140. package/build/src/rendering/default/pipeline.js +536 -0
  141. package/build/src/rendering/default/pipeline.js.map +1 -0
  142. package/build/src/rendering/default/shaders.js +619 -0
  143. package/build/src/rendering/default/shaders.js.map +1 -0
  144. package/build/src/rendering/default/sharpen.js +46 -0
  145. package/build/src/rendering/default/sharpen.js.map +1 -0
  146. package/build/src/rendering/default-pipeline.js +219 -0
  147. package/build/src/rendering/default-pipeline.js.map +1 -0
  148. package/build/src/rendering/motion-blur/post-process.js +223 -0
  149. package/build/src/rendering/motion-blur/post-process.js.map +1 -0
  150. package/build/src/rendering/motion-blur/shaders.js +83 -0
  151. package/build/src/rendering/motion-blur/shaders.js.map +1 -0
  152. package/build/src/rendering/motion-blur.js +54 -0
  153. package/build/src/rendering/motion-blur.js.map +1 -0
  154. package/build/src/rendering/order.js +33 -0
  155. package/build/src/rendering/order.js.map +1 -0
  156. package/build/src/rendering/pipeline.js +478 -0
  157. package/build/src/rendering/pipeline.js.map +1 -0
  158. package/build/src/rendering/post-process/context.js +8 -0
  159. package/build/src/rendering/post-process/context.js.map +1 -0
  160. package/build/src/rendering/post-process/depth-renderer.js +150 -0
  161. package/build/src/rendering/post-process/depth-renderer.js.map +1 -0
  162. package/build/src/rendering/post-process/geometry.js +303 -0
  163. package/build/src/rendering/post-process/geometry.js.map +1 -0
  164. package/build/src/rendering/post-process/includes.js +455 -0
  165. package/build/src/rendering/post-process/includes.js.map +1 -0
  166. package/build/src/rendering/post-process/jitter.js +23 -0
  167. package/build/src/rendering/post-process/jitter.js.map +1 -0
  168. package/build/src/rendering/post-process/matrix.js +110 -0
  169. package/build/src/rendering/post-process/matrix.js.map +1 -0
  170. package/build/src/rendering/post-process/mesh-materials.js +212 -0
  171. package/build/src/rendering/post-process/mesh-materials.js.map +1 -0
  172. package/build/src/rendering/post-process/mesh-pass.js +780 -0
  173. package/build/src/rendering/post-process/mesh-pass.js.map +1 -0
  174. package/build/src/rendering/post-process/pass.js +426 -0
  175. package/build/src/rendering/post-process/pass.js.map +1 -0
  176. package/build/src/rendering/post-process/pre-pass.js +189 -0
  177. package/build/src/rendering/post-process/pre-pass.js.map +1 -0
  178. package/build/src/rendering/post-process/shader.js +611 -0
  179. package/build/src/rendering/post-process/shader.js.map +1 -0
  180. package/build/src/rendering/post-process/targets.js +79 -0
  181. package/build/src/rendering/post-process/targets.js.map +1 -0
  182. package/build/src/rendering/shaders.js +136 -0
  183. package/build/src/rendering/shaders.js.map +1 -0
  184. package/build/src/rendering/ssao/pipeline.js +440 -0
  185. package/build/src/rendering/ssao/pipeline.js.map +1 -0
  186. package/build/src/rendering/ssao/shaders.js +210 -0
  187. package/build/src/rendering/ssao/shaders.js.map +1 -0
  188. package/build/src/rendering/ssao.js +71 -0
  189. package/build/src/rendering/ssao.js.map +1 -0
  190. package/build/src/rendering/ssr/pipeline.js +464 -0
  191. package/build/src/rendering/ssr/pipeline.js.map +1 -0
  192. package/build/src/rendering/ssr/shaders.js +978 -0
  193. package/build/src/rendering/ssr/shaders.js.map +1 -0
  194. package/build/src/rendering/ssr.js +87 -0
  195. package/build/src/rendering/ssr.js.map +1 -0
  196. package/build/src/rendering/taa/halton.js +84 -0
  197. package/build/src/rendering/taa/halton.js.map +1 -0
  198. package/build/src/rendering/taa/pipeline.js +478 -0
  199. package/build/src/rendering/taa/pipeline.js.map +1 -0
  200. package/build/src/rendering/taa/shaders.js +42 -0
  201. package/build/src/rendering/taa/shaders.js.map +1 -0
  202. package/build/src/rendering/taa.js +56 -0
  203. package/build/src/rendering/taa.js.map +1 -0
  204. package/build/src/rendering/tools.js +94 -0
  205. package/build/src/rendering/tools.js.map +1 -0
  206. package/build/src/rendering/vls.js +33 -0
  207. package/build/src/rendering/vls.js.map +1 -0
  208. package/build/src/rendering/volumetric/depth.js +29 -0
  209. package/build/src/rendering/volumetric/depth.js.map +1 -0
  210. package/build/src/rendering/volumetric/pipeline.js +989 -0
  211. package/build/src/rendering/volumetric/pipeline.js.map +1 -0
  212. package/build/src/rendering/volumetric/selector.js +604 -0
  213. package/build/src/rendering/volumetric/selector.js.map +1 -0
  214. package/build/src/rendering/volumetric/shaders.js +1307 -0
  215. package/build/src/rendering/volumetric/shaders.js.map +1 -0
  216. package/build/src/rendering/volumetric/types.js +327 -0
  217. package/build/src/rendering/volumetric/types.js.map +1 -0
  218. package/build/src/rendering/volumetric-lighting.js +213 -0
  219. package/build/src/rendering/volumetric-lighting.js.map +1 -0
  220. package/build/src/rendering/wgsl.js +377 -0
  221. package/build/src/rendering/wgsl.js.map +1 -0
  222. package/build/src/script.js +2 -0
  223. package/build/src/script.js.map +1 -0
  224. package/build/src/tools/animation.js +42 -0
  225. package/build/src/tools/animation.js.map +1 -0
  226. package/build/src/tools/augmentations.js +2 -0
  227. package/build/src/tools/augmentations.js.map +1 -0
  228. package/build/src/tools/guards.js +292 -0
  229. package/build/src/tools/guards.js.map +1 -0
  230. package/build/src/tools/inputs.js +136 -0
  231. package/build/src/tools/inputs.js.map +1 -0
  232. package/build/src/tools/light.js +115 -0
  233. package/build/src/tools/light.js.map +1 -0
  234. package/build/src/tools/maths.js +98 -0
  235. package/build/src/tools/maths.js.map +1 -0
  236. package/build/src/tools/mesh.js +95 -0
  237. package/build/src/tools/mesh.js.map +1 -0
  238. package/build/src/tools/navmesh.js +6 -0
  239. package/build/src/tools/navmesh.js.map +1 -0
  240. package/build/src/tools/node.js +418 -0
  241. package/build/src/tools/node.js.map +1 -0
  242. package/build/src/tools/observable.js +122 -0
  243. package/build/src/tools/observable.js.map +1 -0
  244. package/build/src/tools/particle.js +2 -0
  245. package/build/src/tools/particle.js.map +1 -0
  246. package/build/src/tools/ragdoll.js +37 -0
  247. package/build/src/tools/ragdoll.js.map +1 -0
  248. package/build/src/tools/request.js +108 -0
  249. package/build/src/tools/request.js.map +1 -0
  250. package/build/src/tools/scalar.js +8 -0
  251. package/build/src/tools/scalar.js.map +1 -0
  252. package/build/src/tools/scene.js +185 -0
  253. package/build/src/tools/scene.js.map +1 -0
  254. package/build/src/tools/sound.js +20 -0
  255. package/build/src/tools/sound.js.map +1 -0
  256. package/build/src/tools/sprite.js +378 -0
  257. package/build/src/tools/sprite.js.map +1 -0
  258. package/build/src/tools/texture.js +100 -0
  259. package/build/src/tools/texture.js.map +1 -0
  260. package/build/src/tools/tools.js +40 -0
  261. package/build/src/tools/tools.js.map +1 -0
  262. package/build/src/tools/vector.js +12 -0
  263. package/build/src/tools/vector.js.map +1 -0
  264. package/build/src/tools/warn.js +14 -0
  265. package/build/src/tools/warn.js.map +1 -0
  266. package/declaration/src/animation/animation-event.d.ts +27 -0
  267. package/declaration/src/animation/animation-group.d.ts +195 -0
  268. package/declaration/src/animation/animation.d.ts +139 -0
  269. package/declaration/src/animation/parse.d.ts +33 -0
  270. package/declaration/src/animation/property.d.ts +33 -0
  271. package/declaration/src/cinematic/cinematic.d.ts +14 -0
  272. package/declaration/src/cinematic/events/apply-impulse.d.ts +8 -0
  273. package/declaration/src/cinematic/events/event.d.ts +5 -0
  274. package/declaration/src/cinematic/events/set-enabled.d.ts +6 -0
  275. package/declaration/src/cinematic/generate.d.ts +18 -0
  276. package/declaration/src/cinematic/guards.d.ts +6 -0
  277. package/declaration/src/cinematic/parse.d.ts +18 -0
  278. package/declaration/src/cinematic/sequences.d.ts +40 -0
  279. package/declaration/src/cinematic/tools.d.ts +14 -0
  280. package/declaration/src/cinematic/typings.d.ts +73 -0
  281. package/declaration/src/decorators/apply.d.ts +78 -0
  282. package/declaration/src/decorators/events.d.ts +26 -0
  283. package/declaration/src/decorators/gui.d.ts +11 -0
  284. package/declaration/src/decorators/inspector.d.ts +139 -0
  285. package/declaration/src/decorators/particle-systems.d.ts +9 -0
  286. package/declaration/src/decorators/scene.d.ts +51 -0
  287. package/declaration/src/decorators/sound.d.ts +17 -0
  288. package/declaration/src/decorators/sprite.d.ts +18 -0
  289. package/declaration/src/index.d.ts +68 -0
  290. package/declaration/src/loading/brdf.d.ts +8 -0
  291. package/declaration/src/loading/camera.d.ts +25 -0
  292. package/declaration/src/loading/container/container.d.ts +77 -0
  293. package/declaration/src/loading/container/entries.d.ts +46 -0
  294. package/declaration/src/loading/database/database.d.ts +89 -0
  295. package/declaration/src/loading/database/indexdb.d.ts +20 -0
  296. package/declaration/src/loading/database/preload.d.ts +61 -0
  297. package/declaration/src/loading/environment.d.ts +44 -0
  298. package/declaration/src/loading/gaussian-splatting.d.ts +19 -0
  299. package/declaration/src/loading/geometry.d.ts +52 -0
  300. package/declaration/src/loading/light.d.ts +76 -0
  301. package/declaration/src/loading/loader.d.ts +93 -0
  302. package/declaration/src/loading/material.d.ts +62 -0
  303. package/declaration/src/loading/materials/image-processing.d.ts +16 -0
  304. package/declaration/src/loading/materials/node.d.ts +27 -0
  305. package/declaration/src/loading/materials/pbr.d.ts +33 -0
  306. package/declaration/src/loading/materials/repack.d.ts +156 -0
  307. package/declaration/src/loading/materials/sky.d.ts +49 -0
  308. package/declaration/src/loading/materials/standard.d.ts +21 -0
  309. package/declaration/src/loading/mesh.d.ts +158 -0
  310. package/declaration/src/loading/node-particle-system-set.d.ts +13 -0
  311. package/declaration/src/loading/physics.d.ts +8 -0
  312. package/declaration/src/loading/rendering.d.ts +2 -0
  313. package/declaration/src/loading/scene-parser.d.ts +88 -0
  314. package/declaration/src/loading/script/apply.d.ts +101 -0
  315. package/declaration/src/loading/script/preload/common.d.ts +10 -0
  316. package/declaration/src/loading/script/preload/plugins/gui.d.ts +6 -0
  317. package/declaration/src/loading/script/preload/plugins/navmesh.d.ts +8 -0
  318. package/declaration/src/loading/script/preload/scene.d.ts +3 -0
  319. package/declaration/src/loading/script/preload.d.ts +34 -0
  320. package/declaration/src/loading/shadows.d.ts +59 -0
  321. package/declaration/src/loading/sound.d.ts +35 -0
  322. package/declaration/src/loading/sprite-manager.d.ts +12 -0
  323. package/declaration/src/loading/sprite-map.d.ts +8 -0
  324. package/declaration/src/loading/texture.d.ts +126 -0
  325. package/declaration/src/loading/transform-node.d.ts +14 -0
  326. package/declaration/src/rendering/color-grading.d.ts +124 -0
  327. package/declaration/src/rendering/default/bloom.d.ts +57 -0
  328. package/declaration/src/rendering/default/blur.d.ts +71 -0
  329. package/declaration/src/rendering/default/chromatic-aberration.d.ts +61 -0
  330. package/declaration/src/rendering/default/depth-of-field.d.ts +74 -0
  331. package/declaration/src/rendering/default/fxaa.d.ts +24 -0
  332. package/declaration/src/rendering/default/glow-layer.d.ts +285 -0
  333. package/declaration/src/rendering/default/grain.d.ts +33 -0
  334. package/declaration/src/rendering/default/image-processing.d.ts +351 -0
  335. package/declaration/src/rendering/default/pipeline.d.ts +249 -0
  336. package/declaration/src/rendering/default/shaders.d.ts +56 -0
  337. package/declaration/src/rendering/default/sharpen.d.ts +33 -0
  338. package/declaration/src/rendering/default-pipeline.d.ts +29 -0
  339. package/declaration/src/rendering/motion-blur/post-process.d.ts +112 -0
  340. package/declaration/src/rendering/motion-blur/shaders.d.ts +4 -0
  341. package/declaration/src/rendering/motion-blur.d.ts +18 -0
  342. package/declaration/src/rendering/order.d.ts +20 -0
  343. package/declaration/src/rendering/pipeline.d.ts +101 -0
  344. package/declaration/src/rendering/post-process/context.d.ts +214 -0
  345. package/declaration/src/rendering/post-process/depth-renderer.d.ts +79 -0
  346. package/declaration/src/rendering/post-process/geometry.d.ts +70 -0
  347. package/declaration/src/rendering/post-process/includes.d.ts +32 -0
  348. package/declaration/src/rendering/post-process/jitter.d.ts +18 -0
  349. package/declaration/src/rendering/post-process/matrix.d.ts +40 -0
  350. package/declaration/src/rendering/post-process/mesh-materials.d.ts +86 -0
  351. package/declaration/src/rendering/post-process/mesh-pass.d.ts +187 -0
  352. package/declaration/src/rendering/post-process/pass.d.ts +167 -0
  353. package/declaration/src/rendering/post-process/pre-pass.d.ts +87 -0
  354. package/declaration/src/rendering/post-process/shader.d.ts +132 -0
  355. package/declaration/src/rendering/post-process/targets.d.ts +43 -0
  356. package/declaration/src/rendering/shaders.d.ts +12 -0
  357. package/declaration/src/rendering/ssao/pipeline.d.ts +211 -0
  358. package/declaration/src/rendering/ssao/shaders.d.ts +8 -0
  359. package/declaration/src/rendering/ssao.d.ts +18 -0
  360. package/declaration/src/rendering/ssr/pipeline.d.ts +274 -0
  361. package/declaration/src/rendering/ssr/shaders.d.ts +20 -0
  362. package/declaration/src/rendering/ssr.d.ts +18 -0
  363. package/declaration/src/rendering/taa/halton.d.ts +47 -0
  364. package/declaration/src/rendering/taa/pipeline.d.ts +199 -0
  365. package/declaration/src/rendering/taa/shaders.d.ts +4 -0
  366. package/declaration/src/rendering/taa.d.ts +19 -0
  367. package/declaration/src/rendering/tools.d.ts +45 -0
  368. package/declaration/src/rendering/vls.d.ts +21 -0
  369. package/declaration/src/rendering/volumetric/depth.d.ts +25 -0
  370. package/declaration/src/rendering/volumetric/pipeline.d.ts +293 -0
  371. package/declaration/src/rendering/volumetric/selector.d.ts +291 -0
  372. package/declaration/src/rendering/volumetric/shaders.d.ts +24 -0
  373. package/declaration/src/rendering/volumetric/types.d.ts +413 -0
  374. package/declaration/src/rendering/volumetric-lighting.d.ts +26 -0
  375. package/declaration/src/rendering/wgsl.d.ts +114 -0
  376. package/declaration/src/script.d.ts +17 -0
  377. package/declaration/src/tools/animation.d.ts +7 -0
  378. package/declaration/src/tools/augmentations.d.ts +82 -0
  379. package/declaration/src/tools/guards.d.ts +158 -0
  380. package/declaration/src/tools/inputs.d.ts +78 -0
  381. package/declaration/src/tools/light.d.ts +31 -0
  382. package/declaration/src/tools/maths.d.ts +52 -0
  383. package/declaration/src/tools/mesh.d.ts +38 -0
  384. package/declaration/src/tools/navmesh.d.ts +8 -0
  385. package/declaration/src/tools/node.d.ts +148 -0
  386. package/declaration/src/tools/observable.d.ts +70 -0
  387. package/declaration/src/tools/particle.d.ts +15 -0
  388. package/declaration/src/tools/ragdoll.d.ts +39 -0
  389. package/declaration/src/tools/request.d.ts +49 -0
  390. package/declaration/src/tools/scalar.d.ts +1 -0
  391. package/declaration/src/tools/scene.d.ts +176 -0
  392. package/declaration/src/tools/sound.d.ts +50 -0
  393. package/declaration/src/tools/sprite.d.ts +244 -0
  394. package/declaration/src/tools/texture.d.ts +40 -0
  395. package/declaration/src/tools/tools.d.ts +20 -0
  396. package/declaration/src/tools/vector.d.ts +6 -0
  397. package/declaration/src/tools/warn.d.ts +6 -0
  398. package/package.json +34 -5
  399. package/vitest.config.ts +8 -0
  400. package/README.md +0 -3
@@ -0,0 +1,205 @@
1
+ # babylonjs-editor-tools-lite — missing features
2
+
3
+ `babylonjs-editor-tools-lite` reproduces the features of `babylonjs-editor-tools` using only [Babylon Lite](https://www.npmjs.com/package/@babylonjs/lite) (`@babylonjs/lite` 1.36.0). Babylon Lite supports fewer features than Babylon.js: this file lists everything the editor can configure that is not supported, only partially supported or emulated by the tools, and the behaviors that differ from the Babylon.js version of the tools.
4
+
5
+ Legend:
6
+
7
+ - **Missing**: not supported, the feature is ignored (a warning is logged once when it is used).
8
+ - **Partial**: supported with limitations.
9
+ - **Emulated**: Babylon Lite has no equivalent, the tools reproduce the behavior on top of Babylon Lite.
10
+
11
+ ## Platform
12
+
13
+ - **Intentional**: WebGPU only. There is no WebGL support, in compatibility mode or otherwise.
14
+ - **Intentional**: only the KTX2 compressed textures (`.ktx2`) are supported. The KTX1 textures generated with a format suffix (`-astc.ktx`, `-dxt.ktx`, `-pvrtc.ktx`, `-etc1.ktx`, `-etc2.ktx`) are not loaded, `configureEngineToUseCompressedTextures` and `addExcludedCompressedTexture` are removed and the offline preload ignores the `.ktx` files. KTX2 textures are enabled using `setUseKtx2CompressedTextures`.
15
+ - **Partial**: the MSAA of the scenes rendered without post-process is the MSAA of the engine (`createEngine`). When rendering pipelines render the camera, the scene is rendered with the samples of the first pipeline, as Babylon.js does (`samples` of the default rendering pipeline and of the SSR, `textureSamples` of the SSAO2, `msaaSamples` of the TAA and of the volumetric lighting), with 1 or 4 samples (the sample counts supported by WebGPU).
16
+
17
+ ## Scene loading
18
+
19
+ - **Partial**: Babylon Lite renders only the registered scenes. `loadScene` registers the scene (with the support of the shadows when the scene contains shadow generators) or rebuilds its renderables when it is already registered (several editor scenes loaded in the same scene). Use `doNotRegisterScene` to register the scene yourself.
20
+ - **Partial**: the physics world must be created by the application (`createHavokWorld`) and given to `loadScene` (`physicsWorld` option): Babylon Lite scenes have no physics engine.
21
+ - **Partial**: the BRDF lookup texture required by Babylon Lite for the image based lighting is embedded in the tools (same texture as Babylon.js). It can be replaced using the `brdfUrl` option.
22
+ - **Missing**: the entities of the scene file that Babylon Lite doesn't support are not loaded: classic particle systems (`ParticleSystem`, `GPUParticleSystem`), reflection probes, lens flare systems, the effect layers saved in the scene file (glow and highlight layers: the glow layer of the default rendering pipeline is supported, see below) and legacy sounds.
23
+ - **Missing**: Babylon Lite has no collision system: the collisions of the scene, the meshes and the cameras (`collisionsEnabled`, `checkCollisions`, `ellipsoid`, collision meshes of the editor) are not applied. The physics (character controller of Babylon Lite) can be used instead.
24
+
25
+ ## Meshes and geometry
26
+
27
+ - **Missing**: skeletons and skinned meshes. Babylon Lite creates skeletons only when loading glTF files: the skinned meshes of the editor scenes are displayed in their bind pose, the bones are not animated and `AdvancedAssetContainerInstantiatedEntries.skeletons` is always empty.
28
+ - **Emulated**: instanced meshes (`InstancedMesh`). Babylon Lite has no instanced mesh: each instance is a clone sharing the geometry (GPU buffers) and the material of its source mesh, available through `mesh.sourceMesh` and identified by `isInstancedMesh`. There is no GPU instancing: each instance is a draw call. Thin instances are supported.
29
+ - **Emulated**: levels of detail. The mesh to display is selected each frame using the distance to the camera, the same way Babylon.js does (`getLOD`). As with Babylon.js, the screen coverages (`lodCoverages`) are ignored. Use `getMeshLodLevels` / `setMeshLodLevelDistance` instead of `getLODLevels`.
30
+ - **Emulated**: billboard modes and infinite distance, updated each frame by the tools.
31
+ - **Emulated**: the enabled and visible states of the nodes (`setNodeEnabled`, `setMeshVisibleState`), the dispose of the nodes (`disposeNode`) and the dispose observables (`getOnDisposeObservable`).
32
+ - **Partial**: multi-materials: each sub-mesh is a mesh of its own (child of the main mesh) as Babylon Lite meshes have one material.
33
+ - **Partial**: morph targets: up to 4 targets per mesh, on PBR materials only. The morph targets are shared between the clones of a mesh (`AdvancedAssetContainer.instantiate`).
34
+ - **Missing**: mesh properties: `visibility`, `renderingGroupId`, `layerMask`, `alphaIndex` (Babylon Lite sorts the transparent meshes by distance only), `applyFog`, overlay (`renderOverlay`, `overlayColor`), outline, edges rendering.
35
+ - **Partial**: Babylon Lite doesn't cull the meshes outside of the camera frustum (except the thin instances): all the visible meshes are drawn, as with `alwaysSelectAsActiveMesh`.
36
+ - **Partial**: the meshes disabled by an asset container (`removeDefault`) stay in the scene but are not rendered: Babylon Lite disposes the meshes removed from their last scene and a disposed mesh can't be cloned anymore.
37
+
38
+ ## Materials
39
+
40
+ ### PBR materials
41
+
42
+ Babylon Lite PBR materials implement the glTF metallic-roughness model. The other channel layouts of Babylon.js are emulated by repacking the textures on the CPU: when the compressed textures are enabled, the original image (`.png`, `.jpg`) exported with the KTX2 texture is repacked, so the repacked textures are not compressed. A texture is used as it is when its original image can't be loaded.
43
+
44
+ - **Emulated**: the metallic textures configured with other channels than the glTF layout (metalness in blue, roughness in green, ambient occlusion in red) are repacked.
45
+ - **Emulated**: `invertNormalMapX` / `invertNormalMapY`. Babylon Lite reads the normal maps as Babylon.js does with `invertNormalMapX = true` and `invertNormalMapY = false`: the other normal maps are repacked (red and/or green channels inverted).
46
+ - **Emulated**: the specular-glossiness workflow (materials without metallic and roughness values, like the PBR materials created in the editor, which are mirrors by default). The reflectivity color is the reflectance of the material, or a specular-glossiness texture is created with the values computed by Babylon.js (reflectivity texture multiplied by the reflectivity color and the level of the texture, micro surface read from the alpha channel or computed from the reflectivity with `useAutoMicroSurfaceFromReflectivityMap`).
47
+ - **Emulated**: the alpha of the material. Babylon Lite reads the alpha from the base color texture: when the material is transparent (alpha blend or alpha test), the alpha channel of the base color texture is computed as Babylon.js computes the alpha (albedo alpha used only with `useAlphaFromAlbedoTexture` or alpha test, opacity texture read from its alpha channel or from the luminance of its color with `getAlphaFromRGB`). Without albedo texture, a white base color texture is created from the opacity texture. An opacity texture with another UV transform than the albedo texture is read with the UV transform of the albedo texture.
48
+ - **Emulated**: the skybox materials (reflection texture in skybox mode, ie. created by `scene.createDefaultSkybox`) are Babylon Lite PBR skyboxes, which display the environment of the scene: the reflection texture of the skybox is expected to be the environment texture of the scene (a warning is logged otherwise).
49
+ - **Emulated**: `disableLighting` disables the lights only (`directIntensity = 0`), the image based lighting is kept as in Babylon.js.
50
+ - **Partial**: the material plugins are partially supported: clear coat, sheen, anisotropy, iridescence and sub-surface translucency. The sub-surface refraction is not supported (Babylon.js refracts the environment texture while Babylon Lite only refracts the scene, as the glTF transmission).
51
+ - **Missing**: parallax and parallax occlusion (Babylon Lite PBR materials have no way to offset the texture coordinates), `zOffset` / `zOffsetUnits` (only the shader materials of Babylon Lite have a depth bias: the decals may z-fight), object space normal maps, micro surface texture, detail maps, hexagonal tiling, OpenPBR properties (`baseWeight`), `specularIntensity`, `ambientColor`, `reflectionColor`, the reflection texture of the materials (except the skyboxes, the environment of the scene is used), `twoSidedLighting`, `useSpecularOverAlpha` / `useRadianceOverAlpha` set to false, `useHorizonOcclusion`, `useRadianceOcclusion`, `useAmbientInGrayScale`, `ambientTextureImpactOnAnalyticalLights`, `useLogarithmicDepth`, alpha modes other than the standard blending, `disableDepthWrite` / `forceDepthWrite` / `needDepthPrePass`, `fogEnabled` per material, stencil, point size, `sideOrientation`.
52
+ - **Emulated**: the image processing configuration saved per material (`_imageProcessingConfiguration`, saved with the materials of some assets). When it isn't applied by a post-process (`applyByPostProcess = false`), Babylon.js applies the image processing of the material in the material, then the default rendering pipeline applies its own on top. Otherwise the material outputs linear colors, processed by the default rendering pipeline only. A material plugin captures the linear color of the material before the image processing of Babylon Lite and applies the one of Babylon.js: exposure, vignette, tone mapping, contrast and color curves of the material, then the image processing of the scene when the default rendering pipeline applies it. The materials without configuration keep the image processing of the scene.
53
+ - the dithering, color grading and white balance of the material configurations are not supported (a warning is logged).
54
+ - the unlit, sheen, sub-surface and refraction features of Babylon Lite change the color after the capture: the linear color is then recovered by inverting the image processing of Babylon Lite, which can't recover the dark tones the tone mapping crushes.
55
+ - **Emulated**: the decoding of the colors of the textures. The shaders of Babylon.js decode the color textures in gamma space (albedo, emissive, reflectivity, reflectance, sheen, lightmap) with the sRGB curve approximated by a 2.2 power, darker in the dark tones than the exact curve of the GPU. The GPU decodes the textures loaded in a sRGB buffer (`_useSRGBBuffer`, the textures imported from glTF files, whose `gammaSpace` is false). The albedo textures in gamma space use the gamma albedo of Babylon Lite (same decoding), the textures in a sRGB buffer are loaded as sRGB textures, and the other color textures are repacked so Babylon Lite (GPU or shaders) decodes them to the same values, with a 8 bits precision.
56
+ - **Partial**: the metallic reflectance (`metallicF0Factor`, `metallicReflectanceColor` and their textures). The PBR materials of Babylon.js use the legacy specular energy conservation by default (`brdf.useLegacySpecularEnergyConservation`): the reflectance at grazing angles (F90) is `metallicF0Factor`, metals included. Babylon Lite uses `mix(metallicF0Factor, 1, metallic)` (the non legacy model of Babylon.js) and has no option for the legacy one: the metallic materials with a `metallicF0Factor` lower than 1 are brighter at grazing angles.
57
+
58
+ ### Standard materials
59
+
60
+ - **Partial**: supported channels: diffuse, ambient, specular (color, power, texture), emissive, bump (`invertNormalMapX` / `invertNormalMapY` emulated by repacking the normal map), opacity, 2D reflection texture, lightmap, alpha, alpha cutoff, back-face culling, `disableLighting`.
61
+ - **Emulated**: the alpha of the diffuse texture used for the alpha blending (`useAlphaFromDiffuseTexture`): Babylon Lite reads it for the alpha test only, the diffuse texture is set as the opacity texture too (combined with the opacity texture of the material, if any). When a transparency mode is set, the alpha cutoff is divided by the alpha of the material, as Babylon.js then tests the alpha of the material multiplied by the alpha of the diffuse texture.
62
+ - **Emulated**: `disableLighting`: Babylon Lite outputs the emissive color multiplied by the diffuse color while Babylon.js outputs their sum (plus the ambient color): the colors are combined when the material has no emissive texture.
63
+ - **Missing**: cube reflection and refraction textures (Babylon Lite standard materials only accept cube textures made of six images while the editor saves `.env` and `.hdr` cube textures), skyboxes (reflection texture in skybox mode), Fresnel parameters, parallax, `twoSidedLighting`, alpha modes, `fogEnabled` per material, material plugins.
64
+
65
+ ### Node materials
66
+
67
+ Node materials are compiled by the node material parser of Babylon Lite.
68
+
69
+ - **Partial**: the blocks not supported by Babylon Lite make the material fail to compile: the meshes use the default material.
70
+ - **Missing**: node materials don't receive the cascaded shadows (only the exponential and PCF shadows).
71
+ - **Partial**: the names of the blocks starting with a digit (ie. `2π`, `0.5`) are prefixed by `_` (Babylon Lite generates invalid WGSL identifiers for them).
72
+ - **Partial**: the node material compiler of Babylon Lite can generate gigantic shaders for some graphs (shared expressions are not stored in temporary variables). The shaders larger than `maxNodeMaterialShaderLength` (2 000 000 characters) are rejected to avoid freezing the page: the meshes use the default material.
73
+ - **Partial**: a texture of a node material that can't be loaded is replaced by a white texture (Babylon Lite requires a texture for each texture block).
74
+ - **Partial**: `convertToGammaSpace` of the texture blocks converts the textures in gamma space too (Babylon.js only converts the textures in linear space). `convertToLinearSpace` behaves as in Babylon.js (the textures are repacked when needed).
75
+
76
+ ### Other materials
77
+
78
+ - **Emulated**: `SkyMaterial` is rendered by a shader material implementing the same sky model (Preetham), with the same properties (`luminance`, `turbidity`, `inclination`, etc.). The fog and the dithering of the sky material are not supported. As with Babylon.js, the sky is not used for the image based lighting (`loadSkyEnvironment` can be used to generate the environment from a sky material).
79
+ - **Missing**: the other materials of the materials library available in the editor (cell, fire, gradient, grid, lava, normal, tri-planar and water materials): the meshes use the default material.
80
+
81
+ ## Textures
82
+
83
+ - **Missing**: the cube textures used by the materials (except the PBR skyboxes, see above), mirror and render target textures, video textures, procedural textures.
84
+ - **Partial**: texture transforms: `uScale`, `vScale`, `uOffset`, `vOffset` and `wAng` (the rotation around the center is converted to the rotation around the origin of Babylon Lite). `uAng` and `vAng` (3D rotations) are not supported.
85
+ - **Partial**: `applyTexturesQuality` loads the textures again with the new quality (Babylon Lite textures are immutable), repacked textures included.
86
+ - **Partial**: the offline database (`setupOfflineProvider`) stores and loads the files requested by the tools (scenes, geometries, textures, sounds) through `addFileLoaderOverride`: the files loaded by your own code with `fetch` don't use the database.
87
+
88
+ ## Lights and shadows
89
+
90
+ - **Partial**: point, spot, directional and hemispheric lights. `radius`, projection textures, `falloffType`, `lightmapMode` and `renderPriority` are not supported.
91
+ - **Partial**: clustered lights: the clustered point and spot lights are plain data in Babylon Lite: the tools create a node for each of them (`ClusteredLightNode`) that the clustered light follows each frame. The clustered lights only light the PBR materials. The clustered light container is added once the scene has an active camera.
92
+ - **Missing**: the shadows of the point lights.
93
+ - **Partial**: shadow generators: PCF (directional and spot lights), exponential shadow maps (directional lights, the exponential shadow maps of the spot lights are rendered as PCF shadow maps) and cascaded shadow maps (directional lights). Contact hardening shadows (PCSS), Poisson sampling, `filteringQuality`, `transparencyShadow`, `forceBackFacesOnly`, `penumbraDarkness`, `depthClamp`, `autoCalcDepthBounds`, `blurBoxOffset`, the shadow frustum settings of the directional lights (`shadowOrthoScale`, `shadowFrustumSize`, `autoUpdateExtends`, ortho extents) and the `refreshRate` of the shadow maps are not supported.
94
+ - **Emulated**: the casters of the shadows are evaluated as the render list predicate of the Babylon.js version of the tools (all the meshes within the range of the light), every few frames instead of each frame. The skyboxes (sky materials and PBR skyboxes) are excluded: their huge bounds break the fitting of the cascaded shadow maps of Babylon Lite.
95
+ - **Partial**: changing the quality of the shadows (`applyShadowsQuality`) creates the shadow generators again and rebuilds the renderables of the scene.
96
+
97
+ ## Cameras and inputs
98
+
99
+ - **Partial**: free, universal, target, touch and gamepad cameras are loaded as Babylon Lite free cameras, arc rotate cameras as arc rotate cameras. Other cameras (follow, VR, XR, etc.) are not supported.
100
+ - **Missing**: camera inputs configuration (keys, mouse, touch and gamepad settings), `upVector` (roll), `lockedTarget`, `layerMask`, the other properties of the arc rotate cameras (`targetScreenOffset`, `allowUpsideDown`, `panningOriginTarget`, etc.).
101
+ - **Partial**: `attachCameraControl` attaches the default inputs of Babylon Lite (orbit for arc rotate cameras, WASD / arrows and mouse look for free cameras).
102
+ - **Emulated**: the pointer and keyboard events of the scene (`onPointerObservable`, `onKeyboardObservable`, `PointerEventTypes`, `KeyboardEventTypes`) and the picking of the pointer events (`pickScene`).
103
+
104
+ ## Animations
105
+
106
+ - **Emulated**: animation groups (`EditorAnimationGroup`) and animations (`EditorAnimation`). The values are evaluated the same way Babylon.js does (linear, step and Hermite interpolations, spherical interpolation of quaternions, easing function) and the playback (range, speed, loop modes, events) is handled by the tools: Babylon Lite animations support neither Hermite tangents nor events.
107
+ - **Missing**: animation blending (`enableBlending`, `blendingSpeed`), weights and additive animations (`weight`, `isAdditive` are kept but not applied), animation masks, `playOrder`, the `Animatable` API, the easing function classes of Babylon.js (use a function `(gradient) => number`).
108
+ - **Missing**: bones animations (no skeletons).
109
+ - **Partial**: matrices are not interpolated (same as Babylon.js by default).
110
+
111
+ ## Rendering pipelines and post-processes
112
+
113
+ The rendering pipelines are rendered by the frame graph tasks of the tools: the scene must be created using `createEditorSceneContext`. The scenes created with the default render task of Babylon Lite are rendered without post-processes: only the exposure, the contrast and the tone mapping apply (to the materials, not to the clear color).
114
+
115
+ - **Emulated**: the default rendering pipeline (`rendering/default`), the SSAO2 (`rendering/ssao`), SSR (`rendering/ssr`) and TAA (`rendering/taa`) rendering pipelines and the motion blur post-process (`rendering/motion-blur`) are custom implementations of the pipelines of Babylon.js 9.27 with WebGPU: same passes, same sizes, formats and samplers of the textures, same order (`renderingPipelinesOrder`) and the WGSL shaders of Babylon.js, run through an adapter reproducing the conventions of Babylon.js (render targets stored upside down, texture and fragment coordinates with their origin at the bottom-left corner). They have the properties and the options of the Babylon.js pipelines and were compared pixel by pixel with Babylon.js (WebGPU, or WebGL2 where Babylon.js fails with WebGPU): the remaining differences are a few 1/255 on a fraction of the pixels, as for the scenes rendered without post-process.
116
+ - default rendering pipeline: image processing (exposure, contrast, tone mapping, vignette, color curves, color grading, white balance, dithering), bloom, depth of field, chromatic aberration, sharpen, grain, FXAA and glow layer. As with Babylon.js, the materials output linear colors when the image processing is applied by the post-process.
117
+ - SSAO2: same random texture and sample sphere, generated using `Math.random` as Babylon.js does (the noise differs from one run to the other, as with Babylon.js), expensive and legacy blurs.
118
+ - SSR: all the options, including the thickness computed from the depth of the back faces, the blur, the attenuations, the environment texture (`ISSREnvironmentTexture`, a cube texture of Babylon Lite), the screen space depth (`useScreenspaceDepth`) and the debug output.
119
+ - TAA: same Halton sequence, history (ping-pong textures), `clampHistory` and `reprojectHistory`. The projection is jittered by offsetting the view projection matrix of the scene, the same way Babylon.js jitters the projection matrix of the camera, including its behaviors: no new jitter while the camera moves, and no jitter at all when the TAA isn't the first post-process of the camera (see "Babylon.js issues found while porting").
120
+ - motion blur: object based (velocity of the meshes, `motionBlurSamples`, `motionStrength`) and screen based (depth of the scene and previous view projection of the camera), scaled by the time elapsed since the previous frame as Babylon.js does (`scene.getAnimationRatio()`).
121
+ - glow layer (`glowLayerEnabled`, `GlowLayer`): the meshes are drawn into the glow map with the color of their glow (emissive color and texture, alpha, alpha test and blending of the PBR and standard materials, as Babylon.js computes them), the glow map is blurred twice and added to the color of the scene before the post-processes. The meshes using another material (node materials, sky materials) are drawn with the neutral color, as Babylon.js does.
122
+ - **Partial**: the geometry textures of the pre-pass renderer read by the SSAO2 and the SSR (depth, normals, reflectivity) are rendered by geometry renderer tasks of Babylon Lite. As with Babylon.js, the transparent meshes are drawn after the opaque meshes, sorted from back to front, and write the geometry where their alpha is greater than their alpha cutoff (PBR materials) or 0.4 (standard materials). The differences: the alpha of the PBR materials doesn't include the luminance of the specular and radiance (`useSpecularOverAlpha`, `useRadianceOverAlpha`) and the alpha channel of the reflectivity (roughness) is blended as the color while Babylon.js adds the alphas.
123
+ - **Emulated**: the velocity of the pre-pass renderer (object based motion blur, reprojection of the TAA) is rendered by the tools, the same way Babylon.js computes it (world matrices and view projection of the previous frame, encoded or linear velocity, alpha of the transparent meshes): the geometry renderer tasks of Babylon Lite compute the motion of the camera only (see "Babylon Lite issues found while porting"). The screen space depth of the pre-pass (SSR `useScreenspaceDepth`) and the depth renderers of Babylon.js (depth of field, back faces of the SSR with `backfaceForceDepthWriteTransparentMeshes`) are rendered the same way: the geometry renderer tasks of Babylon Lite run the whole shaders of the materials to render a depth. These meshes are drawn from their GPU buffers (positions, texture coordinates, vertex colors, thin instances): the morph targets, the skeletons and the baked vertex animations are not applied (`excludeSkinnedMesh` has no effect), and the thin instances keep the velocity of their mesh (the previous matrices of the instances are not tracked). As with the TAA material manager of Babylon.js, the jitter of the reprojection offsets the vertices of the pre-pass once the velocity is computed.
124
+ - **Partial**: motion blur: rendered at the size of the rendering (the `options` ratio of the constructor is not supported).
125
+ - **Partial**: glow layer: the glow map is drawn from the GPU buffers of the meshes (positions, texture coordinates, vertex colors, thin instances): the morph targets, the skeletons and the baked vertex animations are not applied. `referenceMeshToUseItsOwnMaterial`, the rendering groups other than the default one, the MSAA of the glow map (`mainTextureSamples`) and the blend modes of the merge other than "add" and "combine" are not supported. The emissive textures of the PBR materials are loaded a second time for the glow: Babylon Lite decodes them as sRGB textures, whose mipmaps are computed in linear space.
126
+ - **Emulated**: color grading: the `.3dl` lookup tables (`ColorGradingTexture`) and the 2D lookup textures are sampled as 3D textures. The 2D lookup textures are converted when loaded: changing `colorGradingWithGreenDepth` afterwards has no effect. The 2D lookup textures were compared with Babylon.js using WebGL2 (they fail with WebGPU, see below).
127
+ - **Partial**: volumetric lighting rendering pipeline (`rendering/volumetric`), ported from the Babylon.js version of the tools with the same configuration, the same configuration per light (`light.metadata.volumetricLighting`, clustered lights included), the same selection of the lights and the same shaders (raymarching, temporal accumulation, bilateral blur, composition and debug outputs). The differences:
128
+ - Babylon Lite has no shadows for the point lights: the point lights casting volumetric shadows are occluded using the depth buffer, as the Babylon.js version does for the lights without shadow map.
129
+ - the depth of the scene is stored in half floats: the surfaces further than 65504 units are considered as the sky.
130
+ - `depthSource`: as with the Babylon.js version, the depth is read from the pre-pass when another pipeline renders it (SSAO2, SSR, motion blur, reprojection of the TAA). Otherwise the depth of all the surfaces is rendered by a geometry renderer task (`GeometryBuffer`), while the Babylon.js version then renders the opaque and alpha tested surfaces with a depth renderer (when the scene has no geometry buffer renderer).
131
+ - **Missing**: volumetric light scattering post-process. Its configuration functions are kept and return `null`.
132
+ - **Missing**: `sortCameraPostProcesses` / `keepRenderingPipelinesOrdered` do nothing: the order of the post-processes is fixed (`renderingPipelinesOrder`).
133
+
134
+ ## Sounds
135
+
136
+ - **Partial**: sound nodes are played using the audio engine of Babylon Lite (static sounds, spatial sounds, volume, playback rate). The spatial sounds follow their node once the listener is attached (`attachAudioListener`, equivalent of `audioEngine.listener.attach`).
137
+ - **Partial**: changing `playbackRate` applies the next time the sound is played.
138
+
139
+ ## Sprites
140
+
141
+ - **Partial**: sprite managers are rendered by the billboard sprite systems of Babylon Lite. The packed atlases (`.json`) and the grid atlases are supported, the sprite animations, `cellIndex` / `cellRef`, `invertU` / `invertV`, `angle`, `color`, `width` / `height` and `isVisible` too.
142
+ - **Missing**: sprite maps (`SpriteMap`), the picking of the sprites, the blend modes and depth options of the sprite managers.
143
+
144
+ ## Particles
145
+
146
+ - **Partial**: node particle system sets are supported using the node particles of Babylon Lite.
147
+ - **Missing**: `ParticleSystem` and `GPUParticleSystem`. `@particleSystemFromScene` resolves only the node particle systems.
148
+
149
+ ## Physics
150
+
151
+ - **Partial**: physics aggregates are configured as the Babylon.js version of the tools does (shape, mass properties, motion type, friction and restitution) using Havok. The density of the shapes is not supported by Babylon Lite.
152
+ - **Missing**: ragdolls (`applyRagdollJointLimits` is removed, the ragdoll configurations can still be parsed).
153
+
154
+ ## Navigation
155
+
156
+ - **Partial**: the navmesh assets (`.navmesh`) import the data baked by the editor (`navmesh.bin`, `tilecache.bin`) in a navigation plugin of Babylon Lite. Babylon Lite has no public function to import baked navmesh data: the data is imported through the Recast module used by Babylon Lite. When the module is not available, the navmesh is built at runtime from the static meshes and the removal of the isolated areas is not applied.
157
+ - **Partial**: the navigation plugin is a Babylon Lite `NavigationPlugin` (functional API: `computePath`, `createNavCrowd`, etc.) instead of the Babylon.js `RecastJSPlugin`.
158
+
159
+ ## GUI
160
+
161
+ - **Missing**: Babylon.js GUI (`AdvancedDynamicTexture`, `.gui` files): Babylon Lite has no GUI system. `@guiFromAsset` assigns `null` and the `gui` asset parser logs an error.
162
+
163
+ ## Scripts, decorators and asset containers
164
+
165
+ - **Partial**: scripts receive Babylon Lite objects (plain data): they must use the Babylon Lite API. All the decorators are supported (except the GUI, see above).
166
+ - **Partial**: `AdvancedAssetContainer.instantiate` clones the nodes (`doNotInstantiate` is ignored), copies the states kept by the tools (class names, enabled and visible states, levels of detail, behaviors, sounds) and clones the cameras. The clones have no physics aggregate (same as Babylon.js).
167
+ - **Missing**: `AdvancedAssetContainer.container` (Babylon Lite has no asset container): use `entities`, `getNodes()` and `dispose()`.
168
+
169
+ ## Gaussian splatting
170
+
171
+ - **Partial**: gaussian splatting meshes are created from the splats data saved by the editor, one Babylon Lite gaussian splatting mesh per proxy. The spherical harmonics are not supported (Babylon Lite reads them only when loading splat files with `loadSplat`).
172
+
173
+ ## Behavior differences with babylonjs-editor-tools
174
+
175
+ These behaviors of the Babylon.js version of the tools are not reproduced on purpose:
176
+
177
+ - the assets of the scripts that fail to load are not loaded again forever (the preload loop of the Babylon.js version never ends when an asset fails to load).
178
+ - `applyScriptOnObject` stops calling `onUpdate` once the object is disposed.
179
+ - when an asset container is instantiated, the script values referencing another node of the container always reference the instantiated node.
180
+
181
+ ## Babylon Lite issues found while porting
182
+
183
+ - the node material compiler doesn't store shared expressions in temporary variables (a 400 blocks graph generated a 10 MB shader that freezes the page).
184
+ - the node material compiler generates invalid WGSL identifiers for the block names starting with a digit.
185
+ - `loadBabylon` applies the Euler rotations in XYZ order while Babylon.js uses the yaw-pitch-roll (YXZ) order.
186
+ - `addClusteredLightContainer` throws when the scene has no camera yet.
187
+ - the chromatic aberration post-process uses a V axis pointing down (Babylon.js uses a V axis pointing up for `direction` and `centerPosition`).
188
+ - the standard materials with `disableLighting` output `emissive * diffuse` while Babylon.js outputs `diffuse + emissive + ambient`, and they don't use the alpha of the diffuse texture for the alpha blending (both emulated by the tools).
189
+ - a scene with a cascaded shadow generator (directional light) and a PCF shadow generator (spot light) renders nothing: every frame fails with an invalid bind group ("binding index 3 not present in the bind group layout"), also without the tools.
190
+ - the PBR materials have no legacy specular energy conservation (`useLegacySpecularEnergyConservation` of Babylon.js, enabled by default): the F90 of the metallic reflectance is always `mix(specularWeight, 1, metallic)`.
191
+ - the geometry shaders of the standard materials (geometry renderer task) replace the first `return color;` of the fragment shader by the geometry outputs: when the code of a material plugin contains `return color;` (in a helper function), the shader fails to compile (the plugins of the tools avoid it).
192
+ - the velocity rendered by the geometry renderer (`LINEAR_VELOCITY`) is not exactly 0 for the static meshes when the camera doesn't move: the current and previous clip positions are computed with identical matrices but differ by up to 1e-5 (in normalized device coordinates) near the camera on large triangles.
193
+ - the velocity rendered by the geometry renderer for the PBR materials only includes the motion of the camera (`previousViewProjection * worldPosition`): the motion of the meshes is ignored (the standard materials use the previous world matrix of the mesh).
194
+ - the geometry renderer tasks run the whole shaders of the materials (lights, shadows, image based lighting) even when only a depth is requested: rendering a depth costs about as much as rendering the scene (the tools render the depths with their own shaders).
195
+ - the material plugins can't change the color of the PBR materials before the fog and the image processing: `CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION` is injected in the middle of the fragments sorted by name (before the unlit, sheen, sub-surface and refraction fragments), and `CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR` runs after the image processing.
196
+
197
+ ## Babylon.js issues found while porting
198
+
199
+ - with WebGPU, the image processing fails to compile when the color grading uses a 2D lookup texture: the WGSL version of the "imageProcessingFunctions" shader calls `textureSample(txColorTransform, sampler, vec3, vec2)` instead of the `sampleTexture3D` function of the GLSL version.
200
+ - the `.babylon` loader doesn't import the module registering `TransformNode.Parse`: the scenes with transform nodes stop loading after the multi-materials, unless the application imports `@babylonjs/core/Meshes/transformNode` (or the whole `@babylonjs/core`). The error is not reported: `SceneLoader` ignores the error the plugin reports when it returns `true`.
201
+ - with WebGPU, the SSR fails to compile with `attenuateBackfaceReflection`: the WGSL version of `computeAttenuationForIntersection` calls `texelFetch(normalSampler, hitPixel, 0)` (GLSL function, undefined variable) instead of `textureLoad(normalSampler, vec2<i32>(ihitPixel), 0)`.
202
+ - the TAA only jitters the camera when it is the first post-process of the camera: when another post-process renders before it (default rendering pipeline, SSAO2, SSR, volumetric lighting), the TAA jitters the projection matrix after the scene is drawn, and each render target rendered before the next frame is drawn (shadow maps, depth renderers, and the tile mask of the clustered light container that the Babylon.js version of the tools creates for each scene) computes the projection matrix again (`getProjectionMatrix(true)` in `ObjectRenderer.initRender`), removing the jitter: the TAA then blends frames without anti-aliasing them. The tools reproduce this behavior.
203
+ - with WebGPU, the reprojection of the TAA (`reprojectHistory`) makes the PBR materials using a normal map without tangents or receiving cascaded shadows exceed the 16 inter-stage variables allowed by default (`maxInterStageShaderVariables`): their render pipelines are invalid and the meshes are not drawn.
204
+ - with WebGPU, the prepass renderer of a scene using SSAO2, the motion blur and the TAA together exceeds `maxColorAttachmentBytesPerSample` (34 bytes for 32): Babylon.js doesn't request the higher limit the adapter supports.
205
+ - with WebGPU, the object based motion blur makes the PBR materials receiving cascaded shadows exceed the 16 inter-stage variables allowed by default (velocity of the pre-pass, same as the reprojection of the TAA): the meshes are not drawn.
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Defines an event raised when an animation reaches a given frame, the equivalent of a Babylon.js `AnimationEvent`.
3
+ * Babylon Lite animations have no events: the events are raised by the animation groups of the tools.
4
+ */
5
+ export class EditorAnimationEvent {
6
+ /**
7
+ * Defines the frame of the animation at which the event is raised.
8
+ */
9
+ frame;
10
+ /**
11
+ * Defines the callback called when the event is raised, with the current frame of the animation.
12
+ */
13
+ action;
14
+ /**
15
+ * Defines wether or not the event is raised only once, even when the animation loops.
16
+ */
17
+ onlyOnce;
18
+ /**
19
+ * @internal
20
+ */
21
+ _isDone = false;
22
+ constructor(frame, action, onlyOnce) {
23
+ this.frame = frame;
24
+ this.action = action;
25
+ this.onlyOnce = onlyOnce ?? false;
26
+ }
27
+ /**
28
+ * Clones the event.
29
+ */
30
+ clone() {
31
+ return new EditorAnimationEvent(this.frame, this.action, this.onlyOnce);
32
+ }
33
+ }
34
+ //# sourceMappingURL=animation-event.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"animation-event.js","sourceRoot":"","sources":["../../../src/animation/animation-event.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAChC;;OAEG;IACI,KAAK,CAAS;IACrB;;OAEG;IACI,MAAM,CAAiC;IAC9C;;OAEG;IACI,QAAQ,CAAU;IAEzB;;OAEG;IACI,OAAO,GAAY,KAAK,CAAC;IAEhC,YAAmB,KAAa,EAAE,MAAsC,EAAE,QAAkB;QAC3F,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,KAAK,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,KAAK;QACX,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;CACD"}