super-three 0.181.0 → 0.184.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (539) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +3 -4
  3. package/build/three.cjs +13152 -11354
  4. package/build/three.core.js +12319 -11539
  5. package/build/three.core.min.js +2 -2
  6. package/build/three.module.js +1808 -781
  7. package/build/three.module.min.js +2 -2
  8. package/build/three.tsl.js +27 -13
  9. package/build/three.tsl.min.js +2 -2
  10. package/build/three.webgpu.js +10523 -6263
  11. package/build/three.webgpu.min.js +2 -2
  12. package/build/three.webgpu.nodes.js +10484 -6262
  13. package/build/three.webgpu.nodes.min.js +2 -2
  14. package/examples/jsm/Addons.js +11 -3
  15. package/examples/jsm/animation/CCDIKSolver.js +7 -3
  16. package/examples/jsm/controls/ArcballControls.js +7 -4
  17. package/examples/jsm/controls/DragControls.js +2 -2
  18. package/examples/jsm/controls/FirstPersonControls.js +58 -54
  19. package/examples/jsm/controls/FlyControls.js +4 -0
  20. package/examples/jsm/controls/MapControls.js +55 -1
  21. package/examples/jsm/controls/OrbitControls.js +111 -8
  22. package/examples/jsm/controls/TrackballControls.js +8 -8
  23. package/examples/jsm/controls/TransformControls.js +34 -2
  24. package/examples/jsm/csm/CSM.js +2 -1
  25. package/examples/jsm/csm/CSMShadowNode.js +6 -2
  26. package/examples/jsm/effects/AnaglyphEffect.js +102 -7
  27. package/examples/jsm/environments/ColorEnvironment.js +59 -0
  28. package/examples/jsm/environments/RoomEnvironment.js +3 -0
  29. package/examples/jsm/exporters/EXRExporter.js +1 -1
  30. package/examples/jsm/exporters/GLTFExporter.js +152 -9
  31. package/examples/jsm/exporters/USDZExporter.js +22 -3
  32. package/examples/jsm/geometries/DecalGeometry.js +1 -1
  33. package/examples/jsm/geometries/TextGeometry.js +18 -0
  34. package/examples/jsm/helpers/AnimationPathHelper.js +302 -0
  35. package/examples/jsm/helpers/LightProbeGridHelper.js +221 -0
  36. package/examples/jsm/helpers/LightProbeHelperGPU.js +1 -1
  37. package/examples/jsm/helpers/TextureHelperGPU.js +1 -1
  38. package/examples/jsm/helpers/ViewHelper.js +67 -8
  39. package/examples/jsm/inspector/Extension.js +13 -0
  40. package/examples/jsm/inspector/Inspector.js +203 -88
  41. package/examples/jsm/inspector/RendererInspector.js +14 -4
  42. package/examples/jsm/inspector/extensions/extensions.json +6 -0
  43. package/examples/jsm/inspector/extensions/tsl-graph/TSLGraphEditor.js +916 -0
  44. package/examples/jsm/inspector/extensions/tsl-graph/TSLGraphLoader.js +281 -0
  45. package/examples/jsm/inspector/tabs/Console.js +41 -7
  46. package/examples/jsm/inspector/tabs/Memory.js +128 -0
  47. package/examples/jsm/inspector/tabs/Parameters.js +51 -3
  48. package/examples/jsm/inspector/tabs/Performance.js +4 -4
  49. package/examples/jsm/inspector/tabs/Settings.js +264 -0
  50. package/examples/jsm/inspector/tabs/Timeline.js +1611 -0
  51. package/examples/jsm/inspector/tabs/Viewer.js +107 -5
  52. package/examples/jsm/inspector/ui/Graph.js +2 -2
  53. package/examples/jsm/inspector/ui/List.js +1 -1
  54. package/examples/jsm/inspector/ui/Profiler.js +1936 -34
  55. package/examples/jsm/inspector/ui/Style.js +1044 -31
  56. package/examples/jsm/inspector/ui/Tab.js +222 -3
  57. package/examples/jsm/inspector/ui/Values.js +55 -2
  58. package/examples/jsm/inspector/ui/utils.js +13 -0
  59. package/examples/jsm/interaction/InteractionManager.js +226 -0
  60. package/examples/jsm/libs/meshopt_decoder.module.js +9 -8
  61. package/examples/jsm/lighting/DynamicLighting.js +82 -0
  62. package/examples/jsm/lighting/LightProbeGrid.js +651 -0
  63. package/examples/jsm/lines/LineMaterial.js +7 -1
  64. package/examples/jsm/loaders/3DMLoader.js +5 -4
  65. package/examples/jsm/loaders/3MFLoader.js +2 -2
  66. package/examples/jsm/loaders/AMFLoader.js +2 -2
  67. package/examples/jsm/loaders/ColladaLoader.js +24 -4026
  68. package/examples/jsm/loaders/DRACOLoader.js +5 -5
  69. package/examples/jsm/loaders/EXRLoader.js +687 -48
  70. package/examples/jsm/loaders/FBXLoader.js +235 -37
  71. package/examples/jsm/loaders/GCodeLoader.js +34 -8
  72. package/examples/jsm/loaders/GLTFLoader.js +146 -178
  73. package/examples/jsm/loaders/HDRLoader.js +1 -2
  74. package/examples/jsm/loaders/KMZLoader.js +5 -5
  75. package/examples/jsm/loaders/KTX2Loader.js +27 -5
  76. package/examples/jsm/loaders/LDrawLoader.js +41 -50
  77. package/examples/jsm/loaders/LWOLoader.js +7 -39
  78. package/examples/jsm/loaders/NRRDLoader.js +2 -2
  79. package/examples/jsm/loaders/PCDLoader.js +4 -2
  80. package/examples/jsm/loaders/SVGLoader.js +2 -2
  81. package/examples/jsm/loaders/TDSLoader.js +0 -2
  82. package/examples/jsm/loaders/TGALoader.js +0 -2
  83. package/examples/jsm/loaders/USDLoader.js +100 -40
  84. package/examples/jsm/loaders/UltraHDRLoader.js +285 -160
  85. package/examples/jsm/loaders/VOXLoader.js +660 -117
  86. package/examples/jsm/loaders/VRMLLoader.js +79 -2
  87. package/examples/jsm/loaders/VTKLoader.js +42 -25
  88. package/examples/jsm/loaders/collada/ColladaComposer.js +3044 -0
  89. package/examples/jsm/loaders/collada/ColladaParser.js +1977 -0
  90. package/examples/jsm/loaders/usd/USDAParser.js +450 -363
  91. package/examples/jsm/loaders/usd/USDCParser.js +1867 -6
  92. package/examples/jsm/loaders/usd/USDComposer.js +4594 -0
  93. package/examples/jsm/materials/LDrawConditionalLineNodeMaterial.js +2 -2
  94. package/examples/jsm/materials/WoodNodeMaterial.js +11 -11
  95. package/examples/jsm/math/Octree.js +131 -1
  96. package/examples/jsm/misc/GPUComputationRenderer.js +2 -0
  97. package/examples/jsm/misc/RollerCoaster.js +42 -4
  98. package/examples/jsm/misc/Volume.js +0 -1
  99. package/examples/jsm/misc/VolumeSlice.js +0 -1
  100. package/examples/jsm/modifiers/TessellateModifier.js +1 -1
  101. package/examples/jsm/objects/LensflareMesh.js +1 -1
  102. package/examples/jsm/objects/Reflector.js +73 -25
  103. package/examples/jsm/objects/Sky.js +90 -6
  104. package/examples/jsm/objects/SkyMesh.js +150 -16
  105. package/examples/jsm/objects/Water.js +4 -3
  106. package/examples/jsm/objects/Water2.js +5 -3
  107. package/examples/jsm/objects/WaterMesh.js +5 -7
  108. package/examples/jsm/physics/AmmoPhysics.js +12 -7
  109. package/examples/jsm/physics/JoltPhysics.js +10 -6
  110. package/examples/jsm/physics/RapierPhysics.js +9 -5
  111. package/examples/jsm/postprocessing/EffectComposer.js +7 -5
  112. package/examples/jsm/postprocessing/OutputPass.js +9 -0
  113. package/examples/jsm/postprocessing/RenderPass.js +10 -0
  114. package/examples/jsm/postprocessing/RenderTransitionPass.js +1 -1
  115. package/examples/jsm/postprocessing/UnrealBloomPass.js +48 -18
  116. package/examples/jsm/renderers/CSS3DRenderer.js +1 -1
  117. package/examples/jsm/renderers/Projector.js +246 -28
  118. package/examples/jsm/renderers/SVGRenderer.js +174 -60
  119. package/examples/jsm/shaders/GTAOShader.js +19 -6
  120. package/examples/jsm/shaders/HalftoneShader.js +12 -1
  121. package/examples/jsm/shaders/PoissonDenoiseShader.js +6 -2
  122. package/examples/jsm/shaders/SAOShader.js +17 -4
  123. package/examples/jsm/shaders/SSAOShader.js +11 -1
  124. package/examples/jsm/shaders/SSRShader.js +6 -5
  125. package/examples/jsm/shaders/UnpackDepthRGBAShader.js +2 -4
  126. package/examples/jsm/shaders/VignetteShader.js +1 -1
  127. package/examples/jsm/transpiler/AST.js +44 -0
  128. package/examples/jsm/transpiler/GLSLDecoder.js +63 -6
  129. package/examples/jsm/transpiler/ShaderToyDecoder.js +2 -0
  130. package/examples/jsm/transpiler/TSLEncoder.js +46 -3
  131. package/examples/jsm/transpiler/TranspilerUtils.js +3 -3
  132. package/examples/jsm/transpiler/WGSLEncoder.js +27 -0
  133. package/examples/jsm/tsl/WebGLNodesHandler.js +605 -0
  134. package/examples/jsm/tsl/display/AfterImageNode.js +11 -1
  135. package/examples/jsm/tsl/display/AnaglyphPassNode.js +458 -16
  136. package/examples/jsm/tsl/display/AnamorphicNode.js +12 -1
  137. package/examples/jsm/tsl/display/BilateralBlurNode.js +374 -0
  138. package/examples/jsm/tsl/display/BloomNode.js +16 -6
  139. package/examples/jsm/tsl/display/CRT.js +150 -0
  140. package/examples/jsm/tsl/display/ChromaticAberrationNode.js +3 -36
  141. package/examples/jsm/tsl/display/DenoiseNode.js +1 -1
  142. package/examples/jsm/tsl/display/DepthOfFieldNode.js +1 -1
  143. package/examples/jsm/tsl/display/DotScreenNode.js +1 -1
  144. package/examples/jsm/tsl/display/FSR1Node.js +477 -0
  145. package/examples/jsm/tsl/display/FXAANode.js +2 -2
  146. package/examples/jsm/tsl/display/GTAONode.js +6 -4
  147. package/examples/jsm/tsl/display/GaussianBlurNode.js +21 -2
  148. package/examples/jsm/tsl/display/GodraysNode.js +615 -0
  149. package/examples/jsm/tsl/display/LensflareNode.js +1 -1
  150. package/examples/jsm/tsl/display/Lut3DNode.js +1 -1
  151. package/examples/jsm/tsl/display/OutlineNode.js +69 -19
  152. package/examples/jsm/tsl/display/ParallaxBarrierPassNode.js +2 -2
  153. package/examples/jsm/tsl/display/PixelationPassNode.js +7 -6
  154. package/examples/jsm/tsl/display/RGBShiftNode.js +2 -2
  155. package/examples/jsm/tsl/display/RetroPassNode.js +263 -0
  156. package/examples/jsm/tsl/display/SMAANode.js +2 -2
  157. package/examples/jsm/tsl/display/SSAAPassNode.js +2 -2
  158. package/examples/jsm/tsl/display/SSGINode.js +8 -24
  159. package/examples/jsm/tsl/display/SSRNode.js +8 -8
  160. package/examples/jsm/tsl/display/SSSNode.js +6 -4
  161. package/examples/jsm/tsl/display/Shape.js +29 -0
  162. package/examples/jsm/tsl/display/SharpenNode.js +283 -0
  163. package/examples/jsm/tsl/display/SobelOperatorNode.js +2 -2
  164. package/examples/jsm/tsl/display/StereoCompositePassNode.js +8 -1
  165. package/examples/jsm/tsl/display/StereoPassNode.js +1 -2
  166. package/examples/jsm/tsl/display/TAAUNode.js +835 -0
  167. package/examples/jsm/tsl/display/TRAANode.js +315 -126
  168. package/examples/jsm/tsl/display/TransitionNode.js +1 -1
  169. package/examples/jsm/tsl/display/depthAwareBlend.js +80 -0
  170. package/examples/jsm/tsl/display/radialBlur.js +68 -0
  171. package/examples/jsm/tsl/lighting/DynamicLightsNode.js +300 -0
  172. package/examples/jsm/tsl/lighting/data/AmbientLightDataNode.js +61 -0
  173. package/examples/jsm/tsl/lighting/data/DirectionalLightDataNode.js +111 -0
  174. package/examples/jsm/tsl/lighting/data/HemisphereLightDataNode.js +99 -0
  175. package/examples/jsm/tsl/lighting/data/PointLightDataNode.js +134 -0
  176. package/examples/jsm/tsl/lighting/data/SpotLightDataNode.js +161 -0
  177. package/examples/jsm/tsl/math/Bayer.js +53 -3
  178. package/examples/jsm/utils/BufferGeometryUtils.js +2 -3
  179. package/examples/jsm/utils/ColorUtils.js +76 -0
  180. package/examples/jsm/utils/LDrawUtils.js +1 -1
  181. package/examples/jsm/utils/ShadowMapViewer.js +24 -10
  182. package/examples/jsm/utils/ShadowMapViewerGPU.js +1 -1
  183. package/examples/jsm/utils/SkeletonUtils.js +14 -8
  184. package/examples/jsm/utils/WebGPUTextureUtils.js +1 -1
  185. package/examples/jsm/webxr/XRHandMeshModel.js +36 -10
  186. package/examples/jsm/webxr/XRHandModelFactory.js +2 -1
  187. package/package.json +24 -30
  188. package/src/Three.Core.js +3 -1
  189. package/src/Three.TSL.js +25 -11
  190. package/src/Three.WebGPU.Nodes.js +5 -0
  191. package/src/Three.WebGPU.js +9 -0
  192. package/src/Three.js +1 -0
  193. package/src/animation/AnimationAction.js +12 -2
  194. package/src/animation/AnimationClip.js +1 -1
  195. package/src/animation/AnimationMixer.js +6 -0
  196. package/src/animation/AnimationUtils.js +1 -12
  197. package/src/animation/KeyframeTrack.js +47 -8
  198. package/src/animation/PropertyMixer.js +4 -4
  199. package/src/animation/tracks/BooleanKeyframeTrack.js +1 -1
  200. package/src/animation/tracks/ColorKeyframeTrack.js +1 -1
  201. package/src/animation/tracks/NumberKeyframeTrack.js +1 -1
  202. package/src/animation/tracks/QuaternionKeyframeTrack.js +1 -1
  203. package/src/animation/tracks/StringKeyframeTrack.js +1 -1
  204. package/src/animation/tracks/VectorKeyframeTrack.js +1 -1
  205. package/src/audio/Audio.js +1 -1
  206. package/src/audio/AudioContext.js +2 -2
  207. package/src/audio/AudioListener.js +5 -3
  208. package/src/cameras/Camera.js +32 -2
  209. package/src/cameras/CubeCamera.js +20 -0
  210. package/src/constants.js +90 -5
  211. package/src/core/BufferAttribute.js +13 -1
  212. package/src/core/BufferGeometry.js +14 -2
  213. package/src/core/Clock.js +7 -0
  214. package/src/core/Object3D.js +52 -4
  215. package/src/core/Raycaster.js +2 -2
  216. package/src/core/RenderTarget.js +4 -4
  217. package/src/extras/PMREMGenerator.js +7 -18
  218. package/src/extras/TextureUtils.js +5 -1
  219. package/src/extras/curves/CatmullRomCurve3.js +3 -2
  220. package/src/geometries/ExtrudeGeometry.js +2 -2
  221. package/src/geometries/PolyhedronGeometry.js +1 -1
  222. package/src/geometries/TorusGeometry.js +8 -3
  223. package/src/helpers/CameraHelper.js +3 -0
  224. package/src/helpers/DirectionalLightHelper.js +4 -1
  225. package/src/helpers/HemisphereLightHelper.js +3 -0
  226. package/src/helpers/PointLightHelper.js +1 -25
  227. package/src/helpers/SpotLightHelper.js +3 -0
  228. package/src/lights/DirectionalLight.js +13 -0
  229. package/src/lights/HemisphereLight.js +10 -0
  230. package/src/lights/Light.js +1 -11
  231. package/src/lights/LightProbe.js +0 -15
  232. package/src/lights/LightShadow.js +15 -6
  233. package/src/lights/PointLight.js +15 -0
  234. package/src/lights/PointLightShadow.js +0 -86
  235. package/src/lights/SpotLight.js +22 -1
  236. package/src/lights/webgpu/IESSpotLight.js +2 -1
  237. package/src/loaders/AudioLoader.js +11 -1
  238. package/src/loaders/Cache.js +28 -0
  239. package/src/loaders/DataTextureLoader.js +6 -4
  240. package/src/loaders/FileLoader.js +2 -3
  241. package/src/loaders/ImageBitmapLoader.js +12 -9
  242. package/src/loaders/Loader.js +6 -0
  243. package/src/loaders/MaterialLoader.js +3 -2
  244. package/src/loaders/ObjectLoader.js +46 -6
  245. package/src/loaders/nodes/NodeLoader.js +2 -2
  246. package/src/loaders/nodes/NodeObjectLoader.js +18 -0
  247. package/src/materials/Material.js +2 -0
  248. package/src/materials/MeshLambertMaterial.js +9 -0
  249. package/src/materials/MeshPhongMaterial.js +9 -0
  250. package/src/materials/MeshToonMaterial.js +1 -1
  251. package/src/materials/ShaderMaterial.js +20 -1
  252. package/src/materials/nodes/Line2NodeMaterial.js +34 -7
  253. package/src/materials/nodes/MeshPhysicalNodeMaterial.js +5 -2
  254. package/src/materials/nodes/MeshStandardNodeMaterial.js +5 -4
  255. package/src/materials/nodes/NodeMaterial.js +45 -25
  256. package/src/materials/nodes/manager/NodeMaterialObserver.js +191 -86
  257. package/src/math/Line3.js +6 -5
  258. package/src/math/MathUtils.js +10 -10
  259. package/src/math/Matrix2.js +13 -9
  260. package/src/math/Matrix3.js +13 -9
  261. package/src/math/Matrix4.js +87 -74
  262. package/src/math/Plane.js +4 -3
  263. package/src/math/Quaternion.js +3 -29
  264. package/src/math/Sphere.js +1 -1
  265. package/src/math/Triangle.js +1 -1
  266. package/src/math/Vector2.js +11 -7
  267. package/src/math/Vector3.js +15 -13
  268. package/src/math/Vector4.js +13 -9
  269. package/src/math/interpolants/BezierInterpolant.js +108 -0
  270. package/src/nodes/Nodes.js +86 -68
  271. package/src/nodes/TSL.js +7 -7
  272. package/src/nodes/accessors/Arrays.js +1 -1
  273. package/src/nodes/accessors/BatchNode.js +10 -10
  274. package/src/nodes/accessors/Bitangent.js +5 -5
  275. package/src/nodes/accessors/BufferAttributeNode.js +107 -15
  276. package/src/nodes/accessors/BufferNode.js +29 -2
  277. package/src/nodes/accessors/Camera.js +149 -28
  278. package/src/nodes/accessors/ClippingNode.js +4 -4
  279. package/src/nodes/accessors/CubeTextureNode.js +27 -2
  280. package/src/nodes/accessors/InstanceNode.js +148 -43
  281. package/src/nodes/accessors/MaterialNode.js +9 -1
  282. package/src/nodes/accessors/MaterialProperties.js +2 -5
  283. package/src/nodes/accessors/MaterialReferenceNode.js +1 -2
  284. package/src/nodes/accessors/ModelNode.js +1 -1
  285. package/src/nodes/accessors/Normal.js +11 -11
  286. package/src/nodes/accessors/Object3DNode.js +1 -1
  287. package/src/nodes/accessors/Position.js +34 -2
  288. package/src/nodes/accessors/ReferenceBaseNode.js +6 -6
  289. package/src/nodes/accessors/ReferenceNode.js +8 -8
  290. package/src/nodes/accessors/RendererReferenceNode.js +1 -2
  291. package/src/nodes/accessors/SceneProperties.js +47 -0
  292. package/src/nodes/accessors/SkinningNode.js +27 -26
  293. package/src/nodes/accessors/StorageBufferNode.js +14 -25
  294. package/src/nodes/accessors/StorageTextureNode.js +40 -9
  295. package/src/nodes/accessors/Tangent.js +4 -14
  296. package/src/nodes/accessors/Texture3DNode.js +32 -35
  297. package/src/nodes/accessors/TextureNode.js +67 -23
  298. package/src/nodes/accessors/UniformArrayNode.js +6 -4
  299. package/src/nodes/accessors/UserDataNode.js +1 -2
  300. package/src/nodes/accessors/VertexColorNode.js +1 -2
  301. package/src/nodes/code/FunctionCallNode.js +1 -1
  302. package/src/nodes/code/FunctionNode.js +2 -3
  303. package/src/nodes/core/ArrayNode.js +21 -2
  304. package/src/nodes/core/AssignNode.js +3 -3
  305. package/src/nodes/core/AttributeNode.js +3 -3
  306. package/src/nodes/core/BypassNode.js +1 -1
  307. package/src/nodes/core/ContextNode.js +104 -5
  308. package/src/nodes/core/IndexNode.js +2 -1
  309. package/src/nodes/core/InputNode.js +1 -1
  310. package/src/nodes/core/InspectorNode.js +1 -1
  311. package/src/nodes/core/IsolateNode.js +1 -1
  312. package/src/nodes/core/MRTNode.js +48 -2
  313. package/src/nodes/core/Node.js +112 -15
  314. package/src/nodes/core/NodeBuilder.js +284 -66
  315. package/src/nodes/core/NodeError.js +28 -0
  316. package/src/nodes/core/NodeFrame.js +12 -4
  317. package/src/nodes/core/NodeUtils.js +11 -9
  318. package/src/nodes/core/OutputStructNode.js +12 -10
  319. package/src/nodes/core/ParameterNode.js +4 -4
  320. package/src/nodes/core/PropertyNode.js +19 -3
  321. package/src/nodes/core/StackNode.js +66 -17
  322. package/src/nodes/core/StackTrace.js +139 -0
  323. package/src/nodes/core/StructNode.js +17 -3
  324. package/src/nodes/core/StructTypeNode.js +12 -18
  325. package/src/nodes/core/SubBuildNode.js +2 -2
  326. package/src/nodes/core/UniformGroupNode.js +36 -6
  327. package/src/nodes/core/UniformNode.js +21 -5
  328. package/src/nodes/core/VarNode.js +48 -23
  329. package/src/nodes/core/VaryingNode.js +2 -19
  330. package/src/nodes/display/BlendModes.js +0 -64
  331. package/src/nodes/display/ColorAdjustment.js +17 -0
  332. package/src/nodes/display/ColorSpaceNode.js +3 -3
  333. package/src/nodes/display/NormalMapNode.js +39 -4
  334. package/src/nodes/display/PassNode.js +125 -16
  335. package/src/nodes/display/RenderOutputNode.js +7 -7
  336. package/src/nodes/display/ScreenNode.js +4 -2
  337. package/src/nodes/display/ToneMappingNode.js +1 -1
  338. package/src/nodes/display/ToonOutlinePassNode.js +2 -2
  339. package/src/nodes/display/ViewportDepthNode.js +52 -4
  340. package/src/nodes/display/ViewportDepthTextureNode.js +11 -15
  341. package/src/nodes/display/ViewportTextureNode.js +39 -11
  342. package/src/nodes/fog/Fog.js +18 -35
  343. package/src/nodes/functions/BSDF/BRDF_GGX_Multiscatter.js +3 -3
  344. package/src/nodes/functions/BSDF/DFGLUT.js +56 -0
  345. package/src/nodes/functions/BSDF/EnvironmentBRDF.js +2 -2
  346. package/src/nodes/functions/BSDF/V_GGX_SmithCorrelated_Anisotropic.js +2 -2
  347. package/src/nodes/functions/PhysicalLightingModel.js +126 -45
  348. package/src/nodes/geometry/RangeNode.js +5 -3
  349. package/src/nodes/gpgpu/AtomicFunctionNode.js +1 -1
  350. package/src/nodes/gpgpu/BarrierNode.js +9 -0
  351. package/src/nodes/gpgpu/ComputeBuiltinNode.js +2 -3
  352. package/src/nodes/gpgpu/ComputeNode.js +74 -48
  353. package/src/nodes/gpgpu/SubgroupFunctionNode.js +2 -2
  354. package/src/nodes/gpgpu/WorkgroupInfoNode.js +4 -4
  355. package/src/nodes/lighting/AnalyticLightNode.js +53 -0
  356. package/src/nodes/lighting/EnvironmentNode.js +28 -3
  357. package/src/nodes/lighting/LightsNode.js +7 -28
  358. package/src/nodes/lighting/PointShadowNode.js +162 -149
  359. package/src/nodes/lighting/ShadowFilterNode.js +53 -65
  360. package/src/nodes/lighting/ShadowNode.js +120 -42
  361. package/src/nodes/math/BitcastNode.js +1 -1
  362. package/src/nodes/math/BitcountNode.js +433 -0
  363. package/src/nodes/math/ConditionalNode.js +3 -3
  364. package/src/nodes/math/MathNode.js +76 -41
  365. package/src/nodes/math/OperatorNode.js +3 -2
  366. package/src/nodes/math/PackFloatNode.js +98 -0
  367. package/src/nodes/math/UnpackFloatNode.js +96 -0
  368. package/src/nodes/pmrem/PMREMNode.js +1 -1
  369. package/src/nodes/pmrem/PMREMUtils.js +9 -15
  370. package/src/nodes/tsl/TSLBase.js +1 -1
  371. package/src/nodes/tsl/TSLCore.js +38 -17
  372. package/src/nodes/utils/ArrayElementNode.js +14 -1
  373. package/src/nodes/utils/ConvertNode.js +1 -1
  374. package/src/nodes/utils/DebugNode.js +12 -12
  375. package/src/nodes/utils/EventNode.js +31 -2
  376. package/src/nodes/utils/FlipNode.js +1 -1
  377. package/src/nodes/utils/FunctionOverloadingNode.js +1 -1
  378. package/src/nodes/utils/JoinNode.js +3 -3
  379. package/src/nodes/utils/LoopNode.js +1 -1
  380. package/src/nodes/utils/MemberNode.js +2 -2
  381. package/src/nodes/utils/Packing.js +13 -1
  382. package/src/nodes/utils/PostProcessingUtils.js +33 -1
  383. package/src/nodes/utils/RTTNode.js +1 -1
  384. package/src/nodes/utils/ReflectorNode.js +3 -4
  385. package/src/nodes/utils/Remap.js +48 -0
  386. package/src/nodes/utils/RotateNode.js +1 -1
  387. package/src/nodes/utils/SampleNode.js +1 -1
  388. package/src/nodes/utils/SetNode.js +1 -1
  389. package/src/nodes/utils/SplitNode.js +1 -1
  390. package/src/nodes/utils/SpriteSheetUV.js +35 -0
  391. package/src/nodes/utils/UVUtils.js +28 -0
  392. package/src/objects/BatchedMesh.js +44 -16
  393. package/src/objects/InstancedMesh.js +30 -3
  394. package/src/objects/Line.js +1 -1
  395. package/src/objects/Mesh.js +1 -1
  396. package/src/objects/Points.js +1 -1
  397. package/src/objects/Skeleton.js +9 -0
  398. package/src/objects/SkinnedMesh.js +26 -9
  399. package/src/renderers/WebGLRenderer.js +329 -145
  400. package/src/renderers/common/Animation.js +3 -3
  401. package/src/renderers/common/Attributes.js +15 -1
  402. package/src/renderers/common/Backend.js +29 -8
  403. package/src/renderers/common/Background.js +26 -13
  404. package/src/renderers/common/BindGroup.js +1 -16
  405. package/src/renderers/common/Binding.js +11 -0
  406. package/src/renderers/common/Bindings.js +29 -14
  407. package/src/renderers/common/BlendMode.js +143 -0
  408. package/src/renderers/common/Buffer.js +40 -0
  409. package/src/renderers/common/BundleGroup.js +1 -1
  410. package/src/renderers/common/ChainMap.js +30 -6
  411. package/src/renderers/common/ComputePipeline.js +1 -1
  412. package/src/renderers/common/CubeRenderTarget.js +51 -7
  413. package/src/renderers/common/Geometries.js +29 -3
  414. package/src/renderers/common/Info.js +333 -4
  415. package/src/renderers/common/InspectorBase.js +6 -1
  416. package/src/renderers/common/Lighting.js +5 -21
  417. package/src/renderers/common/Pipelines.js +40 -7
  418. package/src/renderers/common/PostProcessing.js +8 -206
  419. package/src/renderers/common/ReadbackBuffer.js +78 -0
  420. package/src/renderers/common/RenderBundle.js +3 -1
  421. package/src/renderers/common/RenderBundles.js +7 -3
  422. package/src/renderers/common/RenderContext.js +16 -0
  423. package/src/renderers/common/RenderContexts.js +33 -49
  424. package/src/renderers/common/RenderLists.js +2 -1
  425. package/src/renderers/common/RenderObject.js +17 -5
  426. package/src/renderers/common/RenderObjectPipeline.js +40 -0
  427. package/src/renderers/common/RenderObjects.js +21 -5
  428. package/src/renderers/common/RenderPipeline.js +232 -17
  429. package/src/renderers/common/Renderer.js +481 -117
  430. package/src/renderers/common/Sampler.js +4 -4
  431. package/src/renderers/common/StorageBuffer.js +13 -1
  432. package/src/renderers/common/Textures.js +89 -4
  433. package/src/renderers/common/TimestampQueryPool.js +5 -3
  434. package/src/renderers/common/Uniform.js +8 -0
  435. package/src/renderers/common/UniformsGroup.js +62 -1
  436. package/src/renderers/common/XRManager.js +37 -29
  437. package/src/renderers/common/extras/PMREMGenerator.js +25 -23
  438. package/src/renderers/common/nodes/NodeBuilderState.js +1 -1
  439. package/src/renderers/common/nodes/{Nodes.js → NodeManager.js} +242 -99
  440. package/src/renderers/common/nodes/NodeStorageBuffer.js +13 -2
  441. package/src/renderers/common/nodes/NodeUniformBuffer.js +52 -0
  442. package/src/renderers/shaders/DFGLUTData.js +19 -34
  443. package/src/renderers/shaders/ShaderChunk/batching_pars_vertex.glsl.js +2 -2
  444. package/src/renderers/shaders/ShaderChunk/color_fragment.glsl.js +1 -5
  445. package/src/renderers/shaders/ShaderChunk/color_pars_fragment.glsl.js +1 -5
  446. package/src/renderers/shaders/ShaderChunk/color_pars_vertex.glsl.js +1 -5
  447. package/src/renderers/shaders/ShaderChunk/color_vertex.glsl.js +8 -10
  448. package/src/renderers/shaders/ShaderChunk/envmap_common_pars_fragment.glsl.js +0 -1
  449. package/src/renderers/shaders/ShaderChunk/envmap_fragment.glsl.js +8 -12
  450. package/src/renderers/shaders/ShaderChunk/lightprobes_pars_fragment.glsl.js +80 -0
  451. package/src/renderers/shaders/ShaderChunk/lights_fragment_begin.glsl.js +13 -2
  452. package/src/renderers/shaders/ShaderChunk/lights_fragment_end.glsl.js +6 -0
  453. package/src/renderers/shaders/ShaderChunk/lights_fragment_maps.glsl.js +6 -2
  454. package/src/renderers/shaders/ShaderChunk/lights_pars_begin.glsl.js +2 -0
  455. package/src/renderers/shaders/ShaderChunk/lights_physical_fragment.glsl.js +8 -4
  456. package/src/renderers/shaders/ShaderChunk/lights_physical_pars_fragment.glsl.js +112 -53
  457. package/src/renderers/shaders/ShaderChunk/normal_fragment_maps.glsl.js +7 -0
  458. package/src/renderers/shaders/ShaderChunk/packing.glsl.js +20 -4
  459. package/src/renderers/shaders/ShaderChunk/premultiplied_alpha_fragment.glsl.js +0 -1
  460. package/src/renderers/shaders/ShaderChunk/shadowmap_pars_fragment.glsl.js +225 -186
  461. package/src/renderers/shaders/ShaderChunk/shadowmap_vertex.glsl.js +12 -2
  462. package/src/renderers/shaders/ShaderChunk/shadowmask_pars_fragment.glsl.js +1 -1
  463. package/src/renderers/shaders/ShaderChunk/transmission_fragment.glsl.js +1 -1
  464. package/src/renderers/shaders/ShaderChunk.js +5 -3
  465. package/src/renderers/shaders/ShaderLib/backgroundCube.glsl.js +1 -2
  466. package/src/renderers/shaders/ShaderLib/depth.glsl.js +3 -0
  467. package/src/renderers/shaders/ShaderLib/{distanceRGBA.glsl.js → distance.glsl.js} +1 -2
  468. package/src/renderers/shaders/ShaderLib/meshlambert.glsl.js +2 -1
  469. package/src/renderers/shaders/ShaderLib/meshnormal.glsl.js +1 -2
  470. package/src/renderers/shaders/ShaderLib/meshphong.glsl.js +2 -1
  471. package/src/renderers/shaders/ShaderLib/meshphysical.glsl.js +4 -9
  472. package/src/renderers/shaders/ShaderLib/meshtoon.glsl.js +0 -1
  473. package/src/renderers/shaders/ShaderLib/shadow.glsl.js +1 -1
  474. package/src/renderers/shaders/ShaderLib/vsm.glsl.js +4 -6
  475. package/src/renderers/shaders/ShaderLib.js +7 -6
  476. package/src/renderers/shaders/UniformsLib.js +7 -5
  477. package/src/renderers/shaders/UniformsUtils.js +27 -5
  478. package/src/renderers/webgl/WebGLAnimation.js +2 -1
  479. package/src/renderers/webgl/WebGLBackground.js +15 -15
  480. package/src/renderers/webgl/WebGLBindingStates.js +99 -27
  481. package/src/renderers/webgl/WebGLBufferRenderer.js +0 -32
  482. package/src/renderers/webgl/WebGLCapabilities.js +9 -4
  483. package/src/renderers/webgl/WebGLEnvironments.js +228 -0
  484. package/src/renderers/webgl/WebGLGeometries.js +10 -7
  485. package/src/renderers/webgl/WebGLIndexedBufferRenderer.js +0 -32
  486. package/src/renderers/webgl/WebGLLights.js +18 -1
  487. package/src/renderers/webgl/WebGLMaterials.js +24 -13
  488. package/src/renderers/webgl/WebGLObjects.js +3 -1
  489. package/src/renderers/webgl/WebGLOutput.js +270 -0
  490. package/src/renderers/webgl/WebGLProgram.js +49 -109
  491. package/src/renderers/webgl/WebGLPrograms.js +63 -51
  492. package/src/renderers/webgl/WebGLRenderLists.js +15 -0
  493. package/src/renderers/webgl/WebGLRenderStates.js +13 -2
  494. package/src/renderers/webgl/WebGLShadowMap.js +188 -24
  495. package/src/renderers/webgl/WebGLState.js +75 -37
  496. package/src/renderers/webgl/WebGLTextures.js +215 -54
  497. package/src/renderers/webgl/WebGLUniforms.js +40 -3
  498. package/src/renderers/webgl/WebGLUniformsGroups.js +19 -0
  499. package/src/renderers/webgl/WebGLUtils.js +6 -2
  500. package/src/renderers/webgl-fallback/WebGLBackend.js +253 -82
  501. package/src/renderers/webgl-fallback/WebGLBufferRenderer.js +0 -41
  502. package/src/renderers/webgl-fallback/nodes/GLSLNodeBuilder.js +173 -74
  503. package/src/renderers/webgl-fallback/utils/WebGLAttributeUtils.js +53 -19
  504. package/src/renderers/webgl-fallback/utils/WebGLCapabilities.js +25 -0
  505. package/src/renderers/webgl-fallback/utils/WebGLState.js +223 -6
  506. package/src/renderers/webgl-fallback/utils/WebGLTextureUtils.js +68 -53
  507. package/src/renderers/webgl-fallback/utils/WebGLTimestampQueryPool.js +10 -10
  508. package/src/renderers/webgl-fallback/utils/WebGLUtils.js +6 -2
  509. package/src/renderers/webgpu/WebGPUBackend.js +260 -140
  510. package/src/renderers/webgpu/WebGPURenderer.js +2 -1
  511. package/src/renderers/webgpu/nodes/WGSLNodeBuilder.js +366 -90
  512. package/src/renderers/webgpu/utils/WebGPUAttributeUtils.js +107 -34
  513. package/src/renderers/webgpu/utils/WebGPUBindingUtils.js +357 -200
  514. package/src/renderers/webgpu/utils/WebGPUCapabilities.js +48 -0
  515. package/src/renderers/webgpu/utils/WebGPUConstants.js +10 -0
  516. package/src/renderers/webgpu/utils/WebGPUPipelineUtils.js +61 -23
  517. package/src/renderers/webgpu/utils/WebGPUTexturePassUtils.js +152 -200
  518. package/src/renderers/webgpu/utils/WebGPUTextureUtils.js +156 -59
  519. package/src/renderers/webgpu/utils/WebGPUTimestampQueryPool.js +7 -7
  520. package/src/renderers/webgpu/utils/WebGPUUtils.js +33 -11
  521. package/src/renderers/webxr/WebXRController.js +12 -0
  522. package/src/renderers/webxr/WebXRManager.js +4 -2
  523. package/src/textures/CubeDepthTexture.js +76 -0
  524. package/src/textures/HTMLTexture.js +74 -0
  525. package/src/textures/Source.js +2 -2
  526. package/src/textures/Texture.js +16 -5
  527. package/src/utils.js +280 -3
  528. package/examples/jsm/materials/MeshGouraudMaterial.js +0 -434
  529. package/examples/jsm/materials/MeshPostProcessingMaterial.js +0 -167
  530. package/examples/jsm/shaders/GodRaysShader.js +0 -333
  531. package/src/nodes/accessors/SceneNode.js +0 -145
  532. package/src/nodes/code/ScriptableNode.js +0 -726
  533. package/src/nodes/code/ScriptableValueNode.js +0 -253
  534. package/src/nodes/display/PosterizeNode.js +0 -65
  535. package/src/nodes/functions/BSDF/DFGApprox.js +0 -71
  536. package/src/nodes/utils/RemapNode.js +0 -125
  537. package/src/nodes/utils/SpriteSheetUVNode.js +0 -90
  538. package/src/renderers/webgl/WebGLCubeMaps.js +0 -99
  539. package/src/renderers/webgl/WebGLCubeUVMaps.js +0 -134
