vc-spaces365-threejs 0.180.0

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 (1120) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +86 -0
  3. package/build/three.cjs +77750 -0
  4. package/build/three.core.js +58846 -0
  5. package/build/three.core.min.js +6 -0
  6. package/build/three.module.js +18484 -0
  7. package/build/three.module.min.js +6 -0
  8. package/build/three.tsl.js +636 -0
  9. package/build/three.tsl.min.js +6 -0
  10. package/build/three.webgpu.js +77332 -0
  11. package/build/three.webgpu.min.js +6 -0
  12. package/build/three.webgpu.nodes.js +77103 -0
  13. package/build/three.webgpu.nodes.min.js +6 -0
  14. package/examples/fonts/LICENSE +13 -0
  15. package/examples/fonts/README.md +11 -0
  16. package/examples/fonts/droid/NOTICE +190 -0
  17. package/examples/fonts/droid/README.txt +18 -0
  18. package/examples/fonts/droid/droid_sans_bold.typeface.json +1 -0
  19. package/examples/fonts/droid/droid_sans_mono_regular.typeface.json +1 -0
  20. package/examples/fonts/droid/droid_sans_regular.typeface.json +1 -0
  21. package/examples/fonts/droid/droid_serif_bold.typeface.json +1 -0
  22. package/examples/fonts/droid/droid_serif_regular.typeface.json +1 -0
  23. package/examples/fonts/gentilis_bold.typeface.json +1 -0
  24. package/examples/fonts/gentilis_regular.typeface.json +1 -0
  25. package/examples/fonts/helvetiker_bold.typeface.json +1 -0
  26. package/examples/fonts/helvetiker_regular.typeface.json +1 -0
  27. package/examples/fonts/optimer_bold.typeface.json +1 -0
  28. package/examples/fonts/optimer_regular.typeface.json +1 -0
  29. package/examples/fonts/ttf/README.md +9 -0
  30. package/examples/fonts/ttf/kenpixel.ttf +0 -0
  31. package/examples/jsm/Addons.js +285 -0
  32. package/examples/jsm/animation/AnimationClipCreator.js +168 -0
  33. package/examples/jsm/animation/CCDIKSolver.js +591 -0
  34. package/examples/jsm/capabilities/WebGL.js +113 -0
  35. package/examples/jsm/capabilities/WebGPU.js +59 -0
  36. package/examples/jsm/controls/ArcballControls.js +3536 -0
  37. package/examples/jsm/controls/DragControls.js +452 -0
  38. package/examples/jsm/controls/FirstPersonControls.js +447 -0
  39. package/examples/jsm/controls/FlyControls.js +380 -0
  40. package/examples/jsm/controls/MapControls.js +62 -0
  41. package/examples/jsm/controls/OrbitControls.js +1860 -0
  42. package/examples/jsm/controls/PointerLockControls.js +264 -0
  43. package/examples/jsm/controls/TrackballControls.js +1001 -0
  44. package/examples/jsm/controls/TransformControls.js +1918 -0
  45. package/examples/jsm/csm/CSM.js +597 -0
  46. package/examples/jsm/csm/CSMFrustum.js +209 -0
  47. package/examples/jsm/csm/CSMHelper.js +243 -0
  48. package/examples/jsm/csm/CSMShader.js +307 -0
  49. package/examples/jsm/csm/CSMShadowNode.js +599 -0
  50. package/examples/jsm/curves/CurveExtras.js +694 -0
  51. package/examples/jsm/curves/NURBSCurve.js +155 -0
  52. package/examples/jsm/curves/NURBSSurface.js +98 -0
  53. package/examples/jsm/curves/NURBSUtils.js +532 -0
  54. package/examples/jsm/curves/NURBSVolume.js +82 -0
  55. package/examples/jsm/effects/AnaglyphEffect.js +179 -0
  56. package/examples/jsm/effects/AsciiEffect.js +310 -0
  57. package/examples/jsm/effects/OutlineEffect.js +489 -0
  58. package/examples/jsm/effects/ParallaxBarrierEffect.js +155 -0
  59. package/examples/jsm/effects/StereoEffect.js +91 -0
  60. package/examples/jsm/environments/DebugEnvironment.js +102 -0
  61. package/examples/jsm/environments/RoomEnvironment.js +182 -0
  62. package/examples/jsm/exporters/DRACOExporter.js +311 -0
  63. package/examples/jsm/exporters/EXRExporter.js +618 -0
  64. package/examples/jsm/exporters/GLTFExporter.js +3595 -0
  65. package/examples/jsm/exporters/KTX2Exporter.js +347 -0
  66. package/examples/jsm/exporters/OBJExporter.js +308 -0
  67. package/examples/jsm/exporters/PLYExporter.js +562 -0
  68. package/examples/jsm/exporters/STLExporter.js +221 -0
  69. package/examples/jsm/exporters/USDZExporter.js +1228 -0
  70. package/examples/jsm/geometries/BoxLineGeometry.js +92 -0
  71. package/examples/jsm/geometries/ConvexGeometry.js +72 -0
  72. package/examples/jsm/geometries/DecalGeometry.js +420 -0
  73. package/examples/jsm/geometries/ParametricFunctions.js +100 -0
  74. package/examples/jsm/geometries/ParametricGeometry.js +172 -0
  75. package/examples/jsm/geometries/RoundedBoxGeometry.js +216 -0
  76. package/examples/jsm/geometries/TeapotGeometry.js +689 -0
  77. package/examples/jsm/geometries/TextGeometry.js +83 -0
  78. package/examples/jsm/helpers/LightProbeHelper.js +165 -0
  79. package/examples/jsm/helpers/LightProbeHelperGPU.js +102 -0
  80. package/examples/jsm/helpers/OctreeHelper.js +109 -0
  81. package/examples/jsm/helpers/PositionalAudioHelper.js +169 -0
  82. package/examples/jsm/helpers/RapierHelper.js +59 -0
  83. package/examples/jsm/helpers/RectAreaLightHelper.js +118 -0
  84. package/examples/jsm/helpers/TextureHelper.js +265 -0
  85. package/examples/jsm/helpers/TextureHelperGPU.js +214 -0
  86. package/examples/jsm/helpers/VertexNormalsHelper.js +155 -0
  87. package/examples/jsm/helpers/VertexTangentsHelper.js +133 -0
  88. package/examples/jsm/helpers/ViewHelper.js +422 -0
  89. package/examples/jsm/interactive/HTMLMesh.js +605 -0
  90. package/examples/jsm/interactive/InteractiveGroup.js +224 -0
  91. package/examples/jsm/interactive/SelectionBox.js +294 -0
  92. package/examples/jsm/interactive/SelectionHelper.js +150 -0
  93. package/examples/jsm/libs/ammo.wasm.js +822 -0
  94. package/examples/jsm/libs/ammo.wasm.wasm +0 -0
  95. package/examples/jsm/libs/basis/README.md +46 -0
  96. package/examples/jsm/libs/basis/basis_transcoder.js +19 -0
  97. package/examples/jsm/libs/basis/basis_transcoder.wasm +0 -0
  98. package/examples/jsm/libs/chevrotain.module.min.js +141 -0
  99. package/examples/jsm/libs/demuxer_mp4.js +109 -0
  100. package/examples/jsm/libs/draco/README.md +32 -0
  101. package/examples/jsm/libs/draco/draco_decoder.js +34 -0
  102. package/examples/jsm/libs/draco/draco_decoder.wasm +0 -0
  103. package/examples/jsm/libs/draco/draco_encoder.js +33 -0
  104. package/examples/jsm/libs/draco/draco_wasm_wrapper.js +117 -0
  105. package/examples/jsm/libs/draco/gltf/draco_decoder.js +33 -0
  106. package/examples/jsm/libs/draco/gltf/draco_decoder.wasm +0 -0
  107. package/examples/jsm/libs/draco/gltf/draco_encoder.js +33 -0
  108. package/examples/jsm/libs/draco/gltf/draco_wasm_wrapper.js +116 -0
  109. package/examples/jsm/libs/ecsy.module.js +1792 -0
  110. package/examples/jsm/libs/fflate.module.js +2672 -0
  111. package/examples/jsm/libs/ktx-parse.module.js +1 -0
  112. package/examples/jsm/libs/lil-gui.module.min.js +8 -0
  113. package/examples/jsm/libs/lottie_canvas.module.js +14849 -0
  114. package/examples/jsm/libs/meshopt_decoder.module.js +195 -0
  115. package/examples/jsm/libs/mikktspace.module.js +128 -0
  116. package/examples/jsm/libs/motion-controllers.module.js +397 -0
  117. package/examples/jsm/libs/opentype.module.js +14506 -0
  118. package/examples/jsm/libs/potpack.module.js +125 -0
  119. package/examples/jsm/libs/rhino3dm/rhino3dm.js +21 -0
  120. package/examples/jsm/libs/rhino3dm/rhino3dm.module.js +16 -0
  121. package/examples/jsm/libs/rhino3dm/rhino3dm.wasm +0 -0
  122. package/examples/jsm/libs/stats.module.js +167 -0
  123. package/examples/jsm/libs/surfaceNet.js +201 -0
  124. package/examples/jsm/libs/tween.module.js +876 -0
  125. package/examples/jsm/libs/utif.module.js +1665 -0
  126. package/examples/jsm/libs/zstddec.module.js +1 -0
  127. package/examples/jsm/lighting/TiledLighting.js +42 -0
  128. package/examples/jsm/lights/LightProbeGenerator.js +337 -0
  129. package/examples/jsm/lights/RectAreaLightTexturesLib.js +127 -0
  130. package/examples/jsm/lights/RectAreaLightUniformsLib.js +40 -0
  131. package/examples/jsm/lines/Line2.js +56 -0
  132. package/examples/jsm/lines/LineGeometry.js +157 -0
  133. package/examples/jsm/lines/LineMaterial.js +697 -0
  134. package/examples/jsm/lines/LineSegments2.js +426 -0
  135. package/examples/jsm/lines/LineSegmentsGeometry.js +298 -0
  136. package/examples/jsm/lines/Wireframe.js +108 -0
  137. package/examples/jsm/lines/WireframeGeometry2.js +49 -0
  138. package/examples/jsm/lines/webgpu/Line2.js +46 -0
  139. package/examples/jsm/lines/webgpu/LineSegments2.js +411 -0
  140. package/examples/jsm/lines/webgpu/Wireframe.js +86 -0
  141. package/examples/jsm/loaders/3DMLoader.js +1835 -0
  142. package/examples/jsm/loaders/3MFLoader.js +1621 -0
  143. package/examples/jsm/loaders/AMFLoader.js +541 -0
  144. package/examples/jsm/loaders/BVHLoader.js +484 -0
  145. package/examples/jsm/loaders/ColladaLoader.js +4155 -0
  146. package/examples/jsm/loaders/DDSLoader.js +385 -0
  147. package/examples/jsm/loaders/DRACOLoader.js +688 -0
  148. package/examples/jsm/loaders/EXRLoader.js +2784 -0
  149. package/examples/jsm/loaders/FBXLoader.js +4382 -0
  150. package/examples/jsm/loaders/FontLoader.js +242 -0
  151. package/examples/jsm/loaders/GCodeLoader.js +292 -0
  152. package/examples/jsm/loaders/GLTFLoader.js +4890 -0
  153. package/examples/jsm/loaders/HDRCubeTextureLoader.js +164 -0
  154. package/examples/jsm/loaders/HDRLoader.js +486 -0
  155. package/examples/jsm/loaders/IESLoader.js +379 -0
  156. package/examples/jsm/loaders/KMZLoader.js +163 -0
  157. package/examples/jsm/loaders/KTX2Loader.js +1228 -0
  158. package/examples/jsm/loaders/KTXLoader.js +197 -0
  159. package/examples/jsm/loaders/LDrawLoader.js +2519 -0
  160. package/examples/jsm/loaders/LUT3dlLoader.js +205 -0
  161. package/examples/jsm/loaders/LUTCubeLoader.js +190 -0
  162. package/examples/jsm/loaders/LUTImageLoader.js +190 -0
  163. package/examples/jsm/loaders/LWOLoader.js +1079 -0
  164. package/examples/jsm/loaders/LottieLoader.js +130 -0
  165. package/examples/jsm/loaders/MD2Loader.js +435 -0
  166. package/examples/jsm/loaders/MDDLoader.js +147 -0
  167. package/examples/jsm/loaders/MTLLoader.js +593 -0
  168. package/examples/jsm/loaders/MaterialXLoader.js +1087 -0
  169. package/examples/jsm/loaders/NRRDLoader.js +718 -0
  170. package/examples/jsm/loaders/OBJLoader.js +955 -0
  171. package/examples/jsm/loaders/PCDLoader.js +618 -0
  172. package/examples/jsm/loaders/PDBLoader.js +272 -0
  173. package/examples/jsm/loaders/PLYLoader.js +805 -0
  174. package/examples/jsm/loaders/PVRLoader.js +270 -0
  175. package/examples/jsm/loaders/RGBELoader.js +18 -0
  176. package/examples/jsm/loaders/STLLoader.js +421 -0
  177. package/examples/jsm/loaders/SVGLoader.js +3267 -0
  178. package/examples/jsm/loaders/TDSLoader.js +1144 -0
  179. package/examples/jsm/loaders/TGALoader.js +540 -0
  180. package/examples/jsm/loaders/TIFFLoader.js +59 -0
  181. package/examples/jsm/loaders/TTFLoader.js +261 -0
  182. package/examples/jsm/loaders/USDLoader.js +219 -0
  183. package/examples/jsm/loaders/USDZLoader.js +16 -0
  184. package/examples/jsm/loaders/UltraHDRLoader.js +630 -0
  185. package/examples/jsm/loaders/VOXLoader.js +376 -0
  186. package/examples/jsm/loaders/VRMLLoader.js +3569 -0
  187. package/examples/jsm/loaders/VTKLoader.js +1276 -0
  188. package/examples/jsm/loaders/XYZLoader.js +143 -0
  189. package/examples/jsm/loaders/lwo/IFFParser.js +1217 -0
  190. package/examples/jsm/loaders/lwo/LWO2Parser.js +414 -0
  191. package/examples/jsm/loaders/lwo/LWO3Parser.js +373 -0
  192. package/examples/jsm/loaders/usd/USDAParser.js +741 -0
  193. package/examples/jsm/loaders/usd/USDCParser.js +17 -0
  194. package/examples/jsm/materials/LDrawConditionalLineMaterial.js +183 -0
  195. package/examples/jsm/materials/LDrawConditionalLineNodeMaterial.js +154 -0
  196. package/examples/jsm/materials/MeshGouraudMaterial.js +434 -0
  197. package/examples/jsm/materials/MeshPostProcessingMaterial.js +167 -0
  198. package/examples/jsm/materials/WoodNodeMaterial.js +533 -0
  199. package/examples/jsm/math/Capsule.js +159 -0
  200. package/examples/jsm/math/ColorConverter.js +58 -0
  201. package/examples/jsm/math/ColorSpaces.js +147 -0
  202. package/examples/jsm/math/ConvexHull.js +1695 -0
  203. package/examples/jsm/math/ImprovedNoise.js +88 -0
  204. package/examples/jsm/math/Lut.js +317 -0
  205. package/examples/jsm/math/MeshSurfaceSampler.js +315 -0
  206. package/examples/jsm/math/OBB.js +535 -0
  207. package/examples/jsm/math/Octree.js +692 -0
  208. package/examples/jsm/math/SimplexNoise.js +470 -0
  209. package/examples/jsm/misc/ConvexObjectBreaker.js +539 -0
  210. package/examples/jsm/misc/GPUComputationRenderer.js +506 -0
  211. package/examples/jsm/misc/Gyroscope.js +78 -0
  212. package/examples/jsm/misc/MD2Character.js +391 -0
  213. package/examples/jsm/misc/MD2CharacterComplex.js +740 -0
  214. package/examples/jsm/misc/MorphAnimMesh.js +119 -0
  215. package/examples/jsm/misc/MorphBlendMesh.js +425 -0
  216. package/examples/jsm/misc/ProgressiveLightMap.js +370 -0
  217. package/examples/jsm/misc/ProgressiveLightMapGPU.js +322 -0
  218. package/examples/jsm/misc/RollerCoaster.js +623 -0
  219. package/examples/jsm/misc/TubePainter.js +256 -0
  220. package/examples/jsm/misc/Volume.js +521 -0
  221. package/examples/jsm/misc/VolumeSlice.js +276 -0
  222. package/examples/jsm/modifiers/CurveModifier.js +374 -0
  223. package/examples/jsm/modifiers/CurveModifierGPU.js +256 -0
  224. package/examples/jsm/modifiers/EdgeSplitModifier.js +299 -0
  225. package/examples/jsm/modifiers/SimplifyModifier.js +632 -0
  226. package/examples/jsm/modifiers/TessellateModifier.js +340 -0
  227. package/examples/jsm/objects/GroundedSkybox.js +69 -0
  228. package/examples/jsm/objects/Lensflare.js +489 -0
  229. package/examples/jsm/objects/LensflareMesh.js +376 -0
  230. package/examples/jsm/objects/MarchingCubes.js +1261 -0
  231. package/examples/jsm/objects/Reflector.js +338 -0
  232. package/examples/jsm/objects/ReflectorForSSRPass.js +393 -0
  233. package/examples/jsm/objects/Refractor.js +389 -0
  234. package/examples/jsm/objects/ShadowMesh.js +130 -0
  235. package/examples/jsm/objects/Sky.js +237 -0
  236. package/examples/jsm/objects/SkyMesh.js +243 -0
  237. package/examples/jsm/objects/Water.js +373 -0
  238. package/examples/jsm/objects/Water2.js +401 -0
  239. package/examples/jsm/objects/Water2Mesh.js +199 -0
  240. package/examples/jsm/objects/WaterMesh.js +196 -0
  241. package/examples/jsm/offscreen/jank.js +45 -0
  242. package/examples/jsm/offscreen/offscreen.js +8 -0
  243. package/examples/jsm/offscreen/scene.js +86 -0
  244. package/examples/jsm/physics/AmmoPhysics.js +354 -0
  245. package/examples/jsm/physics/JoltPhysics.js +330 -0
  246. package/examples/jsm/physics/RapierPhysics.js +432 -0
  247. package/examples/jsm/postprocessing/AfterimagePass.js +185 -0
  248. package/examples/jsm/postprocessing/BloomPass.js +274 -0
  249. package/examples/jsm/postprocessing/BokehPass.js +218 -0
  250. package/examples/jsm/postprocessing/ClearPass.js +97 -0
  251. package/examples/jsm/postprocessing/CubeTexturePass.js +146 -0
  252. package/examples/jsm/postprocessing/DotScreenPass.js +114 -0
  253. package/examples/jsm/postprocessing/EffectComposer.js +363 -0
  254. package/examples/jsm/postprocessing/FXAAPass.js +40 -0
  255. package/examples/jsm/postprocessing/FilmPass.js +113 -0
  256. package/examples/jsm/postprocessing/GTAOPass.js +727 -0
  257. package/examples/jsm/postprocessing/GlitchPass.js +177 -0
  258. package/examples/jsm/postprocessing/HalftonePass.js +134 -0
  259. package/examples/jsm/postprocessing/LUTPass.js +138 -0
  260. package/examples/jsm/postprocessing/MaskPass.js +195 -0
  261. package/examples/jsm/postprocessing/OutlinePass.js +776 -0
  262. package/examples/jsm/postprocessing/OutputPass.js +139 -0
  263. package/examples/jsm/postprocessing/Pass.js +191 -0
  264. package/examples/jsm/postprocessing/RenderPass.js +183 -0
  265. package/examples/jsm/postprocessing/RenderPixelatedPass.js +314 -0
  266. package/examples/jsm/postprocessing/RenderTransitionPass.js +267 -0
  267. package/examples/jsm/postprocessing/SAOPass.js +407 -0
  268. package/examples/jsm/postprocessing/SMAAPass.js +230 -0
  269. package/examples/jsm/postprocessing/SSAARenderPass.js +313 -0
  270. package/examples/jsm/postprocessing/SSAOPass.js +527 -0
  271. package/examples/jsm/postprocessing/SSRPass.js +856 -0
  272. package/examples/jsm/postprocessing/SavePass.js +132 -0
  273. package/examples/jsm/postprocessing/ShaderPass.js +135 -0
  274. package/examples/jsm/postprocessing/TAARenderPass.js +243 -0
  275. package/examples/jsm/postprocessing/TexturePass.js +131 -0
  276. package/examples/jsm/postprocessing/UnrealBloomPass.js +492 -0
  277. package/examples/jsm/renderers/CSS2DRenderer.js +317 -0
  278. package/examples/jsm/renderers/CSS3DRenderer.js +453 -0
  279. package/examples/jsm/renderers/Projector.js +936 -0
  280. package/examples/jsm/renderers/SVGRenderer.js +685 -0
  281. package/examples/jsm/shaders/ACESFilmicToneMappingShader.js +96 -0
  282. package/examples/jsm/shaders/AfterimageShader.js +63 -0
  283. package/examples/jsm/shaders/BasicShader.js +36 -0
  284. package/examples/jsm/shaders/BleachBypassShader.js +68 -0
  285. package/examples/jsm/shaders/BlendShader.js +56 -0
  286. package/examples/jsm/shaders/BokehShader.js +151 -0
  287. package/examples/jsm/shaders/BokehShader2.js +404 -0
  288. package/examples/jsm/shaders/BrightnessContrastShader.js +62 -0
  289. package/examples/jsm/shaders/ColorCorrectionShader.js +59 -0
  290. package/examples/jsm/shaders/ColorifyShader.js +57 -0
  291. package/examples/jsm/shaders/ConvolutionShader.js +74 -0
  292. package/examples/jsm/shaders/CopyShader.js +52 -0
  293. package/examples/jsm/shaders/DOFMipMapShader.js +63 -0
  294. package/examples/jsm/shaders/DepthLimitedBlurShader.js +180 -0
  295. package/examples/jsm/shaders/DigitalGlitch.js +104 -0
  296. package/examples/jsm/shaders/DotScreenShader.js +75 -0
  297. package/examples/jsm/shaders/ExposureShader.js +51 -0
  298. package/examples/jsm/shaders/FXAAShader.js +298 -0
  299. package/examples/jsm/shaders/FilmShader.js +72 -0
  300. package/examples/jsm/shaders/FocusShader.js +94 -0
  301. package/examples/jsm/shaders/FreiChenShader.js +103 -0
  302. package/examples/jsm/shaders/GTAOShader.js +421 -0
  303. package/examples/jsm/shaders/GammaCorrectionShader.js +52 -0
  304. package/examples/jsm/shaders/GodRaysShader.js +333 -0
  305. package/examples/jsm/shaders/HalftoneShader.js +321 -0
  306. package/examples/jsm/shaders/HorizontalBlurShader.js +68 -0
  307. package/examples/jsm/shaders/HorizontalTiltShiftShader.js +70 -0
  308. package/examples/jsm/shaders/HueSaturationShader.js +74 -0
  309. package/examples/jsm/shaders/KaleidoShader.js +65 -0
  310. package/examples/jsm/shaders/LuminosityHighPassShader.js +68 -0
  311. package/examples/jsm/shaders/LuminosityShader.js +54 -0
  312. package/examples/jsm/shaders/MirrorShader.js +62 -0
  313. package/examples/jsm/shaders/NormalMapShader.js +60 -0
  314. package/examples/jsm/shaders/OutputShader.js +103 -0
  315. package/examples/jsm/shaders/PoissonDenoiseShader.js +235 -0
  316. package/examples/jsm/shaders/RGBShiftShader.js +61 -0
  317. package/examples/jsm/shaders/SAOShader.js +188 -0
  318. package/examples/jsm/shaders/SMAAShader.js +489 -0
  319. package/examples/jsm/shaders/SSAOShader.js +321 -0
  320. package/examples/jsm/shaders/SSRShader.js +395 -0
  321. package/examples/jsm/shaders/SepiaShader.js +57 -0
  322. package/examples/jsm/shaders/SobelOperatorShader.js +98 -0
  323. package/examples/jsm/shaders/SubsurfaceScatteringShader.js +95 -0
  324. package/examples/jsm/shaders/TechnicolorShader.js +51 -0
  325. package/examples/jsm/shaders/ToonShader.js +349 -0
  326. package/examples/jsm/shaders/TriangleBlurShader.js +79 -0
  327. package/examples/jsm/shaders/UnpackDepthRGBAShader.js +62 -0
  328. package/examples/jsm/shaders/VelocityShader.js +137 -0
  329. package/examples/jsm/shaders/VerticalBlurShader.js +66 -0
  330. package/examples/jsm/shaders/VerticalTiltShiftShader.js +70 -0
  331. package/examples/jsm/shaders/VignetteShader.js +56 -0
  332. package/examples/jsm/shaders/VolumeShader.js +298 -0
  333. package/examples/jsm/shaders/WaterRefractionShader.js +106 -0
  334. package/examples/jsm/textures/FlakesTexture.js +54 -0
  335. package/examples/jsm/textures/IESTexture.js +101 -0
  336. package/examples/jsm/transpiler/AST.js +631 -0
  337. package/examples/jsm/transpiler/GLSLDecoder.js +1171 -0
  338. package/examples/jsm/transpiler/Linker.js +327 -0
  339. package/examples/jsm/transpiler/ShaderToyDecoder.js +49 -0
  340. package/examples/jsm/transpiler/TSLEncoder.js +933 -0
  341. package/examples/jsm/transpiler/Transpiler.js +67 -0
  342. package/examples/jsm/transpiler/TranspilerUtils.js +29 -0
  343. package/examples/jsm/transpiler/WGSLEncoder.js +812 -0
  344. package/examples/jsm/tsl/display/AfterImageNode.js +242 -0
  345. package/examples/jsm/tsl/display/AnaglyphPassNode.js +107 -0
  346. package/examples/jsm/tsl/display/AnamorphicNode.js +281 -0
  347. package/examples/jsm/tsl/display/BleachBypass.js +33 -0
  348. package/examples/jsm/tsl/display/BloomNode.js +520 -0
  349. package/examples/jsm/tsl/display/ChromaticAberrationNode.js +207 -0
  350. package/examples/jsm/tsl/display/DenoiseNode.js +332 -0
  351. package/examples/jsm/tsl/display/DepthOfFieldNode.js +547 -0
  352. package/examples/jsm/tsl/display/DotScreenNode.js +104 -0
  353. package/examples/jsm/tsl/display/FXAANode.js +365 -0
  354. package/examples/jsm/tsl/display/FilmNode.js +101 -0
  355. package/examples/jsm/tsl/display/GTAONode.js +530 -0
  356. package/examples/jsm/tsl/display/GaussianBlurNode.js +378 -0
  357. package/examples/jsm/tsl/display/LensflareNode.js +279 -0
  358. package/examples/jsm/tsl/display/Lut3DNode.js +109 -0
  359. package/examples/jsm/tsl/display/MotionBlur.js +33 -0
  360. package/examples/jsm/tsl/display/OutlineNode.js +751 -0
  361. package/examples/jsm/tsl/display/ParallaxBarrierPassNode.js +89 -0
  362. package/examples/jsm/tsl/display/PixelationPassNode.js +334 -0
  363. package/examples/jsm/tsl/display/RGBShiftNode.js +96 -0
  364. package/examples/jsm/tsl/display/SMAANode.js +768 -0
  365. package/examples/jsm/tsl/display/SSAAPassNode.js +358 -0
  366. package/examples/jsm/tsl/display/SSGINode.js +650 -0
  367. package/examples/jsm/tsl/display/SSRNode.js +654 -0
  368. package/examples/jsm/tsl/display/Sepia.js +24 -0
  369. package/examples/jsm/tsl/display/SobelOperatorNode.js +168 -0
  370. package/examples/jsm/tsl/display/StereoCompositePassNode.js +185 -0
  371. package/examples/jsm/tsl/display/StereoPassNode.js +120 -0
  372. package/examples/jsm/tsl/display/TRAANode.js +461 -0
  373. package/examples/jsm/tsl/display/TransitionNode.js +141 -0
  374. package/examples/jsm/tsl/display/boxBlur.js +64 -0
  375. package/examples/jsm/tsl/display/hashBlur.js +53 -0
  376. package/examples/jsm/tsl/lighting/TiledLightsNode.js +422 -0
  377. package/examples/jsm/tsl/math/Bayer.js +34 -0
  378. package/examples/jsm/tsl/shadows/TileShadowNode.js +456 -0
  379. package/examples/jsm/tsl/shadows/TileShadowNodeHelper.js +212 -0
  380. package/examples/jsm/tsl/utils/Raymarching.js +70 -0
  381. package/examples/jsm/utils/BufferGeometryUtils.js +1435 -0
  382. package/examples/jsm/utils/CameraUtils.js +82 -0
  383. package/examples/jsm/utils/GeometryCompressionUtils.js +547 -0
  384. package/examples/jsm/utils/GeometryUtils.js +226 -0
  385. package/examples/jsm/utils/LDrawUtils.js +211 -0
  386. package/examples/jsm/utils/SceneOptimizer.js +458 -0
  387. package/examples/jsm/utils/SceneUtils.js +363 -0
  388. package/examples/jsm/utils/ShadowMapViewer.js +230 -0
  389. package/examples/jsm/utils/ShadowMapViewerGPU.js +233 -0
  390. package/examples/jsm/utils/SkeletonUtils.js +490 -0
  391. package/examples/jsm/utils/SortUtils.js +175 -0
  392. package/examples/jsm/utils/UVsDebug.js +173 -0
  393. package/examples/jsm/utils/WebGLTextureUtils.js +115 -0
  394. package/examples/jsm/utils/WebGPUTextureUtils.js +81 -0
  395. package/examples/jsm/utils/WorkerPool.js +167 -0
  396. package/examples/jsm/webxr/ARButton.js +251 -0
  397. package/examples/jsm/webxr/OculusHandModel.js +194 -0
  398. package/examples/jsm/webxr/OculusHandPointerModel.js +539 -0
  399. package/examples/jsm/webxr/Text2D.js +52 -0
  400. package/examples/jsm/webxr/VRButton.js +264 -0
  401. package/examples/jsm/webxr/XRButton.js +246 -0
  402. package/examples/jsm/webxr/XRControllerModelFactory.js +403 -0
  403. package/examples/jsm/webxr/XREstimatedLight.js +254 -0
  404. package/examples/jsm/webxr/XRHandMeshModel.js +151 -0
  405. package/examples/jsm/webxr/XRHandModelFactory.js +197 -0
  406. package/examples/jsm/webxr/XRHandPrimitiveModel.js +147 -0
  407. package/examples/jsm/webxr/XRPlanes.js +118 -0
  408. package/package.json +134 -0
  409. package/src/Three.Core.js +185 -0
  410. package/src/Three.Legacy.js +0 -0
  411. package/src/Three.TSL.js +629 -0
  412. package/src/Three.WebGPU.Nodes.js +24 -0
  413. package/src/Three.WebGPU.js +26 -0
  414. package/src/Three.js +9 -0
  415. package/src/animation/AnimationAction.js +932 -0
  416. package/src/animation/AnimationClip.js +628 -0
  417. package/src/animation/AnimationMixer.js +854 -0
  418. package/src/animation/AnimationObjectGroup.js +411 -0
  419. package/src/animation/AnimationUtils.js +506 -0
  420. package/src/animation/KeyframeTrack.js +597 -0
  421. package/src/animation/PropertyBinding.js +794 -0
  422. package/src/animation/PropertyMixer.js +385 -0
  423. package/src/animation/tracks/BooleanKeyframeTrack.js +55 -0
  424. package/src/animation/tracks/ColorKeyframeTrack.js +36 -0
  425. package/src/animation/tracks/NumberKeyframeTrack.js +36 -0
  426. package/src/animation/tracks/QuaternionKeyframeTrack.js +51 -0
  427. package/src/animation/tracks/StringKeyframeTrack.js +55 -0
  428. package/src/animation/tracks/VectorKeyframeTrack.js +36 -0
  429. package/src/audio/Audio.js +778 -0
  430. package/src/audio/AudioAnalyser.js +97 -0
  431. package/src/audio/AudioContext.js +40 -0
  432. package/src/audio/AudioListener.js +216 -0
  433. package/src/audio/PositionalAudio.js +253 -0
  434. package/src/cameras/ArrayCamera.js +54 -0
  435. package/src/cameras/Camera.js +130 -0
  436. package/src/cameras/CubeCamera.js +239 -0
  437. package/src/cameras/OrthographicCamera.js +245 -0
  438. package/src/cameras/PerspectiveCamera.js +407 -0
  439. package/src/cameras/StereoCamera.js +146 -0
  440. package/src/constants.js +1675 -0
  441. package/src/core/BufferAttribute.js +1044 -0
  442. package/src/core/BufferGeometry.js +1446 -0
  443. package/src/core/Clock.js +128 -0
  444. package/src/core/EventDispatcher.js +131 -0
  445. package/src/core/GLBufferAttribute.js +171 -0
  446. package/src/core/InstancedBufferAttribute.js +68 -0
  447. package/src/core/InstancedBufferGeometry.js +60 -0
  448. package/src/core/InstancedInterleavedBuffer.js +74 -0
  449. package/src/core/InterleavedBuffer.js +291 -0
  450. package/src/core/InterleavedBufferAttribute.js +549 -0
  451. package/src/core/Layers.js +121 -0
  452. package/src/core/Object3D.js +1619 -0
  453. package/src/core/Raycaster.js +262 -0
  454. package/src/core/RenderTarget.js +392 -0
  455. package/src/core/RenderTarget3D.js +48 -0
  456. package/src/core/Timer.js +184 -0
  457. package/src/core/Uniform.js +46 -0
  458. package/src/core/UniformsGroup.js +180 -0
  459. package/src/extras/Controls.js +120 -0
  460. package/src/extras/DataUtils.js +217 -0
  461. package/src/extras/Earcut.js +22 -0
  462. package/src/extras/ImageUtils.js +137 -0
  463. package/src/extras/PMREMGenerator.js +966 -0
  464. package/src/extras/ShapeUtils.js +114 -0
  465. package/src/extras/TextureUtils.js +293 -0
  466. package/src/extras/core/Curve.js +517 -0
  467. package/src/extras/core/CurvePath.js +296 -0
  468. package/src/extras/core/Interpolations.js +105 -0
  469. package/src/extras/core/Path.js +329 -0
  470. package/src/extras/core/Shape.js +165 -0
  471. package/src/extras/core/ShapePath.js +367 -0
  472. package/src/extras/curves/ArcCurve.js +39 -0
  473. package/src/extras/curves/CatmullRomCurve3.js +326 -0
  474. package/src/extras/curves/CubicBezierCurve.js +145 -0
  475. package/src/extras/curves/CubicBezierCurve3.js +129 -0
  476. package/src/extras/curves/Curves.js +10 -0
  477. package/src/extras/curves/EllipseCurve.js +258 -0
  478. package/src/extras/curves/LineCurve.js +128 -0
  479. package/src/extras/curves/LineCurve3.js +128 -0
  480. package/src/extras/curves/QuadraticBezierCurve.js +133 -0
  481. package/src/extras/curves/QuadraticBezierCurve3.js +118 -0
  482. package/src/extras/curves/SplineCurve.js +145 -0
  483. package/src/extras/lib/earcut.js +685 -0
  484. package/src/geometries/BoxGeometry.js +218 -0
  485. package/src/geometries/CapsuleGeometry.js +217 -0
  486. package/src/geometries/CircleGeometry.js +141 -0
  487. package/src/geometries/ConeGeometry.js +69 -0
  488. package/src/geometries/CylinderGeometry.js +332 -0
  489. package/src/geometries/DodecahedronGeometry.js +98 -0
  490. package/src/geometries/EdgesGeometry.js +180 -0
  491. package/src/geometries/ExtrudeGeometry.js +909 -0
  492. package/src/geometries/Geometries.js +21 -0
  493. package/src/geometries/IcosahedronGeometry.js +74 -0
  494. package/src/geometries/LatheGeometry.js +229 -0
  495. package/src/geometries/OctahedronGeometry.js +69 -0
  496. package/src/geometries/PlaneGeometry.js +132 -0
  497. package/src/geometries/PolyhedronGeometry.js +348 -0
  498. package/src/geometries/RingGeometry.js +164 -0
  499. package/src/geometries/ShapeGeometry.js +232 -0
  500. package/src/geometries/SphereGeometry.js +174 -0
  501. package/src/geometries/TetrahedronGeometry.js +66 -0
  502. package/src/geometries/TorusGeometry.js +155 -0
  503. package/src/geometries/TorusKnotGeometry.js +205 -0
  504. package/src/geometries/TubeGeometry.js +252 -0
  505. package/src/geometries/WireframeGeometry.js +179 -0
  506. package/src/helpers/ArrowHelper.js +171 -0
  507. package/src/helpers/AxesHelper.js +96 -0
  508. package/src/helpers/Box3Helper.js +83 -0
  509. package/src/helpers/BoxHelper.js +149 -0
  510. package/src/helpers/CameraHelper.js +342 -0
  511. package/src/helpers/DirectionalLightHelper.js +145 -0
  512. package/src/helpers/GridHelper.js +82 -0
  513. package/src/helpers/HemisphereLightHelper.js +127 -0
  514. package/src/helpers/PlaneHelper.js +96 -0
  515. package/src/helpers/PointLightHelper.js +135 -0
  516. package/src/helpers/PolarGridHelper.js +126 -0
  517. package/src/helpers/SkeletonHelper.js +194 -0
  518. package/src/helpers/SpotLightHelper.js +151 -0
  519. package/src/lights/AmbientLight.js +42 -0
  520. package/src/lights/DirectionalLight.js +100 -0
  521. package/src/lights/DirectionalLightShadow.js +31 -0
  522. package/src/lights/HemisphereLight.js +66 -0
  523. package/src/lights/Light.js +95 -0
  524. package/src/lights/LightProbe.js +90 -0
  525. package/src/lights/LightShadow.js +338 -0
  526. package/src/lights/PointLight.js +116 -0
  527. package/src/lights/PointLightShadow.js +117 -0
  528. package/src/lights/RectAreaLight.js +115 -0
  529. package/src/lights/SpotLight.js +173 -0
  530. package/src/lights/SpotLightShadow.js +80 -0
  531. package/src/lights/webgpu/IESSpotLight.js +46 -0
  532. package/src/lights/webgpu/ProjectorLight.js +46 -0
  533. package/src/loaders/AnimationLoader.js +98 -0
  534. package/src/loaders/AudioLoader.js +98 -0
  535. package/src/loaders/BufferGeometryLoader.js +242 -0
  536. package/src/loaders/Cache.js +87 -0
  537. package/src/loaders/CompressedTextureLoader.js +167 -0
  538. package/src/loaders/CubeTextureLoader.js +103 -0
  539. package/src/loaders/DataTextureLoader.js +172 -0
  540. package/src/loaders/FileLoader.js +368 -0
  541. package/src/loaders/IESLoader.js +327 -0
  542. package/src/loaders/ImageBitmapLoader.js +220 -0
  543. package/src/loaders/ImageLoader.js +168 -0
  544. package/src/loaders/Loader.js +216 -0
  545. package/src/loaders/LoaderUtils.js +59 -0
  546. package/src/loaders/LoadingManager.js +307 -0
  547. package/src/loaders/MaterialLoader.js +438 -0
  548. package/src/loaders/ObjectLoader.js +1264 -0
  549. package/src/loaders/TextureLoader.js +74 -0
  550. package/src/loaders/nodes/NodeLoader.js +194 -0
  551. package/src/loaders/nodes/NodeMaterialLoader.js +108 -0
  552. package/src/loaders/nodes/NodeObjectLoader.js +151 -0
  553. package/src/materials/LineBasicMaterial.js +122 -0
  554. package/src/materials/LineDashedMaterial.js +86 -0
  555. package/src/materials/Material.js +1015 -0
  556. package/src/materials/Materials.js +39 -0
  557. package/src/materials/MeshBasicMaterial.js +249 -0
  558. package/src/materials/MeshDepthMaterial.js +147 -0
  559. package/src/materials/MeshDistanceMaterial.js +119 -0
  560. package/src/materials/MeshLambertMaterial.js +392 -0
  561. package/src/materials/MeshMatcapMaterial.js +223 -0
  562. package/src/materials/MeshNormalMaterial.js +174 -0
  563. package/src/materials/MeshPhongMaterial.js +411 -0
  564. package/src/materials/MeshPhysicalMaterial.js +535 -0
  565. package/src/materials/MeshStandardMaterial.js +424 -0
  566. package/src/materials/MeshToonMaterial.js +320 -0
  567. package/src/materials/PointsMaterial.js +139 -0
  568. package/src/materials/RawShaderMaterial.js +42 -0
  569. package/src/materials/ShaderMaterial.js +394 -0
  570. package/src/materials/ShadowMaterial.js +91 -0
  571. package/src/materials/SpriteMaterial.js +136 -0
  572. package/src/materials/nodes/Line2NodeMaterial.js +542 -0
  573. package/src/materials/nodes/LineBasicNodeMaterial.js +46 -0
  574. package/src/materials/nodes/LineDashedNodeMaterial.js +132 -0
  575. package/src/materials/nodes/MeshBasicNodeMaterial.js +134 -0
  576. package/src/materials/nodes/MeshLambertNodeMaterial.js +82 -0
  577. package/src/materials/nodes/MeshMatcapNodeMaterial.js +77 -0
  578. package/src/materials/nodes/MeshNormalNodeMaterial.js +67 -0
  579. package/src/materials/nodes/MeshPhongNodeMaterial.js +141 -0
  580. package/src/materials/nodes/MeshPhysicalNodeMaterial.js +518 -0
  581. package/src/materials/nodes/MeshSSSNodeMaterial.js +175 -0
  582. package/src/materials/nodes/MeshStandardNodeMaterial.js +186 -0
  583. package/src/materials/nodes/MeshToonNodeMaterial.js +66 -0
  584. package/src/materials/nodes/NodeMaterial.js +1271 -0
  585. package/src/materials/nodes/NodeMaterials.js +21 -0
  586. package/src/materials/nodes/PointsNodeMaterial.js +211 -0
  587. package/src/materials/nodes/ShadowNodeMaterial.js +76 -0
  588. package/src/materials/nodes/SpriteNodeMaterial.js +186 -0
  589. package/src/materials/nodes/VolumeNodeMaterial.js +81 -0
  590. package/src/materials/nodes/manager/NodeMaterialObserver.js +612 -0
  591. package/src/math/Box2.js +381 -0
  592. package/src/math/Box3.js +805 -0
  593. package/src/math/Color.js +967 -0
  594. package/src/math/ColorManagement.js +215 -0
  595. package/src/math/Cylindrical.js +120 -0
  596. package/src/math/Euler.js +449 -0
  597. package/src/math/Frustum.js +285 -0
  598. package/src/math/FrustumArray.js +258 -0
  599. package/src/math/Interpolant.js +320 -0
  600. package/src/math/Line3.js +336 -0
  601. package/src/math/MathUtils.js +751 -0
  602. package/src/math/Matrix2.js +124 -0
  603. package/src/math/Matrix3.js +613 -0
  604. package/src/math/Matrix4.js +1301 -0
  605. package/src/math/Plane.js +367 -0
  606. package/src/math/Quaternion.js +943 -0
  607. package/src/math/Ray.js +655 -0
  608. package/src/math/Sphere.js +420 -0
  609. package/src/math/Spherical.js +147 -0
  610. package/src/math/SphericalHarmonics3.js +341 -0
  611. package/src/math/Triangle.js +539 -0
  612. package/src/math/Vector2.js +866 -0
  613. package/src/math/Vector3.js +1261 -0
  614. package/src/math/Vector4.js +1063 -0
  615. package/src/math/interpolants/CubicInterpolant.js +159 -0
  616. package/src/math/interpolants/DiscreteInterpolant.js +34 -0
  617. package/src/math/interpolants/LinearInterpolant.js +51 -0
  618. package/src/math/interpolants/QuaternionLinearInterpolant.js +48 -0
  619. package/src/nodes/Nodes.js +148 -0
  620. package/src/nodes/TSL.js +173 -0
  621. package/src/nodes/accessors/AccessorsUtils.js +53 -0
  622. package/src/nodes/accessors/Arrays.js +68 -0
  623. package/src/nodes/accessors/BatchNode.js +163 -0
  624. package/src/nodes/accessors/Bitangent.js +82 -0
  625. package/src/nodes/accessors/BufferAttributeNode.js +340 -0
  626. package/src/nodes/accessors/BufferNode.js +101 -0
  627. package/src/nodes/accessors/BuiltinNode.js +63 -0
  628. package/src/nodes/accessors/Camera.js +282 -0
  629. package/src/nodes/accessors/ClippingNode.js +255 -0
  630. package/src/nodes/accessors/CubeTextureNode.js +190 -0
  631. package/src/nodes/accessors/InstanceNode.js +244 -0
  632. package/src/nodes/accessors/InstancedMeshNode.js +50 -0
  633. package/src/nodes/accessors/Lights.js +129 -0
  634. package/src/nodes/accessors/MaterialNode.js +775 -0
  635. package/src/nodes/accessors/MaterialProperties.js +59 -0
  636. package/src/nodes/accessors/MaterialReferenceNode.js +85 -0
  637. package/src/nodes/accessors/ModelNode.js +184 -0
  638. package/src/nodes/accessors/ModelViewProjectionNode.js +13 -0
  639. package/src/nodes/accessors/MorphNode.js +310 -0
  640. package/src/nodes/accessors/Normal.js +243 -0
  641. package/src/nodes/accessors/Object3DNode.js +268 -0
  642. package/src/nodes/accessors/PointUVNode.js +55 -0
  643. package/src/nodes/accessors/Position.js +74 -0
  644. package/src/nodes/accessors/ReferenceBaseNode.js +357 -0
  645. package/src/nodes/accessors/ReferenceNode.js +424 -0
  646. package/src/nodes/accessors/ReflectVector.js +36 -0
  647. package/src/nodes/accessors/RendererReferenceNode.js +79 -0
  648. package/src/nodes/accessors/SceneNode.js +145 -0
  649. package/src/nodes/accessors/SkinningNode.js +327 -0
  650. package/src/nodes/accessors/StorageBufferNode.js +416 -0
  651. package/src/nodes/accessors/StorageTextureNode.js +242 -0
  652. package/src/nodes/accessors/Tangent.js +70 -0
  653. package/src/nodes/accessors/TangentUtils.js +46 -0
  654. package/src/nodes/accessors/Texture3DNode.js +199 -0
  655. package/src/nodes/accessors/TextureBicubic.js +92 -0
  656. package/src/nodes/accessors/TextureNode.js +894 -0
  657. package/src/nodes/accessors/TextureSizeNode.js +77 -0
  658. package/src/nodes/accessors/UV.js +11 -0
  659. package/src/nodes/accessors/UniformArrayNode.js +348 -0
  660. package/src/nodes/accessors/UserDataNode.js +77 -0
  661. package/src/nodes/accessors/VelocityNode.js +224 -0
  662. package/src/nodes/accessors/VertexColorNode.js +110 -0
  663. package/src/nodes/code/CodeNode.js +181 -0
  664. package/src/nodes/code/ExpressionNode.js +68 -0
  665. package/src/nodes/code/FunctionCallNode.js +187 -0
  666. package/src/nodes/code/FunctionNode.js +183 -0
  667. package/src/nodes/code/ScriptableNode.js +726 -0
  668. package/src/nodes/code/ScriptableValueNode.js +253 -0
  669. package/src/nodes/core/ArrayNode.js +154 -0
  670. package/src/nodes/core/AssignNode.js +202 -0
  671. package/src/nodes/core/AttributeNode.js +168 -0
  672. package/src/nodes/core/BypassNode.js +93 -0
  673. package/src/nodes/core/CacheNode.js +100 -0
  674. package/src/nodes/core/ConstNode.js +67 -0
  675. package/src/nodes/core/ContextNode.js +190 -0
  676. package/src/nodes/core/IndexNode.js +164 -0
  677. package/src/nodes/core/InputNode.js +136 -0
  678. package/src/nodes/core/LightingModel.js +77 -0
  679. package/src/nodes/core/MRTNode.js +150 -0
  680. package/src/nodes/core/Node.js +959 -0
  681. package/src/nodes/core/NodeAttribute.js +53 -0
  682. package/src/nodes/core/NodeBuilder.js +2968 -0
  683. package/src/nodes/core/NodeCache.js +75 -0
  684. package/src/nodes/core/NodeCode.js +46 -0
  685. package/src/nodes/core/NodeFrame.js +306 -0
  686. package/src/nodes/core/NodeFunction.js +69 -0
  687. package/src/nodes/core/NodeFunctionInput.js +61 -0
  688. package/src/nodes/core/NodeParser.js +23 -0
  689. package/src/nodes/core/NodeUniform.js +91 -0
  690. package/src/nodes/core/NodeUtils.js +480 -0
  691. package/src/nodes/core/NodeVar.js +60 -0
  692. package/src/nodes/core/NodeVarying.js +63 -0
  693. package/src/nodes/core/OutputStructNode.js +103 -0
  694. package/src/nodes/core/ParameterNode.js +94 -0
  695. package/src/nodes/core/PropertyNode.js +344 -0
  696. package/src/nodes/core/StackNode.js +376 -0
  697. package/src/nodes/core/StructNode.js +120 -0
  698. package/src/nodes/core/StructType.js +13 -0
  699. package/src/nodes/core/StructTypeNode.js +154 -0
  700. package/src/nodes/core/SubBuildNode.js +89 -0
  701. package/src/nodes/core/TempNode.js +88 -0
  702. package/src/nodes/core/UniformGroupNode.js +137 -0
  703. package/src/nodes/core/UniformNode.js +243 -0
  704. package/src/nodes/core/VarNode.js +284 -0
  705. package/src/nodes/core/VaryingNode.js +227 -0
  706. package/src/nodes/core/constants.js +68 -0
  707. package/src/nodes/display/BlendModes.js +235 -0
  708. package/src/nodes/display/BumpMapNode.js +117 -0
  709. package/src/nodes/display/ColorAdjustment.js +141 -0
  710. package/src/nodes/display/ColorSpaceFunctions.js +54 -0
  711. package/src/nodes/display/ColorSpaceNode.js +164 -0
  712. package/src/nodes/display/FrontFacingNode.js +102 -0
  713. package/src/nodes/display/NormalMapNode.js +118 -0
  714. package/src/nodes/display/PassNode.js +905 -0
  715. package/src/nodes/display/PosterizeNode.js +65 -0
  716. package/src/nodes/display/RenderOutputNode.js +124 -0
  717. package/src/nodes/display/ScreenNode.js +290 -0
  718. package/src/nodes/display/ToneMappingFunctions.js +242 -0
  719. package/src/nodes/display/ToneMappingNode.js +121 -0
  720. package/src/nodes/display/ToonOutlinePassNode.js +183 -0
  721. package/src/nodes/display/ViewportDepthNode.js +294 -0
  722. package/src/nodes/display/ViewportDepthTextureNode.js +67 -0
  723. package/src/nodes/display/ViewportSharedTextureNode.js +73 -0
  724. package/src/nodes/display/ViewportTextureNode.js +228 -0
  725. package/src/nodes/fog/Fog.js +114 -0
  726. package/src/nodes/functions/BSDF/BRDF_GGX.js +55 -0
  727. package/src/nodes/functions/BSDF/BRDF_Lambert.js +9 -0
  728. package/src/nodes/functions/BSDF/BRDF_Sheen.js +57 -0
  729. package/src/nodes/functions/BSDF/DFGApprox.js +30 -0
  730. package/src/nodes/functions/BSDF/D_GGX.js +23 -0
  731. package/src/nodes/functions/BSDF/D_GGX_Anisotropic.js +28 -0
  732. package/src/nodes/functions/BSDF/EnvironmentBRDF.js +13 -0
  733. package/src/nodes/functions/BSDF/F_Schlick.js +16 -0
  734. package/src/nodes/functions/BSDF/LTC.js +175 -0
  735. package/src/nodes/functions/BSDF/Schlick_to_F0.js +21 -0
  736. package/src/nodes/functions/BSDF/V_GGX_SmithCorrelated.js +26 -0
  737. package/src/nodes/functions/BSDF/V_GGX_SmithCorrelated_Anisotropic.js +29 -0
  738. package/src/nodes/functions/BasicLightingModel.js +100 -0
  739. package/src/nodes/functions/PhongLightingModel.js +99 -0
  740. package/src/nodes/functions/PhysicalLightingModel.js +796 -0
  741. package/src/nodes/functions/ShadowMaskModel.js +58 -0
  742. package/src/nodes/functions/ToonLightingModel.js +70 -0
  743. package/src/nodes/functions/VolumetricLightingModel.js +183 -0
  744. package/src/nodes/functions/material/getAlphaHashThreshold.js +68 -0
  745. package/src/nodes/functions/material/getGeometryRoughness.js +19 -0
  746. package/src/nodes/functions/material/getParallaxCorrectNormal.js +37 -0
  747. package/src/nodes/functions/material/getRoughness.js +18 -0
  748. package/src/nodes/functions/material/getShIrradianceAt.js +28 -0
  749. package/src/nodes/geometry/RangeNode.js +172 -0
  750. package/src/nodes/gpgpu/AtomicFunctionNode.js +274 -0
  751. package/src/nodes/gpgpu/BarrierNode.js +89 -0
  752. package/src/nodes/gpgpu/ComputeBuiltinNode.js +228 -0
  753. package/src/nodes/gpgpu/ComputeNode.js +273 -0
  754. package/src/nodes/gpgpu/SubgroupFunctionNode.js +430 -0
  755. package/src/nodes/gpgpu/WorkgroupInfoNode.js +234 -0
  756. package/src/nodes/lighting/AONode.js +45 -0
  757. package/src/nodes/lighting/AmbientLightNode.js +35 -0
  758. package/src/nodes/lighting/AnalyticLightNode.js +256 -0
  759. package/src/nodes/lighting/BasicEnvironmentNode.js +49 -0
  760. package/src/nodes/lighting/BasicLightMapNode.js +49 -0
  761. package/src/nodes/lighting/DirectionalLightNode.js +39 -0
  762. package/src/nodes/lighting/EnvironmentNode.js +153 -0
  763. package/src/nodes/lighting/HemisphereLightNode.js +87 -0
  764. package/src/nodes/lighting/IESSpotLightNode.js +49 -0
  765. package/src/nodes/lighting/IrradianceNode.js +44 -0
  766. package/src/nodes/lighting/LightProbeNode.js +73 -0
  767. package/src/nodes/lighting/LightUtils.js +25 -0
  768. package/src/nodes/lighting/LightingContextNode.js +115 -0
  769. package/src/nodes/lighting/LightingNode.js +36 -0
  770. package/src/nodes/lighting/LightsNode.js +455 -0
  771. package/src/nodes/lighting/PointLightNode.js +102 -0
  772. package/src/nodes/lighting/PointShadowNode.js +306 -0
  773. package/src/nodes/lighting/ProjectorLightNode.js +91 -0
  774. package/src/nodes/lighting/RectAreaLightNode.js +133 -0
  775. package/src/nodes/lighting/ShadowBaseNode.js +81 -0
  776. package/src/nodes/lighting/ShadowFilterNode.js +274 -0
  777. package/src/nodes/lighting/ShadowNode.js +745 -0
  778. package/src/nodes/lighting/SpotLightNode.js +168 -0
  779. package/src/nodes/materialx/DISCLAIMER.md +199 -0
  780. package/src/nodes/materialx/MaterialXNodes.js +197 -0
  781. package/src/nodes/materialx/lib/mx_hsv.js +127 -0
  782. package/src/nodes/materialx/lib/mx_noise.js +1491 -0
  783. package/src/nodes/materialx/lib/mx_transform_color.js +23 -0
  784. package/src/nodes/math/BitcastNode.js +156 -0
  785. package/src/nodes/math/ConditionalNode.js +245 -0
  786. package/src/nodes/math/Hash.js +21 -0
  787. package/src/nodes/math/MathNode.js +1167 -0
  788. package/src/nodes/math/MathUtils.js +54 -0
  789. package/src/nodes/math/OperatorNode.js +751 -0
  790. package/src/nodes/math/TriNoise3D.js +71 -0
  791. package/src/nodes/parsers/GLSLNodeFunction.js +168 -0
  792. package/src/nodes/parsers/GLSLNodeParser.js +25 -0
  793. package/src/nodes/pmrem/PMREMNode.js +397 -0
  794. package/src/nodes/pmrem/PMREMUtils.js +288 -0
  795. package/src/nodes/procedural/Checker.js +22 -0
  796. package/src/nodes/shapes/Shapes.js +33 -0
  797. package/src/nodes/tsl/TSLBase.js +35 -0
  798. package/src/nodes/tsl/TSLCore.js +1209 -0
  799. package/src/nodes/utils/ArrayElementNode.js +77 -0
  800. package/src/nodes/utils/ConvertNode.js +100 -0
  801. package/src/nodes/utils/CubeMapNode.js +237 -0
  802. package/src/nodes/utils/DebugNode.js +83 -0
  803. package/src/nodes/utils/Discard.js +24 -0
  804. package/src/nodes/utils/EquirectUV.js +27 -0
  805. package/src/nodes/utils/EventNode.js +83 -0
  806. package/src/nodes/utils/FlipNode.js +106 -0
  807. package/src/nodes/utils/FunctionOverloadingNode.js +152 -0
  808. package/src/nodes/utils/JoinNode.js +117 -0
  809. package/src/nodes/utils/LoopNode.js +354 -0
  810. package/src/nodes/utils/MatcapUV.js +22 -0
  811. package/src/nodes/utils/MaxMipLevelNode.js +103 -0
  812. package/src/nodes/utils/MemberNode.js +120 -0
  813. package/src/nodes/utils/Oscillators.js +41 -0
  814. package/src/nodes/utils/Packing.js +21 -0
  815. package/src/nodes/utils/PostProcessingUtils.js +95 -0
  816. package/src/nodes/utils/RTTNode.js +279 -0
  817. package/src/nodes/utils/ReflectorNode.js +623 -0
  818. package/src/nodes/utils/RemapNode.js +125 -0
  819. package/src/nodes/utils/RotateNode.js +103 -0
  820. package/src/nodes/utils/SampleNode.js +91 -0
  821. package/src/nodes/utils/SetNode.js +108 -0
  822. package/src/nodes/utils/SplitNode.js +179 -0
  823. package/src/nodes/utils/SpriteSheetUVNode.js +90 -0
  824. package/src/nodes/utils/SpriteUtils.js +63 -0
  825. package/src/nodes/utils/StorageArrayElementNode.js +143 -0
  826. package/src/nodes/utils/Timer.js +26 -0
  827. package/src/nodes/utils/TriplanarTextures.js +65 -0
  828. package/src/nodes/utils/UVUtils.js +39 -0
  829. package/src/nodes/utils/ViewportUtils.js +26 -0
  830. package/src/objects/BatchedMesh.js +1654 -0
  831. package/src/objects/Bone.js +41 -0
  832. package/src/objects/ClippingGroup.js +68 -0
  833. package/src/objects/Group.js +41 -0
  834. package/src/objects/InstancedMesh.js +395 -0
  835. package/src/objects/LOD.js +329 -0
  836. package/src/objects/Line.js +329 -0
  837. package/src/objects/LineLoop.js +37 -0
  838. package/src/objects/LineSegments.js +74 -0
  839. package/src/objects/Mesh.js +496 -0
  840. package/src/objects/Points.js +228 -0
  841. package/src/objects/Skeleton.js +383 -0
  842. package/src/objects/SkinnedMesh.js +352 -0
  843. package/src/objects/Sprite.js +245 -0
  844. package/src/renderers/WebGL3DRenderTarget.js +48 -0
  845. package/src/renderers/WebGLArrayRenderTarget.js +48 -0
  846. package/src/renderers/WebGLCubeRenderTarget.js +182 -0
  847. package/src/renderers/WebGLRenderTarget.js +34 -0
  848. package/src/renderers/WebGLRenderer.js +3508 -0
  849. package/src/renderers/common/Animation.js +147 -0
  850. package/src/renderers/common/Attributes.js +118 -0
  851. package/src/renderers/common/Backend.js +685 -0
  852. package/src/renderers/common/Background.js +212 -0
  853. package/src/renderers/common/BindGroup.js +61 -0
  854. package/src/renderers/common/Binding.js +60 -0
  855. package/src/renderers/common/Bindings.js +343 -0
  856. package/src/renderers/common/Buffer.js +87 -0
  857. package/src/renderers/common/BufferUtils.js +58 -0
  858. package/src/renderers/common/BundleGroup.js +83 -0
  859. package/src/renderers/common/ChainMap.js +98 -0
  860. package/src/renderers/common/ClippingContext.js +262 -0
  861. package/src/renderers/common/Color4.js +77 -0
  862. package/src/renderers/common/ComputePipeline.js +41 -0
  863. package/src/renderers/common/Constants.js +15 -0
  864. package/src/renderers/common/CubeRenderTarget.js +103 -0
  865. package/src/renderers/common/DataMap.js +90 -0
  866. package/src/renderers/common/Geometries.js +344 -0
  867. package/src/renderers/common/IndirectStorageBufferAttribute.js +38 -0
  868. package/src/renderers/common/Info.js +172 -0
  869. package/src/renderers/common/Lighting.js +73 -0
  870. package/src/renderers/common/Pipeline.js +35 -0
  871. package/src/renderers/common/Pipelines.js +465 -0
  872. package/src/renderers/common/PostProcessing.js +245 -0
  873. package/src/renderers/common/ProgrammableStage.js +78 -0
  874. package/src/renderers/common/QuadMesh.js +106 -0
  875. package/src/renderers/common/RenderBundle.js +24 -0
  876. package/src/renderers/common/RenderBundles.js +67 -0
  877. package/src/renderers/common/RenderContext.js +265 -0
  878. package/src/renderers/common/RenderContexts.js +116 -0
  879. package/src/renderers/common/RenderList.js +400 -0
  880. package/src/renderers/common/RenderLists.js +77 -0
  881. package/src/renderers/common/RenderObject.js +901 -0
  882. package/src/renderers/common/RenderObjects.js +202 -0
  883. package/src/renderers/common/RenderPipeline.js +40 -0
  884. package/src/renderers/common/Renderer.js +3125 -0
  885. package/src/renderers/common/RendererUtils.js +191 -0
  886. package/src/renderers/common/SampledTexture.js +144 -0
  887. package/src/renderers/common/Sampler.js +139 -0
  888. package/src/renderers/common/Storage3DTexture.js +100 -0
  889. package/src/renderers/common/StorageArrayTexture.js +84 -0
  890. package/src/renderers/common/StorageBuffer.js +41 -0
  891. package/src/renderers/common/StorageBufferAttribute.js +46 -0
  892. package/src/renderers/common/StorageInstancedBufferAttribute.js +46 -0
  893. package/src/renderers/common/StorageTexture.js +78 -0
  894. package/src/renderers/common/Textures.js +491 -0
  895. package/src/renderers/common/TimestampQueryPool.js +99 -0
  896. package/src/renderers/common/Uniform.js +367 -0
  897. package/src/renderers/common/UniformBuffer.js +34 -0
  898. package/src/renderers/common/UniformsGroup.js +487 -0
  899. package/src/renderers/common/XRManager.js +1676 -0
  900. package/src/renderers/common/XRRenderTarget.js +91 -0
  901. package/src/renderers/common/extras/PMREMGenerator.js +946 -0
  902. package/src/renderers/common/nodes/NodeBuilderState.js +152 -0
  903. package/src/renderers/common/nodes/NodeLibrary.js +196 -0
  904. package/src/renderers/common/nodes/NodeSampledTexture.js +140 -0
  905. package/src/renderers/common/nodes/NodeSampler.js +50 -0
  906. package/src/renderers/common/nodes/NodeStorageBuffer.js +61 -0
  907. package/src/renderers/common/nodes/NodeUniform.js +418 -0
  908. package/src/renderers/common/nodes/NodeUniformBuffer.js +53 -0
  909. package/src/renderers/common/nodes/NodeUniformsGroup.js +51 -0
  910. package/src/renderers/common/nodes/Nodes.js +819 -0
  911. package/src/renderers/shaders/ShaderChunk/alphahash_fragment.glsl.js +7 -0
  912. package/src/renderers/shaders/ShaderChunk/alphahash_pars_fragment.glsl.js +68 -0
  913. package/src/renderers/shaders/ShaderChunk/alphamap_fragment.glsl.js +7 -0
  914. package/src/renderers/shaders/ShaderChunk/alphamap_pars_fragment.glsl.js +7 -0
  915. package/src/renderers/shaders/ShaderChunk/alphatest_fragment.glsl.js +16 -0
  916. package/src/renderers/shaders/ShaderChunk/alphatest_pars_fragment.glsl.js +5 -0
  917. package/src/renderers/shaders/ShaderChunk/aomap_fragment.glsl.js +26 -0
  918. package/src/renderers/shaders/ShaderChunk/aomap_pars_fragment.glsl.js +8 -0
  919. package/src/renderers/shaders/ShaderChunk/batching_pars_vertex.glsl.js +49 -0
  920. package/src/renderers/shaders/ShaderChunk/batching_vertex.glsl.js +5 -0
  921. package/src/renderers/shaders/ShaderChunk/begin_vertex.glsl.js +9 -0
  922. package/src/renderers/shaders/ShaderChunk/beginnormal_vertex.glsl.js +9 -0
  923. package/src/renderers/shaders/ShaderChunk/bsdfs.glsl.js +33 -0
  924. package/src/renderers/shaders/ShaderChunk/bumpmap_pars_fragment.glsl.js +43 -0
  925. package/src/renderers/shaders/ShaderChunk/clearcoat_normal_fragment_begin.glsl.js +7 -0
  926. package/src/renderers/shaders/ShaderChunk/clearcoat_normal_fragment_maps.glsl.js +10 -0
  927. package/src/renderers/shaders/ShaderChunk/clearcoat_pars_fragment.glsl.js +21 -0
  928. package/src/renderers/shaders/ShaderChunk/clipping_planes_fragment.glsl.js +78 -0
  929. package/src/renderers/shaders/ShaderChunk/clipping_planes_pars_fragment.glsl.js +9 -0
  930. package/src/renderers/shaders/ShaderChunk/clipping_planes_pars_vertex.glsl.js +7 -0
  931. package/src/renderers/shaders/ShaderChunk/clipping_planes_vertex.glsl.js +7 -0
  932. package/src/renderers/shaders/ShaderChunk/color_fragment.glsl.js +11 -0
  933. package/src/renderers/shaders/ShaderChunk/color_pars_fragment.glsl.js +11 -0
  934. package/src/renderers/shaders/ShaderChunk/color_pars_vertex.glsl.js +11 -0
  935. package/src/renderers/shaders/ShaderChunk/color_vertex.glsl.js +31 -0
  936. package/src/renderers/shaders/ShaderChunk/colorspace_fragment.glsl.js +3 -0
  937. package/src/renderers/shaders/ShaderChunk/colorspace_pars_fragment.glsl.js +15 -0
  938. package/src/renderers/shaders/ShaderChunk/common.glsl.js +137 -0
  939. package/src/renderers/shaders/ShaderChunk/cube_uv_reflection_fragment.glsl.js +186 -0
  940. package/src/renderers/shaders/ShaderChunk/default_fragment.glsl.js +5 -0
  941. package/src/renderers/shaders/ShaderChunk/default_vertex.glsl.js +5 -0
  942. package/src/renderers/shaders/ShaderChunk/defaultnormal_vertex.glsl.js +63 -0
  943. package/src/renderers/shaders/ShaderChunk/displacementmap_pars_vertex.glsl.js +9 -0
  944. package/src/renderers/shaders/ShaderChunk/displacementmap_vertex.glsl.js +7 -0
  945. package/src/renderers/shaders/ShaderChunk/dithering_fragment.glsl.js +7 -0
  946. package/src/renderers/shaders/ShaderChunk/dithering_pars_fragment.glsl.js +20 -0
  947. package/src/renderers/shaders/ShaderChunk/emissivemap_fragment.glsl.js +17 -0
  948. package/src/renderers/shaders/ShaderChunk/emissivemap_pars_fragment.glsl.js +7 -0
  949. package/src/renderers/shaders/ShaderChunk/envmap_common_pars_fragment.glsl.js +15 -0
  950. package/src/renderers/shaders/ShaderChunk/envmap_fragment.glsl.js +62 -0
  951. package/src/renderers/shaders/ShaderChunk/envmap_pars_fragment.glsl.js +21 -0
  952. package/src/renderers/shaders/ShaderChunk/envmap_pars_vertex.glsl.js +22 -0
  953. package/src/renderers/shaders/ShaderChunk/envmap_physical_pars_fragment.glsl.js +69 -0
  954. package/src/renderers/shaders/ShaderChunk/envmap_vertex.glsl.js +37 -0
  955. package/src/renderers/shaders/ShaderChunk/fog_fragment.glsl.js +17 -0
  956. package/src/renderers/shaders/ShaderChunk/fog_pars_fragment.glsl.js +19 -0
  957. package/src/renderers/shaders/ShaderChunk/fog_pars_vertex.glsl.js +7 -0
  958. package/src/renderers/shaders/ShaderChunk/fog_vertex.glsl.js +7 -0
  959. package/src/renderers/shaders/ShaderChunk/gradientmap_pars_fragment.glsl.js +27 -0
  960. package/src/renderers/shaders/ShaderChunk/iridescence_fragment.glsl.js +120 -0
  961. package/src/renderers/shaders/ShaderChunk/iridescence_pars_fragment.glsl.js +14 -0
  962. package/src/renderers/shaders/ShaderChunk/lightmap_pars_fragment.glsl.js +8 -0
  963. package/src/renderers/shaders/ShaderChunk/lights_fragment_begin.glsl.js +209 -0
  964. package/src/renderers/shaders/ShaderChunk/lights_fragment_end.glsl.js +13 -0
  965. package/src/renderers/shaders/ShaderChunk/lights_fragment_maps.glsl.js +40 -0
  966. package/src/renderers/shaders/ShaderChunk/lights_lambert_fragment.glsl.js +5 -0
  967. package/src/renderers/shaders/ShaderChunk/lights_lambert_pars_fragment.glsl.js +28 -0
  968. package/src/renderers/shaders/ShaderChunk/lights_pars_begin.glsl.js +254 -0
  969. package/src/renderers/shaders/ShaderChunk/lights_phong_fragment.glsl.js +7 -0
  970. package/src/renderers/shaders/ShaderChunk/lights_phong_pars_fragment.glsl.js +32 -0
  971. package/src/renderers/shaders/ShaderChunk/lights_physical_fragment.glsl.js +157 -0
  972. package/src/renderers/shaders/ShaderChunk/lights_physical_pars_fragment.glsl.js +563 -0
  973. package/src/renderers/shaders/ShaderChunk/lights_toon_fragment.glsl.js +4 -0
  974. package/src/renderers/shaders/ShaderChunk/lights_toon_pars_fragment.glsl.js +26 -0
  975. package/src/renderers/shaders/ShaderChunk/logdepthbuf_fragment.glsl.js +9 -0
  976. package/src/renderers/shaders/ShaderChunk/logdepthbuf_pars_fragment.glsl.js +9 -0
  977. package/src/renderers/shaders/ShaderChunk/logdepthbuf_pars_vertex.glsl.js +8 -0
  978. package/src/renderers/shaders/ShaderChunk/logdepthbuf_vertex.glsl.js +8 -0
  979. package/src/renderers/shaders/ShaderChunk/map_fragment.glsl.js +17 -0
  980. package/src/renderers/shaders/ShaderChunk/map_pars_fragment.glsl.js +7 -0
  981. package/src/renderers/shaders/ShaderChunk/map_particle_fragment.glsl.js +27 -0
  982. package/src/renderers/shaders/ShaderChunk/map_particle_pars_fragment.glsl.js +27 -0
  983. package/src/renderers/shaders/ShaderChunk/metalnessmap_fragment.glsl.js +12 -0
  984. package/src/renderers/shaders/ShaderChunk/metalnessmap_pars_fragment.glsl.js +7 -0
  985. package/src/renderers/shaders/ShaderChunk/morphcolor_vertex.glsl.js +24 -0
  986. package/src/renderers/shaders/ShaderChunk/morphinstance_vertex.glsl.js +14 -0
  987. package/src/renderers/shaders/ShaderChunk/morphnormal_vertex.glsl.js +16 -0
  988. package/src/renderers/shaders/ShaderChunk/morphtarget_pars_vertex.glsl.js +26 -0
  989. package/src/renderers/shaders/ShaderChunk/morphtarget_vertex.glsl.js +16 -0
  990. package/src/renderers/shaders/ShaderChunk/normal_fragment_begin.glsl.js +76 -0
  991. package/src/renderers/shaders/ShaderChunk/normal_fragment_maps.glsl.js +33 -0
  992. package/src/renderers/shaders/ShaderChunk/normal_pars_fragment.glsl.js +14 -0
  993. package/src/renderers/shaders/ShaderChunk/normal_pars_vertex.glsl.js +14 -0
  994. package/src/renderers/shaders/ShaderChunk/normal_vertex.glsl.js +14 -0
  995. package/src/renderers/shaders/ShaderChunk/normalmap_pars_fragment.glsl.js +43 -0
  996. package/src/renderers/shaders/ShaderChunk/opaque_fragment.glsl.js +11 -0
  997. package/src/renderers/shaders/ShaderChunk/packing.glsl.js +100 -0
  998. package/src/renderers/shaders/ShaderChunk/premultiplied_alpha_fragment.glsl.js +8 -0
  999. package/src/renderers/shaders/ShaderChunk/project_vertex.glsl.js +19 -0
  1000. package/src/renderers/shaders/ShaderChunk/roughnessmap_fragment.glsl.js +12 -0
  1001. package/src/renderers/shaders/ShaderChunk/roughnessmap_pars_fragment.glsl.js +7 -0
  1002. package/src/renderers/shaders/ShaderChunk/shadowmap_pars_fragment.glsl.js +337 -0
  1003. package/src/renderers/shaders/ShaderChunk/shadowmap_pars_vertex.glsl.js +71 -0
  1004. package/src/renderers/shaders/ShaderChunk/shadowmap_vertex.glsl.js +68 -0
  1005. package/src/renderers/shaders/ShaderChunk/shadowmask_pars_fragment.glsl.js +66 -0
  1006. package/src/renderers/shaders/ShaderChunk/skinbase_vertex.glsl.js +10 -0
  1007. package/src/renderers/shaders/ShaderChunk/skinning_pars_vertex.glsl.js +25 -0
  1008. package/src/renderers/shaders/ShaderChunk/skinning_vertex.glsl.js +15 -0
  1009. package/src/renderers/shaders/ShaderChunk/skinnormal_vertex.glsl.js +20 -0
  1010. package/src/renderers/shaders/ShaderChunk/specularmap_fragment.glsl.js +14 -0
  1011. package/src/renderers/shaders/ShaderChunk/specularmap_pars_fragment.glsl.js +7 -0
  1012. package/src/renderers/shaders/ShaderChunk/tonemapping_fragment.glsl.js +7 -0
  1013. package/src/renderers/shaders/ShaderChunk/tonemapping_pars_fragment.glsl.js +200 -0
  1014. package/src/renderers/shaders/ShaderChunk/transmission_fragment.glsl.js +36 -0
  1015. package/src/renderers/shaders/ShaderChunk/transmission_pars_fragment.glsl.js +235 -0
  1016. package/src/renderers/shaders/ShaderChunk/uv_pars_fragment.glsl.js +119 -0
  1017. package/src/renderers/shaders/ShaderChunk/uv_pars_vertex.glsl.js +145 -0
  1018. package/src/renderers/shaders/ShaderChunk/uv_vertex.glsl.js +122 -0
  1019. package/src/renderers/shaders/ShaderChunk/worldpos_vertex.glsl.js +21 -0
  1020. package/src/renderers/shaders/ShaderChunk.js +270 -0
  1021. package/src/renderers/shaders/ShaderLib/background.glsl.js +40 -0
  1022. package/src/renderers/shaders/ShaderLib/backgroundCube.glsl.js +63 -0
  1023. package/src/renderers/shaders/ShaderLib/cube.glsl.js +36 -0
  1024. package/src/renderers/shaders/ShaderLib/depth.glsl.js +114 -0
  1025. package/src/renderers/shaders/ShaderLib/distanceRGBA.glsl.js +78 -0
  1026. package/src/renderers/shaders/ShaderLib/equirect.glsl.js +35 -0
  1027. package/src/renderers/shaders/ShaderLib/linedashed.glsl.js +76 -0
  1028. package/src/renderers/shaders/ShaderLib/meshbasic.glsl.js +116 -0
  1029. package/src/renderers/shaders/ShaderLib/meshlambert.glsl.js +125 -0
  1030. package/src/renderers/shaders/ShaderLib/meshmatcap.glsl.js +112 -0
  1031. package/src/renderers/shaders/ShaderLib/meshnormal.glsl.js +87 -0
  1032. package/src/renderers/shaders/ShaderLib/meshphong.glsl.js +127 -0
  1033. package/src/renderers/shaders/ShaderLib/meshphysical.glsl.js +229 -0
  1034. package/src/renderers/shaders/ShaderLib/meshtoon.glsl.js +119 -0
  1035. package/src/renderers/shaders/ShaderLib/points.glsl.js +87 -0
  1036. package/src/renderers/shaders/ShaderLib/shadow.glsl.js +58 -0
  1037. package/src/renderers/shaders/ShaderLib/sprite.glsl.js +79 -0
  1038. package/src/renderers/shaders/ShaderLib/vsm.glsl.js +53 -0
  1039. package/src/renderers/shaders/ShaderLib.js +361 -0
  1040. package/src/renderers/shaders/UniformsLib.js +235 -0
  1041. package/src/renderers/shaders/UniformsUtils.js +112 -0
  1042. package/src/renderers/webgl/WebGLAnimation.js +53 -0
  1043. package/src/renderers/webgl/WebGLAttributes.js +237 -0
  1044. package/src/renderers/webgl/WebGLBackground.js +303 -0
  1045. package/src/renderers/webgl/WebGLBindingStates.js +594 -0
  1046. package/src/renderers/webgl/WebGLBufferRenderer.js +89 -0
  1047. package/src/renderers/webgl/WebGLCapabilities.js +145 -0
  1048. package/src/renderers/webgl/WebGLClipping.js +171 -0
  1049. package/src/renderers/webgl/WebGLCubeMaps.js +99 -0
  1050. package/src/renderers/webgl/WebGLCubeUVMaps.js +134 -0
  1051. package/src/renderers/webgl/WebGLExtensions.js +84 -0
  1052. package/src/renderers/webgl/WebGLGeometries.js +183 -0
  1053. package/src/renderers/webgl/WebGLIndexedBufferRenderer.js +100 -0
  1054. package/src/renderers/webgl/WebGLInfo.js +73 -0
  1055. package/src/renderers/webgl/WebGLLights.js +571 -0
  1056. package/src/renderers/webgl/WebGLMaterials.js +591 -0
  1057. package/src/renderers/webgl/WebGLMorphtargets.js +168 -0
  1058. package/src/renderers/webgl/WebGLObjects.js +92 -0
  1059. package/src/renderers/webgl/WebGLProgram.js +1091 -0
  1060. package/src/renderers/webgl/WebGLPrograms.js +667 -0
  1061. package/src/renderers/webgl/WebGLProperties.js +55 -0
  1062. package/src/renderers/webgl/WebGLRenderLists.js +238 -0
  1063. package/src/renderers/webgl/WebGLRenderStates.js +116 -0
  1064. package/src/renderers/webgl/WebGLShader.js +12 -0
  1065. package/src/renderers/webgl/WebGLShaderCache.js +124 -0
  1066. package/src/renderers/webgl/WebGLShadowMap.js +436 -0
  1067. package/src/renderers/webgl/WebGLState.js +1332 -0
  1068. package/src/renderers/webgl/WebGLTextures.js +2342 -0
  1069. package/src/renderers/webgl/WebGLUniforms.js +1166 -0
  1070. package/src/renderers/webgl/WebGLUniformsGroups.js +394 -0
  1071. package/src/renderers/webgl/WebGLUtils.js +213 -0
  1072. package/src/renderers/webgl-fallback/WebGLBackend.js +2633 -0
  1073. package/src/renderers/webgl-fallback/WebGLBufferRenderer.js +140 -0
  1074. package/src/renderers/webgl-fallback/nodes/GLSLNodeBuilder.js +1517 -0
  1075. package/src/renderers/webgl-fallback/utils/WebGLAttributeUtils.js +325 -0
  1076. package/src/renderers/webgl-fallback/utils/WebGLCapabilities.js +64 -0
  1077. package/src/renderers/webgl-fallback/utils/WebGLConstants.js +14 -0
  1078. package/src/renderers/webgl-fallback/utils/WebGLExtensions.js +83 -0
  1079. package/src/renderers/webgl-fallback/utils/WebGLState.js +1144 -0
  1080. package/src/renderers/webgl-fallback/utils/WebGLTextureUtils.js +1304 -0
  1081. package/src/renderers/webgl-fallback/utils/WebGLTimestampQueryPool.js +366 -0
  1082. package/src/renderers/webgl-fallback/utils/WebGLUtils.js +313 -0
  1083. package/src/renderers/webgpu/WebGPUBackend.js +2456 -0
  1084. package/src/renderers/webgpu/WebGPURenderer.Nodes.js +69 -0
  1085. package/src/renderers/webgpu/WebGPURenderer.js +106 -0
  1086. package/src/renderers/webgpu/nodes/BasicNodeLibrary.js +66 -0
  1087. package/src/renderers/webgpu/nodes/StandardNodeLibrary.js +100 -0
  1088. package/src/renderers/webgpu/nodes/WGSLNodeBuilder.js +2248 -0
  1089. package/src/renderers/webgpu/nodes/WGSLNodeFunction.js +187 -0
  1090. package/src/renderers/webgpu/nodes/WGSLNodeParser.js +25 -0
  1091. package/src/renderers/webgpu/utils/WebGPUAttributeUtils.js +449 -0
  1092. package/src/renderers/webgpu/utils/WebGPUBindingUtils.js +484 -0
  1093. package/src/renderers/webgpu/utils/WebGPUConstants.js +339 -0
  1094. package/src/renderers/webgpu/utils/WebGPUPipelineUtils.js +781 -0
  1095. package/src/renderers/webgpu/utils/WebGPUTexturePassUtils.js +439 -0
  1096. package/src/renderers/webgpu/utils/WebGPUTextureUtils.js +1505 -0
  1097. package/src/renderers/webgpu/utils/WebGPUTimestampQueryPool.js +287 -0
  1098. package/src/renderers/webgpu/utils/WebGPUUtils.js +227 -0
  1099. package/src/renderers/webxr/WebXRController.js +428 -0
  1100. package/src/renderers/webxr/WebXRDepthSensing.js +155 -0
  1101. package/src/renderers/webxr/WebXRManager.js +1103 -0
  1102. package/src/scenes/Fog.js +98 -0
  1103. package/src/scenes/FogExp2.js +86 -0
  1104. package/src/scenes/Scene.js +165 -0
  1105. package/src/textures/CanvasTexture.js +45 -0
  1106. package/src/textures/CompressedArrayTexture.js +89 -0
  1107. package/src/textures/CompressedCubeTexture.js +48 -0
  1108. package/src/textures/CompressedTexture.js +86 -0
  1109. package/src/textures/CubeTexture.js +81 -0
  1110. package/src/textures/Data3DTexture.js +112 -0
  1111. package/src/textures/DataArrayTexture.js +134 -0
  1112. package/src/textures/DataTexture.js +87 -0
  1113. package/src/textures/DepthTexture.js +104 -0
  1114. package/src/textures/ExternalTexture.js +56 -0
  1115. package/src/textures/FramebufferTexture.js +85 -0
  1116. package/src/textures/Source.js +230 -0
  1117. package/src/textures/Texture.js +801 -0
  1118. package/src/textures/VideoFrameTexture.js +72 -0
  1119. package/src/textures/VideoTexture.js +125 -0
  1120. package/src/utils.js +216 -0
