@needle-tools/three 0.154.2 → 0.160.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (957) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +86 -84
  3. package/build/three.cjs +53679 -51654
  4. package/build/three.module.js +53263 -51253
  5. package/build/three.module.min.js +6 -6
  6. package/examples/fonts/LICENSE +13 -13
  7. package/examples/fonts/README.md +11 -11
  8. package/examples/fonts/droid/NOTICE +190 -190
  9. package/examples/fonts/droid/README.txt +18 -18
  10. package/examples/fonts/ttf/README.md +9 -9
  11. package/examples/jsm/Addons.js +294 -0
  12. package/examples/jsm/animation/AnimationClipCreator.js +116 -116
  13. package/examples/jsm/animation/CCDIKSolver.js +482 -482
  14. package/examples/jsm/animation/MMDAnimationHelper.js +1207 -1207
  15. package/examples/jsm/animation/MMDPhysics.js +1406 -1406
  16. package/examples/jsm/cameras/CinematicCamera.js +208 -208
  17. package/examples/jsm/capabilities/WebGL.js +108 -91
  18. package/examples/jsm/capabilities/WebGPU.js +57 -53
  19. package/examples/jsm/controls/ArcballControls.js +3224 -3224
  20. package/examples/jsm/controls/DragControls.js +221 -220
  21. package/examples/jsm/controls/FirstPersonControls.js +325 -325
  22. package/examples/jsm/controls/FlyControls.js +326 -300
  23. package/examples/jsm/controls/MapControls.js +28 -28
  24. package/examples/jsm/controls/OrbitControls.js +1521 -1279
  25. package/examples/jsm/controls/PointerLockControls.js +162 -162
  26. package/examples/jsm/controls/TrackballControls.js +828 -828
  27. package/examples/jsm/controls/TransformControls.js +1573 -1557
  28. package/examples/jsm/csm/CSM.js +384 -384
  29. package/examples/jsm/csm/CSMFrustum.js +152 -152
  30. package/examples/jsm/csm/CSMHelper.js +193 -193
  31. package/examples/jsm/csm/CSMShader.js +295 -252
  32. package/examples/jsm/curves/CurveExtras.js +422 -422
  33. package/examples/jsm/curves/NURBSCurve.js +80 -80
  34. package/examples/jsm/curves/NURBSSurface.js +52 -52
  35. package/examples/jsm/curves/NURBSUtils.js +487 -487
  36. package/examples/jsm/effects/AnaglyphEffect.js +154 -154
  37. package/examples/jsm/effects/AsciiEffect.js +263 -263
  38. package/examples/jsm/effects/OutlineEffect.js +539 -539
  39. package/examples/jsm/effects/ParallaxBarrierEffect.js +119 -119
  40. package/examples/jsm/effects/PeppersGhostEffect.js +153 -153
  41. package/examples/jsm/effects/StereoEffect.js +55 -55
  42. package/examples/jsm/environments/DebugEnvironment.js +52 -52
  43. package/examples/jsm/environments/RoomEnvironment.js +148 -148
  44. package/examples/jsm/exporters/DRACOExporter.js +267 -267
  45. package/examples/jsm/exporters/EXRExporter.js +579 -501
  46. package/examples/jsm/exporters/GLTFExporter.js +3311 -3163
  47. package/examples/jsm/exporters/KTX2Exporter.js +292 -292
  48. package/examples/jsm/exporters/MMDExporter.js +217 -217
  49. package/examples/jsm/exporters/OBJExporter.js +284 -284
  50. package/examples/jsm/exporters/PLYExporter.js +528 -528
  51. package/examples/jsm/exporters/STLExporter.js +199 -199
  52. package/examples/jsm/exporters/USDZExporter.js +720 -710
  53. package/examples/jsm/geometries/BoxLineGeometry.js +69 -69
  54. package/examples/jsm/geometries/ConvexGeometry.js +53 -53
  55. package/examples/jsm/geometries/DecalGeometry.js +356 -356
  56. package/examples/jsm/geometries/InstancedPointsGeometry.js +174 -0
  57. package/examples/jsm/geometries/ParametricGeometries.js +254 -254
  58. package/examples/jsm/geometries/ParametricGeometry.js +139 -139
  59. package/examples/jsm/geometries/RoundedBoxGeometry.js +155 -155
  60. package/examples/jsm/geometries/SDFGeometryGenerator.js +144 -0
  61. package/examples/jsm/geometries/TeapotGeometry.js +704 -704
  62. package/examples/jsm/geometries/TextGeometry.js +57 -57
  63. package/examples/jsm/helpers/LightProbeHelper.js +130 -130
  64. package/examples/jsm/helpers/OctreeHelper.js +73 -73
  65. package/examples/jsm/helpers/PositionalAudioHelper.js +109 -109
  66. package/examples/jsm/helpers/RectAreaLightHelper.js +85 -85
  67. package/examples/jsm/helpers/TextureHelper.js +237 -0
  68. package/examples/jsm/helpers/VertexNormalsHelper.js +96 -96
  69. package/examples/jsm/helpers/VertexTangentsHelper.js +88 -88
  70. package/examples/jsm/helpers/ViewHelper.js +333 -333
  71. package/examples/jsm/interactive/HTMLMesh.js +572 -565
  72. package/examples/jsm/interactive/InteractiveGroup.js +116 -116
  73. package/examples/jsm/interactive/SelectionBox.js +227 -227
  74. package/examples/jsm/interactive/SelectionHelper.js +104 -97
  75. package/examples/jsm/libs/ammo.wasm.js +822 -822
  76. package/examples/jsm/libs/basis/README.md +46 -46
  77. package/examples/jsm/libs/basis/basis_transcoder.js +21 -21
  78. package/examples/jsm/libs/chevrotain.module.min.js +141 -141
  79. package/examples/jsm/libs/draco/README.md +32 -32
  80. package/examples/jsm/libs/draco/draco_decoder.js +34 -34
  81. package/examples/jsm/libs/draco/draco_encoder.js +33 -33
  82. package/examples/jsm/libs/draco/draco_wasm_wrapper.js +117 -117
  83. package/examples/jsm/libs/draco/gltf/draco_decoder.js +33 -33
  84. package/examples/jsm/libs/draco/gltf/draco_encoder.js +33 -33
  85. package/examples/jsm/libs/draco/gltf/draco_wasm_wrapper.js +116 -116
  86. package/examples/jsm/libs/ecsy.module.js +1792 -1792
  87. package/examples/jsm/libs/fflate.module.js +2474 -2474
  88. package/examples/jsm/libs/ktx-parse.module.js +1 -1
  89. package/examples/jsm/libs/lil-gui.module.min.js +8 -8
  90. package/examples/jsm/libs/lottie_canvas.module.js +14849 -14844
  91. package/examples/jsm/libs/meshopt_decoder.module.js +178 -178
  92. package/examples/jsm/libs/mikktspace.module.js +128 -128
  93. package/examples/jsm/libs/mmdparser.module.js +11530 -11530
  94. package/examples/jsm/libs/motion-controllers.module.js +397 -397
  95. package/examples/jsm/libs/opentype.module.js +14506 -14568
  96. package/examples/jsm/libs/potpack.module.js +124 -124
  97. package/examples/jsm/libs/rhino3dm/rhino3dm.js +8743 -21
  98. package/examples/jsm/libs/rhino3dm/rhino3dm.module.js +8748 -15
  99. package/examples/jsm/libs/rhino3dm/rhino3dm.wasm +0 -0
  100. package/examples/jsm/libs/stats.module.js +167 -167
  101. package/examples/jsm/libs/surfaceNet.js +201 -0
  102. package/examples/jsm/libs/tween.module.js +858 -803
  103. package/examples/jsm/libs/utif.module.js +1664 -1578
  104. package/examples/jsm/libs/zstddec.module.js +1 -1
  105. package/examples/jsm/lights/IESSpotLight.js +25 -25
  106. package/examples/jsm/lights/LightProbeGenerator.js +286 -252
  107. package/examples/jsm/lights/RectAreaLightUniformsLib.js +79 -79
  108. package/examples/jsm/lines/Line2.js +19 -19
  109. package/examples/jsm/lines/LineGeometry.js +79 -79
  110. package/examples/jsm/lines/LineMaterial.js +619 -702
  111. package/examples/jsm/lines/LineSegments2.js +361 -361
  112. package/examples/jsm/lines/LineSegmentsGeometry.js +241 -241
  113. package/examples/jsm/lines/Wireframe.js +56 -56
  114. package/examples/jsm/lines/WireframeGeometry2.js +24 -24
  115. package/examples/jsm/loaders/3DMLoader.js +1772 -1497
  116. package/examples/jsm/loaders/3MFLoader.js +1478 -1478
  117. package/examples/jsm/loaders/AMFLoader.js +521 -521
  118. package/examples/jsm/loaders/BVHLoader.js +437 -437
  119. package/examples/jsm/loaders/ColladaLoader.js +4116 -4122
  120. package/examples/jsm/loaders/DDSLoader.js +318 -274
  121. package/examples/jsm/loaders/DRACOLoader.js +613 -612
  122. package/examples/jsm/loaders/EXRLoader.js +2309 -2309
  123. package/examples/jsm/loaders/FBXLoader.js +4314 -4142
  124. package/examples/jsm/loaders/FontLoader.js +183 -183
  125. package/examples/jsm/loaders/GCodeLoader.js +261 -261
  126. package/examples/jsm/loaders/GLTFLoader.js +4666 -4579
  127. package/examples/jsm/loaders/GLTFLoaderAnimationPointer.js +719 -683
  128. package/examples/jsm/loaders/HDRCubeTextureLoader.js +115 -115
  129. package/examples/jsm/loaders/IESLoader.js +337 -337
  130. package/examples/jsm/loaders/KMZLoader.js +130 -130
  131. package/examples/jsm/loaders/KTX2Loader.js +932 -868
  132. package/examples/jsm/loaders/KTXLoader.js +176 -176
  133. package/examples/jsm/loaders/LDrawLoader.js +2470 -2464
  134. package/examples/jsm/loaders/LUT3dlLoader.js +183 -151
  135. package/examples/jsm/loaders/LUTCubeLoader.js +167 -153
  136. package/examples/jsm/loaders/LUTImageLoader.js +163 -0
  137. package/examples/jsm/loaders/LWOLoader.js +1052 -1052
  138. package/examples/jsm/loaders/LogLuvLoader.js +606 -606
  139. package/examples/jsm/loaders/LottieLoader.js +77 -77
  140. package/examples/jsm/loaders/MD2Loader.js +399 -399
  141. package/examples/jsm/loaders/MDDLoader.js +102 -102
  142. package/examples/jsm/loaders/MMDLoader.js +2276 -2273
  143. package/examples/jsm/loaders/MTLLoader.js +567 -567
  144. package/examples/jsm/loaders/MaterialXLoader.js +852 -734
  145. package/examples/jsm/loaders/NRRDLoader.js +686 -699
  146. package/examples/jsm/loaders/OBJLoader.js +905 -905
  147. package/examples/jsm/loaders/PCDLoader.js +467 -467
  148. package/examples/jsm/loaders/PDBLoader.js +232 -232
  149. package/examples/jsm/loaders/PLYLoader.js +771 -771
  150. package/examples/jsm/loaders/PVRLoader.js +251 -251
  151. package/examples/jsm/loaders/RGBELoader.js +450 -468
  152. package/examples/jsm/loaders/RGBMLoader.js +1065 -1065
  153. package/examples/jsm/loaders/STLLoader.js +410 -403
  154. package/examples/jsm/loaders/SVGLoader.js +3173 -3172
  155. package/examples/jsm/loaders/TDSLoader.js +1124 -1124
  156. package/examples/jsm/loaders/TGALoader.js +517 -517
  157. package/examples/jsm/loaders/TIFFLoader.js +36 -36
  158. package/examples/jsm/loaders/TTFLoader.js +214 -214
  159. package/examples/jsm/loaders/TiltLoader.js +520 -520
  160. package/examples/jsm/loaders/USDZLoader.js +822 -633
  161. package/examples/jsm/loaders/VOXLoader.js +311 -311
  162. package/examples/jsm/loaders/VRMLLoader.js +3533 -3533
  163. package/examples/jsm/loaders/VTKLoader.js +1163 -1163
  164. package/examples/jsm/loaders/XYZLoader.js +106 -106
  165. package/examples/jsm/loaders/lwo/IFFParser.js +1214 -1218
  166. package/examples/jsm/loaders/lwo/LWO2Parser.js +414 -414
  167. package/examples/jsm/loaders/lwo/LWO3Parser.js +373 -373
  168. package/examples/jsm/materials/MeshGouraudMaterial.js +426 -420
  169. package/examples/jsm/materials/MeshPostProcessingMaterial.js +144 -0
  170. package/examples/jsm/math/Capsule.js +82 -137
  171. package/examples/jsm/math/ColorConverter.js +36 -36
  172. package/examples/jsm/math/ConvexHull.js +1271 -1271
  173. package/examples/jsm/math/ImprovedNoise.js +71 -71
  174. package/examples/jsm/math/Lut.js +204 -204
  175. package/examples/jsm/math/MeshSurfaceSampler.js +250 -250
  176. package/examples/jsm/math/OBB.js +423 -423
  177. package/examples/jsm/math/Octree.js +540 -462
  178. package/examples/jsm/math/SimplexNoise.js +444 -444
  179. package/examples/jsm/misc/ConvexObjectBreaker.js +519 -519
  180. package/examples/jsm/misc/GPUComputationRenderer.js +446 -455
  181. package/examples/jsm/misc/Gyroscope.js +66 -66
  182. package/examples/jsm/misc/MD2Character.js +276 -276
  183. package/examples/jsm/misc/MD2CharacterComplex.js +576 -576
  184. package/examples/jsm/misc/MorphAnimMesh.js +75 -75
  185. package/examples/jsm/misc/MorphBlendMesh.js +322 -322
  186. package/examples/jsm/misc/ProgressiveLightMap.js +323 -323
  187. package/examples/jsm/misc/RollerCoaster.js +566 -566
  188. package/examples/jsm/misc/Timer.js +119 -0
  189. package/examples/jsm/misc/TubePainter.js +202 -205
  190. package/examples/jsm/misc/Volume.js +473 -475
  191. package/examples/jsm/misc/VolumeSlice.js +229 -229
  192. package/examples/jsm/modifiers/CurveModifier.js +344 -326
  193. package/examples/jsm/modifiers/EdgeSplitModifier.js +279 -279
  194. package/examples/jsm/modifiers/SimplifyModifier.js +617 -525
  195. package/examples/jsm/modifiers/TessellateModifier.js +307 -307
  196. package/examples/jsm/nodes/Nodes.js +189 -172
  197. package/examples/jsm/nodes/accessors/BitangentNode.js +89 -89
  198. package/examples/jsm/nodes/accessors/BufferAttributeNode.js +127 -99
  199. package/examples/jsm/nodes/accessors/BufferNode.js +30 -30
  200. package/examples/jsm/nodes/accessors/CameraNode.js +120 -98
  201. package/examples/jsm/nodes/accessors/CubeTextureNode.js +61 -101
  202. package/examples/jsm/nodes/accessors/InstanceNode.js +71 -71
  203. package/examples/jsm/nodes/accessors/InstancedPointsMaterialNode.js +21 -0
  204. package/examples/jsm/nodes/accessors/MaterialNode.js +314 -277
  205. package/examples/jsm/nodes/accessors/MaterialReferenceNode.js +51 -39
  206. package/examples/jsm/nodes/accessors/ModelNode.js +33 -34
  207. package/examples/jsm/nodes/accessors/ModelViewProjectionNode.js +39 -29
  208. package/examples/jsm/nodes/accessors/MorphNode.js +245 -70
  209. package/examples/jsm/nodes/accessors/NormalNode.js +96 -96
  210. package/examples/jsm/nodes/accessors/Object3DNode.js +150 -150
  211. package/examples/jsm/nodes/accessors/PointUVNode.js +26 -26
  212. package/examples/jsm/nodes/accessors/PositionNode.js +104 -104
  213. package/examples/jsm/nodes/accessors/ReferenceNode.js +102 -72
  214. package/examples/jsm/nodes/accessors/ReflectVectorNode.js +35 -35
  215. package/examples/jsm/nodes/accessors/SceneNode.js +52 -46
  216. package/examples/jsm/nodes/accessors/SkinningNode.js +103 -93
  217. package/examples/jsm/nodes/accessors/StorageBufferNode.js +54 -27
  218. package/examples/jsm/nodes/accessors/TangentNode.js +103 -103
  219. package/examples/jsm/nodes/accessors/TextureBicubicNode.js +94 -94
  220. package/examples/jsm/nodes/accessors/TextureNode.js +367 -230
  221. package/examples/jsm/nodes/accessors/TextureSizeNode.js +35 -35
  222. package/examples/jsm/nodes/accessors/TextureStoreNode.js +82 -0
  223. package/examples/jsm/nodes/accessors/UVNode.js +47 -47
  224. package/examples/jsm/nodes/accessors/UserDataNode.js +29 -29
  225. package/examples/jsm/nodes/accessors/VertexColorNode.js +70 -0
  226. package/examples/jsm/nodes/code/CodeNode.js +78 -78
  227. package/examples/jsm/nodes/code/ExpressionNode.js +37 -37
  228. package/examples/jsm/nodes/code/FunctionCallNode.js +96 -96
  229. package/examples/jsm/nodes/code/FunctionNode.js +138 -127
  230. package/examples/jsm/nodes/code/ScriptableNode.js +488 -488
  231. package/examples/jsm/nodes/code/ScriptableValueNode.js +167 -167
  232. package/examples/jsm/nodes/core/ArrayUniformNode.js +26 -26
  233. package/examples/jsm/nodes/core/AssignNode.js +72 -0
  234. package/examples/jsm/nodes/core/AttributeNode.js +108 -102
  235. package/examples/jsm/nodes/core/BypassNode.js +45 -45
  236. package/examples/jsm/nodes/core/CacheNode.js +49 -46
  237. package/examples/jsm/nodes/core/ConstNode.js +32 -32
  238. package/examples/jsm/nodes/core/ContextNode.js +61 -61
  239. package/examples/jsm/nodes/core/IndexNode.js +66 -66
  240. package/examples/jsm/nodes/core/InputNode.js +83 -83
  241. package/examples/jsm/nodes/core/LightingModel.js +17 -17
  242. package/examples/jsm/nodes/core/Node.js +483 -445
  243. package/examples/jsm/nodes/core/NodeAttribute.js +15 -15
  244. package/examples/jsm/nodes/core/NodeBuilder.js +1267 -1016
  245. package/examples/jsm/nodes/core/NodeCache.js +26 -26
  246. package/examples/jsm/nodes/core/NodeCode.js +15 -15
  247. package/examples/jsm/nodes/core/NodeFrame.js +135 -110
  248. package/examples/jsm/nodes/core/NodeFunction.js +22 -22
  249. package/examples/jsm/nodes/core/NodeFunctionInput.js +17 -17
  250. package/examples/jsm/nodes/core/NodeKeywords.js +80 -80
  251. package/examples/jsm/nodes/core/NodeParser.js +11 -11
  252. package/examples/jsm/nodes/core/NodeUniform.js +40 -28
  253. package/examples/jsm/nodes/core/NodeUtils.js +210 -212
  254. package/examples/jsm/nodes/core/NodeVar.js +14 -14
  255. package/examples/jsm/nodes/core/NodeVarying.js +17 -17
  256. package/examples/jsm/nodes/core/OutputStructNode.js +62 -0
  257. package/examples/jsm/nodes/core/ParameterNode.js +33 -0
  258. package/examples/jsm/nodes/core/PropertyNode.js +72 -57
  259. package/examples/jsm/nodes/core/StackNode.js +89 -99
  260. package/examples/jsm/nodes/core/StructTypeNode.js +24 -0
  261. package/examples/jsm/nodes/core/TempNode.js +58 -58
  262. package/examples/jsm/nodes/core/UniformGroup.js +13 -0
  263. package/examples/jsm/nodes/core/UniformGroupNode.js +36 -0
  264. package/examples/jsm/nodes/core/UniformNode.js +80 -61
  265. package/examples/jsm/nodes/core/VarNode.js +60 -87
  266. package/examples/jsm/nodes/core/VaryingNode.js +65 -69
  267. package/examples/jsm/nodes/core/constants.js +27 -27
  268. package/examples/jsm/nodes/display/AfterImageNode.js +134 -0
  269. package/examples/jsm/nodes/display/BlendModeNode.js +99 -99
  270. package/examples/jsm/nodes/display/BumpMapNode.js +99 -0
  271. package/examples/jsm/nodes/display/ColorAdjustmentNode.js +96 -100
  272. package/examples/jsm/nodes/display/ColorSpaceNode.js +108 -108
  273. package/examples/jsm/nodes/display/FrontFacingNode.js +27 -27
  274. package/examples/jsm/nodes/display/GaussianBlurNode.js +177 -0
  275. package/examples/jsm/nodes/display/NormalMapNode.js +108 -106
  276. package/examples/jsm/nodes/display/PassNode.js +182 -0
  277. package/examples/jsm/nodes/display/PosterizeNode.js +32 -32
  278. package/examples/jsm/nodes/display/ToneMappingNode.js +184 -141
  279. package/examples/jsm/nodes/display/ViewportDepthNode.js +97 -69
  280. package/examples/jsm/nodes/display/ViewportDepthTextureNode.js +31 -34
  281. package/examples/jsm/nodes/display/ViewportNode.js +134 -115
  282. package/examples/jsm/nodes/display/ViewportSharedTextureNode.js +31 -31
  283. package/examples/jsm/nodes/display/ViewportTextureNode.js +75 -75
  284. package/examples/jsm/nodes/fog/FogExp2Node.js +35 -35
  285. package/examples/jsm/nodes/fog/FogNode.js +38 -37
  286. package/examples/jsm/nodes/fog/FogRangeNode.js +34 -34
  287. package/examples/jsm/nodes/functions/BSDF/BRDF_GGX.js +40 -32
  288. package/examples/jsm/nodes/functions/BSDF/BRDF_Lambert.js +9 -9
  289. package/examples/jsm/nodes/functions/BSDF/BRDF_Sheen.js +57 -43
  290. package/examples/jsm/nodes/functions/BSDF/DFGApprox.js +30 -29
  291. package/examples/jsm/nodes/functions/BSDF/D_GGX.js +23 -18
  292. package/examples/jsm/nodes/functions/BSDF/EnvironmentBRDF.js +13 -13
  293. package/examples/jsm/nodes/functions/BSDF/F_Schlick.js +16 -16
  294. package/examples/jsm/nodes/functions/BSDF/Schlick_to_F0.js +21 -0
  295. package/examples/jsm/nodes/functions/BSDF/V_GGX_SmithCorrelated.js +28 -20
  296. package/examples/jsm/nodes/functions/PhongLightingModel.js +67 -28
  297. package/examples/jsm/nodes/functions/PhysicalLightingModel.js +393 -204
  298. package/examples/jsm/nodes/functions/material/getGeometryRoughness.js +13 -13
  299. package/examples/jsm/nodes/functions/material/getRoughness.js +18 -18
  300. package/examples/jsm/nodes/geometry/RangeNode.js +104 -104
  301. package/examples/jsm/nodes/gpgpu/ComputeNode.js +85 -72
  302. package/examples/jsm/nodes/lighting/AONode.js +27 -27
  303. package/examples/jsm/nodes/lighting/AmbientLightNode.js +27 -27
  304. package/examples/jsm/nodes/lighting/AnalyticLightNode.js +238 -146
  305. package/examples/jsm/nodes/lighting/DirectionalLightNode.js +40 -43
  306. package/examples/jsm/nodes/lighting/EnvironmentNode.js +181 -181
  307. package/examples/jsm/nodes/lighting/HemisphereLightNode.js +55 -55
  308. package/examples/jsm/nodes/lighting/IESSpotLightNode.js +39 -39
  309. package/examples/jsm/nodes/lighting/LightNode.js +57 -57
  310. package/examples/jsm/nodes/lighting/LightUtils.js +17 -17
  311. package/examples/jsm/nodes/lighting/LightingContextNode.js +66 -99
  312. package/examples/jsm/nodes/lighting/LightingNode.js +21 -21
  313. package/examples/jsm/nodes/lighting/LightsNode.js +188 -128
  314. package/examples/jsm/nodes/lighting/PointLightNode.js +68 -71
  315. package/examples/jsm/nodes/lighting/SpotLightNode.js +89 -92
  316. package/examples/jsm/nodes/loaders/NodeLoader.js +108 -108
  317. package/examples/jsm/nodes/loaders/NodeMaterialLoader.js +59 -59
  318. package/examples/jsm/nodes/loaders/NodeObjectLoader.js +70 -70
  319. package/examples/jsm/nodes/materials/InstancedPointsNodeMaterial.js +162 -0
  320. package/examples/jsm/nodes/materials/Line2NodeMaterial.js +436 -0
  321. package/examples/jsm/nodes/materials/LineBasicNodeMaterial.js +28 -28
  322. package/examples/jsm/nodes/materials/LineDashedNodeMaterial.js +54 -0
  323. package/examples/jsm/nodes/materials/Materials.js +16 -11
  324. package/examples/jsm/nodes/materials/MeshBasicNodeMaterial.js +28 -27
  325. package/examples/jsm/nodes/materials/MeshLambertNodeMaterial.js +34 -0
  326. package/examples/jsm/nodes/materials/MeshNormalNodeMaterial.js +40 -38
  327. package/examples/jsm/nodes/materials/MeshPhongNodeMaterial.js +65 -65
  328. package/examples/jsm/nodes/materials/MeshPhysicalNodeMaterial.js +155 -111
  329. package/examples/jsm/nodes/materials/MeshSSSNodeMaterial.js +84 -0
  330. package/examples/jsm/nodes/materials/MeshStandardNodeMaterial.js +80 -80
  331. package/examples/jsm/nodes/materials/NodeMaterial.js +568 -510
  332. package/examples/jsm/nodes/materials/PointsNodeMaterial.js +39 -49
  333. package/examples/jsm/nodes/materials/SpriteNodeMaterial.js +96 -103
  334. package/examples/jsm/nodes/materialx/DISCLAIMER.md +199 -199
  335. package/examples/jsm/nodes/materialx/MaterialXNodes.js +68 -68
  336. package/examples/jsm/nodes/materialx/lib/mx_hsv.js +130 -56
  337. package/examples/jsm/nodes/materialx/lib/mx_noise.js +1430 -618
  338. package/examples/jsm/nodes/materialx/lib/mx_transform_color.js +29 -19
  339. package/examples/jsm/nodes/math/CondNode.js +86 -86
  340. package/examples/jsm/nodes/math/HashNode.js +34 -0
  341. package/examples/jsm/nodes/math/MathNode.js +382 -359
  342. package/examples/jsm/nodes/math/OperatorNode.js +266 -269
  343. package/examples/jsm/nodes/math/TriNoise3D.js +71 -0
  344. package/examples/jsm/nodes/parsers/GLSLNodeFunction.js +152 -152
  345. package/examples/jsm/nodes/parsers/GLSLNodeParser.js +14 -14
  346. package/examples/jsm/nodes/procedural/CheckerNode.js +42 -42
  347. package/examples/jsm/nodes/shadernode/ShaderNode.js +625 -420
  348. package/examples/jsm/nodes/utils/ArrayElementNode.js +41 -33
  349. package/examples/jsm/nodes/utils/ConvertNode.js +65 -65
  350. package/examples/jsm/nodes/utils/DiscardNode.js +27 -26
  351. package/examples/jsm/nodes/utils/EquirectUVNode.js +33 -33
  352. package/examples/jsm/nodes/utils/FunctionOverloadingNode.js +95 -0
  353. package/examples/jsm/nodes/utils/JoinNode.js +61 -51
  354. package/examples/jsm/nodes/utils/LoopNode.js +198 -186
  355. package/examples/jsm/nodes/utils/MatcapUVNode.js +30 -30
  356. package/examples/jsm/nodes/utils/MaxMipLevelNode.js +46 -46
  357. package/examples/jsm/nodes/utils/OscNode.js +81 -81
  358. package/examples/jsm/nodes/utils/PackingNode.js +55 -55
  359. package/examples/jsm/nodes/utils/RemapNode.js +42 -42
  360. package/examples/jsm/nodes/utils/RotateNode.js +43 -0
  361. package/examples/jsm/nodes/utils/RotateUVNode.js +43 -43
  362. package/examples/jsm/nodes/utils/SetNode.js +62 -0
  363. package/examples/jsm/nodes/utils/SpecularMIPLevelNode.js +37 -37
  364. package/examples/jsm/nodes/utils/SplitNode.js +112 -104
  365. package/examples/jsm/nodes/utils/SpriteSheetUVNode.js +41 -41
  366. package/examples/jsm/nodes/utils/TimerNode.js +94 -94
  367. package/examples/jsm/nodes/utils/TriplanarTexturesNode.js +62 -62
  368. package/examples/jsm/objects/GroundedSkybox.js +50 -0
  369. package/examples/jsm/objects/InstancedPoints.js +21 -0
  370. package/examples/jsm/objects/Lensflare.js +397 -377
  371. package/examples/jsm/objects/MarchingCubes.js +1176 -1176
  372. package/examples/jsm/objects/QuadMesh.js +66 -0
  373. package/examples/jsm/objects/Reflector.js +264 -272
  374. package/examples/jsm/objects/ReflectorForSSRPass.js +352 -349
  375. package/examples/jsm/objects/Refractor.js +327 -332
  376. package/examples/jsm/objects/ShadowMesh.js +80 -80
  377. package/examples/jsm/objects/Sky.js +219 -219
  378. package/examples/jsm/objects/Water.js +333 -330
  379. package/examples/jsm/objects/Water2.js +361 -358
  380. package/examples/jsm/offscreen/jank.js +45 -45
  381. package/examples/jsm/offscreen/offscreen.js +8 -8
  382. package/examples/jsm/offscreen/scene.js +86 -87
  383. package/examples/jsm/physics/AmmoPhysics.js +306 -285
  384. package/examples/jsm/physics/RapierPhysics.js +220 -199
  385. package/examples/jsm/postprocessing/AfterimagePass.js +104 -104
  386. package/examples/jsm/postprocessing/BloomPass.js +172 -172
  387. package/examples/jsm/postprocessing/BokehPass.js +141 -140
  388. package/examples/jsm/postprocessing/ClearPass.js +46 -46
  389. package/examples/jsm/postprocessing/CubeTexturePass.js +85 -85
  390. package/examples/jsm/postprocessing/DotScreenPass.js +65 -65
  391. package/examples/jsm/postprocessing/EffectComposer.js +231 -231
  392. package/examples/jsm/postprocessing/FilmPass.js +64 -66
  393. package/examples/jsm/postprocessing/GTAOPass.js +582 -0
  394. package/examples/jsm/postprocessing/GlitchPass.js +128 -128
  395. package/examples/jsm/postprocessing/HalftonePass.js +79 -79
  396. package/examples/jsm/postprocessing/LUTPass.js +174 -173
  397. package/examples/jsm/postprocessing/MaskPass.js +104 -101
  398. package/examples/jsm/postprocessing/OutlinePass.js +654 -654
  399. package/examples/jsm/postprocessing/OutputPass.js +95 -72
  400. package/examples/jsm/postprocessing/Pass.js +95 -84
  401. package/examples/jsm/postprocessing/RenderPass.js +99 -81
  402. package/examples/jsm/postprocessing/RenderPixelatedPass.js +235 -235
  403. package/examples/jsm/postprocessing/SAOPass.js +335 -411
  404. package/examples/jsm/postprocessing/SMAAPass.js +199 -201
  405. package/examples/jsm/postprocessing/SSAARenderPass.js +228 -228
  406. package/examples/jsm/postprocessing/SSAOPass.js +420 -440
  407. package/examples/jsm/postprocessing/SSRPass.js +641 -641
  408. package/examples/jsm/postprocessing/SavePass.js +79 -79
  409. package/examples/jsm/postprocessing/ShaderPass.js +77 -77
  410. package/examples/jsm/postprocessing/TAARenderPass.js +188 -189
  411. package/examples/jsm/postprocessing/TexturePass.js +67 -67
  412. package/examples/jsm/postprocessing/UnrealBloomPass.js +415 -411
  413. package/examples/jsm/renderers/CSS2DRenderer.js +215 -215
  414. package/examples/jsm/renderers/CSS3DRenderer.js +329 -335
  415. package/examples/jsm/renderers/Projector.js +918 -918
  416. package/examples/jsm/renderers/SVGRenderer.js +556 -553
  417. package/examples/jsm/renderers/common/Animation.js +47 -58
  418. package/examples/jsm/renderers/common/Attributes.js +75 -75
  419. package/examples/jsm/renderers/common/Backend.js +193 -162
  420. package/examples/jsm/renderers/common/Background.js +134 -134
  421. package/examples/jsm/renderers/common/Binding.js +25 -11
  422. package/examples/jsm/renderers/common/Bindings.js +173 -169
  423. package/examples/jsm/renderers/common/Buffer.js +38 -38
  424. package/examples/jsm/renderers/common/BufferUtils.js +33 -33
  425. package/examples/jsm/renderers/common/ChainMap.js +89 -89
  426. package/examples/jsm/renderers/common/Color4.js +37 -0
  427. package/examples/jsm/renderers/common/ComputePipeline.js +17 -17
  428. package/examples/jsm/renderers/common/Constants.js +14 -14
  429. package/examples/jsm/renderers/common/CubeRenderTarget.js +65 -65
  430. package/examples/jsm/renderers/common/DataMap.js +54 -54
  431. package/examples/jsm/renderers/common/Geometries.js +215 -215
  432. package/examples/jsm/renderers/common/Info.js +107 -73
  433. package/examples/jsm/renderers/common/Pipeline.js +13 -13
  434. package/examples/jsm/renderers/common/Pipelines.js +322 -321
  435. package/examples/jsm/renderers/common/PostProcessing.js +25 -0
  436. package/examples/jsm/renderers/common/ProgrammableStage.js +20 -18
  437. package/examples/jsm/renderers/common/RenderContext.js +41 -37
  438. package/examples/jsm/renderers/common/RenderContexts.js +74 -38
  439. package/examples/jsm/renderers/common/RenderList.js +186 -178
  440. package/examples/jsm/renderers/common/RenderLists.js +38 -38
  441. package/examples/jsm/renderers/common/RenderObject.js +178 -113
  442. package/examples/jsm/renderers/common/RenderObjects.js +91 -92
  443. package/examples/jsm/renderers/common/RenderPipeline.js +16 -16
  444. package/examples/jsm/renderers/common/Renderer.js +1062 -864
  445. package/examples/jsm/renderers/common/SampledTexture.js +83 -80
  446. package/examples/jsm/renderers/common/Sampler.js +18 -18
  447. package/examples/jsm/renderers/common/StorageBuffer.js +17 -17
  448. package/examples/jsm/renderers/common/StorageBufferAttribute.js +21 -0
  449. package/examples/jsm/renderers/common/StorageTexture.js +20 -0
  450. package/examples/jsm/renderers/common/Textures.js +354 -206
  451. package/examples/jsm/renderers/common/Uniform.js +140 -140
  452. package/examples/jsm/renderers/common/UniformBuffer.js +15 -15
  453. package/examples/jsm/renderers/common/UniformsGroup.js +299 -299
  454. package/examples/jsm/renderers/common/nodes/NodeBuilderState.js +44 -0
  455. package/examples/jsm/renderers/common/nodes/NodeSampledTexture.js +49 -39
  456. package/examples/jsm/renderers/common/nodes/NodeSampler.js +15 -21
  457. package/examples/jsm/renderers/common/nodes/NodeUniform.js +135 -135
  458. package/examples/jsm/renderers/common/nodes/NodeUniformsGroup.js +44 -0
  459. package/examples/jsm/renderers/common/nodes/Nodes.js +495 -319
  460. package/examples/jsm/renderers/webgl/WebGLBackend.js +1290 -0
  461. package/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js +679 -340
  462. package/examples/jsm/renderers/webgl/utils/WebGLAttributeUtils.js +252 -0
  463. package/examples/jsm/renderers/webgl/utils/WebGLCapabilities.js +36 -0
  464. package/examples/jsm/renderers/webgl/utils/WebGLConstants.js +11 -0
  465. package/examples/jsm/renderers/webgl/utils/WebGLExtensions.js +36 -0
  466. package/examples/jsm/renderers/webgl/utils/WebGLState.js +738 -0
  467. package/examples/jsm/renderers/webgl/utils/WebGLTextureUtils.js +647 -0
  468. package/examples/jsm/renderers/webgl/utils/WebGLUtils.js +284 -0
  469. package/examples/jsm/renderers/webgl-legacy/nodes/GLSL1NodeBuilder.js +320 -0
  470. package/examples/jsm/renderers/{webgl → webgl-legacy}/nodes/SlotNode.js +26 -26
  471. package/examples/jsm/renderers/{webgl → webgl-legacy}/nodes/WebGLNodeBuilder.js +794 -764
  472. package/examples/jsm/renderers/{webgl → webgl-legacy}/nodes/WebGLNodes.js +51 -49
  473. package/examples/jsm/renderers/webgpu/WebGPUBackend.js +1321 -847
  474. package/examples/jsm/renderers/webgpu/WebGPURenderer.js +53 -32
  475. package/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js +1098 -878
  476. package/examples/jsm/renderers/webgpu/nodes/WGSLNodeFunction.js +104 -104
  477. package/examples/jsm/renderers/webgpu/nodes/WGSLNodeParser.js +14 -14
  478. package/examples/jsm/renderers/webgpu/utils/WebGPUAttributeUtils.js +287 -255
  479. package/examples/jsm/renderers/webgpu/utils/WebGPUBindingUtils.js +244 -145
  480. package/examples/jsm/renderers/webgpu/utils/WebGPUConstants.js +324 -322
  481. package/examples/jsm/renderers/webgpu/utils/WebGPUPipelineUtils.js +570 -580
  482. package/examples/jsm/renderers/webgpu/utils/WebGPUTexturePassUtils.js +285 -0
  483. package/examples/jsm/renderers/webgpu/utils/WebGPUTextureUtils.js +1040 -937
  484. package/examples/jsm/renderers/webgpu/utils/WebGPUUtils.js +93 -92
  485. package/examples/jsm/shaders/ACESFilmicToneMappingShader.js +89 -87
  486. package/examples/jsm/shaders/AfterimageShader.js +58 -56
  487. package/examples/jsm/shaders/BasicShader.js +29 -27
  488. package/examples/jsm/shaders/BleachBypassShader.js +62 -62
  489. package/examples/jsm/shaders/BlendShader.js +49 -47
  490. package/examples/jsm/shaders/BokehShader.js +145 -143
  491. package/examples/jsm/shaders/BokehShader2.js +397 -393
  492. package/examples/jsm/shaders/BrightnessContrastShader.js +56 -54
  493. package/examples/jsm/shaders/ColorCorrectionShader.js +52 -50
  494. package/examples/jsm/shaders/ColorifyShader.js +51 -51
  495. package/examples/jsm/shaders/ConvolutionShader.js +103 -103
  496. package/examples/jsm/shaders/CopyShader.js +45 -45
  497. package/examples/jsm/shaders/DOFMipMapShader.js +56 -54
  498. package/examples/jsm/shaders/DepthLimitedBlurShader.js +171 -166
  499. package/examples/jsm/shaders/DigitalGlitch.js +101 -101
  500. package/examples/jsm/shaders/DotScreenShader.js +70 -70
  501. package/examples/jsm/shaders/ExposureShader.js +44 -44
  502. package/examples/jsm/shaders/FXAAShader.js +288 -286
  503. package/examples/jsm/shaders/FilmShader.js +59 -102
  504. package/examples/jsm/shaders/FocusShader.js +89 -87
  505. package/examples/jsm/shaders/FreiChenShader.js +96 -94
  506. package/examples/jsm/shaders/GTAOShader.js +424 -0
  507. package/examples/jsm/shaders/GammaCorrectionShader.js +43 -43
  508. package/examples/jsm/shaders/GodRaysShader.js +321 -313
  509. package/examples/jsm/shaders/HalftoneShader.js +312 -310
  510. package/examples/jsm/shaders/HorizontalBlurShader.js +59 -59
  511. package/examples/jsm/shaders/HorizontalTiltShiftShader.js +63 -61
  512. package/examples/jsm/shaders/HueSaturationShader.js +67 -65
  513. package/examples/jsm/shaders/KaleidoShader.js +58 -56
  514. package/examples/jsm/shaders/LuminosityHighPassShader.js +66 -64
  515. package/examples/jsm/shaders/LuminosityShader.js +48 -46
  516. package/examples/jsm/shaders/MMDToonShader.js +134 -132
  517. package/examples/jsm/shaders/MirrorShader.js +56 -54
  518. package/examples/jsm/shaders/NormalMapShader.js +55 -53
  519. package/examples/jsm/shaders/OutputShader.js +81 -61
  520. package/examples/jsm/shaders/PoissonDenoiseShader.js +226 -0
  521. package/examples/jsm/shaders/RGBShiftShader.js +54 -54
  522. package/examples/jsm/shaders/SAOShader.js +179 -188
  523. package/examples/jsm/shaders/SMAAShader.js +466 -460
  524. package/examples/jsm/shaders/SSAOShader.js +300 -288
  525. package/examples/jsm/shaders/SSRShader.js +370 -364
  526. package/examples/jsm/shaders/SepiaShader.js +52 -52
  527. package/examples/jsm/shaders/SobelOperatorShader.js +92 -90
  528. package/examples/jsm/shaders/SubsurfaceScatteringShader.js +90 -88
  529. package/examples/jsm/shaders/TechnicolorShader.js +45 -43
  530. package/examples/jsm/shaders/ToonShader.js +326 -326
  531. package/examples/jsm/shaders/TriangleBlurShader.js +74 -72
  532. package/examples/jsm/shaders/UnpackDepthRGBAShader.js +47 -45
  533. package/examples/jsm/shaders/VelocityShader.js +130 -128
  534. package/examples/jsm/shaders/VerticalBlurShader.js +59 -59
  535. package/examples/jsm/shaders/VerticalTiltShiftShader.js +63 -61
  536. package/examples/jsm/shaders/VignetteShader.js +51 -51
  537. package/examples/jsm/shaders/VolumeShader.js +289 -289
  538. package/examples/jsm/shaders/WaterRefractionShader.js +95 -93
  539. package/examples/jsm/textures/FlakesTexture.js +40 -40
  540. package/examples/jsm/transpiler/AST.js +270 -0
  541. package/examples/jsm/transpiler/GLSLDecoder.js +941 -0
  542. package/examples/jsm/transpiler/ShaderToyDecoder.js +49 -0
  543. package/examples/jsm/transpiler/TSLEncoder.js +715 -0
  544. package/examples/jsm/transpiler/Transpiler.js +18 -0
  545. package/examples/jsm/utils/BufferGeometryUtils.js +1371 -1364
  546. package/examples/jsm/utils/CameraUtils.js +73 -73
  547. package/examples/jsm/utils/GPUStatsPanel.js +128 -128
  548. package/examples/jsm/utils/GeometryCompressionUtils.js +639 -639
  549. package/examples/jsm/utils/GeometryUtils.js +221 -221
  550. package/examples/jsm/utils/LDrawUtils.js +202 -202
  551. package/examples/jsm/utils/PackedPhongMaterial.js +178 -178
  552. package/examples/jsm/utils/SceneUtils.js +254 -254
  553. package/examples/jsm/utils/ShadowMapViewer.js +210 -210
  554. package/examples/jsm/utils/SkeletonUtils.js +413 -413
  555. package/examples/jsm/utils/SortUtils.js +160 -0
  556. package/examples/jsm/utils/TextureUtils.js +98 -86
  557. package/examples/jsm/utils/UVsDebug.js +165 -165
  558. package/examples/jsm/utils/WorkerPool.js +102 -102
  559. package/examples/jsm/webxr/ARButton.js +232 -208
  560. package/examples/jsm/webxr/OculusHandModel.js +109 -109
  561. package/examples/jsm/webxr/OculusHandPointerModel.js +416 -415
  562. package/examples/jsm/webxr/Text2D.js +38 -38
  563. package/examples/jsm/webxr/VRButton.js +225 -200
  564. package/examples/jsm/webxr/XRButton.js +224 -198
  565. package/examples/jsm/webxr/XRControllerModelFactory.js +315 -310
  566. package/examples/jsm/webxr/XREstimatedLight.js +223 -223
  567. package/examples/jsm/webxr/XRHandMeshModel.js +116 -113
  568. package/examples/jsm/webxr/XRHandModelFactory.js +105 -105
  569. package/examples/jsm/webxr/XRHandPrimitiveModel.js +105 -104
  570. package/examples/jsm/webxr/XRPlanes.js +100 -100
  571. package/package.json +129 -126
  572. package/src/Three.Legacy.js +1 -1
  573. package/src/Three.js +184 -182
  574. package/src/animation/AnimationAction.js +700 -700
  575. package/src/animation/AnimationClip.js +473 -473
  576. package/src/animation/AnimationMixer.js +770 -770
  577. package/src/animation/AnimationObjectGroup.js +387 -387
  578. package/src/animation/AnimationUtils.js +356 -373
  579. package/src/animation/KeyframeTrack.js +462 -462
  580. package/src/animation/PropertyBinding.js +719 -719
  581. package/src/animation/PropertyMixer.js +318 -318
  582. package/src/animation/tracks/BooleanKeyframeTrack.js +19 -19
  583. package/src/animation/tracks/ColorKeyframeTrack.js +15 -15
  584. package/src/animation/tracks/NumberKeyframeTrack.js +12 -12
  585. package/src/animation/tracks/QuaternionKeyframeTrack.js +23 -23
  586. package/src/animation/tracks/StringKeyframeTrack.js +15 -15
  587. package/src/animation/tracks/VectorKeyframeTrack.js +12 -12
  588. package/src/audio/Audio.js +400 -396
  589. package/src/audio/AudioAnalyser.js +40 -40
  590. package/src/audio/AudioContext.js +25 -25
  591. package/src/audio/AudioListener.js +140 -137
  592. package/src/audio/PositionalAudio.js +146 -146
  593. package/src/cameras/ArrayCamera.js +17 -17
  594. package/src/cameras/Camera.js +69 -73
  595. package/src/cameras/CubeCamera.js +173 -170
  596. package/src/cameras/OrthographicCamera.js +136 -136
  597. package/src/cameras/PerspectiveCamera.js +268 -233
  598. package/src/cameras/StereoCamera.js +100 -100
  599. package/src/constants.js +216 -201
  600. package/src/core/BufferAttribute.js +650 -610
  601. package/src/core/BufferGeometry.js +1079 -1079
  602. package/src/core/Clock.js +74 -74
  603. package/src/core/EventDispatcher.js +87 -87
  604. package/src/core/GLBufferAttribute.js +60 -60
  605. package/src/core/InstancedBufferAttribute.js +39 -39
  606. package/src/core/InstancedBufferGeometry.js +40 -40
  607. package/src/core/InstancedInterleavedBuffer.js +48 -48
  608. package/src/core/InterleavedBuffer.js +166 -145
  609. package/src/core/InterleavedBufferAttribute.js +351 -331
  610. package/src/core/Layers.js +60 -60
  611. package/src/core/Object3D.js +1008 -973
  612. package/src/core/Raycaster.js +110 -110
  613. package/src/core/RenderTarget.js +131 -0
  614. package/src/core/Uniform.js +17 -17
  615. package/src/core/UniformsGroup.js +98 -92
  616. package/src/extras/DataUtils.js +176 -176
  617. package/src/extras/Earcut.js +789 -789
  618. package/src/extras/ImageUtils.js +129 -129
  619. package/src/extras/PMREMGenerator.js +910 -903
  620. package/src/extras/ShapeUtils.js +92 -92
  621. package/src/extras/core/Curve.js +416 -416
  622. package/src/extras/core/CurvePath.js +255 -252
  623. package/src/extras/core/Interpolations.js +79 -79
  624. package/src/extras/core/Path.js +196 -196
  625. package/src/extras/core/Shape.js +102 -102
  626. package/src/extras/core/ShapePath.js +291 -291
  627. package/src/extras/curves/ArcCurve.js +17 -17
  628. package/src/extras/curves/CatmullRomCurve3.js +255 -255
  629. package/src/extras/curves/CubicBezierCurve.js +78 -78
  630. package/src/extras/curves/CubicBezierCurve3.js +79 -79
  631. package/src/extras/curves/Curves.js +10 -10
  632. package/src/extras/curves/EllipseCurve.js +156 -156
  633. package/src/extras/curves/LineCurve.js +92 -92
  634. package/src/extras/curves/LineCurve3.js +92 -88
  635. package/src/extras/curves/QuadraticBezierCurve.js +74 -74
  636. package/src/extras/curves/QuadraticBezierCurve3.js +75 -75
  637. package/src/extras/curves/SplineCurve.js +97 -97
  638. package/src/geometries/BoxGeometry.js +180 -180
  639. package/src/geometries/CapsuleGeometry.js +33 -33
  640. package/src/geometries/CircleGeometry.js +101 -101
  641. package/src/geometries/ConeGeometry.js +31 -31
  642. package/src/geometries/CylinderGeometry.js +286 -286
  643. package/src/geometries/DodecahedronGeometry.js +66 -66
  644. package/src/geometries/EdgesGeometry.js +152 -152
  645. package/src/geometries/ExtrudeGeometry.js +814 -814
  646. package/src/geometries/Geometries.js +21 -21
  647. package/src/geometries/IcosahedronGeometry.js +42 -42
  648. package/src/geometries/LatheGeometry.js +189 -189
  649. package/src/geometries/OctahedronGeometry.js +37 -37
  650. package/src/geometries/PlaneGeometry.js +98 -98
  651. package/src/geometries/PolyhedronGeometry.js +319 -319
  652. package/src/geometries/RingGeometry.js +128 -128
  653. package/src/geometries/ShapeGeometry.js +195 -195
  654. package/src/geometries/SphereGeometry.js +137 -137
  655. package/src/geometries/TetrahedronGeometry.js +34 -34
  656. package/src/geometries/TorusGeometry.js +120 -120
  657. package/src/geometries/TorusKnotGeometry.js +167 -167
  658. package/src/geometries/TubeGeometry.js +203 -203
  659. package/src/geometries/WireframeGeometry.js +147 -147
  660. package/src/helpers/ArrowHelper.js +114 -114
  661. package/src/helpers/AxesHelper.js +68 -68
  662. package/src/helpers/Box3Helper.js +55 -55
  663. package/src/helpers/BoxHelper.js +113 -113
  664. package/src/helpers/CameraHelper.js +269 -269
  665. package/src/helpers/DirectionalLightHelper.js +93 -93
  666. package/src/helpers/GridHelper.js +56 -56
  667. package/src/helpers/HemisphereLightHelper.js +88 -88
  668. package/src/helpers/PlaneHelper.js +63 -63
  669. package/src/helpers/PointLightHelper.js +92 -92
  670. package/src/helpers/PolarGridHelper.js +96 -96
  671. package/src/helpers/SkeletonHelper.js +128 -128
  672. package/src/helpers/SpotLightHelper.js +94 -94
  673. package/src/lights/AmbientLight.js +17 -17
  674. package/src/lights/DirectionalLight.js +43 -43
  675. package/src/lights/DirectionalLightShadow.js +16 -16
  676. package/src/lights/HemisphereLight.js +34 -34
  677. package/src/lights/Light.js +58 -58
  678. package/src/lights/LightProbe.js +47 -47
  679. package/src/lights/LightShadow.js +147 -147
  680. package/src/lights/PointLight.js +57 -57
  681. package/src/lights/PointLightShadow.js +96 -96
  682. package/src/lights/RectAreaLight.js +56 -56
  683. package/src/lights/SpotLight.js +71 -71
  684. package/src/lights/SpotLightShadow.js +50 -50
  685. package/src/loaders/AnimationLoader.js +66 -66
  686. package/src/loaders/AudioLoader.js +66 -66
  687. package/src/loaders/BufferGeometryLoader.js +217 -224
  688. package/src/loaders/Cache.js +42 -42
  689. package/src/loaders/CompressedTextureLoader.js +134 -134
  690. package/src/loaders/CubeTextureLoader.js +58 -58
  691. package/src/loaders/DataTextureLoader.js +135 -118
  692. package/src/loaders/FileLoader.js +284 -284
  693. package/src/loaders/ImageBitmapLoader.js +123 -99
  694. package/src/loaders/ImageLoader.js +91 -91
  695. package/src/loaders/Loader.js +72 -72
  696. package/src/loaders/LoaderUtils.js +75 -75
  697. package/src/loaders/LoadingManager.js +142 -142
  698. package/src/loaders/MaterialLoader.js +372 -364
  699. package/src/loaders/ObjectLoader.js +1148 -1093
  700. package/src/loaders/TextureLoader.js +41 -41
  701. package/src/materials/LineBasicMaterial.js +53 -49
  702. package/src/materials/LineDashedMaterial.js +35 -35
  703. package/src/materials/Material.js +522 -508
  704. package/src/materials/Materials.js +39 -39
  705. package/src/materials/MeshBasicMaterial.js +85 -81
  706. package/src/materials/MeshDepthMaterial.js +54 -54
  707. package/src/materials/MeshDistanceMaterial.js +43 -43
  708. package/src/materials/MeshLambertMaterial.js +120 -116
  709. package/src/materials/MeshMatcapMaterial.js +85 -81
  710. package/src/materials/MeshNormalMaterial.js +61 -61
  711. package/src/materials/MeshPhongMaterial.js +124 -120
  712. package/src/materials/MeshPhysicalMaterial.js +224 -224
  713. package/src/materials/MeshStandardMaterial.js +128 -124
  714. package/src/materials/MeshToonMaterial.js +106 -102
  715. package/src/materials/PointsMaterial.js +54 -50
  716. package/src/materials/RawShaderMaterial.js +17 -17
  717. package/src/materials/ShaderMaterial.js +190 -187
  718. package/src/materials/ShadowMaterial.js +37 -37
  719. package/src/materials/SpriteMaterial.js +54 -54
  720. package/src/math/Box2.js +204 -204
  721. package/src/math/Box3.js +534 -517
  722. package/src/math/Color.js +623 -627
  723. package/src/math/ColorManagement.js +139 -133
  724. package/src/math/Cylindrical.js +61 -61
  725. package/src/math/Euler.js +315 -315
  726. package/src/math/Frustum.js +186 -186
  727. package/src/math/Interpolant.js +241 -241
  728. package/src/math/Line3.js +115 -115
  729. package/src/math/MathUtils.js +363 -363
  730. package/src/math/Matrix3.js +388 -388
  731. package/src/math/Matrix4.js +915 -915
  732. package/src/math/Plane.js +205 -205
  733. package/src/math/Quaternion.js +685 -684
  734. package/src/math/Ray.js +493 -493
  735. package/src/math/Sphere.js +245 -243
  736. package/src/math/Spherical.js +86 -86
  737. package/src/math/SphericalHarmonics3.js +243 -243
  738. package/src/math/Triangle.js +311 -329
  739. package/src/math/Vector2.js +480 -480
  740. package/src/math/Vector3.js +724 -725
  741. package/src/math/Vector4.js +644 -644
  742. package/src/math/interpolants/CubicInterpolant.js +150 -150
  743. package/src/math/interpolants/DiscreteInterpolant.js +26 -26
  744. package/src/math/interpolants/LinearInterpolant.js +38 -38
  745. package/src/math/interpolants/QuaternionLinearInterpolant.js +39 -39
  746. package/src/objects/BatchedMesh.js +1019 -0
  747. package/src/objects/Bone.js +17 -17
  748. package/src/objects/Group.js +17 -17
  749. package/src/objects/InstancedMesh.js +214 -214
  750. package/src/objects/LOD.js +214 -214
  751. package/src/objects/Line.js +222 -222
  752. package/src/objects/LineLoop.js +17 -17
  753. package/src/objects/LineSegments.js +55 -55
  754. package/src/objects/Mesh.js +429 -429
  755. package/src/objects/Points.js +166 -166
  756. package/src/objects/Skeleton.js +277 -279
  757. package/src/objects/SkinnedMesh.js +257 -266
  758. package/src/objects/Sprite.js +181 -181
  759. package/src/renderers/WebGL1Renderer.js +7 -7
  760. package/src/renderers/WebGL3DRenderTarget.js +22 -22
  761. package/src/renderers/WebGLArrayRenderTarget.js +22 -22
  762. package/src/renderers/WebGLCubeRenderTarget.js +155 -155
  763. package/src/renderers/WebGLMultipleRenderTargets.js +82 -84
  764. package/src/renderers/WebGLRenderTarget.js +15 -122
  765. package/src/renderers/WebGLRenderer.js +2631 -2439
  766. package/src/renderers/shaders/ShaderChunk/alphahash_fragment.glsl.js +7 -7
  767. package/src/renderers/shaders/ShaderChunk/alphahash_pars_fragment.glsl.js +68 -68
  768. package/src/renderers/shaders/ShaderChunk/alphamap_fragment.glsl.js +7 -7
  769. package/src/renderers/shaders/ShaderChunk/alphamap_pars_fragment.glsl.js +7 -7
  770. package/src/renderers/shaders/ShaderChunk/alphatest_fragment.glsl.js +16 -7
  771. package/src/renderers/shaders/ShaderChunk/alphatest_pars_fragment.glsl.js +5 -5
  772. package/src/renderers/shaders/ShaderChunk/aomap_fragment.glsl.js +26 -18
  773. package/src/renderers/shaders/ShaderChunk/aomap_pars_fragment.glsl.js +8 -8
  774. package/src/renderers/shaders/ShaderChunk/batching_pars_vertex.glsl.js +19 -0
  775. package/src/renderers/shaders/ShaderChunk/batching_vertex.glsl.js +5 -0
  776. package/src/renderers/shaders/ShaderChunk/begin_vertex.glsl.js +9 -9
  777. package/src/renderers/shaders/ShaderChunk/beginnormal_vertex.glsl.js +9 -9
  778. package/src/renderers/shaders/ShaderChunk/bsdfs.glsl.js +33 -33
  779. package/src/renderers/shaders/ShaderChunk/bumpmap_pars_fragment.glsl.js +43 -42
  780. package/src/renderers/shaders/ShaderChunk/clearcoat_normal_fragment_begin.glsl.js +7 -7
  781. package/src/renderers/shaders/ShaderChunk/clearcoat_normal_fragment_maps.glsl.js +10 -10
  782. package/src/renderers/shaders/ShaderChunk/clearcoat_pars_fragment.glsl.js +21 -21
  783. package/src/renderers/shaders/ShaderChunk/clipping_planes_fragment.glsl.js +78 -33
  784. package/src/renderers/shaders/ShaderChunk/clipping_planes_pars_fragment.glsl.js +9 -9
  785. package/src/renderers/shaders/ShaderChunk/clipping_planes_pars_vertex.glsl.js +7 -7
  786. package/src/renderers/shaders/ShaderChunk/clipping_planes_vertex.glsl.js +7 -7
  787. package/src/renderers/shaders/ShaderChunk/color_fragment.glsl.js +11 -11
  788. package/src/renderers/shaders/ShaderChunk/color_pars_fragment.glsl.js +11 -11
  789. package/src/renderers/shaders/ShaderChunk/color_pars_vertex.glsl.js +11 -11
  790. package/src/renderers/shaders/ShaderChunk/color_vertex.glsl.js +23 -23
  791. package/src/renderers/shaders/ShaderChunk/colorspace_fragment.glsl.js +3 -3
  792. package/src/renderers/shaders/ShaderChunk/colorspace_pars_fragment.glsl.js +44 -11
  793. package/src/renderers/shaders/ShaderChunk/common.glsl.js +147 -156
  794. package/src/renderers/shaders/ShaderChunk/cube_uv_reflection_fragment.glsl.js +186 -191
  795. package/src/renderers/shaders/ShaderChunk/default_fragment.glsl.js +5 -5
  796. package/src/renderers/shaders/ShaderChunk/default_vertex.glsl.js +5 -5
  797. package/src/renderers/shaders/ShaderChunk/defaultnormal_vertex.glsl.js +63 -36
  798. package/src/renderers/shaders/ShaderChunk/displacementmap_pars_vertex.glsl.js +9 -9
  799. package/src/renderers/shaders/ShaderChunk/displacementmap_vertex.glsl.js +7 -7
  800. package/src/renderers/shaders/ShaderChunk/dithering_fragment.glsl.js +7 -7
  801. package/src/renderers/shaders/ShaderChunk/dithering_pars_fragment.glsl.js +20 -20
  802. package/src/renderers/shaders/ShaderChunk/emissivemap_fragment.glsl.js +9 -9
  803. package/src/renderers/shaders/ShaderChunk/emissivemap_pars_fragment.glsl.js +7 -7
  804. package/src/renderers/shaders/ShaderChunk/envmap_common_pars_fragment.glsl.js +14 -14
  805. package/src/renderers/shaders/ShaderChunk/envmap_fragment.glsl.js +62 -62
  806. package/src/renderers/shaders/ShaderChunk/envmap_pars_fragment.glsl.js +21 -21
  807. package/src/renderers/shaders/ShaderChunk/envmap_pars_vertex.glsl.js +22 -22
  808. package/src/renderers/shaders/ShaderChunk/envmap_physical_pars_fragment.glsl.js +69 -69
  809. package/src/renderers/shaders/ShaderChunk/envmap_vertex.glsl.js +37 -37
  810. package/src/renderers/shaders/ShaderChunk/fog_fragment.glsl.js +17 -17
  811. package/src/renderers/shaders/ShaderChunk/fog_pars_fragment.glsl.js +19 -19
  812. package/src/renderers/shaders/ShaderChunk/fog_pars_vertex.glsl.js +7 -7
  813. package/src/renderers/shaders/ShaderChunk/fog_vertex.glsl.js +7 -7
  814. package/src/renderers/shaders/ShaderChunk/gradientmap_pars_fragment.glsl.js +27 -27
  815. package/src/renderers/shaders/ShaderChunk/iridescence_fragment.glsl.js +120 -121
  816. package/src/renderers/shaders/ShaderChunk/iridescence_pars_fragment.glsl.js +14 -14
  817. package/src/renderers/shaders/ShaderChunk/lightmap_fragment.glsl.js +10 -10
  818. package/src/renderers/shaders/ShaderChunk/lightmap_pars_fragment.glsl.js +8 -8
  819. package/src/renderers/shaders/ShaderChunk/lights_fragment_begin.glsl.js +202 -198
  820. package/src/renderers/shaders/ShaderChunk/lights_fragment_end.glsl.js +13 -13
  821. package/src/renderers/shaders/ShaderChunk/lights_fragment_maps.glsl.js +40 -40
  822. package/src/renderers/shaders/ShaderChunk/lights_lambert_fragment.glsl.js +5 -5
  823. package/src/renderers/shaders/ShaderChunk/lights_lambert_pars_fragment.glsl.js +28 -28
  824. package/src/renderers/shaders/ShaderChunk/lights_pars_begin.glsl.js +228 -223
  825. package/src/renderers/shaders/ShaderChunk/lights_phong_fragment.glsl.js +7 -7
  826. package/src/renderers/shaders/ShaderChunk/lights_phong_pars_fragment.glsl.js +32 -32
  827. package/src/renderers/shaders/ShaderChunk/lights_physical_fragment.glsl.js +151 -146
  828. package/src/renderers/shaders/ShaderChunk/lights_physical_pars_fragment.glsl.js +562 -560
  829. package/src/renderers/shaders/ShaderChunk/lights_toon_fragment.glsl.js +4 -4
  830. package/src/renderers/shaders/ShaderChunk/lights_toon_pars_fragment.glsl.js +26 -26
  831. package/src/renderers/shaders/ShaderChunk/logdepthbuf_fragment.glsl.js +9 -9
  832. package/src/renderers/shaders/ShaderChunk/logdepthbuf_pars_fragment.glsl.js +9 -9
  833. package/src/renderers/shaders/ShaderChunk/logdepthbuf_pars_vertex.glsl.js +16 -16
  834. package/src/renderers/shaders/ShaderChunk/logdepthbuf_vertex.glsl.js +22 -22
  835. package/src/renderers/shaders/ShaderChunk/map_fragment.glsl.js +21 -13
  836. package/src/renderers/shaders/ShaderChunk/map_pars_fragment.glsl.js +11 -11
  837. package/src/renderers/shaders/ShaderChunk/map_particle_fragment.glsl.js +27 -27
  838. package/src/renderers/shaders/ShaderChunk/map_particle_pars_fragment.glsl.js +27 -27
  839. package/src/renderers/shaders/ShaderChunk/metalnessmap_fragment.glsl.js +12 -12
  840. package/src/renderers/shaders/ShaderChunk/metalnessmap_pars_fragment.glsl.js +7 -7
  841. package/src/renderers/shaders/ShaderChunk/morphcolor_vertex.glsl.js +24 -24
  842. package/src/renderers/shaders/ShaderChunk/morphnormal_vertex.glsl.js +27 -27
  843. package/src/renderers/shaders/ShaderChunk/morphtarget_pars_vertex.glsl.js +38 -38
  844. package/src/renderers/shaders/ShaderChunk/morphtarget_vertex.glsl.js +36 -36
  845. package/src/renderers/shaders/ShaderChunk/normal_fragment_begin.glsl.js +76 -76
  846. package/src/renderers/shaders/ShaderChunk/normal_fragment_maps.glsl.js +33 -33
  847. package/src/renderers/shaders/ShaderChunk/normal_pars_fragment.glsl.js +14 -14
  848. package/src/renderers/shaders/ShaderChunk/normal_pars_vertex.glsl.js +14 -14
  849. package/src/renderers/shaders/ShaderChunk/normal_vertex.glsl.js +14 -14
  850. package/src/renderers/shaders/ShaderChunk/normalmap_pars_fragment.glsl.js +43 -43
  851. package/src/renderers/shaders/ShaderChunk/occlusion_fragment.glsl.js +20 -0
  852. package/src/renderers/shaders/ShaderChunk/occlusion_pars_fragment.glsl.js +97 -0
  853. package/src/renderers/shaders/ShaderChunk/opaque_fragment.glsl.js +11 -11
  854. package/src/renderers/shaders/ShaderChunk/packing.glsl.js +68 -68
  855. package/src/renderers/shaders/ShaderChunk/premultiplied_alpha_fragment.glsl.js +8 -8
  856. package/src/renderers/shaders/ShaderChunk/project_vertex.glsl.js +19 -13
  857. package/src/renderers/shaders/ShaderChunk/roughnessmap_fragment.glsl.js +12 -12
  858. package/src/renderers/shaders/ShaderChunk/roughnessmap_pars_fragment.glsl.js +7 -7
  859. package/src/renderers/shaders/ShaderChunk/shadowmap_pars_fragment.glsl.js +314 -314
  860. package/src/renderers/shaders/ShaderChunk/shadowmap_pars_vertex.glsl.js +68 -68
  861. package/src/renderers/shaders/ShaderChunk/shadowmap_vertex.glsl.js +68 -68
  862. package/src/renderers/shaders/ShaderChunk/shadowmask_pars_fragment.glsl.js +66 -66
  863. package/src/renderers/shaders/ShaderChunk/skinbase_vertex.glsl.js +10 -10
  864. package/src/renderers/shaders/ShaderChunk/skinning_pars_vertex.glsl.js +25 -33
  865. package/src/renderers/shaders/ShaderChunk/skinning_vertex.glsl.js +15 -15
  866. package/src/renderers/shaders/ShaderChunk/skinnormal_vertex.glsl.js +20 -20
  867. package/src/renderers/shaders/ShaderChunk/specularmap_fragment.glsl.js +14 -14
  868. package/src/renderers/shaders/ShaderChunk/specularmap_pars_fragment.glsl.js +7 -7
  869. package/src/renderers/shaders/ShaderChunk/tonemapping_fragment.glsl.js +7 -7
  870. package/src/renderers/shaders/ShaderChunk/tonemapping_pars_fragment.glsl.js +169 -77
  871. package/src/renderers/shaders/ShaderChunk/transmission_fragment.glsl.js +36 -36
  872. package/src/renderers/shaders/ShaderChunk/transmission_pars_fragment.glsl.js +201 -201
  873. package/src/renderers/shaders/ShaderChunk/uv_pars_fragment.glsl.js +119 -119
  874. package/src/renderers/shaders/ShaderChunk/uv_pars_vertex.glsl.js +145 -145
  875. package/src/renderers/shaders/ShaderChunk/uv_vertex.glsl.js +122 -122
  876. package/src/renderers/shaders/ShaderChunk/worldpos_vertex.glsl.js +21 -15
  877. package/src/renderers/shaders/ShaderChunk.js +274 -266
  878. package/src/renderers/shaders/ShaderLib/background.glsl.js +40 -32
  879. package/src/renderers/shaders/ShaderLib/backgroundCube.glsl.js +62 -62
  880. package/src/renderers/shaders/ShaderLib/cube.glsl.js +36 -36
  881. package/src/renderers/shaders/ShaderLib/depth.glsl.js +95 -94
  882. package/src/renderers/shaders/ShaderLib/distanceRGBA.glsl.js +76 -75
  883. package/src/renderers/shaders/ShaderLib/equirect.glsl.js +35 -35
  884. package/src/renderers/shaders/ShaderLib/linedashed.glsl.js +77 -75
  885. package/src/renderers/shaders/ShaderLib/meshbasic.glsl.js +117 -114
  886. package/src/renderers/shaders/ShaderLib/meshlambert.glsl.js +126 -122
  887. package/src/renderers/shaders/ShaderLib/meshmatcap.glsl.js +113 -109
  888. package/src/renderers/shaders/ShaderLib/meshnormal.glsl.js +89 -82
  889. package/src/renderers/shaders/ShaderLib/meshphong.glsl.js +128 -124
  890. package/src/renderers/shaders/ShaderLib/meshphysical.glsl.js +226 -222
  891. package/src/renderers/shaders/ShaderLib/meshtoon.glsl.js +120 -116
  892. package/src/renderers/shaders/ShaderLib/points.glsl.js +88 -86
  893. package/src/renderers/shaders/ShaderLib/shadow.glsl.js +57 -54
  894. package/src/renderers/shaders/ShaderLib/sprite.glsl.js +81 -81
  895. package/src/renderers/shaders/ShaderLib/vsm.glsl.js +53 -53
  896. package/src/renderers/shaders/ShaderLib.js +367 -359
  897. package/src/renderers/shaders/UniformsLib.js +236 -230
  898. package/src/renderers/shaders/UniformsUtils.js +104 -104
  899. package/src/renderers/webgl/WebGLAnimation.js +53 -53
  900. package/src/renderers/webgl/WebGLAttributes.js +229 -195
  901. package/src/renderers/webgl/WebGLBackground.js +239 -247
  902. package/src/renderers/webgl/WebGLBindingStates.js +631 -631
  903. package/src/renderers/webgl/WebGLBufferRenderer.js +92 -61
  904. package/src/renderers/webgl/WebGLCapabilities.js +120 -120
  905. package/src/renderers/webgl/WebGLClipping.js +171 -171
  906. package/src/renderers/webgl/WebGLCubeMaps.js +99 -99
  907. package/src/renderers/webgl/WebGLCubeUVMaps.js +132 -130
  908. package/src/renderers/webgl/WebGLExtensions.js +97 -96
  909. package/src/renderers/webgl/WebGLGeometries.js +211 -207
  910. package/src/renderers/webgl/WebGLIndexedBufferRenderer.js +102 -71
  911. package/src/renderers/webgl/WebGLInfo.js +71 -71
  912. package/src/renderers/webgl/WebGLLights.js +590 -570
  913. package/src/renderers/webgl/WebGLMaterials.js +576 -567
  914. package/src/renderers/webgl/WebGLMorphtargets.js +300 -300
  915. package/src/renderers/webgl/WebGLObjects.js +92 -92
  916. package/src/renderers/webgl/WebGLProgram.js +1112 -1002
  917. package/src/renderers/webgl/WebGLPrograms.js +663 -625
  918. package/src/renderers/webgl/WebGLProperties.js +48 -48
  919. package/src/renderers/webgl/WebGLRenderLists.js +238 -238
  920. package/src/renderers/webgl/WebGLRenderStates.js +107 -107
  921. package/src/renderers/webgl/WebGLShader.js +12 -12
  922. package/src/renderers/webgl/WebGLShaderCache.js +124 -124
  923. package/src/renderers/webgl/WebGLShadowMap.js +424 -389
  924. package/src/renderers/webgl/WebGLState.js +1328 -1307
  925. package/src/renderers/webgl/WebGLTextures.js +2117 -2017
  926. package/src/renderers/webgl/WebGLUniforms.js +1156 -1146
  927. package/src/renderers/webgl/WebGLUniformsGroups.js +392 -413
  928. package/src/renderers/webgl/WebGLUtils.js +283 -278
  929. package/src/renderers/webxr/WebXRController.js +343 -343
  930. package/src/renderers/webxr/WebXRManager.js +840 -770
  931. package/src/scenes/Fog.js +38 -37
  932. package/src/scenes/FogExp2.js +35 -34
  933. package/src/scenes/Scene.js +63 -63
  934. package/src/textures/CanvasTexture.js +17 -17
  935. package/src/textures/CompressedArrayTexture.js +18 -18
  936. package/src/textures/CompressedCubeTexture.js +19 -0
  937. package/src/textures/CompressedTexture.js +28 -28
  938. package/src/textures/CubeTexture.js +33 -33
  939. package/src/textures/Data3DTexture.js +35 -35
  940. package/src/textures/DataArrayTexture.js +27 -27
  941. package/src/textures/DataTexture.js +22 -22
  942. package/src/textures/DepthTexture.js +58 -58
  943. package/src/textures/FramebufferTexture.js +23 -23
  944. package/src/textures/Source.js +127 -127
  945. package/src/textures/Texture.js +338 -338
  946. package/src/textures/VideoTexture.js +55 -55
  947. package/src/utils.js +91 -83
  948. package/build/three.js +0 -51661
  949. package/build/three.min.js +0 -7
  950. package/examples/jsm/nodes/accessors/ExtendedMaterialNode.js +0 -64
  951. package/examples/jsm/nodes/functions/BSDF/BRDF_BlinnPhong.js +0 -30
  952. package/examples/jsm/objects/GroundProjectedSkybox.js +0 -172
  953. package/examples/jsm/renderers/common/RenderTarget.js +0 -15
  954. package/examples/jsm/renderers/common/nodes/NodeRender.js +0 -302
  955. package/examples/jsm/renderers/webgpu/utils/WebGPUTextureMipmapUtils.js +0 -163
  956. package/src/lights/AmbientLightProbe.js +0 -21
  957. package/src/lights/HemisphereLightProbe.js +0 -30