@@ -1,5 +1,5 @@
1
- import { DepthTexture, FloatType, RenderTarget, Vector2, TempNode, QuadMesh, NodeMaterial, RendererUtils, NodeUpdateType } from 'three/webgpu';
2
- import { Loop, int, exp, min, float, mul, uv, vec2, vec3, Fn, textureSize, orthographicDepthToViewZ, screenUV, nodeObject, uniform, vec4, passTexture, texture, perspectiveDepthToViewZ, positionView, reference } from 'three/tsl';
1
+ import { DepthTexture, FloatType, RenderTarget, Vector2, TempNode, QuadMesh, NodeMaterial, SpriteNodeMaterial, RendererUtils, NodeUpdateType } from 'three/webgpu';
2
+ import { Loop, int, exp, min, float, mul, uv, vec2, vec3, Fn, textureSize, orthographicDepthToViewZ, screenUV, nodeObject, uniform, vec4, passTexture, texture, perspectiveDepthToViewZ, positionView, reference, color } from 'three/tsl';
3
3
 
4
4
  const _quadMesh = /*@__PURE__*/ new QuadMesh();
5
5
  const _size = /*@__PURE__*/ new Vector2();
@@ -13,7 +13,7 @@ let _rendererState;
13
13
  * gives you great flexibility in composing the final outline look depending on