@@ -0,0 +1,1505 @@
1
+ import {
2
+ GPUTextureFormat, GPUAddressMode, GPUFilterMode, GPUTextureDimension, GPUFeatureName, GPUTextureViewDimension
3
+ } from './WebGPUConstants.js';
4
+ import { ColorManagement } from '../../../math/ColorManagement.js';
5
+
6
+ import WebGPUTexturePassUtils from './WebGPUTexturePassUtils.js';
7
+
8
+ import {
9
+ ByteType, ShortType,
10
+ NearestFilter, NearestMipmapNearestFilter, NearestMipmapLinearFilter,
11
+ RepeatWrapping, MirroredRepeatWrapping,
12
+ RGB_ETC2_Format, RGBA_ETC2_EAC_Format,
13
+ RGBAFormat, RGBFormat, RedFormat, RGFormat, RGBA_S3TC_DXT1_Format, RGBA_S3TC_DXT3_Format, RGBA_S3TC_DXT5_Format, UnsignedByteType, FloatType, HalfFloatType, SRGBTransfer, DepthFormat, DepthStencilFormat,
14
+ RGBA_ASTC_4x4_Format, RGBA_ASTC_5x4_Format, RGBA_ASTC_5x5_Format, RGBA_ASTC_6x5_Format, RGBA_ASTC_6x6_Format, RGBA_ASTC_8x5_Format, RGBA_ASTC_8x6_Format, RGBA_ASTC_8x8_Format, RGBA_ASTC_10x5_Format,
15
+ RGBA_ASTC_10x6_Format, RGBA_ASTC_10x8_Format, RGBA_ASTC_10x10_Format, RGBA_ASTC_12x10_Format, RGBA_ASTC_12x12_Format, UnsignedIntType, UnsignedShortType, UnsignedInt248Type, UnsignedInt5999Type,
16
+ NeverCompare, AlwaysCompare, LessCompare, LessEqualCompare, EqualCompare, GreaterEqualCompare, GreaterCompare, NotEqualCompare, IntType, RedIntegerFormat, RGIntegerFormat, RGBAIntegerFormat,
17
+ UnsignedInt101111Type, RGBA_BPTC_Format, RGB_ETC1_Format, RGB_S3TC_DXT1_Format, RED_RGTC1_Format, SIGNED_RED_RGTC1_Format, RED_GREEN_RGTC2_Format, SIGNED_RED_GREEN_RGTC2_Format
18
+ } from '../../../constants.js';
19
+ import { CubeTexture } from '../../../textures/CubeTexture.js';
20
+ import { DepthTexture } from '../../../textures/DepthTexture.js';
21
+ import { Texture } from '../../../textures/Texture.js';
22
+ import { warn, error } from '../../../utils.js';
23
+
24
+ const _compareToWebGPU = {
25
+ [ NeverCompare ]: 'never',
26
+ [ LessCompare ]: 'less',
27
+ [ EqualCompare ]: 'equal',
28
+ [ LessEqualCompare ]: 'less-equal',
29
+ [ GreaterCompare ]: 'greater',
30
+ [ GreaterEqualCompare ]: 'greater-equal',
31
+ [ AlwaysCompare ]: 'always',
32
+ [ NotEqualCompare ]: 'not-equal'
33
+ };
34
+
35
+ const _flipMap = [ 0, 1, 3, 2, 4, 5 ];
36
+
37
+ /**
38
+ * A WebGPU backend utility module for managing textures.
39
+ *
40
+ * @private
41
+ */
42
+ class WebGPUTextureUtils {
43
+
44
+ /**
45
+ * Constructs a new utility object.
46
+ *
47
+ * @param {WebGPUBackend} backend - The WebGPU backend.
48
+ */
49
+ constructor( backend ) {
50
+
51
+ /**
52
+ * A reference to the WebGPU backend.
53
+ *
54
+ * @type {WebGPUBackend}
55
+ */
56
+ this.backend = backend;
57
+
58
+ /**
59
+ * A reference to the pass utils.
60
+ *
61
+ * @type {?WebGPUTexturePassUtils}
62
+ * @default null
63
+ */
64
+ this._passUtils = null;
65
+
66
+ /**
67
+ * A dictionary for managing default textures. The key
68
+ * is the texture format, the value the texture object.
69
+ *
70
+ * @type {Object<string,Texture>}
71
+ */
72
+ this.defaultTexture = {};
73
+
74
+ /**
75
+ * A dictionary for managing default cube textures. The key
76
+ * is the texture format, the value the texture object.
77
+ *
78
+ * @type {Object<string,CubeTexture>}
79
+ */
80
+ this.defaultCubeTexture = {};
81
+
82
+ /**
83
+ * A default video frame.
84
+ *
85
+ * @type {?VideoFrame}
86
+ * @default null
87
+ */
88
+ this.defaultVideoFrame = null;
89
+
90
+ /**
91
+ * Represents the color attachment of the default framebuffer.
92
+ *
93
+ * @type {?GPUTexture}
94
+ * @default null
95
+ */
96
+ this.colorBuffer = null;
97
+
98
+ /**
99
+ * Represents the depth attachment of the default framebuffer.
100
+ *
101
+ * @type {DepthTexture}
102
+ */
103
+ this.depthTexture = new DepthTexture();
104
+ this.depthTexture.name = 'depthBuffer';
105
+
106
+ }
107
+
108
+ /**
109
+ * Creates a GPU sampler for the given texture.
110
+ *
111
+ * @param {Texture} texture - The texture to create the sampler for.
112
+ */
113
+ createSampler( texture ) {
114
+
115
+ const backend = this.backend;
116
+ const device = backend.device;
117
+
118
+ const textureGPU = backend.get( texture );
119
+
120
+ const samplerDescriptorGPU = {
121
+ addressModeU: this._convertAddressMode( texture.wrapS ),
122
+ addressModeV: this._convertAddressMode( texture.wrapT ),
123
+ addressModeW: this._convertAddressMode( texture.wrapR ),
124
+ magFilter: this._convertFilterMode( texture.magFilter ),
125
+ minFilter: this._convertFilterMode( texture.minFilter ),
126
+ mipmapFilter: this._convertFilterMode( texture.minFilter ),
127
+ maxAnisotropy: 1
128
+ };
129
+
130
+ // anisotropy can only be used when all filter modes are set to linear.
131
+
132
+ if ( samplerDescriptorGPU.magFilter === GPUFilterMode.Linear && samplerDescriptorGPU.minFilter === GPUFilterMode.Linear && samplerDescriptorGPU.mipmapFilter === GPUFilterMode.Linear ) {
133
+
134
+ samplerDescriptorGPU.maxAnisotropy = texture.anisotropy;
135
+
136
+ }
137
+
138
+ if ( texture.isDepthTexture && texture.compareFunction !== null ) {
139
+
140
+ samplerDescriptorGPU.compare = _compareToWebGPU[ texture.compareFunction ];
141
+
142
+ }
143
+
144
+ textureGPU.sampler = device.createSampler( samplerDescriptorGPU );
145
+
146
+ }
147
+
148
+ /**
149
+ * Creates a default texture for the given texture that can be used
150
+ * as a placeholder until the actual texture is ready for usage.
151
+ *
152
+ * @param {Texture} texture - The texture to create a default texture for.
153
+ */
154
+ createDefaultTexture( texture ) {
155
+
156
+ let textureGPU;
157
+
158
+ const format = getFormat( texture );
159
+
160
+ if ( texture.isCubeTexture ) {
161
+
162
+ textureGPU = this._getDefaultCubeTextureGPU( format );
163
+
164
+ } else {
165
+
166
+ textureGPU = this._getDefaultTextureGPU( format );
167
+
168
+ }
169
+
170
+ this.backend.get( texture ).texture = textureGPU;
171
+
172
+ }
173
+
174
+ /**
175
+ * Defines a texture on the GPU for the given texture object.
176
+ *
177
+ * @param {Texture} texture - The texture.
178
+ * @param {Object} [options={}] - Optional configuration parameter.
179
+ */
180
+ createTexture( texture, options = {} ) {
181
+
182
+ const backend = this.backend;
183
+ const textureData = backend.get( texture );
184
+
185
+ if ( textureData.initialized ) {
186
+
187
+ throw new Error( 'WebGPUTextureUtils: Texture already initialized.' );
188
+
189
+ }
190
+
191
+ if ( texture.isExternalTexture ) {
192
+
193
+ textureData.texture = texture.sourceTexture;
194
+ textureData.initialized = true;
195
+
196
+ return;
197
+
198
+ }
199
+
200
+ if ( options.needsMipmaps === undefined ) options.needsMipmaps = false;
201
+ if ( options.levels === undefined ) options.levels = 1;
202
+ if ( options.depth === undefined ) options.depth = 1;
203
+
204
+ const { width, height, depth, levels } = options;
205
+
206
+ if ( texture.isFramebufferTexture ) {
207
+
208
+ if ( options.renderTarget ) {
209
+
210
+ options.format = this.backend.utils.getCurrentColorFormat( options.renderTarget );
211
+
212
+ } else {
213
+
214
+ options.format = this.backend.utils.getPreferredCanvasFormat();
215
+
216
+ }
217
+
218
+ }
219
+
220
+ const dimension = this._getDimension( texture );
221
+ const format = texture.internalFormat || options.format || getFormat( texture, backend.device );
222
+
223
+ textureData.format = format;
224
+
225
+ const { samples, primarySamples, isMSAA } = backend.utils.getTextureSampleData( texture );
226
+
227
+ let usage = GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.COPY_SRC;
228
+
229
+ if ( texture.isStorageTexture === true ) {
230
+
231
+ usage |= GPUTextureUsage.STORAGE_BINDING;
232
+
233
+ }
234
+
235
+ if ( texture.isCompressedTexture !== true && texture.isCompressedArrayTexture !== true && format !== GPUTextureFormat.RGB9E5UFloat ) {
236
+
237
+ usage |= GPUTextureUsage.RENDER_ATTACHMENT;
238
+
239
+ }
240
+
241
+ const textureDescriptorGPU = {
242
+ label: texture.name,
243
+ size: {
244
+ width: width,
245
+ height: height,
246
+ depthOrArrayLayers: depth,
247
+ },
248
+ mipLevelCount: levels,
249
+ sampleCount: primarySamples,
250
+ dimension: dimension,
251
+ format: format,
252
+ usage: usage
253
+ };
254
+
255
+ // texture creation
256
+
257
+ if ( format === undefined ) {
258
+
259
+ warn( 'WebGPURenderer: Texture format not supported.' );
260
+
261
+ this.createDefaultTexture( texture );
262
+ return;
263
+
264
+ }
265
+
266
+ if ( texture.isCubeTexture ) {
267
+
268
+ textureDescriptorGPU.textureBindingViewDimension = GPUTextureViewDimension.Cube;
269
+
270
+ }
271
+
272
+ textureData.texture = backend.device.createTexture( textureDescriptorGPU );
273
+
274
+ if ( isMSAA ) {
275
+
276
+ const msaaTextureDescriptorGPU = Object.assign( {}, textureDescriptorGPU );
277
+
278
+ msaaTextureDescriptorGPU.label = msaaTextureDescriptorGPU.label + '-msaa';
279
+ msaaTextureDescriptorGPU.sampleCount = samples;
280
+ msaaTextureDescriptorGPU.mipLevelCount = 1; // See https://www.w3.org/TR/webgpu/#texture-creation
281
+
282
+ textureData.msaaTexture = backend.device.createTexture( msaaTextureDescriptorGPU );
283
+
284
+ }
285
+
286
+ textureData.initialized = true;
287
+
288
+ textureData.textureDescriptorGPU = textureDescriptorGPU;
289
+
290
+ }
291
+
292
+ /**
293
+ * Destroys the GPU data for the given texture object.
294
+ *
295
+ * @param {Texture} texture - The texture.
296
+ */
297
+ destroyTexture( texture ) {
298
+
299
+ const backend = this.backend;
300
+ const textureData = backend.get( texture );
301
+
302
+ if ( textureData.texture !== undefined ) textureData.texture.destroy();
303
+
304
+ if ( textureData.msaaTexture !== undefined ) textureData.msaaTexture.destroy();
305
+
306
+ backend.delete( texture );
307
+
308
+ }
309
+
310
+ /**
311
+ * Destroys the GPU sampler for the given texture.
312
+ *
313
+ * @param {Texture} texture - The texture to destroy the sampler for.
314
+ */
315
+ destroySampler( texture ) {
316
+
317
+ const backend = this.backend;
318
+ const textureData = backend.get( texture );
319
+
320
+ delete textureData.sampler;
321
+
322
+ }
323
+
324
+ /**
325
+ * Generates mipmaps for the given texture.
326
+ *
327
+ * @param {Texture} texture - The texture.
328
+ */
329
+ generateMipmaps( texture ) {
330
+
331
+ const textureData = this.backend.get( texture );
332
+
333
+ if ( texture.isCubeTexture ) {
334
+
335
+ for ( let i = 0; i < 6; i ++ ) {
336
+
337
+ this._generateMipmaps( textureData.texture, textureData.textureDescriptorGPU, i );
338
+
339
+ }
340
+
341
+ } else {
342
+
343
+ const depth = texture.image.depth || 1;
344
+
345
+ for ( let i = 0; i < depth; i ++ ) {
346
+
347
+ this._generateMipmaps( textureData.texture, textureData.textureDescriptorGPU, i );
348
+
349
+ }
350
+
351
+ }
352
+
353
+ }
354
+
355
+ /**
356
+ * Returns the color buffer representing the color
357
+ * attachment of the default framebuffer.
358
+ *
359
+ * @return {GPUTexture} The color buffer.
360
+ */
361
+ getColorBuffer() {
362
+
363
+ if ( this.colorBuffer ) this.colorBuffer.destroy();
364
+
365
+ const backend = this.backend;
366
+ const { width, height } = backend.getDrawingBufferSize();
367
+
368
+ this.colorBuffer = backend.device.createTexture( {
369
+ label: 'colorBuffer',
370
+ size: {
371
+ width: width,
372
+ height: height,
373
+ depthOrArrayLayers: 1
374
+ },
375
+ sampleCount: backend.utils.getSampleCount( backend.renderer.samples ),
376
+ format: backend.utils.getPreferredCanvasFormat(),
377
+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.COPY_SRC
378
+ } );
379
+
380
+ return this.colorBuffer;
381
+
382
+ }
383
+
384
+ /**
385
+ * Returns the depth buffer representing the depth
386
+ * attachment of the default framebuffer.
387
+ *
388
+ * @param {boolean} [depth=true] - Whether depth is enabled or not.
389
+ * @param {boolean} [stencil=false] - Whether stencil is enabled or not.
390
+ * @return {GPUTexture} The depth buffer.
391
+ */
392
+ getDepthBuffer( depth = true, stencil = false ) {
393
+
394
+ const backend = this.backend;
395
+ const { width, height } = backend.getDrawingBufferSize();
396
+
397
+ const depthTexture = this.depthTexture;
398
+ const depthTextureGPU = backend.get( depthTexture ).texture;
399
+
400
+ let format, type;
401
+
402
+ if ( stencil ) {
403
+
404
+ format = DepthStencilFormat;
405
+ type = UnsignedInt248Type;
406
+
407
+ } else if ( depth ) {
408
+
409
+ format = DepthFormat;
410
+ type = UnsignedIntType;
411
+
412
+ }
413
+
414
+ if ( depthTextureGPU !== undefined ) {
415
+
416
+ if ( depthTexture.image.width === width && depthTexture.image.height === height && depthTexture.format === format && depthTexture.type === type ) {
417
+
418
+ return depthTextureGPU;
419
+
420
+ }
421
+
422
+ this.destroyTexture( depthTexture );
423
+
424
+ }
425
+
426
+ depthTexture.name = 'depthBuffer';
427
+ depthTexture.format = format;
428
+ depthTexture.type = type;
429
+ depthTexture.image.width = width;
430
+ depthTexture.image.height = height;
431
+
432
+ this.createTexture( depthTexture, { width, height } );
433
+
434
+ return backend.get( depthTexture ).texture;
435
+
436
+ }
437
+
438
+ /**
439
+ * Uploads the updated texture data to the GPU.
440
+ *
441
+ * @param {Texture} texture - The texture.
442
+ * @param {Object} [options={}] - Optional configuration parameter.
443
+ */
444
+ updateTexture( texture, options ) {
445
+
446
+ const textureData = this.backend.get( texture );
447
+ const mipmaps = texture.mipmaps;
448
+
449
+ const { textureDescriptorGPU } = textureData;
450
+
451
+ if ( texture.isRenderTargetTexture || ( textureDescriptorGPU === undefined /* unsupported texture format */ ) )
452
+ return;
453
+
454
+ // transfer texture data
455
+
456
+ if ( texture.isDataTexture ) {
457
+
458
+ if ( mipmaps.length > 0 ) {
459
+
460
+ for ( let i = 0, il = mipmaps.length; i < il; i ++ ) {
461
+
462
+ const mipmap = mipmaps[ i ];
463
+
464
+ this._copyBufferToTexture( mipmap, textureData.texture, textureDescriptorGPU, 0, texture.flipY, 0, i );
465
+
466
+ }
467
+
468
+
469
+ } else {
470
+
471
+ this._copyBufferToTexture( options.image, textureData.texture, textureDescriptorGPU, 0, texture.flipY );
472
+
473
+ }
474
+
475
+ } else if ( texture.isArrayTexture || texture.isDataArrayTexture || texture.isData3DTexture ) {
476
+
477
+ for ( let i = 0; i < options.image.depth; i ++ ) {
478
+
479
+ this._copyBufferToTexture( options.image, textureData.texture, textureDescriptorGPU, i, texture.flipY, i );
480
+
481
+ }
482
+
483
+ } else if ( texture.isCompressedTexture || texture.isCompressedArrayTexture ) {
484
+
485
+ this._copyCompressedBufferToTexture( texture.mipmaps, textureData.texture, textureDescriptorGPU );
486
+
487
+ } else if ( texture.isCubeTexture ) {
488
+
489
+ this._copyCubeMapToTexture( texture, textureData.texture, textureDescriptorGPU );
490
+
491
+ } else {
492
+
493
+ if ( mipmaps.length > 0 ) {
494
+
495
+ for ( let i = 0, il = mipmaps.length; i < il; i ++ ) {
496
+
497
+ const mipmap = mipmaps[ i ];
498
+
499
+ this._copyImageToTexture( mipmap, textureData.texture, textureDescriptorGPU, 0, texture.flipY, texture.premultiplyAlpha, i );
500
+
501
+ }
502
+
503
+
504
+ } else {
505
+
506
+ this._copyImageToTexture( options.image, textureData.texture, textureDescriptorGPU, 0, texture.flipY, texture.premultiplyAlpha );
507
+
508
+ }
509
+
510
+ }
511
+
512
+ //
513
+
514
+ textureData.version = texture.version;
515
+
516
+ }
517
+
518
+ /**
519
+ * Returns texture data as a typed array.
520
+ *
521
+ * @async
522
+ * @param {Texture} texture - The texture to copy.
523
+ * @param {number} x - The x coordinate of the copy origin.
524
+ * @param {number} y - The y coordinate of the copy origin.
525
+ * @param {number} width - The width of the copy.
526
+ * @param {number} height - The height of the copy.
527
+ * @param {number} faceIndex - The face index.
528
+ * @return {Promise<TypedArray>} A Promise that resolves with a typed array when the copy operation has finished.
529
+ */
530
+ async copyTextureToBuffer( texture, x, y, width, height, faceIndex ) {
531
+
532
+ const device = this.backend.device;
533
+
534
+ const textureData = this.backend.get( texture );
535
+ const textureGPU = textureData.texture;
536
+ const format = textureData.textureDescriptorGPU.format;
537
+ const bytesPerTexel = this._getBytesPerTexel( format );
538
+
539
+ let bytesPerRow = width * bytesPerTexel;
540
+ bytesPerRow = Math.ceil( bytesPerRow / 256 ) * 256; // Align to 256 bytes
541
+
542
+ const readBuffer = device.createBuffer(
543
+ {
544
+ size: ( ( height - 1 ) * bytesPerRow ) + ( width * bytesPerTexel ), // see https://github.com/mrdoob/three.js/issues/31658#issuecomment-3229442010
545
+ usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
546
+ }
547
+ );
548
+
549
+ const encoder = device.createCommandEncoder();
550
+
551
+ encoder.copyTextureToBuffer(
552
+ {
553
+ texture: textureGPU,
554
+ origin: { x, y, z: faceIndex },
555
+ },
556
+ {
557
+ buffer: readBuffer,
558
+ bytesPerRow: bytesPerRow
559
+ },
560
+ {
561
+ width: width,
562
+ height: height
563
+ }
564
+
565
+ );
566
+
567
+ const typedArrayType = this._getTypedArrayType( format );
568
+
569
+ device.queue.submit( [ encoder.finish() ] );
570
+
571
+ await readBuffer.mapAsync( GPUMapMode.READ );
572
+
573
+ const buffer = readBuffer.getMappedRange();
574
+
575
+ return new typedArrayType( buffer );
576
+
577
+ }
578
+
579
+ /**
580
+ * Returns the default GPU texture for the given format.
581
+ *
582
+ * @private
583
+ * @param {string} format - The GPU format.
584
+ * @return {GPUTexture} The GPU texture.
585
+ */
586
+ _getDefaultTextureGPU( format ) {
587
+
588
+ let defaultTexture = this.defaultTexture[ format ];
589
+
590
+ if ( defaultTexture === undefined ) {
591
+
592
+ const texture = new Texture();
593
+ texture.minFilter = NearestFilter;
594
+ texture.magFilter = NearestFilter;
595
+
596
+ this.createTexture( texture, { width: 1, height: 1, format } );
597
+
598
+ this.defaultTexture[ format ] = defaultTexture = texture;
599
+
600
+ }
601
+
602
+ return this.backend.get( defaultTexture ).texture;
603
+
604
+ }
605
+
606
+ /**
607
+ * Returns the default GPU cube texture for the given format.
608
+ *
609
+ * @private
610
+ * @param {string} format - The GPU format.
611
+ * @return {GPUTexture} The GPU texture.
612
+ */
613
+ _getDefaultCubeTextureGPU( format ) {
614
+
615
+ let defaultCubeTexture = this.defaultTexture[ format ];
616
+
617
+ if ( defaultCubeTexture === undefined ) {
618
+
619
+ const texture = new CubeTexture();
620
+ texture.minFilter = NearestFilter;
621
+ texture.magFilter = NearestFilter;
622
+
623
+ this.createTexture( texture, { width: 1, height: 1, depth: 6 } );
624
+
625
+ this.defaultCubeTexture[ format ] = defaultCubeTexture = texture;
626
+
627
+ }
628
+
629
+ return this.backend.get( defaultCubeTexture ).texture;
630
+
631
+ }
632
+
633
+ /**
634
+ * Uploads cube texture image data to the GPU memory.
635
+ *
636
+ * @private
637
+ * @param {CubeTexture} texture - The cube texture.
638
+ * @param {GPUTexture} textureGPU - The GPU texture.
639
+ * @param {Object} textureDescriptorGPU - The GPU texture descriptor.
640
+ */
641
+ _copyCubeMapToTexture( texture, textureGPU, textureDescriptorGPU ) {
642
+
643
+ const images = texture.images;
644
+ const mipmaps = texture.mipmaps;
645
+
646
+ for ( let i = 0; i < 6; i ++ ) {
647
+
648
+ const image = images[ i ];
649
+
650
+ const flipIndex = texture.flipY === true ? _flipMap[ i ] : i;
651
+
652
+ if ( image.isDataTexture ) {
653
+
654
+ this._copyBufferToTexture( image.image, textureGPU, textureDescriptorGPU, flipIndex, texture.flipY );
655
+
656
+ } else {
657
+
658
+ this._copyImageToTexture( image, textureGPU, textureDescriptorGPU, flipIndex, texture.flipY, texture.premultiplyAlpha );
659
+
660
+ }
661
+
662
+ for ( let j = 0; j < mipmaps.length; j ++ ) {
663
+
664
+ const mipmap = mipmaps[ j ];
665
+ const image = mipmap.images[ i ];
666
+
667
+ if ( image.isDataTexture ) {
668
+
669
+ this._copyBufferToTexture( image.image, textureGPU, textureDescriptorGPU, flipIndex, texture.flipY, 0, j + 1 );
670
+
671
+ } else {
672
+
673
+ this._copyImageToTexture( image, textureGPU, textureDescriptorGPU, flipIndex, texture.flipY, texture.premultiplyAlpha, j + 1 );
674
+
675
+ }
676
+
677
+
678
+ }
679
+
680
+ }
681
+
682
+ }
683
+
684
+ /**
685
+ * Uploads texture image data to the GPU memory.
686
+ *
687
+ * @private
688
+ * @param {HTMLImageElement|ImageBitmap|HTMLCanvasElement} image - The image data.
689
+ * @param {GPUTexture} textureGPU - The GPU texture.
690
+ * @param {Object} textureDescriptorGPU - The GPU texture descriptor.
691
+ * @param {number} originDepth - The origin depth.
692
+ * @param {boolean} flipY - Whether to flip texture data along their vertical axis or not.
693
+ * @param {boolean} premultiplyAlpha - Whether the texture should have its RGB channels premultiplied by the alpha channel or not.
694
+ * @param {number} [mipLevel=0] - The mip level where the data should be copied to.
695
+ */
696
+ _copyImageToTexture( image, textureGPU, textureDescriptorGPU, originDepth, flipY, premultiplyAlpha, mipLevel = 0 ) {
697
+
698
+ const device = this.backend.device;
699
+
700
+ const width = ( mipLevel > 0 ) ? image.width : textureDescriptorGPU.size.width;
701
+ const height = ( mipLevel > 0 ) ? image.height : textureDescriptorGPU.size.height;
702
+
703
+ device.queue.copyExternalImageToTexture(
704
+ {
705
+ source: image,
706
+ flipY: flipY
707
+ }, {
708
+ texture: textureGPU,
709
+ mipLevel: mipLevel,
710
+ origin: { x: 0, y: 0, z: originDepth },
711
+ premultipliedAlpha: premultiplyAlpha
712
+ }, {
713
+ width: width,
714
+ height: height,
715
+ depthOrArrayLayers: 1
716
+ }
717
+ );
718
+
719
+ }
720
+
721
+ /**
722
+ * Returns the pass utils singleton.
723
+ *
724
+ * @private
725
+ * @return {WebGPUTexturePassUtils} The utils instance.
726
+ */
727
+ _getPassUtils() {
728
+
729
+ let passUtils = this._passUtils;
730
+
731
+ if ( passUtils === null ) {
732
+
733
+ this._passUtils = passUtils = new WebGPUTexturePassUtils( this.backend.device );
734
+
735
+ }
736
+
737
+ return passUtils;
738
+
739
+ }
740
+
741
+ /**
742
+ * Generates mipmaps for the given GPU texture.
743
+ *
744
+ * @private
745
+ * @param {GPUTexture} textureGPU - The GPU texture object.
746
+ * @param {Object} textureDescriptorGPU - The texture descriptor.
747
+ * @param {number} [baseArrayLayer=0] - The index of the first array layer accessible to the texture view.
748
+ */
749
+ _generateMipmaps( textureGPU, textureDescriptorGPU, baseArrayLayer = 0 ) {
750
+
751
+ this._getPassUtils().generateMipmaps( textureGPU, textureDescriptorGPU, baseArrayLayer );
752
+
753
+ }
754
+
755
+ /**
756
+ * Flip the contents of the given GPU texture along its vertical axis.
757
+ *
758
+ * @private
759
+ * @param {GPUTexture} textureGPU - The GPU texture object.
760
+ * @param {Object} textureDescriptorGPU - The texture descriptor.
761
+ * @param {number} [originDepth=0] - The origin depth.
762
+ */
763
+ _flipY( textureGPU, textureDescriptorGPU, originDepth = 0 ) {
764
+
765
+ this._getPassUtils().flipY( textureGPU, textureDescriptorGPU, originDepth );
766
+
767
+ }
768
+
769
+ /**
770
+ * Uploads texture buffer data to the GPU memory.
771
+ *
772
+ * @private
773
+ * @param {Object} image - An object defining the image buffer data.
774
+ * @param {GPUTexture} textureGPU - The GPU texture.
775
+ * @param {Object} textureDescriptorGPU - The GPU texture descriptor.
776
+ * @param {number} originDepth - The origin depth.
777
+ * @param {boolean} flipY - Whether to flip texture data along their vertical axis or not.
778
+ * @param {number} [depth=0] - The depth offset when copying array or 3D texture data.
779
+ * @param {number} [mipLevel=0] - The mip level where the data should be copied to.
780
+ */
781
+ _copyBufferToTexture( image, textureGPU, textureDescriptorGPU, originDepth, flipY, depth = 0, mipLevel = 0 ) {
782
+
783
+ // @TODO: Consider to use GPUCommandEncoder.copyBufferToTexture()
784
+ // @TODO: Consider to support valid buffer layouts with other formats like RGB
785
+
786
+ const device = this.backend.device;
787
+
788
+ const data = image.data;
789
+
790
+ const bytesPerTexel = this._getBytesPerTexel( textureDescriptorGPU.format );
791
+ const bytesPerRow = image.width * bytesPerTexel;
792
+
793
+ device.queue.writeTexture(
794
+ {
795
+ texture: textureGPU,
796
+ mipLevel: mipLevel,
797
+ origin: { x: 0, y: 0, z: originDepth }
798
+ },
799
+ data,
800
+ {
801
+ offset: image.width * image.height * bytesPerTexel * depth,
802
+ bytesPerRow
803
+ },
804
+ {
805
+ width: image.width,
806
+ height: image.height,
807
+ depthOrArrayLayers: 1
808
+ } );
809
+
810
+ if ( flipY === true ) {
811
+
812
+ this._flipY( textureGPU, textureDescriptorGPU, originDepth );
813
+
814
+ }
815
+
816
+ }
817
+
818
+ /**
819
+ * Uploads compressed texture data to the GPU memory.
820
+ *
821
+ * @private
822
+ * @param {Array<Object>} mipmaps - An array with mipmap data.
823
+ * @param {GPUTexture} textureGPU - The GPU texture.
824
+ * @param {Object} textureDescriptorGPU - The GPU texture descriptor.
825
+ */
826
+ _copyCompressedBufferToTexture( mipmaps, textureGPU, textureDescriptorGPU ) {
827
+
828
+ // @TODO: Consider to use GPUCommandEncoder.copyBufferToTexture()
829
+
830
+ const device = this.backend.device;
831
+
832
+ const blockData = this._getBlockData( textureDescriptorGPU.format );
833
+ const isArrayTexture = textureDescriptorGPU.size.depthOrArrayLayers > 1;
834
+
835
+ for ( let i = 0; i < mipmaps.length; i ++ ) {
836
+
837
+ const mipmap = mipmaps[ i ];
838
+
839
+ const width = mipmap.width;
840
+ const height = mipmap.height;
841
+ const depth = isArrayTexture ? textureDescriptorGPU.size.depthOrArrayLayers : 1;
842
+
843
+ const bytesPerRow = Math.ceil( width / blockData.width ) * blockData.byteLength;
844
+ const bytesPerImage = bytesPerRow * Math.ceil( height / blockData.height );
845
+
846
+ for ( let j = 0; j < depth; j ++ ) {
847
+
848
+ device.queue.writeTexture(
849
+ {
850
+ texture: textureGPU,
851
+ mipLevel: i,
852
+ origin: { x: 0, y: 0, z: j }
853
+ },
854
+ mipmap.data,
855
+ {
856
+ offset: j * bytesPerImage,
857
+ bytesPerRow,
858
+ rowsPerImage: Math.ceil( height / blockData.height )
859
+ },
860
+ {
861
+ width: Math.ceil( width / blockData.width ) * blockData.width,
862
+ height: Math.ceil( height / blockData.height ) * blockData.height,
863
+ depthOrArrayLayers: 1
864
+ }
865
+ );
866
+
867
+ }
868
+
869
+ }
870
+
871
+ }
872
+
873
+ /**
874
+ * This method is only relevant for compressed texture formats. It returns a block
875
+ * data descriptor for the given GPU compressed texture format.
876
+ *
877
+ * @private
878
+ * @param {string} format - The GPU compressed texture format.
879
+ * @return {Object} The block data descriptor.
880
+ */
881
+ _getBlockData( format ) {
882
+
883
+ if ( format === GPUTextureFormat.BC1RGBAUnorm || format === GPUTextureFormat.BC1RGBAUnormSRGB ) return { byteLength: 8, width: 4, height: 4 }; // DXT1
884
+ if ( format === GPUTextureFormat.BC2RGBAUnorm || format === GPUTextureFormat.BC2RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // DXT3
885
+ if ( format === GPUTextureFormat.BC3RGBAUnorm || format === GPUTextureFormat.BC3RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // DXT5
886
+ if ( format === GPUTextureFormat.BC4RUnorm || format === GPUTextureFormat.BC4RSnorm ) return { byteLength: 8, width: 4, height: 4 }; // RGTC1
887
+ if ( format === GPUTextureFormat.BC5RGUnorm || format === GPUTextureFormat.BC5RGSnorm ) return { byteLength: 16, width: 4, height: 4 }; // RGTC2
888
+ if ( format === GPUTextureFormat.BC6HRGBUFloat || format === GPUTextureFormat.BC6HRGBFloat ) return { byteLength: 16, width: 4, height: 4 }; // BPTC (float)
889
+ if ( format === GPUTextureFormat.BC7RGBAUnorm || format === GPUTextureFormat.BC7RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // BPTC (unorm)
890
+
891
+ if ( format === GPUTextureFormat.ETC2RGB8Unorm || format === GPUTextureFormat.ETC2RGB8UnormSRGB ) return { byteLength: 8, width: 4, height: 4 };
892
+ if ( format === GPUTextureFormat.ETC2RGB8A1Unorm || format === GPUTextureFormat.ETC2RGB8A1UnormSRGB ) return { byteLength: 8, width: 4, height: 4 };
893
+ if ( format === GPUTextureFormat.ETC2RGBA8Unorm || format === GPUTextureFormat.ETC2RGBA8UnormSRGB ) return { byteLength: 16, width: 4, height: 4 };
894
+ if ( format === GPUTextureFormat.EACR11Unorm ) return { byteLength: 8, width: 4, height: 4 };
895
+ if ( format === GPUTextureFormat.EACR11Snorm ) return { byteLength: 8, width: 4, height: 4 };
896
+ if ( format === GPUTextureFormat.EACRG11Unorm ) return { byteLength: 16, width: 4, height: 4 };
897
+ if ( format === GPUTextureFormat.EACRG11Snorm ) return { byteLength: 16, width: 4, height: 4 };
898
+
899
+ if ( format === GPUTextureFormat.ASTC4x4Unorm || format === GPUTextureFormat.ASTC4x4UnormSRGB ) return { byteLength: 16, width: 4, height: 4 };
900
+ if ( format === GPUTextureFormat.ASTC5x4Unorm || format === GPUTextureFormat.ASTC5x4UnormSRGB ) return { byteLength: 16, width: 5, height: 4 };
901
+ if ( format === GPUTextureFormat.ASTC5x5Unorm || format === GPUTextureFormat.ASTC5x5UnormSRGB ) return { byteLength: 16, width: 5, height: 5 };
902
+ if ( format === GPUTextureFormat.ASTC6x5Unorm || format === GPUTextureFormat.ASTC6x5UnormSRGB ) return { byteLength: 16, width: 6, height: 5 };
903
+ if ( format === GPUTextureFormat.ASTC6x6Unorm || format === GPUTextureFormat.ASTC6x6UnormSRGB ) return { byteLength: 16, width: 6, height: 6 };
904
+ if ( format === GPUTextureFormat.ASTC8x5Unorm || format === GPUTextureFormat.ASTC8x5UnormSRGB ) return { byteLength: 16, width: 8, height: 5 };
905
+ if ( format === GPUTextureFormat.ASTC8x6Unorm || format === GPUTextureFormat.ASTC8x6UnormSRGB ) return { byteLength: 16, width: 8, height: 6 };
906
+ if ( format === GPUTextureFormat.ASTC8x8Unorm || format === GPUTextureFormat.ASTC8x8UnormSRGB ) return { byteLength: 16, width: 8, height: 8 };
907
+ if ( format === GPUTextureFormat.ASTC10x5Unorm || format === GPUTextureFormat.ASTC10x5UnormSRGB ) return { byteLength: 16, width: 10, height: 5 };
908
+ if ( format === GPUTextureFormat.ASTC10x6Unorm || format === GPUTextureFormat.ASTC10x6UnormSRGB ) return { byteLength: 16, width: 10, height: 6 };
909
+ if ( format === GPUTextureFormat.ASTC10x8Unorm || format === GPUTextureFormat.ASTC10x8UnormSRGB ) return { byteLength: 16, width: 10, height: 8 };
910
+ if ( format === GPUTextureFormat.ASTC10x10Unorm || format === GPUTextureFormat.ASTC10x10UnormSRGB ) return { byteLength: 16, width: 10, height: 10 };
911
+ if ( format === GPUTextureFormat.ASTC12x10Unorm || format === GPUTextureFormat.ASTC12x10UnormSRGB ) return { byteLength: 16, width: 12, height: 10 };
912
+ if ( format === GPUTextureFormat.ASTC12x12Unorm || format === GPUTextureFormat.ASTC12x12UnormSRGB ) return { byteLength: 16, width: 12, height: 12 };
913
+
914
+ }
915
+
916
+ /**
917
+ * Converts the three.js uv wrapping constants to GPU address mode constants.
918
+ *
919
+ * @private
920
+ * @param {number} value - The three.js constant defining a uv wrapping mode.
921
+ * @return {string} The GPU address mode.
922
+ */
923
+ _convertAddressMode( value ) {
924
+
925
+ let addressMode = GPUAddressMode.ClampToEdge;
926
+
927
+ if ( value === RepeatWrapping ) {
928
+
929
+ addressMode = GPUAddressMode.Repeat;
930
+
931
+ } else if ( value === MirroredRepeatWrapping ) {
932
+
933
+ addressMode = GPUAddressMode.MirrorRepeat;
934
+
935
+ }
936
+
937
+ return addressMode;
938
+
939
+ }
940
+
941
+ /**
942
+ * Converts the three.js filter constants to GPU filter constants.
943
+ *
944
+ * @private
945
+ * @param {number} value - The three.js constant defining a filter mode.
946
+ * @return {string} The GPU filter mode.
947
+ */
948
+ _convertFilterMode( value ) {
949
+
950
+ let filterMode = GPUFilterMode.Linear;
951
+
952
+ if ( value === NearestFilter || value === NearestMipmapNearestFilter || value === NearestMipmapLinearFilter ) {
953
+
954
+ filterMode = GPUFilterMode.Nearest;
955
+
956
+ }
957
+
958
+ return filterMode;
959
+
960
+ }
961
+
962
+ /**
963
+ * Returns the bytes-per-texel value for the given GPU texture format.
964
+ *
965
+ * @private
966
+ * @param {string} format - The GPU texture format.
967
+ * @return {number} The bytes-per-texel.
968
+ */
969
+ _getBytesPerTexel( format ) {
970
+
971
+ // 8-bit formats
972
+ if ( format === GPUTextureFormat.R8Unorm ||
973
+ format === GPUTextureFormat.R8Snorm ||
974
+ format === GPUTextureFormat.R8Uint ||
975
+ format === GPUTextureFormat.R8Sint ) return 1;
976
+
977
+ // 16-bit formats
978
+ if ( format === GPUTextureFormat.R16Uint ||
979
+ format === GPUTextureFormat.R16Sint ||
980
+ format === GPUTextureFormat.R16Float ||
981
+ format === GPUTextureFormat.RG8Unorm ||
982
+ format === GPUTextureFormat.RG8Snorm ||
983
+ format === GPUTextureFormat.RG8Uint ||
984
+ format === GPUTextureFormat.RG8Sint ) return 2;
985
+
986
+ // 32-bit formats
987
+ if ( format === GPUTextureFormat.R32Uint ||
988
+ format === GPUTextureFormat.R32Sint ||
989
+ format === GPUTextureFormat.R32Float ||
990
+ format === GPUTextureFormat.RG16Uint ||
991
+ format === GPUTextureFormat.RG16Sint ||
992
+ format === GPUTextureFormat.RG16Float ||
993
+ format === GPUTextureFormat.RGBA8Unorm ||
994
+ format === GPUTextureFormat.RGBA8UnormSRGB ||
995
+ format === GPUTextureFormat.RGBA8Snorm ||
996
+ format === GPUTextureFormat.RGBA8Uint ||
997
+ format === GPUTextureFormat.RGBA8Sint ||
998
+ format === GPUTextureFormat.BGRA8Unorm ||
999
+ format === GPUTextureFormat.BGRA8UnormSRGB ||
1000
+ // Packed 32-bit formats
1001
+ format === GPUTextureFormat.RGB9E5UFloat ||
1002
+ format === GPUTextureFormat.RGB10A2Unorm ||
1003
+ format === GPUTextureFormat.RG11B10UFloat ||
1004
+ format === GPUTextureFormat.Depth32Float ||
1005
+ format === GPUTextureFormat.Depth24Plus ||
1006
+ format === GPUTextureFormat.Depth24PlusStencil8 ||
1007
+ format === GPUTextureFormat.Depth32FloatStencil8 ) return 4;
1008
+
1009
+ // 64-bit formats
1010
+ if ( format === GPUTextureFormat.RG32Uint ||
1011
+ format === GPUTextureFormat.RG32Sint ||
1012
+ format === GPUTextureFormat.RG32Float ||
1013
+ format === GPUTextureFormat.RGBA16Uint ||
1014
+ format === GPUTextureFormat.RGBA16Sint ||
1015
+ format === GPUTextureFormat.RGBA16Float ) return 8;
1016
+
1017
+ // 128-bit formats
1018
+ if ( format === GPUTextureFormat.RGBA32Uint ||
1019
+ format === GPUTextureFormat.RGBA32Sint ||
1020
+ format === GPUTextureFormat.RGBA32Float ) return 16;
1021
+
1022
+
1023
+ }
1024
+
1025
+ /**
1026
+ * Returns the corresponding typed array type for the given GPU texture format.
1027
+ *
1028
+ * @private
1029
+ * @param {string} format - The GPU texture format.
1030
+ * @return {TypedArray.constructor} The typed array type.
1031
+ */
1032
+ _getTypedArrayType( format ) {
1033
+
1034
+ if ( format === GPUTextureFormat.R8Uint ) return Uint8Array;
1035
+ if ( format === GPUTextureFormat.R8Sint ) return Int8Array;
1036
+ if ( format === GPUTextureFormat.R8Unorm ) return Uint8Array;
1037
+ if ( format === GPUTextureFormat.R8Snorm ) return Int8Array;
1038
+ if ( format === GPUTextureFormat.RG8Uint ) return Uint8Array;
1039
+ if ( format === GPUTextureFormat.RG8Sint ) return Int8Array;
1040
+ if ( format === GPUTextureFormat.RG8Unorm ) return Uint8Array;
1041
+ if ( format === GPUTextureFormat.RG8Snorm ) return Int8Array;
1042
+ if ( format === GPUTextureFormat.RGBA8Uint ) return Uint8Array;
1043
+ if ( format === GPUTextureFormat.RGBA8Sint ) return Int8Array;
1044
+ if ( format === GPUTextureFormat.RGBA8Unorm || format === GPUTextureFormat.RGBA8UnormSRGB ) return Uint8Array;
1045
+ if ( format === GPUTextureFormat.RGBA8Snorm ) return Int8Array;
1046
+
1047
+
1048
+ if ( format === GPUTextureFormat.R16Uint ) return Uint16Array;
1049
+ if ( format === GPUTextureFormat.R16Sint ) return Int16Array;
1050
+ if ( format === GPUTextureFormat.RG16Uint ) return Uint16Array;
1051
+ if ( format === GPUTextureFormat.RG16Sint ) return Int16Array;
1052
+ if ( format === GPUTextureFormat.RGBA16Uint ) return Uint16Array;
1053
+ if ( format === GPUTextureFormat.RGBA16Sint ) return Int16Array;
1054
+ if ( format === GPUTextureFormat.R16Float ) return Uint16Array;
1055
+ if ( format === GPUTextureFormat.RG16Float ) return Uint16Array;
1056
+ if ( format === GPUTextureFormat.RGBA16Float ) return Uint16Array;
1057
+
1058
+
1059
+ if ( format === GPUTextureFormat.R32Uint ) return Uint32Array;
1060
+ if ( format === GPUTextureFormat.R32Sint ) return Int32Array;
1061
+ if ( format === GPUTextureFormat.R32Float ) return Float32Array;
1062
+ if ( format === GPUTextureFormat.RG32Uint ) return Uint32Array;
1063
+ if ( format === GPUTextureFormat.RG32Sint ) return Int32Array;
1064
+ if ( format === GPUTextureFormat.RG32Float ) return Float32Array;
1065
+ if ( format === GPUTextureFormat.RGBA32Uint ) return Uint32Array;
1066
+ if ( format === GPUTextureFormat.RGBA32Sint ) return Int32Array;
1067
+ if ( format === GPUTextureFormat.RGBA32Float ) return Float32Array;
1068
+
1069
+ if ( format === GPUTextureFormat.BGRA8Unorm || format === GPUTextureFormat.BGRA8UnormSRGB ) return Uint8Array;
1070
+ if ( format === GPUTextureFormat.RGB10A2Unorm ) return Uint32Array;
1071
+ if ( format === GPUTextureFormat.RGB9E5UFloat ) return Uint32Array;
1072
+ if ( format === GPUTextureFormat.RG11B10UFloat ) return Uint32Array;
1073
+
1074
+ if ( format === GPUTextureFormat.Depth32Float ) return Float32Array;
1075
+ if ( format === GPUTextureFormat.Depth24Plus ) return Uint32Array;
1076
+ if ( format === GPUTextureFormat.Depth24PlusStencil8 ) return Uint32Array;
1077
+ if ( format === GPUTextureFormat.Depth32FloatStencil8 ) return Float32Array;
1078
+
1079
+ }
1080
+
1081
+ /**
1082
+ * Returns the GPU dimensions for the given texture.
1083
+ *
1084
+ * @private
1085
+ * @param {Texture} texture - The texture.
1086
+ * @return {string} The GPU dimension.
1087
+ */
1088
+ _getDimension( texture ) {
1089
+
1090
+ let dimension;
1091
+
1092
+ if ( texture.is3DTexture || texture.isData3DTexture ) {
1093
+
1094
+ dimension = GPUTextureDimension.ThreeD;
1095
+
1096
+ } else {
1097
+
1098
+ dimension = GPUTextureDimension.TwoD;
1099
+
1100
+ }
1101
+
1102
+ return dimension;
1103
+
1104
+ }
1105
+
1106
+ }
1107
+
1108
+ /**
1109
+ * Returns the GPU format for the given texture.
1110
+ *
1111
+ * @param {Texture} texture - The texture.
1112
+ * @param {?GPUDevice} [device=null] - The GPU device which is used for feature detection.
1113
+ * It is not necessary to apply the device for most formats.
1114
+ * @return {string} The GPU format.
1115
+ */
1116
+ export function getFormat( texture, device = null ) {
1117
+
1118
+ const format = texture.format;
1119
+ const type = texture.type;
1120
+ const colorSpace = texture.colorSpace;
1121
+ const transfer = ColorManagement.getTransfer( colorSpace );
1122
+
1123
+ let formatGPU;
1124
+
1125
+ if ( texture.isCompressedTexture === true || texture.isCompressedArrayTexture === true ) {
1126
+
1127
+ switch ( format ) {
1128
+
1129
+ case RGB_S3TC_DXT1_Format:
1130
+ case RGBA_S3TC_DXT1_Format:
1131
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.BC1RGBAUnormSRGB : GPUTextureFormat.BC1RGBAUnorm;
1132
+ break;
1133
+
1134
+ case RGBA_S3TC_DXT3_Format:
1135
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.BC2RGBAUnormSRGB : GPUTextureFormat.BC2RGBAUnorm;
1136
+ break;
1137
+
1138
+ case RGBA_S3TC_DXT5_Format:
1139
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.BC3RGBAUnormSRGB : GPUTextureFormat.BC3RGBAUnorm;
1140
+ break;
1141
+
1142
+ case RED_RGTC1_Format:
1143
+ formatGPU = GPUTextureFormat.BC4RUnorm;
1144
+ break;
1145
+
1146
+ case SIGNED_RED_RGTC1_Format:
1147
+ formatGPU = GPUTextureFormat.BC4RSnorm;
1148
+ break;
1149
+
1150
+ case RED_GREEN_RGTC2_Format:
1151
+ formatGPU = GPUTextureFormat.BC5RGUnorm;
1152
+ break;
1153
+
1154
+ case SIGNED_RED_GREEN_RGTC2_Format:
1155
+ formatGPU = GPUTextureFormat.BC5RGSnorm;
1156
+ break;
1157
+
1158
+ case RGBA_BPTC_Format:
1159
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.BC7RGBAUnormSRGB : GPUTextureFormat.BC7RGBAUnorm;
1160
+ break;
1161
+
1162
+ case RGB_ETC2_Format:
1163
+ case RGB_ETC1_Format:
1164
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ETC2RGB8UnormSRGB : GPUTextureFormat.ETC2RGB8Unorm;
1165
+ break;
1166
+
1167
+ case RGBA_ETC2_EAC_Format:
1168
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ETC2RGBA8UnormSRGB : GPUTextureFormat.ETC2RGBA8Unorm;
1169
+ break;
1170
+
1171
+ case RGBA_ASTC_4x4_Format:
1172
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC4x4UnormSRGB : GPUTextureFormat.ASTC4x4Unorm;
1173
+ break;
1174
+
1175
+ case RGBA_ASTC_5x4_Format:
1176
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC5x4UnormSRGB : GPUTextureFormat.ASTC5x4Unorm;
1177
+ break;
1178
+
1179
+ case RGBA_ASTC_5x5_Format:
1180
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC5x5UnormSRGB : GPUTextureFormat.ASTC5x5Unorm;
1181
+ break;
1182
+
1183
+ case RGBA_ASTC_6x5_Format:
1184
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC6x5UnormSRGB : GPUTextureFormat.ASTC6x5Unorm;
1185
+ break;
1186
+
1187
+ case RGBA_ASTC_6x6_Format:
1188
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC6x6UnormSRGB : GPUTextureFormat.ASTC6x6Unorm;
1189
+ break;
1190
+
1191
+ case RGBA_ASTC_8x5_Format:
1192
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC8x5UnormSRGB : GPUTextureFormat.ASTC8x5Unorm;
1193
+ break;
1194
+
1195
+ case RGBA_ASTC_8x6_Format:
1196
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC8x6UnormSRGB : GPUTextureFormat.ASTC8x6Unorm;
1197
+ break;
1198
+
1199
+ case RGBA_ASTC_8x8_Format:
1200
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC8x8UnormSRGB : GPUTextureFormat.ASTC8x8Unorm;
1201
+ break;
1202
+
1203
+ case RGBA_ASTC_10x5_Format:
1204
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC10x5UnormSRGB : GPUTextureFormat.ASTC10x5Unorm;
1205
+ break;
1206
+
1207
+ case RGBA_ASTC_10x6_Format:
1208
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC10x6UnormSRGB : GPUTextureFormat.ASTC10x6Unorm;
1209
+ break;
1210
+
1211
+ case RGBA_ASTC_10x8_Format:
1212
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC10x8UnormSRGB : GPUTextureFormat.ASTC10x8Unorm;
1213
+ break;
1214
+
1215
+ case RGBA_ASTC_10x10_Format:
1216
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC10x10UnormSRGB : GPUTextureFormat.ASTC10x10Unorm;
1217
+ break;
1218
+
1219
+ case RGBA_ASTC_12x10_Format:
1220
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC12x10UnormSRGB : GPUTextureFormat.ASTC12x10Unorm;
1221
+ break;
1222
+
1223
+ case RGBA_ASTC_12x12_Format:
1224
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.ASTC12x12UnormSRGB : GPUTextureFormat.ASTC12x12Unorm;
1225
+ break;
1226
+
1227
+ case RGBAFormat:
1228
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.RGBA8UnormSRGB : GPUTextureFormat.RGBA8Unorm;
1229
+ break;
1230
+
1231
+ default:
1232
+ error( 'WebGPURenderer: Unsupported texture format.', format );
1233
+
1234
+ }
1235
+
1236
+ } else {
1237
+
1238
+ switch ( format ) {
1239
+
1240
+ case RGBAFormat:
1241
+
1242
+ switch ( type ) {
1243
+
1244
+ case ByteType:
1245
+ formatGPU = GPUTextureFormat.RGBA8Snorm;
1246
+ break;
1247
+
1248
+ case ShortType:
1249
+ formatGPU = GPUTextureFormat.RGBA16Sint;
1250
+ break;
1251
+
1252
+ case UnsignedShortType:
1253
+ formatGPU = GPUTextureFormat.RGBA16Uint;
1254
+ break;
1255
+ case UnsignedIntType:
1256
+ formatGPU = GPUTextureFormat.RGBA32Uint;
1257
+ break;
1258
+
1259
+ case IntType:
1260
+ formatGPU = GPUTextureFormat.RGBA32Sint;
1261
+ break;
1262
+
1263
+ case UnsignedByteType:
1264
+ formatGPU = ( transfer === SRGBTransfer ) ? GPUTextureFormat.RGBA8UnormSRGB : GPUTextureFormat.RGBA8Unorm;
1265
+ break;
1266
+
1267
+ case HalfFloatType:
1268
+ formatGPU = GPUTextureFormat.RGBA16Float;
1269
+ break;
1270
+
1271
+ case FloatType:
1272
+ formatGPU = GPUTextureFormat.RGBA32Float;
1273
+ break;
1274
+
1275
+ default:
1276
+ error( 'WebGPURenderer: Unsupported texture type with RGBAFormat.', type );
1277
+
1278
+ }
1279
+
1280
+ break;
1281
+
1282
+ case RGBFormat:
1283
+
1284
+ switch ( type ) {
1285
+
1286
+ case UnsignedInt5999Type:
1287
+ formatGPU = GPUTextureFormat.RGB9E5UFloat;
1288
+ break;
1289
+
1290
+ case UnsignedInt101111Type:
1291
+ formatGPU = GPUTextureFormat.RG11B10UFloat;
1292
+ break;
1293
+
1294
+ default:
1295
+ error( 'WebGPURenderer: Unsupported texture type with RGBFormat.', type );
1296
+
1297
+ }
1298
+
1299
+ break;
1300
+
1301
+ case RedFormat:
1302
+
1303
+ switch ( type ) {
1304
+
1305
+ case ByteType:
1306
+ formatGPU = GPUTextureFormat.R8Snorm;
1307
+ break;
1308
+
1309
+ case ShortType:
1310
+ formatGPU = GPUTextureFormat.R16Sint;
1311
+ break;
1312
+
1313
+ case UnsignedShortType:
1314
+ formatGPU = GPUTextureFormat.R16Uint;
1315
+ break;
1316
+
1317
+ case UnsignedIntType:
1318
+ formatGPU = GPUTextureFormat.R32Uint;
1319
+ break;
1320
+
1321
+ case IntType:
1322
+ formatGPU = GPUTextureFormat.R32Sint;
1323
+ break;
1324
+
1325
+ case UnsignedByteType:
1326
+ formatGPU = GPUTextureFormat.R8Unorm;
1327
+ break;
1328
+
1329
+ case HalfFloatType:
1330
+ formatGPU = GPUTextureFormat.R16Float;
1331
+ break;
1332
+
1333
+ case FloatType:
1334
+ formatGPU = GPUTextureFormat.R32Float;
1335
+ break;
1336
+
1337
+ default:
1338
+ error( 'WebGPURenderer: Unsupported texture type with RedFormat.', type );
1339
+
1340
+ }
1341
+
1342
+ break;
1343
+
1344
+ case RGFormat:
1345
+
1346
+ switch ( type ) {
1347
+
1348
+ case ByteType:
1349
+ formatGPU = GPUTextureFormat.RG8Snorm;
1350
+ break;
1351
+
1352
+ case ShortType:
1353
+ formatGPU = GPUTextureFormat.RG16Sint;
1354
+ break;
1355
+
1356
+ case UnsignedShortType:
1357
+ formatGPU = GPUTextureFormat.RG16Uint;
1358
+ break;
1359
+
1360
+ case UnsignedIntType:
1361
+ formatGPU = GPUTextureFormat.RG32Uint;
1362
+ break;
1363
+
1364
+ case IntType:
1365
+ formatGPU = GPUTextureFormat.RG32Sint;
1366
+ break;
1367
+
1368
+ case UnsignedByteType:
1369
+ formatGPU = GPUTextureFormat.RG8Unorm;
1370
+ break;
1371
+
1372
+ case HalfFloatType:
1373
+ formatGPU = GPUTextureFormat.RG16Float;
1374
+ break;
1375
+
1376
+ case FloatType:
1377
+ formatGPU = GPUTextureFormat.RG32Float;
1378
+ break;
1379
+
1380
+ default:
1381
+ error( 'WebGPURenderer: Unsupported texture type with RGFormat.', type );
1382
+
1383
+ }
1384
+
1385
+ break;
1386
+
1387
+ case DepthFormat:
1388
+
1389
+ switch ( type ) {
1390
+
1391
+ case UnsignedShortType:
1392
+ formatGPU = GPUTextureFormat.Depth16Unorm;
1393
+ break;
1394
+
1395
+ case UnsignedIntType:
1396
+ formatGPU = GPUTextureFormat.Depth24Plus;
1397
+ break;
1398
+
1399
+ case FloatType:
1400
+ formatGPU = GPUTextureFormat.Depth32Float;
1401
+ break;
1402
+
1403
+ default:
1404
+ error( 'WebGPURenderer: Unsupported texture type with DepthFormat.', type );
1405
+
1406
+ }
1407
+
1408
+ break;
1409
+
1410
+ case DepthStencilFormat:
1411
+
1412
+ switch ( type ) {
1413
+
1414
+ case UnsignedInt248Type:
1415
+ formatGPU = GPUTextureFormat.Depth24PlusStencil8;
1416
+ break;
1417
+
1418
+ case FloatType:
1419
+
1420
+ if ( device && device.features.has( GPUFeatureName.Depth32FloatStencil8 ) === false ) {
1421
+
1422
+ error( 'WebGPURenderer: Depth textures with DepthStencilFormat + FloatType can only be used with the "depth32float-stencil8" GPU feature.' );
1423
+
1424
+ }
1425
+
1426
+ formatGPU = GPUTextureFormat.Depth32FloatStencil8;
1427
+
1428
+ break;
1429
+
1430
+ default:
1431
+ error( 'WebGPURenderer: Unsupported texture type with DepthStencilFormat.', type );
1432
+
1433
+ }
1434
+
1435
+ break;
1436
+
1437
+ case RedIntegerFormat:
1438
+
1439
+ switch ( type ) {
1440
+
1441
+ case IntType:
1442
+ formatGPU = GPUTextureFormat.R32Sint;
1443
+ break;
1444
+
1445
+ case UnsignedIntType:
1446
+ formatGPU = GPUTextureFormat.R32Uint;
1447
+ break;
1448
+
1449
+ default:
1450
+ error( 'WebGPURenderer: Unsupported texture type with RedIntegerFormat.', type );
1451
+
1452
+ }
1453
+
1454
+ break;
1455
+
1456
+ case RGIntegerFormat:
1457
+
1458
+ switch ( type ) {
1459
+
1460
+ case IntType:
1461
+ formatGPU = GPUTextureFormat.RG32Sint;
1462
+ break;
1463
+
1464
+ case UnsignedIntType:
1465
+ formatGPU = GPUTextureFormat.RG32Uint;
1466
+ break;
1467
+
1468
+ default:
1469
+ error( 'WebGPURenderer: Unsupported texture type with RGIntegerFormat.', type );
1470
+
1471
+ }
1472
+
1473
+ break;
1474
+
1475
+ case RGBAIntegerFormat:
1476
+
1477
+ switch ( type ) {
1478
+
1479
+ case IntType:
1480
+ formatGPU = GPUTextureFormat.RGBA32Sint;
1481
+ break;
1482
+
1483
+ case UnsignedIntType:
1484
+ formatGPU = GPUTextureFormat.RGBA32Uint;
1485
+ break;
1486
+
1487
+ default:
1488
+ error( 'WebGPURenderer: Unsupported texture type with RGBAIntegerFormat.', type );
1489
+
1490
+ }
1491
+
1492
+ break;
1493
+
1494
+ default:
1495
+ error( 'WebGPURenderer: Unsupported texture format.', format );
1496
+
1497
+ }
1498
+
1499
+ }
1500
+
1501
+ return formatGPU;
1502
+
1503
+ }
1504
+
1505
+ export default WebGPUTextureUtils;