@@ -1,878 +1,1098 @@
1
- import { NoColorSpace } from 'three';
2
-
3
- import UniformsGroup from '../../common/UniformsGroup.js';
4
- import {
5
- FloatNodeUniform, Vector2NodeUniform, Vector3NodeUniform, Vector4NodeUniform,
6
- ColorNodeUniform, Matrix3NodeUniform, Matrix4NodeUniform
7
- } from '../../common/nodes/NodeUniform.js';
8
- import NodeSampler from '../../common/nodes/NodeSampler.js';
9
- import { NodeSampledTexture, NodeSampledCubeTexture } from '../../common/nodes/NodeSampledTexture.js';
10
-
11
- import UniformBuffer from '../../common/UniformBuffer.js';
12
- import StorageBuffer from '../../common/StorageBuffer.js';
13
- import { getVectorLength, getStrideLength } from '../../common/BufferUtils.js';
14
-
15
- import RenderTarget from '../../common/RenderTarget.js';
16
- import CubeRenderTarget from '../../common/CubeRenderTarget.js';
17
-
18
- import { NodeBuilder, CodeNode, NodeMaterial } from '../../../nodes/Nodes.js';
19
-
20
- import WGSLNodeParser from './WGSLNodeParser.js';
21
-
22
- /*
23
- const gpuShaderStageLib = {
24
- 'vertex': GPUShaderStage.VERTEX,
25
- 'fragment': GPUShaderStage.FRAGMENT,
26
- 'compute': GPUShaderStage.COMPUTE
27
- };
28
- */
29
-
30
- const supports = {
31
- instance: true
32
- };
33
-
34
- const wgslTypeLib = {
35
- float: 'f32',
36
- int: 'i32',
37
- uint: 'u32',
38
- bool: 'bool',
39
- color: 'vec3<f32>',
40
-
41
- vec2: 'vec2<f32>',
42
- ivec2: 'vec2<i32>',
43
- uvec2: 'vec2<u32>',
44
- bvec2: 'vec2<bool>',
45
-
46
- vec3: 'vec3<f32>',
47
- ivec3: 'vec3<i32>',
48
- uvec3: 'vec3<u32>',
49
- bvec3: 'vec3<bool>',
50
-
51
- vec4: 'vec4<f32>',
52
- ivec4: 'vec4<i32>',
53
- uvec4: 'vec4<u32>',
54
- bvec4: 'vec4<bool>',
55
-
56
- mat3: 'mat3x3<f32>',
57
- imat3: 'mat3x3<i32>',
58
- umat3: 'mat3x3<u32>',
59
- bmat3: 'mat3x3<bool>',
60
-
61
- mat4: 'mat4x4<f32>',
62
- imat4: 'mat4x4<i32>',
63
- umat4: 'mat4x4<u32>',
64
- bmat4: 'mat4x4<bool>'
65
- };
66
-
67
- const wgslMethods = {
68
- dFdx: 'dpdx',
69
- dFdy: 'dpdy',
70
- mod: 'threejs_mod',
71
- lessThanEqual: 'threejs_lessThanEqual',
72
- inversesqrt: 'inverseSqrt'
73
- };
74
-
75
- const wgslPolyfill = {
76
- lessThanEqual: new CodeNode( `
77
- fn threejs_lessThanEqual( a : vec3<f32>, b : vec3<f32> ) -> vec3<bool> {
78
-
79
- return vec3<bool>( a.x <= b.x, a.y <= b.y, a.z <= b.z );
80
-
81
- }
82
- ` ),
83
- mod: new CodeNode( `
84
- fn threejs_mod( x : f32, y : f32 ) -> f32 {
85
-
86
- return x - y * floor( x / y );
87
-
88
- }
89
- ` ),
90
- repeatWrapping: new CodeNode( `
91
- fn threejs_repeatWrapping( uv : vec2<f32>, dimension : vec2<u32> ) -> vec2<u32> {
92
-
93
- let uvScaled = vec2<u32>( uv * vec2<f32>( dimension ) );
94
-
95
- return ( ( uvScaled % dimension ) + dimension ) % dimension;
96
-
97
- }
98
- ` )
99
- };
100
-
101
- class WGSLNodeBuilder extends NodeBuilder {
102
-
103
- constructor( object, renderer, scene = null ) {
104
-
105
- super( object, renderer, new WGSLNodeParser(), scene );
106
-
107
- this.uniformsGroup = {};
108
-
109
- this.builtins = {
110
- vertex: new Map(),
111
- fragment: new Map(),
112
- compute: new Map(),
113
- attribute: new Map()
114
- };
115
-
116
- }
117
-
118
- build() {
119
-
120
- const { object, material } = this;
121
-
122
- if ( material !== null ) {
123
-
124
- NodeMaterial.fromMaterial( material ).build( this );
125
-
126
- } else {
127
-
128
- this.addFlow( 'compute', object );
129
-
130
- }
131
-
132
- return super.build();
133
-
134
- }
135
-
136
- needsColorSpaceToLinear( texture ) {
137
-
138
- return texture.isVideoTexture === true && texture.colorSpace !== NoColorSpace;
139
-
140
- }
141
-
142
- getSampler( textureProperty, uvSnippet, shaderStage = this.shaderStage ) {
143
-
144
- if ( shaderStage === 'fragment' ) {
145
-
146
- return `textureSample( ${textureProperty}, ${textureProperty}_sampler, ${uvSnippet} )`;
147
-
148
- } else {
149
-
150
- this._include( 'repeatWrapping' );
151
-
152
- const dimension = `textureDimensions( ${textureProperty}, 0 )`;
153
-
154
- return `textureLoad( ${textureProperty}, threejs_repeatWrapping( ${uvSnippet}, ${dimension} ), 0 )`;
155
-
156
- }
157
-
158
- }
159
-
160
- getVideoSampler( textureProperty, uvSnippet, shaderStage = this.shaderStage ) {
161
-
162
- if ( shaderStage === 'fragment' ) {
163
-
164
- return `textureSampleBaseClampToEdge( ${textureProperty}, ${textureProperty}_sampler, vec2<f32>( ${uvSnippet}.x, 1.0 - ${uvSnippet}.y ) )`;
165
-
166
- } else {
167
-
168
- console.error( `WebGPURenderer: THREE.VideoTexture does not support ${ shaderStage } shader.` );
169
-
170
- }
171
-
172
- }
173
-
174
- getSamplerLevel( textureProperty, uvSnippet, biasSnippet, shaderStage = this.shaderStage ) {
175
-
176
- if ( shaderStage === 'fragment' ) {
177
-
178
- return `textureSampleLevel( ${textureProperty}, ${textureProperty}_sampler, ${uvSnippet}, ${biasSnippet} )`;
179
-
180
- } else {
181
-
182
- this._include( 'repeatWrapping' );
183
-
184
- const dimension = `textureDimensions( ${textureProperty}, 0 )`;
185
-
186
- return `textureLoad( ${textureProperty}, threejs_repeatWrapping( ${uvSnippet}, ${dimension} ), i32( ${biasSnippet} ) )`;
187
-
188
- }
189
-
190
- }
191
-
192
- getTexture( texture, textureProperty, uvSnippet, shaderStage = this.shaderStage ) {
193
-
194
- let snippet = null;
195
-
196
- if ( texture.isVideoTexture === true ) {
197
-
198
- snippet = this.getVideoSampler( textureProperty, uvSnippet, shaderStage );
199
-
200
- } else {
201
-
202
- snippet = this.getSampler( textureProperty, uvSnippet, shaderStage );
203
-
204
- }
205
-
206
- return snippet;
207
-
208
- }
209
-
210
- getTextureLevel( texture, textureProperty, uvSnippet, biasSnippet, shaderStage = this.shaderStage ) {
211
-
212
- let snippet = null;
213
-
214
- if ( texture.isVideoTexture === true ) {
215
-
216
- snippet = this.getVideoSampler( textureProperty, uvSnippet, shaderStage );
217
-
218
- } else {
219
-
220
- snippet = this.getSamplerLevel( textureProperty, uvSnippet, biasSnippet, shaderStage );
221
-
222
- }
223
-
224
- return snippet;
225
-
226
- }
227
-
228
- getPropertyName( node, shaderStage = this.shaderStage ) {
229
-
230
- if ( node.isNodeVarying === true && node.needsInterpolation === true ) {
231
-
232
- if ( shaderStage === 'vertex' ) {
233
-
234
- return `NodeVaryings.${ node.name }`;
235
-
236
- }
237
-
238
- } else if ( node.isNodeUniform === true ) {
239
-
240
- const name = node.name;
241
- const type = node.type;
242
-
243
- if ( type === 'texture' || type === 'cubeTexture' ) {
244
-
245
- return name;
246
-
247
- } else if ( type === 'buffer' || type === 'storageBuffer' ) {
248
-
249
- return `NodeBuffer_${node.node.id}.${name}`;
250
-
251
- } else {
252
-
253
- return `NodeUniforms.${name}`;
254
-
255
- }
256
-
257
- }
258
-
259
- return super.getPropertyName( node );
260
-
261
- }
262
-
263
- getUniformFromNode( node, type, shaderStage, name = null ) {
264
-
265
- const uniformNode = super.getUniformFromNode( node, type, shaderStage, name );
266
- const nodeData = this.getDataFromNode( node, shaderStage );
267
-
268
- if ( nodeData.uniformGPU === undefined ) {
269
-
270
- let uniformGPU;
271
-
272
- const bindings = this.bindings[ shaderStage ];
273
-
274
- if ( type === 'texture' || type === 'cubeTexture' ) {
275
-
276
- const sampler = new NodeSampler( `${uniformNode.name}_sampler`, uniformNode.node );
277
-
278
- let texture = null;
279
-
280
- if ( type === 'texture' ) {
281
-
282
- texture = new NodeSampledTexture( uniformNode.name, uniformNode.node );
283
-
284
- } else if ( type === 'cubeTexture' ) {
285
-
286
- texture = new NodeSampledCubeTexture( uniformNode.name, uniformNode.node );
287
-
288
- }
289
-
290
- // add first textures in sequence and group for last
291
- const lastBinding = bindings[ bindings.length - 1 ];
292
- const index = lastBinding && lastBinding.isUniformsGroup ? bindings.length - 1 : bindings.length;
293
-
294
- if ( shaderStage === 'fragment' ) {
295
-
296
- bindings.splice( index, 0, sampler, texture );
297
-
298
- uniformGPU = [ sampler, texture ];
299
-
300
- } else {
301
-
302
- bindings.splice( index, 0, texture );
303
-
304
- uniformGPU = [ texture ];
305
-
306
- }
307
-
308
- } else if ( type === 'buffer' || type === 'storageBuffer' ) {
309
-
310
- const bufferClass = type === 'storageBuffer' ? StorageBuffer : UniformBuffer;
311
- const buffer = new bufferClass( 'NodeBuffer_' + node.id, node.value );
312
- //buffer.setVisibility( gpuShaderStageLib[ shaderStage ] );
313
-
314
- // add first textures in sequence and group for last
315
- const lastBinding = bindings[ bindings.length - 1 ];
316
- const index = lastBinding && lastBinding.isUniformsGroup ? bindings.length - 1 : bindings.length;
317
-
318
- bindings.splice( index, 0, buffer );
319
-
320
- uniformGPU = buffer;
321
-
322
- } else {
323
-
324
- let uniformsGroup = this.uniformsGroup[ shaderStage ];
325
-
326
- if ( uniformsGroup === undefined ) {
327
-
328
- uniformsGroup = new UniformsGroup( 'nodeUniforms' );
329
- //uniformsGroup.setVisibility( gpuShaderStageLib[ shaderStage ] );
330
-
331
- this.uniformsGroup[ shaderStage ] = uniformsGroup;
332
-
333
- bindings.push( uniformsGroup );
334
-
335
- }
336
-
337
- if ( node.isArrayUniformNode === true ) {
338
-
339
- uniformGPU = [];
340
-
341
- for ( const uniformNode of node.nodes ) {
342
-
343
- const uniformNodeGPU = this._getNodeUniform( uniformNode, type );
344
-
345
- // fit bounds to buffer
346
- uniformNodeGPU.boundary = getVectorLength( uniformNodeGPU.itemSize );
347
- uniformNodeGPU.itemSize = getStrideLength( uniformNodeGPU.itemSize );
348
-
349
- uniformsGroup.addUniform( uniformNodeGPU );
350
-
351
- uniformGPU.push( uniformNodeGPU );
352
-
353
- }
354
-
355
- } else {
356
-
357
- uniformGPU = this._getNodeUniform( uniformNode, type );
358
-
359
- uniformsGroup.addUniform( uniformGPU );
360
-
361
- }
362
-
363
- }
364
-
365
- nodeData.uniformGPU = uniformGPU;
366
-
367
- if ( shaderStage === 'vertex' ) {
368
-
369
- this.bindingsOffset[ 'fragment' ] = bindings.length;
370
-
371
- }
372
-
373
- }
374
-
375
- return uniformNode;
376
-
377
- }
378
-
379
- isReference( type ) {
380
-
381
- return super.isReference( type ) || type === 'texture_2d' || type === 'texture_cube';
382
-
383
- }
384
-
385
- getBuiltin( name, property, type, shaderStage = this.shaderStage ) {
386
-
387
- const map = this.builtins[ shaderStage ];
388
-
389
- if ( map.has( name ) === false ) {
390
-
391
- map.set( name, {
392
- name,
393
- property,
394
- type
395
- } );
396
-
397
- }
398
-
399
- return property;
400
-
401
- }
402
-
403
- getVertexIndex() {
404
-
405
- if ( this.shaderStage === 'vertex' ) {
406
-
407
- return this.getBuiltin( 'vertex_index', 'vertexIndex', 'u32', 'attribute' );
408
-
409
- }
410
-
411
- return 'vertexIndex';
412
-
413
- }
414
-
415
- getInstanceIndex() {
416
-
417
- if ( this.shaderStage === 'vertex' ) {
418
-
419
- return this.getBuiltin( 'instance_index', 'instanceIndex', 'u32', 'attribute' );
420
-
421
- }
422
-
423
- return 'instanceIndex';
424
-
425
- }
426
-
427
- getFrontFacing() {
428
-
429
- return this.getBuiltin( 'front_facing', 'isFront', 'bool' );
430
-
431
- }
432
-
433
- getFragCoord() {
434
-
435
- return this.getBuiltin( 'position', 'fragCoord', 'vec4<f32>', 'fragment' );
436
-
437
- }
438
-
439
- isFlipY() {
440
-
441
- return false;
442
-
443
- }
444
-
445
- getAttributes( shaderStage ) {
446
-
447
- const snippets = [];
448
-
449
- if ( shaderStage === 'compute' ) {
450
-
451
- this.getBuiltin( 'global_invocation_id', 'id', 'vec3<u32>', 'attribute' );
452
-
453
- }
454
-
455
- if ( shaderStage === 'vertex' || shaderStage === 'compute' ) {
456
-
457
- for ( const { name, property, type } of this.builtins.attribute.values() ) {
458
-
459
- snippets.push( `@builtin( ${name} ) ${property} : ${type}` );
460
-
461
- }
462
-
463
- const attributes = this.getAttributesArray();
464
-
465
- for ( let index = 0, length = attributes.length; index < length; index ++ ) {
466
-
467
- const attribute = attributes[ index ];
468
- const name = attribute.name;
469
- const type = this.getType( attribute.type );
470
-
471
- snippets.push( `@location( ${index} ) ${ name } : ${ type }` );
472
-
473
- }
474
-
475
- }
476
-
477
- return snippets.join( ',\n\t' );
478
-
479
- }
480
-
481
- getVar( type, name ) {
482
-
483
- return `var ${ name } : ${ this.getType( type ) }`;
484
-
485
- }
486
-
487
- getVars( shaderStage ) {
488
-
489
- const snippets = [];
490
- const vars = this.vars[ shaderStage ];
491
-
492
- for ( const variable of vars ) {
493
-
494
- snippets.push( `\t${ this.getVar( variable.type, variable.name ) };` );
495
-
496
- }
497
-
498
- return `\n${ snippets.join( '\n' ) }\n`;
499
-
500
- }
501
-
502
- getVaryings( shaderStage ) {
503
-
504
- const snippets = [];
505
-
506
- if ( shaderStage === 'vertex' ) {
507
-
508
- this.getBuiltin( 'position', 'Vertex', 'vec4<f32>', 'vertex' );
509
-
510
- }
511
-
512
- if ( shaderStage === 'vertex' || shaderStage === 'fragment' ) {
513
-
514
- const varyings = this.varyings;
515
- const vars = this.vars[ shaderStage ];
516
-
517
- for ( let index = 0; index < varyings.length; index ++ ) {
518
-
519
- const varying = varyings[ index ];
520
-
521
- if ( varying.needsInterpolation ) {
522
-
523
- let attributesSnippet = `@location( ${index} )`;
524
-
525
- if ( varying.type === 'int' || varying.type === 'uint' ) {
526
-
527
- attributesSnippet += ' @interpolate( flat )';
528
-
529
- }
530
-
531
- snippets.push( `${ attributesSnippet } ${ varying.name } : ${ this.getType( varying.type ) }` );
532
-
533
- } else if ( shaderStage === 'vertex' && vars.includes( varying ) === false ) {
534
-
535
- vars.push( varying );
536
-
537
- }
538
-
539
- }
540
-
541
- }
542
-
543
- for ( const { name, property, type } of this.builtins[ shaderStage ].values() ) {
544
-
545
- snippets.push( `@builtin( ${name} ) ${property} : ${type}` );
546
-
547
- }
548
-
549
- const code = snippets.join( ',\n\t' );
550
-
551
- return shaderStage === 'vertex' ? this._getWGSLStruct( 'NodeVaryingsStruct', '\t' + code ) : code;
552
-
553
- }
554
-
555
- getUniforms( shaderStage ) {
556
-
557
- const uniforms = this.uniforms[ shaderStage ];
558
-
559
- const bindingSnippets = [];
560
- const bufferSnippets = [];
561
- const groupSnippets = [];
562
-
563
- let index = this.bindingsOffset[ shaderStage ];
564
-
565
- for ( const uniform of uniforms ) {
566
-
567
- if ( uniform.type === 'texture' || uniform.type === 'cubeTexture' ) {
568
-
569
- if ( shaderStage === 'fragment' ) {
570
-
571
- bindingSnippets.push( `@binding( ${index ++} ) @group( 0 ) var ${uniform.name}_sampler : sampler;` );
572
-
573
- }
574
-
575
- const texture = uniform.node.value;
576
-
577
- let textureType;
578
-
579
- if ( texture.isCubeTexture === true ) {
580
-
581
- textureType = 'texture_cube<f32>';
582
-
583
- } else if ( texture.isDepthTexture === true ) {
584
-
585
- textureType = 'texture_depth_2d';
586
-
587
- } else if ( texture.isVideoTexture === true ) {
588
-
589
- textureType = 'texture_external';
590
-
591
- } else {
592
-
593
- textureType = 'texture_2d<f32>';
594
-
595
- }
596
-
597
- bindingSnippets.push( `@binding( ${index ++} ) @group( 0 ) var ${uniform.name} : ${textureType};` );
598
-
599
- } else if ( uniform.type === 'buffer' || uniform.type === 'storageBuffer' ) {
600
-
601
- const bufferNode = uniform.node;
602
- const bufferType = this.getType( bufferNode.bufferType );
603
- const bufferCount = bufferNode.bufferCount;
604
-
605
- const bufferCountSnippet = bufferCount > 0 ? ', ' + bufferCount : '';
606
- const bufferSnippet = `\t${uniform.name} : array< ${bufferType}${bufferCountSnippet} >\n`;
607
- const bufferAccessMode = bufferNode.isStorageBufferNode ? 'storage,read_write' : 'uniform';
608
-
609
- bufferSnippets.push( this._getWGSLStructBinding( 'NodeBuffer_' + bufferNode.id, bufferSnippet, bufferAccessMode, index ++ ) );
610
-
611
- } else {
612
-
613
- const vectorType = this.getType( this.getVectorType( uniform.type ) );
614
-
615
- if ( Array.isArray( uniform.value ) === true ) {
616
-
617
- const length = uniform.value.length;
618
-
619
- groupSnippets.push( `uniform ${vectorType}[ ${length} ] ${uniform.name}` );
620
-
621
- } else {
622
-
623
- groupSnippets.push( `\t${uniform.name} : ${ vectorType}` );
624
-
625
- }
626
-
627
- }
628
-
629
- }
630
-
631
- let code = bindingSnippets.join( '\n' );
632
- code += bufferSnippets.join( '\n' );
633
-
634
- if ( groupSnippets.length > 0 ) {
635
-
636
- code += this._getWGSLStructBinding( 'NodeUniforms', groupSnippets.join( ',\n' ), 'uniform', index ++ );
637
-
638
- }
639
-
640
- return code;
641
-
642
- }
643
-
644
- buildCode() {
645
-
646
- const shadersData = this.material !== null ? { fragment: {}, vertex: {} } : { compute: {} };
647
-
648
- for ( const shaderStage in shadersData ) {
649
-
650
- let flow = '// code\n\n';
651
- flow += this.flowCode[ shaderStage ];
652
-
653
- const flowNodes = this.flowNodes[ shaderStage ];
654
- const mainNode = flowNodes[ flowNodes.length - 1 ];
655
-
656
- for ( const node of flowNodes ) {
657
-
658
- const flowSlotData = this.getFlowData( node/*, shaderStage*/ );
659
- const slotName = node.name;
660
-
661
- if ( slotName ) {
662
-
663
- if ( flow.length > 0 ) flow += '\n';
664
-
665
- flow += `\t// flow -> ${ slotName }\n\t`;
666
-
667
- }
668
-
669
- flow += `${ flowSlotData.code }\n\t`;
670
-
671
- if ( node === mainNode && shaderStage !== 'compute' ) {
672
-
673
- flow += '// result\n\t';
674
-
675
- if ( shaderStage === 'vertex' ) {
676
-
677
- flow += 'NodeVaryings.Vertex = ';
678
-
679
- } else if ( shaderStage === 'fragment' ) {
680
-
681
- flow += 'return ';
682
-
683
- }
684
-
685
- flow += `${ flowSlotData.result };`;
686
-
687
- }
688
-
689
- }
690
-
691
- const stageData = shadersData[ shaderStage ];
692
-
693
- stageData.uniforms = this.getUniforms( shaderStage );
694
- stageData.attributes = this.getAttributes( shaderStage );
695
- stageData.varyings = this.getVaryings( shaderStage );
696
- stageData.vars = this.getVars( shaderStage );
697
- stageData.codes = this.getCodes( shaderStage );
698
- stageData.flow = flow;
699
-
700
- }
701
-
702
- if ( this.material !== null ) {
703
-
704
- this.vertexShader = this._getWGSLVertexCode( shadersData.vertex );
705
- this.fragmentShader = this._getWGSLFragmentCode( shadersData.fragment );
706
-
707
- } else {
708
-
709
- this.computeShader = this._getWGSLComputeCode( shadersData.compute, ( this.object.workgroupSize || [ 64 ] ).join( ', ' ) );
710
-
711
- }
712
-
713
- }
714
-
715
- getRenderTarget( width, height, options ) {
716
-
717
- return new RenderTarget( width, height, options );
718
-
719
- }
720
-
721
- getCubeRenderTarget( size, options ) {
722
-
723
- return new CubeRenderTarget( size, options );
724
-
725
- }
726
-
727
- getMethod( method ) {
728
-
729
- if ( wgslPolyfill[ method ] !== undefined ) {
730
-
731
- this._include( method );
732
-
733
- }
734
-
735
- return wgslMethods[ method ] || method;
736
-
737
- }
738
-
739
- getType( type ) {
740
-
741
- return wgslTypeLib[ type ] || type;
742
-
743
- }
744
-
745
- isAvailable( name ) {
746
-
747
- return supports[ name ] === true;
748
-
749
- }
750
-
751
- _include( name ) {
752
-
753
- wgslPolyfill[ name ].build( this );
754
-
755
- }
756
-
757
- _getNodeUniform( uniformNode, type ) {
758
-
759
- if ( type === 'float' ) return new FloatNodeUniform( uniformNode );
760
- if ( type === 'vec2' ) return new Vector2NodeUniform( uniformNode );
761
- if ( type === 'vec3' ) return new Vector3NodeUniform( uniformNode );
762
- if ( type === 'vec4' ) return new Vector4NodeUniform( uniformNode );
763
- if ( type === 'color' ) return new ColorNodeUniform( uniformNode );
764
- if ( type === 'mat3' ) return new Matrix3NodeUniform( uniformNode );
765
- if ( type === 'mat4' ) return new Matrix4NodeUniform( uniformNode );
766
-
767
- throw new Error( `Uniform "${type}" not declared.` );
768
-
769
- }
770
-
771
- _getWGSLVertexCode( shaderData ) {
772
-
773
- return `${ this.getSignature() }
774
-
775
- // uniforms
776
- ${shaderData.uniforms}
777
-
778
- // varyings
779
- ${shaderData.varyings}
780
-
781
- // codes
782
- ${shaderData.codes}
783
-
784
- @vertex
785
- fn main( ${shaderData.attributes} ) -> NodeVaryingsStruct {
786
-
787
- // system
788
- var NodeVaryings: NodeVaryingsStruct;
789
-
790
- // vars
791
- ${shaderData.vars}
792
-
793
- // flow
794
- ${shaderData.flow}
795
-
796
- return NodeVaryings;
797
-
798
- }
799
- `;
800
-
801
- }
802
-
803
- _getWGSLFragmentCode( shaderData ) {
804
-
805
- return `${ this.getSignature() }
806
-
807
- // uniforms
808
- ${shaderData.uniforms}
809
-
810
- // codes
811
- ${shaderData.codes}
812
-
813
- @fragment
814
- fn main( ${shaderData.varyings} ) -> @location( 0 ) vec4<f32> {
815
-
816
- // vars
817
- ${shaderData.vars}
818
-
819
- // flow
820
- ${shaderData.flow}
821
-
822
- }
823
- `;
824
-
825
- }
826
-
827
- _getWGSLComputeCode( shaderData, workgroupSize ) {
828
-
829
- return `${ this.getSignature() }
830
- // system
831
- var<private> instanceIndex : u32;
832
-
833
- // uniforms
834
- ${shaderData.uniforms}
835
-
836
- // codes
837
- ${shaderData.codes}
838
-
839
- @compute @workgroup_size( ${workgroupSize} )
840
- fn main( ${shaderData.attributes} ) {
841
-
842
- // system
843
- instanceIndex = id.x;
844
-
845
- // vars
846
- ${shaderData.vars}
847
-
848
- // flow
849
- ${shaderData.flow}
850
-
851
- }
852
- `;
853
-
854
- }
855
-
856
- _getWGSLStruct( name, vars ) {
857
-
858
- return `
859
- struct ${name} {
860
- ${vars}
861
- };`;
862
-
863
- }
864
-
865
- _getWGSLStructBinding( name, vars, access, binding = 0, group = 0 ) {
866
-
867
- const structName = name + 'Struct';
868
- const structSnippet = this._getWGSLStruct( structName, vars );
869
-
870
- return `${structSnippet}
871
- @binding( ${binding} ) @group( ${group} )
872
- var<${access}> ${name} : ${structName};`;
873
-
874
- }
875
-
876
- }
877
-
878
- export default WGSLNodeBuilder;
1
+ import { NoColorSpace, FloatType } from 'three';
2
+
3
+ import NodeUniformsGroup from '../../common/nodes/NodeUniformsGroup.js';
4
+
5
+ import NodeSampler from '../../common/nodes/NodeSampler.js';
6
+ import { NodeSampledTexture, NodeSampledCubeTexture } from '../../common/nodes/NodeSampledTexture.js';
7
+
8
+ import UniformBuffer from '../../common/UniformBuffer.js';
9
+ import StorageBuffer from '../../common/StorageBuffer.js';
10
+ import { getVectorLength, getStrideLength } from '../../common/BufferUtils.js';
11
+
12
+ import { NodeBuilder, CodeNode } from '../../../nodes/Nodes.js';
13
+
14
+ import { getFormat } from '../utils/WebGPUTextureUtils.js';
15
+
16
+ import WGSLNodeParser from './WGSLNodeParser.js';
17
+
18
+ // GPUShaderStage is not defined in browsers not supporting WebGPU
19
+ const GPUShaderStage = self.GPUShaderStage;
20
+
21
+ const gpuShaderStageLib = {
22
+ 'vertex': GPUShaderStage ? GPUShaderStage.VERTEX : 1,
23
+ 'fragment': GPUShaderStage ? GPUShaderStage.FRAGMENT : 2,
24
+ 'compute': GPUShaderStage ? GPUShaderStage.COMPUTE : 4
25
+ };
26
+
27
+ const supports = {
28
+ instance: true,
29
+ storageBuffer: true
30
+ };
31
+
32
+ const wgslFnOpLib = {
33
+ '^^': 'threejs_xor'
34
+ };
35
+
36
+ const wgslTypeLib = {
37
+ float: 'f32',
38
+ int: 'i32',
39
+ uint: 'u32',
40
+ bool: 'bool',
41
+ color: 'vec3<f32>',
42
+
43
+ vec2: 'vec2<f32>',
44
+ ivec2: 'vec2<i32>',
45
+ uvec2: 'vec2<u32>',
46
+ bvec2: 'vec2<bool>',
47
+
48
+ vec3: 'vec3<f32>',
49
+ ivec3: 'vec3<i32>',
50
+ uvec3: 'vec3<u32>',
51
+ bvec3: 'vec3<bool>',
52
+
53
+ vec4: 'vec4<f32>',
54
+ ivec4: 'vec4<i32>',
55
+ uvec4: 'vec4<u32>',
56
+ bvec4: 'vec4<bool>',
57
+
58
+ mat3: 'mat3x3<f32>',
59
+ imat3: 'mat3x3<i32>',
60
+ umat3: 'mat3x3<u32>',
61
+ bmat3: 'mat3x3<bool>',
62
+
63
+ mat4: 'mat4x4<f32>',
64
+ imat4: 'mat4x4<i32>',
65
+ umat4: 'mat4x4<u32>',
66
+ bmat4: 'mat4x4<bool>'
67
+ };
68
+
69
+ const wgslMethods = {
70
+ dFdx: 'dpdx',
71
+ dFdy: '- dpdy',
72
+ mod_float: 'threejs_mod_float',
73
+ mod_vec2: 'threejs_mod_vec2',
74
+ mod_vec3: 'threejs_mod_vec3',
75
+ mod_vec4: 'threejs_mod_vec4',
76
+ lessThanEqual: 'threejs_lessThanEqual',
77
+ greaterThan: 'threejs_greaterThan',
78
+ inversesqrt: 'inverseSqrt',
79
+ bitcast: 'bitcast<f32>'
80
+ };
81
+
82
+ const wgslPolyfill = {
83
+ threejs_xor: new CodeNode( `
84
+ fn threejs_xor( a : bool, b : bool ) -> bool {
85
+
86
+ return ( a || b ) && !( a && b );
87
+
88
+ }
89
+ ` ),
90
+ lessThanEqual: new CodeNode( `
91
+ fn threejs_lessThanEqual( a : vec3<f32>, b : vec3<f32> ) -> vec3<bool> {
92
+
93
+ return vec3<bool>( a.x <= b.x, a.y <= b.y, a.z <= b.z );
94
+
95
+ }
96
+ ` ),
97
+ greaterThan: new CodeNode( `
98
+ fn threejs_greaterThan( a : vec3<f32>, b : vec3<f32> ) -> vec3<bool> {
99
+
100
+ return vec3<bool>( a.x > b.x, a.y > b.y, a.z > b.z );
101
+
102
+ }
103
+ ` ),
104
+ mod_float: new CodeNode( 'fn threejs_mod_float( x : f32, y : f32 ) -> f32 { return x - y * floor( x / y ); }' ),
105
+ mod_vec2: new CodeNode( 'fn threejs_mod_vec2( x : vec2f, y : vec2f ) -> vec2f { return x - y * floor( x / y ); }' ),
106
+ mod_vec3: new CodeNode( 'fn threejs_mod_vec3( x : vec3f, y : vec3f ) -> vec3f { return x - y * floor( x / y ); }' ),
107
+ mod_vec4: new CodeNode( 'fn threejs_mod_vec4( x : vec4f, y : vec4f ) -> vec4f { return x - y * floor( x / y ); }' ),
108
+ repeatWrapping: new CodeNode( `
109
+ fn threejs_repeatWrapping( uv : vec2<f32>, dimension : vec2<u32> ) -> vec2<u32> {
110
+
111
+ let uvScaled = vec2<u32>( uv * vec2<f32>( dimension ) );
112
+
113
+ return ( ( uvScaled % dimension ) + dimension ) % dimension;
114
+
115
+ }
116
+ ` )
117
+ };
118
+
119
+ class WGSLNodeBuilder extends NodeBuilder {
120
+
121
+ constructor( object, renderer, scene = null ) {
122
+
123
+ super( object, renderer, new WGSLNodeParser(), scene );
124
+
125
+ this.uniformGroups = {};
126
+
127
+ this.builtins = {};
128
+
129
+ }
130
+
131
+ needsColorSpaceToLinear( texture ) {
132
+
133
+ return texture.isVideoTexture === true && texture.colorSpace !== NoColorSpace;
134
+
135
+ }
136
+
137
+ _generateTextureSample( texture, textureProperty, uvSnippet, depthSnippet, shaderStage = this.shaderStage ) {
138
+
139
+ if ( shaderStage === 'fragment' ) {
140
+
141
+ if ( depthSnippet ) {
142
+
143
+ return `textureSample( ${ textureProperty }, ${ textureProperty }_sampler, ${ uvSnippet }, ${ depthSnippet } )`;
144
+
145
+ } else {
146
+
147
+ return `textureSample( ${ textureProperty }, ${ textureProperty }_sampler, ${ uvSnippet } )`;
148
+
149
+ }
150
+
151
+ } else {
152
+
153
+ return this.generateTextureLod( texture, textureProperty, uvSnippet );
154
+
155
+ }
156
+
157
+ }
158
+
159
+ _generateVideoSample( textureProperty, uvSnippet, shaderStage = this.shaderStage ) {
160
+
161
+ if ( shaderStage === 'fragment' ) {
162
+
163
+ return `textureSampleBaseClampToEdge( ${ textureProperty }, ${ textureProperty }_sampler, vec2<f32>( ${ uvSnippet }.x, 1.0 - ${ uvSnippet }.y ) )`;
164
+
165
+ } else {
166
+
167
+ console.error( `WebGPURenderer: THREE.VideoTexture does not support ${ shaderStage } shader.` );
168
+
169
+ }
170
+
171
+ }
172
+
173
+ _generateTextureSampleLevel( texture, textureProperty, uvSnippet, levelSnippet, depthSnippet, shaderStage = this.shaderStage ) {
174
+
175
+ if ( shaderStage === 'fragment' && this.isUnfilterable( texture ) === false ) {
176
+
177
+ return `textureSampleLevel( ${ textureProperty }, ${ textureProperty }_sampler, ${ uvSnippet }, ${ levelSnippet } )`;
178
+
179
+ } else {
180
+
181
+ return this.generateTextureLod( texture, textureProperty, uvSnippet, levelSnippet );
182
+
183
+ }
184
+
185
+ }
186
+
187
+ generateTextureLod( texture, textureProperty, uvSnippet, levelSnippet = '0' ) {
188
+
189
+ this._include( 'repeatWrapping' );
190
+
191
+ const dimension = `textureDimensions( ${ textureProperty }, 0 )`;
192
+
193
+ return `textureLoad( ${ textureProperty }, threejs_repeatWrapping( ${ uvSnippet }, ${ dimension } ), i32( ${ levelSnippet } ) )`;
194
+
195
+ }
196
+
197
+ generateTextureLoad( texture, textureProperty, uvIndexSnippet, depthSnippet, levelSnippet = '0u' ) {
198
+
199
+ if ( depthSnippet ) {
200
+
201
+ return `textureLoad( ${ textureProperty }, ${ uvIndexSnippet }, ${ depthSnippet }, ${ levelSnippet } )`;
202
+
203
+ } else {
204
+
205
+ return `textureLoad( ${ textureProperty }, ${ uvIndexSnippet }, ${ levelSnippet } )`;
206
+
207
+ }
208
+
209
+ }
210
+
211
+ generateTextureStore( texture, textureProperty, uvIndexSnippet, valueSnippet ) {
212
+
213
+ return `textureStore( ${ textureProperty }, ${ uvIndexSnippet }, ${ valueSnippet } )`;
214
+
215
+ }
216
+
217
+ isUnfilterable( texture ) {
218
+
219
+ return texture.isDataTexture === true && texture.type === FloatType;
220
+
221
+ }
222
+
223
+ generateTexture( texture, textureProperty, uvSnippet, depthSnippet, shaderStage = this.shaderStage ) {
224
+
225
+ let snippet = null;
226
+
227
+ if ( texture.isVideoTexture === true ) {
228
+
229
+ snippet = this._generateVideoSample( textureProperty, uvSnippet, shaderStage );
230
+
231
+ } else if ( this.isUnfilterable( texture ) ) {
232
+
233
+ snippet = this.generateTextureLod( texture, textureProperty, uvSnippet, '0', depthSnippet, shaderStage );
234
+
235
+ } else {
236
+
237
+ snippet = this._generateTextureSample( texture, textureProperty, uvSnippet, depthSnippet, shaderStage );
238
+
239
+ }
240
+
241
+ return snippet;
242
+
243
+ }
244
+
245
+ generateTextureCompare( texture, textureProperty, uvSnippet, compareSnippet, depthSnippet, shaderStage = this.shaderStage ) {
246
+
247
+ if ( shaderStage === 'fragment' ) {
248
+
249
+ return `textureSampleCompare( ${ textureProperty }, ${ textureProperty }_sampler, ${ uvSnippet }, ${ compareSnippet } )`;
250
+
251
+ } else {
252
+
253
+ console.error( `WebGPURenderer: THREE.DepthTexture.compareFunction() does not support ${ shaderStage } shader.` );
254
+
255
+ }
256
+
257
+ }
258
+
259
+ generateTextureLevel( texture, textureProperty, uvSnippet, levelSnippet, depthSnippet, shaderStage = this.shaderStage ) {
260
+
261
+ let snippet = null;
262
+
263
+ if ( texture.isVideoTexture === true ) {
264
+
265
+ snippet = this._generateVideoSample( textureProperty, uvSnippet, shaderStage );
266
+
267
+ } else {
268
+
269
+ snippet = this._generateTextureSampleLevel( texture, textureProperty, uvSnippet, levelSnippet, depthSnippet, shaderStage );
270
+
271
+ }
272
+
273
+ return snippet;
274
+
275
+ }
276
+
277
+ getPropertyName( node, shaderStage = this.shaderStage ) {
278
+
279
+ if ( node.isNodeVarying === true && node.needsInterpolation === true ) {
280
+
281
+ if ( shaderStage === 'vertex' ) {
282
+
283
+ return `varyings.${ node.name }`;
284
+
285
+ }
286
+
287
+ } else if ( node.isNodeUniform === true ) {
288
+
289
+ const name = node.name;
290
+ const type = node.type;
291
+
292
+ if ( type === 'texture' || type === 'cubeTexture' || type === 'storageTexture' ) {
293
+
294
+ return name;
295
+
296
+ } else if ( type === 'buffer' || type === 'storageBuffer' ) {
297
+
298
+ return `NodeBuffer_${ node.id }.${name}`;
299
+
300
+ } else {
301
+
302
+ return node.groupNode.name + '.' + name;
303
+
304
+ }
305
+
306
+ }
307
+
308
+ return super.getPropertyName( node );
309
+
310
+ }
311
+
312
+ _getUniformGroupCount( shaderStage ) {
313
+
314
+ return Object.keys( this.uniforms[ shaderStage ] ).length;
315
+
316
+ }
317
+
318
+ getFunctionOperator( op ) {
319
+
320
+ const fnOp = wgslFnOpLib[ op ];
321
+
322
+ if ( fnOp !== undefined ) {
323
+
324
+ this._include( fnOp );
325
+
326
+ return fnOp;
327
+
328
+ }
329
+
330
+ return null;
331
+
332
+ }
333
+
334
+ getUniformFromNode( node, type, shaderStage, name = null ) {
335
+
336
+ const uniformNode = super.getUniformFromNode( node, type, shaderStage, name );
337
+ const nodeData = this.getDataFromNode( node, shaderStage, this.globalCache );
338
+
339
+ if ( nodeData.uniformGPU === undefined ) {
340
+
341
+ let uniformGPU;
342
+
343
+ const bindings = this.bindings[ shaderStage ];
344
+
345
+ if ( type === 'texture' || type === 'cubeTexture' || type === 'storageTexture' ) {
346
+
347
+ let texture = null;
348
+
349
+ if ( type === 'texture' || type === 'storageTexture' ) {
350
+
351
+ texture = new NodeSampledTexture( uniformNode.name, uniformNode.node );
352
+
353
+ } else if ( type === 'cubeTexture' ) {
354
+
355
+ texture = new NodeSampledCubeTexture( uniformNode.name, uniformNode.node );
356
+
357
+ }
358
+
359
+ texture.store = node.isStoreTextureNode === true;
360
+ texture.setVisibility( gpuShaderStageLib[ shaderStage ] );
361
+
362
+ if ( shaderStage === 'fragment' && this.isUnfilterable( node.value ) === false && texture.store === false ) {
363
+
364
+ const sampler = new NodeSampler( `${uniformNode.name}_sampler`, uniformNode.node );
365
+ sampler.setVisibility( gpuShaderStageLib[ shaderStage ] );
366
+
367
+ bindings.push( sampler, texture );
368
+
369
+ uniformGPU = [ sampler, texture ];
370
+
371
+ } else {
372
+
373
+ bindings.push( texture );
374
+
375
+ uniformGPU = [ texture ];
376
+
377
+ }
378
+
379
+ } else if ( type === 'buffer' || type === 'storageBuffer' ) {
380
+
381
+ const bufferClass = type === 'storageBuffer' ? StorageBuffer : UniformBuffer;
382
+ const buffer = new bufferClass( 'NodeBuffer_' + node.id, node.value );
383
+ buffer.setVisibility( gpuShaderStageLib[ shaderStage ] );
384
+
385
+ bindings.push( buffer );
386
+
387
+ uniformGPU = buffer;
388
+
389
+ } else {
390
+
391
+ const group = node.groupNode;
392
+ const groupName = group.name;
393
+
394
+ const uniformsStage = this.uniformGroups[ shaderStage ] || ( this.uniformGroups[ shaderStage ] = {} );
395
+
396
+ let uniformsGroup = uniformsStage[ groupName ];
397
+
398
+ if ( uniformsGroup === undefined ) {
399
+
400
+ uniformsGroup = new NodeUniformsGroup( groupName, group );
401
+ uniformsGroup.setVisibility( gpuShaderStageLib[ shaderStage ] );
402
+
403
+ uniformsStage[ groupName ] = uniformsGroup;
404
+
405
+ bindings.push( uniformsGroup );
406
+
407
+ }
408
+
409
+ if ( node.isArrayUniformNode === true ) {
410
+
411
+ uniformGPU = [];
412
+
413
+ for ( const uniformNode of node.nodes ) {
414
+
415
+ const uniformNodeGPU = this.getNodeUniform( uniformNode, type );
416
+
417
+ // fit bounds to buffer
418
+ uniformNodeGPU.boundary = getVectorLength( uniformNodeGPU.itemSize );
419
+ uniformNodeGPU.itemSize = getStrideLength( uniformNodeGPU.itemSize );
420
+
421
+ uniformsGroup.addUniform( uniformNodeGPU );
422
+
423
+ uniformGPU.push( uniformNodeGPU );
424
+
425
+ }
426
+
427
+ } else {
428
+
429
+ uniformGPU = this.getNodeUniform( uniformNode, type );
430
+
431
+ uniformsGroup.addUniform( uniformGPU );
432
+
433
+ }
434
+
435
+ }
436
+
437
+ nodeData.uniformGPU = uniformGPU;
438
+
439
+ if ( shaderStage === 'vertex' ) {
440
+
441
+ this.bindingsOffset[ 'fragment' ] = bindings.length;
442
+
443
+ }
444
+
445
+ }
446
+
447
+ return uniformNode;
448
+
449
+ }
450
+
451
+ isReference( type ) {
452
+
453
+ return super.isReference( type ) || type === 'texture_2d' || type === 'texture_cube' || type === 'texture_depth_2d' || type === 'texture_storage_2d';
454
+
455
+ }
456
+
457
+ getBuiltin( name, property, type, shaderStage = this.shaderStage ) {
458
+
459
+ const map = this.builtins[ shaderStage ] || ( this.builtins[ shaderStage ] = new Map() );
460
+
461
+ if ( map.has( name ) === false ) {
462
+
463
+ map.set( name, {
464
+ name,
465
+ property,
466
+ type
467
+ } );
468
+
469
+ }
470
+
471
+ return property;
472
+
473
+ }
474
+
475
+ getVertexIndex() {
476
+
477
+ if ( this.shaderStage === 'vertex' ) {
478
+
479
+ return this.getBuiltin( 'vertex_index', 'vertexIndex', 'u32', 'attribute' );
480
+
481
+ }
482
+
483
+ return 'vertexIndex';
484
+
485
+ }
486
+
487
+ buildFunctionCode( shaderNode ) {
488
+
489
+ const layout = shaderNode.layout;
490
+ const flowData = this.flowShaderNode( shaderNode );
491
+
492
+ const parameters = [];
493
+
494
+ for ( const input of layout.inputs ) {
495
+
496
+ parameters.push( input.name + ' : ' + this.getType( input.type ) );
497
+
498
+ }
499
+
500
+ //
501
+
502
+ const code = `fn ${ layout.name }( ${ parameters.join( ', ' ) } ) -> ${ this.getType( layout.type ) } {
503
+ ${ flowData.vars }
504
+ ${ flowData.code }
505
+ return ${ flowData.result };
506
+
507
+ }`;
508
+
509
+ //
510
+
511
+ return code;
512
+
513
+ }
514
+
515
+ getInstanceIndex() {
516
+
517
+ if ( this.shaderStage === 'vertex' ) {
518
+
519
+ return this.getBuiltin( 'instance_index', 'instanceIndex', 'u32', 'attribute' );
520
+
521
+ }
522
+
523
+ return 'instanceIndex';
524
+
525
+ }
526
+
527
+ getFrontFacing() {
528
+
529
+ return this.getBuiltin( 'front_facing', 'isFront', 'bool' );
530
+
531
+ }
532
+
533
+ getFragCoord() {
534
+
535
+ return this.getBuiltin( 'position', 'fragCoord', 'vec4<f32>' ) + '.xy';
536
+
537
+ }
538
+
539
+ getFragDepth() {
540
+
541
+ return 'output.' + this.getBuiltin( 'frag_depth', 'depth', 'f32', 'output' );
542
+
543
+ }
544
+
545
+ isFlipY() {
546
+
547
+ return false;
548
+
549
+ }
550
+
551
+ getBuiltins( shaderStage ) {
552
+
553
+ const snippets = [];
554
+ const builtins = this.builtins[ shaderStage ];
555
+
556
+ if ( builtins !== undefined ) {
557
+
558
+ for ( const { name, property, type } of builtins.values() ) {
559
+
560
+ snippets.push( `@builtin( ${name} ) ${property} : ${type}` );
561
+
562
+ }
563
+
564
+ }
565
+
566
+ return snippets.join( ',\n\t' );
567
+
568
+ }
569
+
570
+ getAttributes( shaderStage ) {
571
+
572
+ const snippets = [];
573
+
574
+ if ( shaderStage === 'compute' ) {
575
+
576
+ this.getBuiltin( 'global_invocation_id', 'id', 'vec3<u32>', 'attribute' );
577
+
578
+ }
579
+
580
+ if ( shaderStage === 'vertex' || shaderStage === 'compute' ) {
581
+
582
+ const builtins = this.getBuiltins( 'attribute' );
583
+
584
+ if ( builtins ) snippets.push( builtins );
585
+
586
+ const attributes = this.getAttributesArray();
587
+
588
+ for ( let index = 0, length = attributes.length; index < length; index ++ ) {
589
+
590
+ const attribute = attributes[ index ];
591
+ const name = attribute.name;
592
+ const type = this.getType( attribute.type );
593
+
594
+ snippets.push( `@location( ${index} ) ${ name } : ${ type }` );
595
+
596
+ }
597
+
598
+ }
599
+
600
+ return snippets.join( ',\n\t' );
601
+
602
+ }
603
+
604
+ getStructMembers( struct ) {
605
+
606
+ const snippets = [];
607
+ const members = struct.getMemberTypes();
608
+
609
+ for ( let i = 0; i < members.length; i ++ ) {
610
+
611
+ const member = members[ i ];
612
+ snippets.push( `\t@location( ${i} ) m${i} : ${ member }<f32>` );
613
+
614
+ }
615
+
616
+ return snippets.join( ',\n' );
617
+
618
+ }
619
+
620
+ getStructs( shaderStage ) {
621
+
622
+ const snippets = [];
623
+ const structs = this.structs[ shaderStage ];
624
+
625
+ for ( let index = 0, length = structs.length; index < length; index ++ ) {
626
+
627
+ const struct = structs[ index ];
628
+ const name = struct.name;
629
+
630
+ let snippet = `\struct ${ name } {\n`;
631
+ snippet += this.getStructMembers( struct );
632
+ snippet += '\n}';
633
+
634
+ snippets.push( snippet );
635
+
636
+ }
637
+
638
+ return snippets.join( '\n\n' );
639
+
640
+ }
641
+
642
+ getVar( type, name ) {
643
+
644
+ return `var ${ name } : ${ this.getType( type ) }`;
645
+
646
+ }
647
+
648
+ getVars( shaderStage ) {
649
+
650
+ const snippets = [];
651
+ const vars = this.vars[ shaderStage ];
652
+
653
+ if ( vars !== undefined ) {
654
+
655
+ for ( const variable of vars ) {
656
+
657
+ snippets.push( `\t${ this.getVar( variable.type, variable.name ) };` );
658
+
659
+ }
660
+
661
+ }
662
+
663
+ return `\n${ snippets.join( '\n' ) }\n`;
664
+
665
+ }
666
+
667
+ getVaryings( shaderStage ) {
668
+
669
+ const snippets = [];
670
+
671
+ if ( shaderStage === 'vertex' ) {
672
+
673
+ this.getBuiltin( 'position', 'Vertex', 'vec4<f32>', 'vertex' );
674
+
675
+ }
676
+
677
+ if ( shaderStage === 'vertex' || shaderStage === 'fragment' ) {
678
+
679
+ const varyings = this.varyings;
680
+ const vars = this.vars[ shaderStage ];
681
+
682
+ for ( let index = 0; index < varyings.length; index ++ ) {
683
+
684
+ const varying = varyings[ index ];
685
+
686
+ if ( varying.needsInterpolation ) {
687
+
688
+ let attributesSnippet = `@location( ${index} )`;
689
+
690
+ if ( /^(int|uint|ivec|uvec)/.test( varying.type ) ) {
691
+
692
+ attributesSnippet += ' @interpolate( flat )';
693
+
694
+
695
+ }
696
+
697
+ snippets.push( `${ attributesSnippet } ${ varying.name } : ${ this.getType( varying.type ) }` );
698
+
699
+ } else if ( shaderStage === 'vertex' && vars.includes( varying ) === false ) {
700
+
701
+ vars.push( varying );
702
+
703
+ }
704
+
705
+ }
706
+
707
+ }
708
+
709
+ const builtins = this.getBuiltins( shaderStage );
710
+
711
+ if ( builtins ) snippets.push( builtins );
712
+
713
+ const code = snippets.join( ',\n\t' );
714
+
715
+ return shaderStage === 'vertex' ? this._getWGSLStruct( 'VaryingsStruct', '\t' + code ) : code;
716
+
717
+ }
718
+
719
+ getUniforms( shaderStage ) {
720
+
721
+ const uniforms = this.uniforms[ shaderStage ];
722
+
723
+ const bindingSnippets = [];
724
+ const bufferSnippets = [];
725
+ const structSnippets = [];
726
+ const uniformGroups = {};
727
+
728
+ let index = this.bindingsOffset[ shaderStage ];
729
+
730
+ for ( const uniform of uniforms ) {
731
+
732
+ if ( uniform.type === 'texture' || uniform.type === 'cubeTexture' || uniform.type === 'storageTexture' ) {
733
+
734
+ const texture = uniform.node.value;
735
+
736
+ if ( shaderStage === 'fragment' && this.isUnfilterable( texture ) === false && uniform.node.isStoreTextureNode !== true ) {
737
+
738
+ if ( texture.isDepthTexture === true && texture.compareFunction !== null ) {
739
+
740
+ bindingSnippets.push( `@binding( ${index ++} ) @group( 0 ) var ${uniform.name}_sampler : sampler_comparison;` );
741
+
742
+ } else {
743
+
744
+ bindingSnippets.push( `@binding( ${index ++} ) @group( 0 ) var ${uniform.name}_sampler : sampler;` );
745
+
746
+ }
747
+
748
+ }
749
+
750
+ let textureType;
751
+
752
+ if ( texture.isCubeTexture === true ) {
753
+
754
+ textureType = 'texture_cube<f32>';
755
+
756
+ } else if ( texture.isDataArrayTexture === true ) {
757
+
758
+ textureType = 'texture_2d_array<f32>';
759
+
760
+ } else if ( texture.isDepthTexture === true ) {
761
+
762
+ textureType = 'texture_depth_2d';
763
+
764
+ } else if ( texture.isVideoTexture === true ) {
765
+
766
+ textureType = 'texture_external';
767
+
768
+ } else if ( uniform.node.isStoreTextureNode === true ) {
769
+
770
+ const format = getFormat( texture );
771
+
772
+ textureType = 'texture_storage_2d<' + format + ', write>';
773
+
774
+ } else {
775
+
776
+ textureType = 'texture_2d<f32>';
777
+
778
+ }
779
+
780
+ bindingSnippets.push( `@binding( ${index ++} ) @group( 0 ) var ${uniform.name} : ${textureType};` );
781
+
782
+ } else if ( uniform.type === 'buffer' || uniform.type === 'storageBuffer' ) {
783
+
784
+ const bufferNode = uniform.node;
785
+ const bufferType = this.getType( bufferNode.bufferType );
786
+ const bufferCount = bufferNode.bufferCount;
787
+
788
+ const bufferCountSnippet = bufferCount > 0 ? ', ' + bufferCount : '';
789
+ const bufferSnippet = `\t${uniform.name} : array< ${bufferType}${bufferCountSnippet} >\n`;
790
+ const bufferAccessMode = bufferNode.isStorageBufferNode ? 'storage,read_write' : 'uniform';
791
+
792
+ bufferSnippets.push( this._getWGSLStructBinding( 'NodeBuffer_' + bufferNode.id, bufferSnippet, bufferAccessMode, index ++ ) );
793
+
794
+ } else {
795
+
796
+ const vectorType = this.getType( this.getVectorType( uniform.type ) );
797
+ const groupName = uniform.groupNode.name;
798
+
799
+ const group = uniformGroups[ groupName ] || ( uniformGroups[ groupName ] = {
800
+ index: index ++,
801
+ snippets: []
802
+ } );
803
+
804
+ if ( Array.isArray( uniform.value ) === true ) {
805
+
806
+ const length = uniform.value.length;
807
+
808
+ group.snippets.push( `uniform ${vectorType}[ ${length} ] ${uniform.name}` );
809
+
810
+ } else {
811
+
812
+ group.snippets.push( `\t${uniform.name} : ${ vectorType}` );
813
+
814
+ }
815
+
816
+ }
817
+
818
+ }
819
+
820
+ for ( const name in uniformGroups ) {
821
+
822
+ const group = uniformGroups[ name ];
823
+
824
+ structSnippets.push( this._getWGSLStructBinding( name, group.snippets.join( ',\n' ), 'uniform', group.index ) );
825
+
826
+ }
827
+
828
+ let code = bindingSnippets.join( '\n' );
829
+ code += bufferSnippets.join( '\n' );
830
+ code += structSnippets.join( '\n' );
831
+
832
+ return code;
833
+
834
+ }
835
+
836
+ buildCode() {
837
+
838
+ const shadersData = this.material !== null ? { fragment: {}, vertex: {} } : { compute: {} };
839
+
840
+ for ( const shaderStage in shadersData ) {
841
+
842
+ const stageData = shadersData[ shaderStage ];
843
+ stageData.uniforms = this.getUniforms( shaderStage );
844
+ stageData.attributes = this.getAttributes( shaderStage );
845
+ stageData.varyings = this.getVaryings( shaderStage );
846
+ stageData.structs = this.getStructs( shaderStage );
847
+ stageData.vars = this.getVars( shaderStage );
848
+ stageData.codes = this.getCodes( shaderStage );
849
+
850
+ //
851
+
852
+ let flow = '// code\n\n';
853
+ flow += this.flowCode[ shaderStage ];
854
+
855
+ const flowNodes = this.flowNodes[ shaderStage ];
856
+ const mainNode = flowNodes[ flowNodes.length - 1 ];
857
+
858
+ const outputNode = mainNode.outputNode;
859
+ const isOutputStruct = ( outputNode !== undefined && outputNode.isOutputStructNode === true );
860
+
861
+ for ( const node of flowNodes ) {
862
+
863
+ const flowSlotData = this.getFlowData( node/*, shaderStage*/ );
864
+ const slotName = node.name;
865
+
866
+ if ( slotName ) {
867
+
868
+ if ( flow.length > 0 ) flow += '\n';
869
+
870
+ flow += `\t// flow -> ${ slotName }\n\t`;
871
+
872
+ }
873
+
874
+ flow += `${ flowSlotData.code }\n\t`;
875
+
876
+ if ( node === mainNode && shaderStage !== 'compute' ) {
877
+
878
+ flow += '// result\n\n\t';
879
+
880
+ if ( shaderStage === 'vertex' ) {
881
+
882
+ flow += `varyings.Vertex = ${ flowSlotData.result };`;
883
+
884
+ } else if ( shaderStage === 'fragment' ) {
885
+
886
+ if ( isOutputStruct ) {
887
+
888
+ stageData.returnType = outputNode.nodeType;
889
+
890
+ flow += `return ${ flowSlotData.result };`;
891
+
892
+ } else {
893
+
894
+ let structSnippet = '\t@location(0) color: vec4<f32>';
895
+
896
+ const builtins = this.getBuiltins( 'output' );
897
+
898
+ if ( builtins ) structSnippet += ',\n\t' + builtins;
899
+
900
+ stageData.returnType = 'OutputStruct';
901
+ stageData.structs += this._getWGSLStruct( 'OutputStruct', structSnippet );
902
+ stageData.structs += '\nvar<private> output : OutputStruct;\n\n';
903
+
904
+ flow += `output.color = ${ flowSlotData.result };\n\n\treturn output;`;
905
+
906
+ }
907
+
908
+ }
909
+
910
+ }
911
+
912
+ }
913
+
914
+ stageData.flow = flow;
915
+
916
+ }
917
+
918
+ if ( this.material !== null ) {
919
+
920
+ this.vertexShader = this._getWGSLVertexCode( shadersData.vertex );
921
+ this.fragmentShader = this._getWGSLFragmentCode( shadersData.fragment );
922
+
923
+ } else {
924
+
925
+ this.computeShader = this._getWGSLComputeCode( shadersData.compute, ( this.object.workgroupSize || [ 64 ] ).join( ', ' ) );
926
+
927
+ }
928
+
929
+ }
930
+
931
+ getMethod( method, output = null ) {
932
+
933
+ let wgslMethod;
934
+
935
+ if ( output !== null ) {
936
+
937
+ wgslMethod = this._getWGSLMethod( method + '_' + output );
938
+
939
+ }
940
+
941
+ if ( wgslMethod === undefined ) {
942
+
943
+ wgslMethod = this._getWGSLMethod( method );
944
+
945
+ }
946
+
947
+ return wgslMethod || method;
948
+
949
+ }
950
+
951
+ getType( type ) {
952
+
953
+ return wgslTypeLib[ type ] || type;
954
+
955
+ }
956
+
957
+ isAvailable( name ) {
958
+
959
+ return supports[ name ] === true;
960
+
961
+ }
962
+
963
+ _getWGSLMethod( method ) {
964
+
965
+ if ( wgslPolyfill[ method ] !== undefined ) {
966
+
967
+ this._include( method );
968
+
969
+ }
970
+
971
+ return wgslMethods[ method ];
972
+
973
+ }
974
+
975
+ _include( name ) {
976
+
977
+ const codeNode = wgslPolyfill[ name ];
978
+ codeNode.build( this );
979
+
980
+ if ( this.currentFunctionNode !== null ) {
981
+
982
+ this.currentFunctionNode.includes.push( codeNode );
983
+
984
+ }
985
+
986
+ return codeNode;
987
+
988
+ }
989
+
990
+ _getWGSLVertexCode( shaderData ) {
991
+
992
+ return `${ this.getSignature() }
993
+
994
+ // uniforms
995
+ ${shaderData.uniforms}
996
+
997
+ // varyings
998
+ ${shaderData.varyings}
999
+ var<private> varyings : VaryingsStruct;
1000
+
1001
+ // codes
1002
+ ${shaderData.codes}
1003
+
1004
+ @vertex
1005
+ fn main( ${shaderData.attributes} ) -> VaryingsStruct {
1006
+
1007
+ // vars
1008
+ ${shaderData.vars}
1009
+
1010
+ // flow
1011
+ ${shaderData.flow}
1012
+
1013
+ return varyings;
1014
+
1015
+ }
1016
+ `;
1017
+
1018
+ }
1019
+
1020
+ _getWGSLFragmentCode( shaderData ) {
1021
+
1022
+ return `${ this.getSignature() }
1023
+
1024
+ // uniforms
1025
+ ${shaderData.uniforms}
1026
+
1027
+ // structs
1028
+ ${shaderData.structs}
1029
+
1030
+ // codes
1031
+ ${shaderData.codes}
1032
+
1033
+ @fragment
1034
+ fn main( ${shaderData.varyings} ) -> ${shaderData.returnType} {
1035
+
1036
+ // vars
1037
+ ${shaderData.vars}
1038
+
1039
+ // flow
1040
+ ${shaderData.flow}
1041
+
1042
+ }
1043
+ `;
1044
+
1045
+ }
1046
+
1047
+ _getWGSLComputeCode( shaderData, workgroupSize ) {
1048
+
1049
+ return `${ this.getSignature() }
1050
+ // system
1051
+ var<private> instanceIndex : u32;
1052
+
1053
+ // uniforms
1054
+ ${shaderData.uniforms}
1055
+
1056
+ // codes
1057
+ ${shaderData.codes}
1058
+
1059
+ @compute @workgroup_size( ${workgroupSize} )
1060
+ fn main( ${shaderData.attributes} ) {
1061
+
1062
+ // system
1063
+ instanceIndex = id.x;
1064
+
1065
+ // vars
1066
+ ${shaderData.vars}
1067
+
1068
+ // flow
1069
+ ${shaderData.flow}
1070
+
1071
+ }
1072
+ `;
1073
+
1074
+ }
1075
+
1076
+ _getWGSLStruct( name, vars ) {
1077
+
1078
+ return `
1079
+ struct ${name} {
1080
+ ${vars}
1081
+ };`;
1082
+
1083
+ }
1084
+
1085
+ _getWGSLStructBinding( name, vars, access, binding = 0, group = 0 ) {
1086
+
1087
+ const structName = name + 'Struct';
1088
+ const structSnippet = this._getWGSLStruct( structName, vars );
1089
+
1090
+ return `${structSnippet}
1091
+ @binding( ${binding} ) @group( ${group} )
1092
+ var<${access}> ${name} : ${structName};`;
1093
+
1094
+ }
1095
+
1096
+ }
1097
+
1098
+ export default WGSLNodeBuilder;