14
14
  * your requirements.
15
15
  * ```js
16
- * const postProcessing = new THREE.PostProcessing( renderer );
16
+ * const renderPipeline = new THREE.RenderPipeline( renderer );
17
17
  *
18
18
  * const scenePass = pass( scene, camera );
19
19
  *
@@ -36,7 +36,7 @@ let _rendererState;
36
36
  * const { visibleEdge, hiddenEdge } = outlinePass;
37
37
  * const outlineColor = visibleEdge.mul( visibleEdgeColor ).add( hiddenEdge.mul( hiddenEdgeColor ) ).mul( edgeStrength );
38
38
  *
39
- * postProcessing.outputNode = outlineColor.add( scenePass );
39
+ * renderPipeline.outputNode = outlineColor.add( scenePass );
40
40
  * ```
41
41
  *
42
42
  * @augments TempNode
@@ -293,9 +293,13 @@ class OutlineNode extends TempNode {
293
293
  * @type {NodeMaterial}
294
294
  */
295
295
  this._depthMaterial = new NodeMaterial();
296
- this._depthMaterial.fragmentNode = vec4( 0, 0, 0, 1 );
296
+ this._depthMaterial.colorNode = color( 0, 0, 0 );
297
297
  this._depthMaterial.name = 'OutlineNode.depth';
298
298
 
299
+ this._depthSpriteMaterial = new SpriteNodeMaterial();
300
+ this._depthSpriteMaterial.colorNode = color( 0, 0, 0 );
301
+ this._depthSpriteMaterial.name = 'OutlineNode.depthSprite';
302
+
299
303
  /**
300
304
  * The material for preparing the mask.
301
305
  *
@@ -305,6 +309,9 @@ class OutlineNode extends TempNode {
305
309
  this._prepareMaskMaterial = new NodeMaterial();
306
310
  this._prepareMaskMaterial.name = 'OutlineNode.prepareMask';
307
311
 
312
+ this._prepareMaskSpriteMaterial = new SpriteNodeMaterial();
313
+ this._prepareMaskSpriteMaterial.name = 'OutlineNode.prepareMaskSprite';
314
+
308
315
  /**
309
316
  * The copy material
310
317
  *
@@ -358,6 +365,17 @@ class OutlineNode extends TempNode {
358
365
  */
359
366
  this._selectionCache = new Set();
360
367
 
368
+ /**
369
+ * The number of selected objects from the previous frame. Used to detect
370
+ * the transition to an empty selection so the composite render target can
371
+ * be cleared once and avoid leaving a stale outline on screen.
372
+ *
373
+ * @private
374
+ * @type {number}
375
+ * @default 0
376
+ */
377
+ this._lastSelectionCount = 0;
378
+
361
379
  /**
362
380
  * The result of the effect is represented as a separate texture node.
363
381
  *
@@ -442,6 +460,35 @@ class OutlineNode extends TempNode {
442
460
  const { renderer } = frame;
443
461
  const { camera, scene } = this;
444
462
 
463
+ this._updateSelectionCache();
464
+
465
+ // If no objects are selected, all subsequent passes can be skipped since
466
+ // the outline would be empty anyway. The composite render target is cleared
467
+ // once when transitioning to an empty selection so a previously rendered
468
+ // outline does not linger on screen.
469
+
470
+ if ( this._selectionCache.size === 0 ) {
471
+
472
+ if ( this._lastSelectionCount > 0 ) {
473
+
474
+ _rendererState = RendererUtils.resetRendererState( renderer, _rendererState );
475
+
476
+ renderer.setRenderTarget( this._renderTargetComposite );
477
+ renderer.setClearColor( 0x000000, 0 );
478
+ renderer.clear();
479
+
480
+ RendererUtils.restoreRendererState( renderer, _rendererState );
481
+
482
+ this._lastSelectionCount = 0;
483
+
484
+ }
485
+
486
+ return;
487
+
488
+ }
489
+
490
+ this._lastSelectionCount = this._selectionCache.size;
491
+
445
492
  _rendererState = RendererUtils.resetRendererAndSceneState( renderer, scene, _rendererState );
446
493
 
447
494
  //
@@ -453,20 +500,18 @@ class OutlineNode extends TempNode {
453
500
 
454
501
  renderer.setClearColor( 0xffffff, 1 );
455
502
 
456
- this._updateSelectionCache();
457
-
458
503
  const currentSceneName = scene.name;
459
504
 
460
505
  // 1. Draw non-selected objects in the depth buffer
461
506
 
462
- scene.overrideMaterial = this._depthMaterial;
463
-
464
507
  renderer.setRenderTarget( this._renderTargetDepthBuffer );
465
- renderer.setRenderObjectFunction( ( object, ...params ) => {
508
+ renderer.setRenderObjectFunction( ( object, scene, camera, geometry, material, group, lightsNode, clippingContext ) => {
466
509
 
467
510
  if ( this._selectionCache.has( object ) === false ) {
468
511
 
469
- renderer.renderObject( object, ...params );
512
+ const overrideMaterial = object.isSprite ? this._depthSpriteMaterial : this._depthMaterial;
513
+
514
+ renderer.renderObject( object, scene, camera, geometry, overrideMaterial, group, lightsNode, clippingContext );
470
515
 
471
516
  }
472
517
 
@@ -477,14 +522,14 @@ class OutlineNode extends TempNode {
477
522
 
478
523
  // 2. Draw only the selected objects by comparing the depth buffer of non-selected objects
479
524
 
480
- scene.overrideMaterial = this._prepareMaskMaterial;
481
-
482
525
  renderer.setRenderTarget( this._renderTargetMaskBuffer );
483
- renderer.setRenderObjectFunction( ( object, ...params ) => {
526
+ renderer.setRenderObjectFunction( ( object, scene, camera, geometry, material, group, lightsNode, clippingContext ) => {
484
527
 
485
528
  if ( this._selectionCache.has( object ) === true ) {
486
529
 
487
- renderer.renderObject( object, ...params );
530
+ const overrideMaterial = object.isSprite ? this._prepareMaskSpriteMaterial : this._prepareMaskMaterial;
531
+
532
+ renderer.renderObject( object, scene, camera, geometry, overrideMaterial, group, lightsNode, clippingContext );
488
533
 
489
534
  }
490
535
 
@@ -587,13 +632,16 @@ class OutlineNode extends TempNode {
587
632
  }
588
633
 
589
634
  const depthTest = positionView.z.lessThanEqual( viewZNode ).select( 1, 0 );
590
- return vec4( 0.0, depthTest, 1.0, 1.0 );
635
+ return vec3( 0.0, depthTest, 1.0 );
591
636
 
592
637
  };
593
638
 
594
- this._prepareMaskMaterial.fragmentNode = prepareMask();
639
+ this._prepareMaskMaterial.colorNode = prepareMask();
595
640
  this._prepareMaskMaterial.needsUpdate = true;
596
641
 
642
+ this._prepareMaskSpriteMaterial.colorNode = prepareMask();
643
+ this._prepareMaskSpriteMaterial.needsUpdate = true;
644
+
597
645
  // copy material
598
646
 
599
647
  this._materialCopy.fragmentNode = this._maskTextureUniform;
@@ -712,7 +760,9 @@ class OutlineNode extends TempNode {
712
760
  this._renderTargetComposite.dispose();
713
761
 
714
762
  this._depthMaterial.dispose();
763
+ this._depthSpriteMaterial.dispose();
715
764
  this._prepareMaskMaterial.dispose();
765
+ this._prepareMaskSpriteMaterial.dispose();
716
766
  this._materialCopy.dispose();
717
767
  this._edgeDetectionMaterial.dispose();
718
768
  this._separableBlurMaterial.dispose();
@@ -733,7 +783,7 @@ class OutlineNode extends TempNode {
733
783
  const selectedObject = this.selectedObjects[ i ];
734
784
  selectedObject.traverse( ( object ) => {
735
785
 
736
- if ( object.isMesh ) this._selectionCache.add( object );
786
+ if ( object.isMesh || object.isSprite ) this._selectionCache.add( object );
737
787
 
738
788
  } );
739
789
 
@@ -759,4 +809,4 @@ export default OutlineNode;
759
809
  * @param {number} [params.downSampleRatio=2] - The downsample ratio.
760
810
  * @returns {OutlineNode}
761
811
  */
762
- export const outline = ( scene, camera, params ) => nodeObject( new OutlineNode( scene, camera, params ) );
812
+ export const outline = ( scene, camera, params ) => new OutlineNode( scene, camera, params );
@@ -1,5 +1,5 @@
1
1
  import { NodeMaterial } from 'three/webgpu';
2
- import { nodeObject, Fn, vec4, uv, If, mod, screenCoordinate } from 'three/tsl';
2
+ import { Fn, vec4, uv, If, mod, screenCoordinate } from 'three/tsl';
3
3
  import StereoCompositePassNode from './StereoCompositePassNode.js';
4
4
 
5
5
  /**
@@ -86,4 +86,4 @@ export default ParallaxBarrierPassNode;
86
86
  * @param {Camera} camera - The camera to render the scene with.
87
87
  * @returns {ParallaxBarrierPassNode}
88
88
  */
89
- export const parallaxBarrierPass = ( scene, camera ) => nodeObject( new ParallaxBarrierPassNode( scene, camera ) );
89
+ export const parallaxBarrierPass = ( scene, camera ) => new ParallaxBarrierPassNode( scene, camera );
@@ -74,18 +74,19 @@ class PixelationNode extends TempNode {
74
74
  /**
75
75
  * Uniform node that represents the resolution.
76
76
  *
77
+ * @private
77
78
  * @type {Node<vec4>}
78
79
  */
79
80
  this._resolution = uniform( new Vector4() );
80
81
 
81
82
  /**
82
- * The `updateBeforeType` is set to `NodeUpdateType.FRAME` since the node updates
83
+ * The `updateType` is set to `NodeUpdateType.FRAME` since the node updates
83
84
  * its internal uniforms once per frame in `updateBefore()`.
84
85
  *
85
86
  * @type {string}
86
87
  * @default 'frame'
87
88
  */
88
- this.updateBeforeType = NodeUpdateType.FRAME;
89
+ this.updateType = NodeUpdateType.FRAME;
89
90
 
90
91
  }
91
92
 
@@ -94,7 +95,7 @@ class PixelationNode extends TempNode {
94
95
  *
95
96
  * @param {NodeFrame} frame - The current node frame.
96
97
  */
97
- updateBefore() {
98
+ update() {
98
99
 
99
100
  const map = this.textureNode.value;
100
101
 
@@ -193,7 +194,7 @@ class PixelationNode extends TempNode {
193
194
 
194
195
  const nei = property( 'float', 'nei' );
195
196
 
196
- If( this.normalEdgeStrength.greaterThan( 0.0 ), () => {
197
+ If( this.normalEdgeStrength.greaterThan( 0.0 ).and( normal.length().greaterThan( 0 ) ), () => {
197
198
 
198
199
  nei.assign( normalEdgeIndicator( depth, normal ) );
199
200
 
@@ -213,7 +214,7 @@ class PixelationNode extends TempNode {
213
214
 
214
215
  }
215
216
 
216
- const pixelation = ( node, depthNode, normalNode, pixelSize = 6, normalEdgeStrength = 0.3, depthEdgeStrength = 0.4 ) => nodeObject( new PixelationNode( convertToTexture( node ), convertToTexture( depthNode ), convertToTexture( normalNode ), nodeObject( pixelSize ), nodeObject( normalEdgeStrength ), nodeObject( depthEdgeStrength ) ) );
217
+ const pixelation = ( node, depthNode, normalNode, pixelSize = 6, normalEdgeStrength = 0.3, depthEdgeStrength = 0.4 ) => new PixelationNode( convertToTexture( node ), convertToTexture( depthNode ), convertToTexture( normalNode ), nodeObject( pixelSize ), nodeObject( normalEdgeStrength ), nodeObject( depthEdgeStrength ) );
217
218
 
218
219
  /**
219
220
  * A special render pass node that renders the scene with a pixelation effect.
@@ -329,6 +330,6 @@ class PixelationPassNode extends PassNode {
329
330
  * @param {Node<float> | number} [depthEdgeStrength=0.4] - The depth edge strength.
330
331
  * @returns {PixelationPassNode}
331
332
  */
332
- export const pixelationPass = ( scene, camera, pixelSize, normalEdgeStrength, depthEdgeStrength ) => nodeObject( new PixelationPassNode( scene, camera, pixelSize, normalEdgeStrength, depthEdgeStrength ) );
333
+ export const pixelationPass = ( scene, camera, pixelSize, normalEdgeStrength, depthEdgeStrength ) => new PixelationPassNode( scene, camera, pixelSize, normalEdgeStrength, depthEdgeStrength );
333
334
 
334
335
  export default PixelationPassNode;
@@ -1,5 +1,5 @@
1
1
  import { TempNode } from 'three/webgpu';
2
- import { nodeObject, Fn, uv, uniform, vec2, sin, cos, vec4, convertToTexture } from 'three/tsl';
2
+ import { Fn, uv, uniform, vec2, sin, cos, vec4, convertToTexture } from 'three/tsl';
3
3
 
4
4
  /**
5
5
  * Post processing node for shifting/splitting RGB color channels. The effect
@@ -93,4 +93,4 @@ export default RGBShiftNode;
93
93
  * @param {number} [angle=0] - Defines in which direction colors are shifted.
94
94
  * @returns {RGBShiftNode}
95
95
  */
96
- export const rgbShift = ( node, amount, angle ) => nodeObject( new RGBShiftNode( convertToTexture( node ), amount, angle ) );
96
+ export const rgbShift = ( node, amount, angle ) => new RGBShiftNode( convertToTexture( node ), amount, angle );
@@ -0,0 +1,263 @@
1
+ import { MeshBasicNodeMaterial, PassNode, UnsignedByteType, NearestFilter, CubeMapNode, MeshPhongNodeMaterial } from 'three/webgpu';
2
+ import { float, vec2, vec4, Fn, uv, varying, cameraProjectionMatrix, cameraViewMatrix, positionWorld, screenSize, materialColor, uint, texture, uniform, context, reflectVector } from 'three/tsl';
3
+
4
+ const _affineUv = varying( vec2() );
5
+ const _w = varying( float() );
6
+
7
+ const _clipSpaceRetro = Fn( () => {
8
+
9
+ const defaultPosition = cameraProjectionMatrix
10
+ .mul( cameraViewMatrix )
11
+ .mul( positionWorld );
12
+
13
+ const roundedPosition = defaultPosition.xy
14
+ .div( defaultPosition.w.mul( 2 ) )
15
+ .mul( screenSize.xy )
16
+ .round()
17
+ .div( screenSize.xy )
18
+ .mul( defaultPosition.w.mul( 2 ) );
19
+
20
+ _affineUv.assign( uv().mul( defaultPosition.w ) );
21
+ _w.assign( defaultPosition.w );
22
+
23
+ return vec4( roundedPosition.xy, defaultPosition.zw );
24
+
25
+ } )();
26
+
27
+ /**
28
+ * A post-processing pass that applies a retro PS1-style effect to the scene.
29
+ *
30
+ * This node renders the scene with classic PlayStation 1 visual characteristics:
31
+ * - **Vertex snapping**: Vertices are snapped to screen pixels, creating the iconic "wobbly" geometry
32
+ * - **Affine texture mapping**: Textures are sampled without perspective correction, resulting in distortion effects
33
+ * - **Low resolution**: Default 0.25 scale (typical 320x240 equivalent)
34
+ * - **Nearest-neighbor filtering**: Sharp pixelated textures without smoothing
35
+ *
36
+ * @augments PassNode
37
+ */
38
+ class RetroPassNode extends PassNode {
39
+
40
+ /**
41
+ * Creates a new RetroPassNode instance.
42
+ *
43
+ * @param {Scene} scene - The scene to render.
44
+ * @param {Camera} camera - The camera to render from.
45
+ * @param {Object} [options={}] - Additional options for the retro pass.
46
+ * @param {Node} [options.affineDistortion=null] - An optional node to apply affine distortion to UVs.
47
+ */
48
+ constructor( scene, camera, options = {} ) {
49
+
50
+ super( PassNode.COLOR, scene, camera );
51
+
52
+ const {
53
+ affineDistortion = null,
54
+ filterTextures = false
55
+ } = options;
56
+
57
+ this.setResolutionScale( .25 );
58
+
59
+ this.renderTarget.texture.type = UnsignedByteType;
60
+ this.renderTarget.texture.magFilter = NearestFilter;
61
+ this.renderTarget.texture.minFilter = NearestFilter;
62
+
63
+ this.affineDistortionNode = affineDistortion;
64
+
65
+ this.filterTextures = filterTextures;
66
+
67
+ this._materialCache = new Map();
68
+
69
+ }
70
+
71
+ /**
72
+ * Updates the retro pass before rendering.
73
+ *
74
+ * @override
75
+ * @param {Frame} frame - The current frame information.
76
+ * @returns {void}
77
+ */
78
+ updateBefore( frame ) {
79
+
80
+ const renderer = frame.renderer;
81
+
82
+ const currentRenderObjectFunction = renderer.getRenderObjectFunction();
83
+
84
+ renderer.setRenderObjectFunction( ( object, scene, camera, geometry, material, ...params ) => {
85
+
86
+ const retroMaterialData = this._materialCache.get( material );
87
+
88
+ let retroMaterial;
89
+
90
+ if ( retroMaterialData === undefined || retroMaterialData.version !== material.version ) {
91
+
92
+ if ( retroMaterialData !== undefined ) {
93
+
94
+ retroMaterialData.material.dispose();
95
+
96
+ }
97
+
98
+ if ( material.isMeshBasicMaterial || material.isMeshBasicNodeMaterial ) {
99
+
100
+ retroMaterial = new MeshBasicNodeMaterial();
101
+
102
+ } else {
103
+
104
+ retroMaterial = new MeshPhongNodeMaterial();
105
+
106
+ }
107
+
108
+ retroMaterial.colorNode = material.colorNode || null;
109
+ retroMaterial.opacityNode = material.opacityNode || null;
110
+ retroMaterial.positionNode = material.positionNode || null;
111
+ retroMaterial.vertexNode = material.vertexNode || _clipSpaceRetro;
112
+
113
+ let colorNode = material.colorNode || materialColor;
114
+
115
+ if ( material.isMeshStandardNodeMaterial || material.isMeshStandardMaterial ) {
116
+
117
+ const envMap = material.envMap || scene.environment;
118
+
119
+ if ( envMap ) {
120
+
121
+ const reflection = new CubeMapNode( texture( envMap ) );
122
+
123
+ let metalness;
124
+
125
+ if ( material.metalnessNode ) {
126
+
127
+ metalness = material.metalnessNode;
128
+
129
+ } else {
130
+
131
+ metalness = uniform( material.metalness ).onRenderUpdate( ( { material } ) => material.metalness );
132
+
133
+ if ( material.metalnessMap ) {
134
+
135
+ const textureUniform = texture( material.metalnessMap ).onRenderUpdate( ( { material } ) => material.metalnessMap );
136
+
137
+ metalness = metalness.mul( textureUniform.b );
138
+
139
+ }
140
+
141
+ }
142
+
143
+ colorNode = metalness.mix( colorNode, reflection );
144
+
145
+ }
146
+
147
+ }
148
+
149
+ retroMaterial.colorNode = colorNode;
150
+
151
+ //
152
+
153
+ const contextData = {};
154
+
155
+ if ( this.affineDistortionNode ) {
156
+
157
+ contextData.getUV = ( texture ) => {
158
+
159
+ let finalUV;
160
+
161
+ if ( texture.isCubeTextureNode ) {
162
+
163
+ finalUV = reflectVector;
164
+
165
+ } else {
166
+
167
+ finalUV = this.affineDistortionNode.mix( uv(), _affineUv.div( _w ) );
168
+
169
+ }
170
+
171
+ return finalUV;
172
+
173
+ };
174
+
175
+ }
176
+
177
+ if ( this.filterTextures !== true ) {
178
+
179
+ contextData.getTextureLevel = () => uint( 0 );
180
+
181
+ }
182
+
183
+ retroMaterial.contextNode = context( contextData );
184
+
185
+ //
186
+
187
+ this._materialCache.set( material, {
188
+ material: retroMaterial,
189
+ version: material.version
190
+ } );
191
+
192
+ } else {
193
+
194
+ retroMaterial = retroMaterialData.material;
195
+
196
+ }
197
+
198
+ for ( const property in material ) {
199
+
200
+ if ( retroMaterial[ property ] === undefined ) continue;
201
+
202
+ retroMaterial[ property ] = material[ property ];
203
+
204
+ }
205
+
206
+ renderer.renderObject( object, scene, camera, geometry, retroMaterial, ...params );
207
+
208
+ } );
209
+
210
+ super.updateBefore( frame );
211
+
212
+ renderer.setRenderObjectFunction( currentRenderObjectFunction );
213
+
214
+ }
215
+
216
+ /**
217
+ * Disposes the retro pass and its internal resources.
218
+ *
219
+ * @override
220
+ * @returns {void}
221
+ */
222
+ dispose() {
223
+
224
+ super.dispose();
225
+
226
+ this._materialCache.forEach( ( data ) => {
227
+
228
+ data.material.dispose();
229
+
230
+ } );
231
+
232
+ this._materialCache.clear();
233
+
234
+ }
235
+
236
+ }
237
+
238
+ export default RetroPassNode;
239
+
240
+ /**
241
+ * Creates a new RetroPassNode instance for PS1-style rendering.
242
+ *
243
+ * The retro pass applies vertex snapping, affine texture mapping, and low-resolution
244
+ * rendering to achieve an authentic PlayStation 1 aesthetic. Combine with other
245
+ * post-processing effects like dithering, posterization, and scanlines for full retro look.
246
+ *
247
+ * ```js
248
+ * // Combined with other effects
249
+ * let pipeline = retroPass( scene, camera );
250
+ * pipeline = bayerDither( pipeline, 32 );
251
+ * pipeline = posterize( pipeline, 32 );
252
+ * renderPipeline.outputNode = pipeline;
253
+ * ```
254
+ *
255
+ * @tsl
256
+ * @function
257
+ * @param {Scene} scene - The scene to render.
258
+ * @param {Camera} camera - The camera to render from.
259
+ * @param {Object} [options={}] - Additional options for the retro pass.
260
+ * @param {Node} [options.affineDistortion=null] - An optional node to apply affine distortion to UVs.
261
+ * @return {RetroPassNode} A new RetroPassNode instance.
262
+ */
263
+ export const retroPass = ( scene, camera, options = {} ) => new RetroPassNode( scene, camera, options );
@@ -1,5 +1,5 @@
1
1
  import { HalfFloatType, LinearFilter, NearestFilter, RenderTarget, Texture, Vector2, QuadMesh, NodeMaterial, TempNode, RendererUtils } from 'three/webgpu';
2
- import { abs, nodeObject, Fn, NodeUpdateType, uv, uniform, convertToTexture, varyingProperty, vec2, vec4, modelViewProjection, passTexture, max, step, dot, float, texture, If, Loop, int, Break, sqrt, sign, mix } from 'three/tsl';
2
+ import { abs, Fn, NodeUpdateType, uv, uniform, convertToTexture, varyingProperty, vec2, vec4, modelViewProjection, passTexture, max, step, dot, float, texture, If, Loop, int, Break, sqrt, sign, mix } from 'three/tsl';
3
3
 
4
4
  const _quadMesh = /*@__PURE__*/ new QuadMesh();
5
5
  const _size = /*@__PURE__*/ new Vector2();
@@ -765,4 +765,4 @@ export default SMAANode;
765
765
  * @param {Node<vec4>} node - The node that represents the input of the effect.
766
766
  * @returns {SMAANode}
767
767
  */
768
- export const smaa = ( node ) => nodeObject( new SMAANode( convertToTexture( node ) ) );
768
+ export const smaa = ( node ) => new SMAANode( convertToTexture( node ) );
@@ -1,5 +1,5 @@
1
1
  import { AdditiveBlending, Color, Vector2, RendererUtils, PassNode, QuadMesh, NodeMaterial } from 'three/webgpu';
2
- import { nodeObject, uniform, mrt, texture, getTextureIndex, unpremultiplyAlpha } from 'three/tsl';
2
+ import { uniform, mrt, texture, getTextureIndex, unpremultiplyAlpha } from 'three/tsl';
3
3
 
4
4
  const _size = /*@__PURE__*/ new Vector2();
5
5
 
@@ -355,4 +355,4 @@ const _JitterVectors = [
355
355
  * @param {Camera} camera - The camera to render the scene with.
356
356
  * @returns {SSAAPassNode}
357
357
  */
358
- export const ssaaPass = ( scene, camera ) => nodeObject( new SSAAPassNode( scene, camera ) );
358
+ export const ssaaPass = ( scene, camera ) => new SSAAPassNode( scene, camera );
@@ -1,5 +1,5 @@
1
1
  import { RenderTarget, Vector2, TempNode, QuadMesh, NodeMaterial, RendererUtils, MathUtils } from 'three/webgpu';
2
- import { clamp, normalize, reference, nodeObject, Fn, NodeUpdateType, uniform, vec4, passTexture, uv, logarithmicDepthToViewZ, viewZToPerspectiveDepth, getViewPosition, screenCoordinate, float, sub, fract, dot, vec2, rand, vec3, Loop, mul, PI, cos, sin, uint, cross, acos, sign, pow, luminance, If, max, abs, Break, sqrt, HALF_PI, div, ceil, shiftRight, convertToTexture, bool, getNormalFromDepth, interleavedGradientNoise } from 'three/tsl';
2
+ import { clamp, normalize, reference, Fn, NodeUpdateType, uniform, vec4, passTexture, uv, logarithmicDepthToViewZ, viewZToPerspectiveDepth, getViewPosition, screenCoordinate, float, sub, fract, dot, vec2, rand, vec3, Loop, mul, PI, cos, sin, uint, cross, acos, sign, pow, luminance, If, max, abs, Break, sqrt, HALF_PI, div, ceil, shiftRight, convertToTexture, bool, getNormalFromDepth, countOneBits, interleavedGradientNoise } from 'three/tsl';
3
3
 
4
4
  const _quadMesh = /*@__PURE__*/ new QuadMesh();
5
5
  const _size = /*@__PURE__*/ new Vector2();
@@ -197,6 +197,7 @@ class SSGINode extends TempNode {
197
197
  /**
198
198
  * The resolution of the effect.
199
199
  *
200
+ * @private
200
201
  * @type {UniformNode<vec2>}
201
202
  */
202
203
  this._resolution = uniform( new Vector2() );
@@ -204,6 +205,7 @@ class SSGINode extends TempNode {
204
205
  /**
205
206
  * Used to compute the effective step radius when viewSpaceSampling is `false`.
206
207
  *
208
+ * @private
207
209
  * @type {UniformNode<vec2>}
208
210
  */
209
211
  this._halfProjScale = uniform( 1 );
@@ -211,6 +213,7 @@ class SSGINode extends TempNode {
211
213
  /**
212
214
  * Temporal direction that influences the rotation angle for each slice.
213
215
  *
216
+ * @private
214
217
  * @type {UniformNode<float>}
215
218
  */
216
219
  this._temporalDirection = uniform( 0 );
@@ -218,6 +221,7 @@ class SSGINode extends TempNode {
218
221
  /**
219
222
  * Temporal offset added to the initial ray step.
220
223
  *
224
+ * @private
221
225
  * @type {UniformNode<float>}
222
226
  */
223
227
  this._temporalOffset = uniform( 0 );
@@ -431,22 +435,6 @@ class SSGINode extends TempNode {
431
435
  ]
432
436
  } );
433
437
 
434
- const bitCount = Fn( ( [ value ] ) => {
435
-
436
- const v = uint( value );
437
- v.assign( v.sub( v.shiftRight( uint( 1 ) ).bitAnd( uint( 0x55555555 ) ) ) );
438
- v.assign( v.bitAnd( uint( 0x33333333 ) ).add( v.shiftRight( uint( 2 ) ).bitAnd( uint( 0x33333333 ) ) ) );
439
-
440
- return v.add( v.shiftRight( uint( 4 ) ) ).bitAnd( uint( 0xF0F0F0F ) ).mul( uint( 0x1010101 ) ).shiftRight( uint( 24 ) );
441
-
442
- } ).setLayout( {
443
- name: 'bitCount',
444
- type: 'uint',
445
- inputs: [
446
- { name: 'value', type: 'uint' }
447
- ]
448
- } );
449
-
450
438
  const horizonSampling = Fn( ( [ directionIsRight, RADIUS, viewPosition, slideDirTexelSize, initialRayStep, uvNode, viewDir, viewNormal, n ] ) => {
451
439
 
452
440
  const STEP_COUNT = this.stepCount.toConst();
@@ -473,8 +461,6 @@ class SSGINode extends TempNode {
473
461
 
474
462
  const color = vec3( 0 );
475
463
 
476
- const lastSampleViewPosition = vec3( viewPosition ).toVar();
477
-
478
464
  Loop( { start: uint( 0 ), end: STEP_COUNT, type: 'uint', condition: '<' }, ( { i } ) => {
479
465
 
480
466
  const offset = pow( abs( mul( stepRadius, float( i ).add( initialRayStep ) ).div( radiusVS ) ), EXP_FACTOR ).mul( radiusVS ).toConst();
@@ -509,7 +495,7 @@ class SSGINode extends TempNode {
509
495
  currentOccludedBitfield = currentOccludedBitfield.bitAnd( globalOccludedBitfield.bitNot() );
510
496
 
511
497
  globalOccludedBitfield.assign( globalOccludedBitfield.bitOr( currentOccludedBitfield ) );
512
- const numOccludedZones = bitCount( currentOccludedBitfield );
498
+ const numOccludedZones = countOneBits( currentOccludedBitfield );
513
499
 
514
500
  //
515
501
 
@@ -541,8 +527,6 @@ class SSGINode extends TempNode {
541
527
 
542
528
  } );
543
529
 
544
- lastSampleViewPosition.assign( sampleViewPosition );
545
-
546
530
  } );
547
531
 
548
532
  return vec3( color );
@@ -593,7 +577,7 @@ class SSGINode extends TempNode {
593
577
  color.addAssign( horizonSampling( bool( true ), RADIUS, viewPosition, slideDirTexelSize, initialRayStep, uvNode, viewDir, viewNormal, n ) );
594
578
  color.addAssign( horizonSampling( bool( false ), RADIUS, viewPosition, slideDirTexelSize, initialRayStep, uvNode, viewDir, viewNormal, n ) );
595
579
 
596
- ao.addAssign( float( bitCount( globalOccludedBitfield ) ).div( float( MAX_RAY ) ) );
580
+ ao.addAssign( float( countOneBits( globalOccludedBitfield ) ).div( float( MAX_RAY ) ) );
597
581
 
598
582
  } );
599
583
 
@@ -651,4 +635,4 @@ export default SSGINode;
651
635
  * @param {Camera} camera - The camera the scene is rendered with.
652
636
  * @returns {SSGINode}
653
637
  */
654
- export const ssgi = ( beautyNode, depthNode, normalNode, camera ) => nodeObject( new SSGINode( convertToTexture( beautyNode ), depthNode, normalNode, camera ) );
638
+ export const ssgi = ( beautyNode, depthNode, normalNode, camera ) => new SSGINode( convertToTexture( beautyNode ), depthNode, normalNode, camera );