From 3300ffde2d53fa66e4b6a9156023c2fa6cf3d025 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Wed, 31 Jan 2024 14:27:18 +0000
Subject: [PATCH 01/14] clipping

---
 examples/files.json                           |   1 +
 examples/jsm/nodes/accessors/ClippingNode.js  | 210 +++++++++++++
 examples/jsm/nodes/core/NodeBuilder.js        |   2 +
 examples/jsm/nodes/materials/NodeMaterial.js  |  29 ++
 .../jsm/renderers/common/ClippingContext.js   |  97 ++++++
 examples/jsm/renderers/common/RenderObject.js |  46 ++-
 .../jsm/renderers/common/RenderObjects.js     |  14 +-
 examples/jsm/renderers/common/Renderer.js     |  49 ++-
 examples/jsm/renderers/common/Uniform.js      |   7 +-
 .../jsm/renderers/common/UniformsGroup.js     |  24 +-
 examples/jsm/renderers/common/nodes/Nodes.js  |   1 +
 .../renderers/webgl/nodes/GLSLNodeBuilder.js  |  12 +-
 .../jsm/renderers/webgpu/WebGPUBackend.js     |   7 +-
 .../jsm/renderers/webgpu/WebGPURenderer.js    |   2 +-
 .../renderers/webgpu/nodes/WGSLNodeBuilder.js |  12 +-
 examples/screenshots/webgpu_clipping.jpg      | Bin 0 -> 22470 bytes
 examples/webgpu_clipping.html                 | 292 ++++++++++++++++++
 17 files changed, 781 insertions(+), 24 deletions(-)
 create mode 100644 examples/jsm/nodes/accessors/ClippingNode.js
 create mode 100644 examples/jsm/renderers/common/ClippingContext.js
 create mode 100644 examples/screenshots/webgpu_clipping.jpg
 create mode 100644 examples/webgpu_clipping.html

diff --git a/examples/files.json b/examples/files.json
index a912ac96fe03e4..12152d8fd7b153 100644
--- a/examples/files.json
+++ b/examples/files.json
@@ -321,6 +321,7 @@
 		"webgpu_backdrop_water",
 		"webgpu_camera_logarithmicdepthbuffer",
 		"webgpu_clearcoat",
+		"webgpu_clipping",
 		"webgpu_compute_audio",
 		"webgpu_compute_particles",
 		"webgpu_compute_particles_rain",
diff --git a/examples/jsm/nodes/accessors/ClippingNode.js b/examples/jsm/nodes/accessors/ClippingNode.js
new file mode 100644
index 00000000000000..eda576434bb0fd
--- /dev/null
+++ b/examples/jsm/nodes/accessors/ClippingNode.js
@@ -0,0 +1,210 @@
+
+import Node from '../core/Node.js';
+import { nodeObject } from '../shadernode/ShaderNode.js';
+import { positionView } from './PositionNode.js';
+import { diffuseColor, property } from '../core/PropertyNode.js';
+import { tslFn } from '../shadernode/ShaderNode.js';
+import { loop } from '../utils/LoopNode.js';
+import { smoothstep  } from '../math/MathNode.js';
+import { NodeUpdateType } from '../core/constants.js';
+import { Matrix3, Plane, Vector4 } from 'three';
+import { uniform } from '../core/UniformNode.js';
+
+const _plane = new Plane();
+const _viewNormalMatrix = new Matrix3();
+
+class ClippingNode extends Node {
+
+	constructor( scope = ClippingNode.DEFAULT ) {
+
+		super();
+
+		this.scope = scope;
+		this.updateType = NodeUpdateType.FRAME;
+		this.planes = [];
+
+	}
+
+	projectPlanes( source, offset, viewMatrix ) {
+
+		const l = source.length;
+		const planes = this.planes;
+
+		for ( let i = 0; i < l; i ++ ) {
+
+			_plane.copy( source[ i ] ).applyMatrix4( viewMatrix, _viewNormalMatrix );
+
+			const v = planes[ offset + i ];
+			const normal = _plane.normal;
+
+			v.x = - normal.x;
+			v.y = - normal.y;
+			v.z = - normal.z;
+			v.w = _plane.constant;
+
+		}
+
+	}
+
+	update( frame ) {
+
+		const viewMatrix = frame.camera.matrixWorldInverse;
+
+		_viewNormalMatrix.getNormalMatrix( viewMatrix );
+
+		const globalClippingPlanes = this._globalClippingPlanes;
+		const localClippingPlanes = this._localClippingPlanes;
+
+		const lg = globalClippingPlanes.length;
+		const ll = localClippingPlanes.length;
+
+		if ( lg > 0 ) this.projectPlanes( globalClippingPlanes, 0, viewMatrix );
+
+		if ( ll > 0 ) this.projectPlanes( localClippingPlanes, lg, viewMatrix );
+
+	}
+
+	setup( builder ) {
+
+		super.setup( builder );
+
+		const { localClippingEnabled, localClipIntersection } = builder.clippingContext;
+		const { localClippingCount, globalClippingCount } = builder.clippingContext;
+		const { globalClippingPlanes, localClippingPlanes } = builder.clippingContext;
+
+		this._globalClippingPlanes = globalClippingPlanes;
+		this._localClippingPlanes = localClippingEnabled ? localClippingPlanes : [];
+
+		const l = globalClippingCount + localClippingCount;
+
+		this._numClippingPlanes = l;
+		this._numUnionClippingPlanes = localClipIntersection ? l - localClippingCount : l;
+
+		for ( let i = 0; i < l; i ++ ) {
+
+			this.planes.push( new Vector4() );
+
+		}
+
+		if ( this.scope === ClippingNode.ALPHA_TO_COVERAGE ) {
+
+			this.setupAlphaToCoverage();
+
+		} else {
+
+			this.setupDefault();
+
+		}
+
+		return this.clippingNode;
+
+	}
+
+	setupAlphaToCoverage() {
+
+		const numClippingPlanes = this._numClippingPlanes;
+		const numUnionClippingPlanes = this._numUnionClippingPlanes;
+
+		this.clippingNode = tslFn( () => {
+
+			const clippingPlanes = uniform( this.planes, 'vec4' );
+
+			const distanceToPlane = property( 'float', 'distanceToPlane' );
+			const distanceGradient = property( 'float', 'distanceToGradient' );
+
+			const clipOpacity = property( 'float', 'clipOpacity' );
+
+			clipOpacity.assign( 1 );
+
+			let plane;
+
+			loop( numUnionClippingPlanes, ( { i } ) => {
+
+				plane = clippingPlanes.element( i );
+
+				distanceToPlane.assign( positionView.dot( plane.xyz ).negate().add( plane.w ) );
+				distanceGradient.assign( distanceToPlane.fwidth().div( 2.0 ) );
+
+				clipOpacity.mulAssign( smoothstep( distanceGradient.negate(), distanceGradient, distanceToPlane ) );
+
+				clipOpacity.equal( 0.0 ).discard();
+
+			} );
+
+			if ( numUnionClippingPlanes < numClippingPlanes ) {
+
+				const unionClipOpacity = property( 'float', 'unionclipOpacity' );
+
+				unionClipOpacity.assign( 1 );
+
+				loop( { start: numUnionClippingPlanes, end: numClippingPlanes }, ( { i } ) => {
+
+					plane = clippingPlanes.element( i );
+
+					distanceToPlane.assign( positionView.dot(  plane.xyz ).negate().add( plane.w ) );
+					distanceGradient.assign( distanceToPlane.fwidth().div( 2.0 ) );
+
+					unionClipOpacity.mulAssign( smoothstep( distanceGradient.negate(), distanceGradient, distanceToPlane ).oneMinus() );
+
+				} );
+
+				clipOpacity.mulAssign( unionClipOpacity.oneMinus() );
+
+			}
+
+			diffuseColor.a.mulAssign( clipOpacity );
+
+			diffuseColor.a.equal( 0.0 ).discard();
+
+		} )();
+
+	}
+
+	setupDefault() {
+
+		const numClippingPlanes = this._numClippingPlanes;
+		const numUnionClippingPlanes = this._numUnionClippingPlanes;
+
+		this.clippingNode = tslFn( () => {
+
+			const clippingPlanes = uniform( this.planes, 'vec4' );
+
+			let plane;
+
+			loop( numUnionClippingPlanes, ( { i } ) => {
+
+				plane = clippingPlanes.element( i );
+				positionView.dot( plane.xyz ).greaterThan( plane.w ).discard();
+
+			} );
+
+			if ( numUnionClippingPlanes < numClippingPlanes ) {
+
+				const clipped = property( 'bool', 'clipped' );
+
+				clipped.assign( true );
+
+				loop( { start: numUnionClippingPlanes, end: numClippingPlanes }, ( { i } ) => {
+
+					plane = clippingPlanes.element( i );
+					clipped.assign( positionView.dot( plane.xyz ).greaterThan( plane.w ).and( clipped ) );
+
+				} );
+
+				clipped.discard();
+			}
+
+		} )();
+
+	}
+
+}
+
+ClippingNode.ALPHA_TO_COVERAGE = 'alphaToCoverage';
+ClippingNode.DEFAULT = 'default';
+
+export default ClippingNode;
+
+export const clipping = () => nodeObject( new ClippingNode() );
+
+export const clippingAlpha = () => nodeObject( new ClippingNode( ClippingNode.ALPHA_TO_COVERAGE ) );
diff --git a/examples/jsm/nodes/core/NodeBuilder.js b/examples/jsm/nodes/core/NodeBuilder.js
index 4d0e90e37dfae4..6dd15892b96afc 100644
--- a/examples/jsm/nodes/core/NodeBuilder.js
+++ b/examples/jsm/nodes/core/NodeBuilder.js
@@ -72,6 +72,8 @@ class NodeBuilder {
 		this.fogNode = null;
 		this.toneMappingNode = null;
 
+		this.clippingContext = null;
+
 		this.vertexShader = null;
 		this.fragmentShader = null;
 		this.computeShader = null;
diff --git a/examples/jsm/nodes/materials/NodeMaterial.js b/examples/jsm/nodes/materials/NodeMaterial.js
index 325a08285e93b9..2c493fc3363744 100644
--- a/examples/jsm/nodes/materials/NodeMaterial.js
+++ b/examples/jsm/nodes/materials/NodeMaterial.js
@@ -19,6 +19,7 @@ import { lightingContext } from '../lighting/LightingContextNode.js';
 import EnvironmentNode from '../lighting/EnvironmentNode.js';
 import { depthPixel } from '../display/ViewportDepthNode.js';
 import { cameraLogDepth } from '../accessors/CameraNode.js';
+import { clipping, clippingAlpha } from '../accessors/ClippingNode.js';
 
 const NodeMaterials = new Map();
 
@@ -54,6 +55,7 @@ class NodeMaterial extends ShaderMaterial {
 
 		this.depthNode = null;
 		this.shadowNode = null;
+		this.clippingNode = null;
 
 		this.outputNode = null;
 
@@ -90,6 +92,8 @@ class NodeMaterial extends ShaderMaterial {
 
 		let resultNode;
 
+		this.setupClipping( builder );
+
 		if ( this.fragmentNode === null ) {
 
 			if ( this.depthWrite === true ) this.setupDepth( builder );
@@ -101,6 +105,8 @@ class NodeMaterial extends ShaderMaterial {
 
 			const outgoingLightNode = this.setupLighting( builder );
 
+			if ( this.clippingNode ) builder.stack.add( this.clippingNode );
+
 			resultNode = this.setupOutput( builder, vec4( outgoingLightNode, diffuseColor.a ) );
 
 			// OUTPUT NODE
@@ -123,6 +129,29 @@ class NodeMaterial extends ShaderMaterial {
 
 	}
 
+	setupClipping( builder ) {
+
+		const { globalClippingCount, localClippingCount, localClippingEnabled } = builder.clippingContext;
+
+		this.clippingNode = null;
+
+		if ( globalClippingCount || ( localClippingEnabled && localClippingCount > 0 ) ) {
+
+			if ( this.alphaToCoverage ) {
+
+				// to be added to flow when the color/alpha value has been determined
+				this.clippingNode = clippingAlpha();
+
+			} else {
+
+				builder.stack.add( clipping() );
+
+			}
+
+		}
+
+	}
+
 	setupDepth( builder ) {
 
 		const { renderer } = builder;
diff --git a/examples/jsm/renderers/common/ClippingContext.js b/examples/jsm/renderers/common/ClippingContext.js
new file mode 100644
index 00000000000000..afc96ba4f0ef20
--- /dev/null
+++ b/examples/jsm/renderers/common/ClippingContext.js
@@ -0,0 +1,97 @@
+let _clippingContextVersion = 0;
+
+class ClippingContext {
+
+	constructor() {
+
+		this.version = ++ _clippingContextVersion;
+
+		this.globalClippingPlanes = [];
+		this.globalClippingCount = 0;
+
+		this.localClippingEnabled = false;
+		this.localClippingPlanes = [];
+		this.localClippingCount = 0;
+
+		this.localClipIntersection = false;
+
+		this.parentVersion = 0;
+
+	}
+
+	inherit( parent ) {
+
+		if ( this === parent || parent.version === this.parentVersion ) return;
+
+		this.globalClippingPlanes = parent.globalClippingPlanes;
+		this.globalClippingCount = parent.globalClippingCount;
+		this.localClippingEnabled = parent.localClippingEnabled;
+        this.parentVersion = parent.version;
+
+		this.version = _clippingContextVersion ++;
+
+	}
+
+	updateGlobal( renderer ) {
+
+		let update = false;
+
+		if ( renderer.localClippingEnabled !== this.localClippingEnabled ) {
+
+			this.localClippingEnabled = renderer.localClippingEnabled;
+			update = true;
+
+		}
+
+		if ( renderer.clippingPlanes !== this.globalClippingPlanes && Array.isArray( renderer.clippingPlanes )) {
+
+			this.globalClippingPlanes = renderer.clippingPlanes;
+			this.globalClippingCount = this.globalClippingPlanes.length;
+			update = true;
+
+		} else if ( this.globalClippingPlanes.length !== this.globalClippingCount ) {
+
+			this.globalClippingCount = this.globalClippingPlanes.length;
+			update = true;
+
+		}
+
+		if ( update ) this.version = _clippingContextVersion ++;
+
+	}
+
+	updateMaterial( material ) {
+
+		let update = false;
+
+		if ( this.localClippingEnabled ) {
+
+			if ( material.clippingPlanes != this.localClippingPlanes && Array.isArray( material.clippingPlanes ) ) {
+
+				this.localClippingPlanes = material.clippingPlanes;
+				this.localClippingCount = this.localClippingPlanes.length;
+				update = true;
+
+			} else if ( this.localClippingCount !== this.localClippingPlanes.length ) {
+
+				this.localClippingCount = this.localClippingPlanes.length;
+				update = true;
+
+			}
+
+			if ( this.localClipIntersection !== material.clipIntersection ) {
+
+				this.localClipIntersection = material.clipIntersection;
+				update = true;
+
+			}
+
+			if ( update ) this.version = _clippingContextVersion ++;
+
+		}
+
+	}
+
+}
+
+export default ClippingContext;
diff --git a/examples/jsm/renderers/common/RenderObject.js b/examples/jsm/renderers/common/RenderObject.js
index 5372250b8bcadd..8bca34cf803c50 100644
--- a/examples/jsm/renderers/common/RenderObject.js
+++ b/examples/jsm/renderers/common/RenderObject.js
@@ -1,8 +1,10 @@
+import ClippingContext from "./ClippingContext.js";
+
 let id = 0;
 
 export default class RenderObject {
 
-	constructor( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext ) {
+	constructor( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext ) {
 
 		this._nodes = nodes;
 		this._geometries = geometries;
@@ -24,6 +26,10 @@ export default class RenderObject {
 		this.pipeline = null;
 		this.vertexBuffers = null;
 
+		this.updateClipping( clippingContext );
+
+		this.clippingContextVersion = this.clippingContext.version;
+
 		this.initialNodesCacheKey = this.getNodesCacheKey();
 		this.initialCacheKey = this.getCacheKey();
 
@@ -44,6 +50,42 @@ export default class RenderObject {
 
 	}
 
+	updateClipping( parent ) {
+
+		const material = this.material;
+
+		let clippingContext = this.clippingContext;
+
+		if ( Array.isArray( material.clippingPlanes ) ) {
+
+			if ( clippingContext === parent || ! clippingContext ) {
+
+				clippingContext = new ClippingContext();
+				this.clippingContext = clippingContext;
+
+			}
+
+			clippingContext.inherit( parent );
+			clippingContext.updateMaterial( material );
+
+		} else if ( this.clippingContext !== parent ) {
+
+			this.clippingContext = parent;
+
+		}
+
+	}
+
+	clippingNeedsUpdate () {
+
+		if ( this.clippingContext.version === this.clippingContextVersion ) return false;
+
+		this.clippingContextVersion = this.clippingContext.version;
+
+		return true;
+
+	}
+
 	getNodeBuilderState() {
 
 		return this._nodeBuilderState || ( this._nodeBuilderState = this._nodes.getForRender( this ) );
@@ -131,6 +173,8 @@ export default class RenderObject {
 
 		}
 
+		cacheKey += this.clippingContextVersion + ',';
+
 		if ( object.skeleton ) {
 
 			cacheKey += object.skeleton.uuid + ',';
diff --git a/examples/jsm/renderers/common/RenderObjects.js b/examples/jsm/renderers/common/RenderObjects.js
index f223c38a917af2..309cea3e0f3d98 100644
--- a/examples/jsm/renderers/common/RenderObjects.js
+++ b/examples/jsm/renderers/common/RenderObjects.js
@@ -16,7 +16,7 @@ class RenderObjects {
 
 	}
 
-	get( object, material, scene, camera, lightsNode, renderContext, passId ) {
+	get( object, material, scene, camera, lightsNode, renderContext, clippingContext, passId ) {
 
 		const chainMap = this.getChainMap( passId );
 		const chainArray = [ object, material, renderContext, lightsNode ];
@@ -25,19 +25,21 @@ class RenderObjects {
 
 		if ( renderObject === undefined ) {
 
-			renderObject = this.createRenderObject( this.nodes, this.geometries, this.renderer, object, material, scene, camera, lightsNode, renderContext, passId );
+			renderObject = this.createRenderObject( this.nodes, this.geometries, this.renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext, passId );
 
 			chainMap.set( chainArray, renderObject );
 
 		} else {
 
-			if ( renderObject.version !== material.version || renderObject.needsUpdate ) {
+			renderObject.updateClipping( clippingContext );
+
+			if ( renderObject.version !== material.version || renderObject.needsUpdate || renderObject.clippingNeedsUpdate() ) {
 
 				if ( renderObject.initialCacheKey !== renderObject.getCacheKey() ) {
 
 					renderObject.dispose();
 
-					renderObject = this.get( object, material, scene, camera, lightsNode, renderContext, passId );
+					renderObject = this.get( object, material, scene, camera, lightsNode, renderContext, clippingContext, passId );
 
 				} else {
 
@@ -65,11 +67,11 @@ class RenderObjects {
 
 	}
 
-	createRenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, passId ) {
+	createRenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext, passId ) {
 
 		const chainMap = this.getChainMap( passId );
 
-		const renderObject = new RenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext );
+		const renderObject = new RenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext );
 
 		renderObject.onDispose = () => {
 
diff --git a/examples/jsm/renderers/common/Renderer.js b/examples/jsm/renderers/common/Renderer.js
index 41a05a361664c6..a1509e59f30bd7 100644
--- a/examples/jsm/renderers/common/Renderer.js
+++ b/examples/jsm/renderers/common/Renderer.js
@@ -11,6 +11,7 @@ import Textures from './Textures.js';
 import Background from './Background.js';
 import Nodes from './nodes/Nodes.js';
 import Color4 from './Color4.js';
+import ClippingContext from './ClippingContext.js';
 import { Scene, Frustum, Matrix4, Vector2, Vector3, Vector4, DoubleSide, BackSide, FrontSide, SRGBColorSpace, NoToneMapping } from 'three';
 
 const _scene = new Scene();
@@ -58,6 +59,8 @@ class Renderer {
 		this.depth = true;
 		this.stencil = true;
 
+		this.clippingPlanes = [];
+
 		this.info = new Info();
 
 		// internals
@@ -161,6 +164,7 @@ class Renderer {
 			this._objects = new RenderObjects( this, this._nodes, this._geometries, this._pipelines, this._bindings, this.info );
 			this._renderLists = new RenderLists();
 			this._renderContexts = new RenderContexts();
+			this._clippingContext = new ClippingContext();
 
 			//
 
@@ -386,6 +390,8 @@ class Renderer {
 		renderContext.scissorValue.width >>= activeMipmapLevel;
 		renderContext.scissorValue.height >>= activeMipmapLevel;
 
+		this._clippingContext.updateGlobal( this );
+
 		//
 
 		sceneRef.onBeforeRender( this, scene, camera, renderTarget );
@@ -440,6 +446,7 @@ class Renderer {
 		renderContext.activeCubeFace = activeCubeFace;
 		renderContext.activeMipmapLevel = activeMipmapLevel;
 		renderContext.occlusionQueryCount = renderList.occlusionQueryCount;
+		renderContext.globalClippingCount = this.clippingPlanes !== null ? this.clippingPlanes.length: 0;
 
 		//
 
@@ -1107,10 +1114,42 @@ class Renderer {
 
 			}
 
-			if ( overrideMaterial.isShadowNodeMaterial && ( material.shadowNode && material.shadowNode.isNode ) ) {
+			if ( overrideMaterial.isShadowNodeMaterial ) {
+
+				overrideMaterial.side = material.shadowSide === null ? material.side : material.shadowSide;
+
+				if ( material.shadowNode && material.shadowNode.isNode ) {
+
+					overrideFragmentNode = overrideMaterial.fragmentNode;
+					overrideMaterial.fragmentNode = material.shadowNode;
+
+				}
+
+				if ( this.localClippingEnabled ) {
+
+					if ( material.clipShadows ) {
+
+						if ( overrideMaterial.clippingPlanes !== material.clippingPlanes ) {
+
+							overrideMaterial.clippingPlanes = material.clippingPlanes;
+							overrideMaterial.needsUpdate = true;
 
-				overrideFragmentNode = overrideMaterial.fragmentNode;
-				overrideMaterial.fragmentNode = material.shadowNode;
+						}
+
+						if ( overrideMaterial.clipIntersection !== material.clipIntersection ) {
+
+							overrideMaterial.clipIntersection = material.clipIntersection;
+
+						}
+
+					} else if ( Array.isArray( overrideMaterial.clippingPlanes ) ) {
+
+						overrideMaterial.clippingPlanes = null;
+						overrideMaterial.needsUpdate = true;
+
+					}
+
+				}
 
 			}
 
@@ -1158,7 +1197,7 @@ class Renderer {
 
 	_renderObjectDirect( object, material, scene, camera, lightsNode, passId ) {
 
-		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, passId );
+		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, this._clippingContext, passId );
 
 		//
 
@@ -1184,7 +1223,7 @@ class Renderer {
 
 	_createObjectPipeline( object, material, scene, camera, lightsNode, passId ) {
 
-		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, passId );
+		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, this._clippingContext, passId );
 
 		//
 
diff --git a/examples/jsm/renderers/common/Uniform.js b/examples/jsm/renderers/common/Uniform.js
index 4386d3e755e025..b90d375f864a5a 100644
--- a/examples/jsm/renderers/common/Uniform.js
+++ b/examples/jsm/renderers/common/Uniform.js
@@ -7,6 +7,8 @@ class Uniform {
 		this.name = name;
 		this.value = value;
 
+		this.isArray = value && Array.isArray( value );
+		this.itemCount = this.isArray ? this.value.length : 1;
 		this.boundary = 0; // used to build the uniform buffer according to the STD140 layout
 		this.itemSize = 0;
 
@@ -80,9 +82,8 @@ class Vector4Uniform extends Uniform {
 		super( name, value );
 
 		this.isVector4Uniform = true;
-
-		this.boundary = 16;
-		this.itemSize = 4;
+		this.boundary = this.itemCount * 16;
+		this.itemSize = this.itemCount * 4;
 
 	}
 
diff --git a/examples/jsm/renderers/common/UniformsGroup.js b/examples/jsm/renderers/common/UniformsGroup.js
index 21bb2cd33010f4..24ea9a021f6735 100644
--- a/examples/jsm/renderers/common/UniformsGroup.js
+++ b/examples/jsm/renderers/common/UniformsGroup.js
@@ -116,10 +116,11 @@ class UniformsGroup extends UniformBuffer {
 
 	updateByType( uniform ) {
 
+		if ( uniform.isArray ) return this.updateArray( uniform );
 		if ( uniform.isFloatUniform ) return this.updateNumber( uniform );
 		if ( uniform.isVector2Uniform ) return this.updateVector2( uniform );
 		if ( uniform.isVector3Uniform ) return this.updateVector3( uniform );
-		if ( uniform.isVector4Uniform ) return this.updateVector4( uniform );
+		if ( uniform.isVector4Uniform ) return this.updateVector4( uniform.getValue(), uniform.offset );
 		if ( uniform.isColorUniform ) return this.updateColor( uniform );
 		if ( uniform.isMatrix3Uniform ) return this.updateMatrix3( uniform );
 		if ( uniform.isMatrix4Uniform ) return this.updateMatrix4( uniform );
@@ -128,6 +129,23 @@ class UniformsGroup extends UniformBuffer {
 
 	}
 
+	updateArray( uniform ) {
+
+		const values = uniform.getValue();
+		const l = values.length;
+
+		let updated = false;
+
+		for ( let i = 0; i < l; i ++ ) {
+
+			if ( uniform.isVector4Uniform ) updated = this.updateVector4( values[ i ], uniform.offset + i * 4 ) || updated;
+
+		}
+
+		return updated;
+
+	}
+
 	updateNumber( uniform ) {
 
 		let updated = false;
@@ -190,13 +208,11 @@ class UniformsGroup extends UniformBuffer {
 
 	}
 
-	updateVector4( uniform ) {
+	updateVector4( v, offset ) {
 
 		let updated = false;
 
 		const a = this.buffer;
-		const v = uniform.getValue();
-		const offset = uniform.offset;
 
 		if ( a[ offset + 0 ] !== v.x || a[ offset + 1 ] !== v.y || a[ offset + 2 ] !== v.z || a[ offset + 4 ] !== v.w ) {
 
diff --git a/examples/jsm/renderers/common/nodes/Nodes.js b/examples/jsm/renderers/common/nodes/Nodes.js
index 2364ee5d9ceb59..5e217a3c705bdb 100644
--- a/examples/jsm/renderers/common/nodes/Nodes.js
+++ b/examples/jsm/renderers/common/nodes/Nodes.js
@@ -114,6 +114,7 @@ class Nodes extends DataMap {
 				nodeBuilder.environmentNode = this.getEnvironmentNode( renderObject.scene );
 				nodeBuilder.fogNode = this.getFogNode( renderObject.scene );
 				nodeBuilder.toneMappingNode = this.getToneMappingNode();
+				nodeBuilder.clippingContext = renderObject.clippingContext;
 				nodeBuilder.build();
 
 				nodeBuilderState = this._createNodeBuilderState( nodeBuilder );
diff --git a/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js b/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js
index 53088cdcca6cd2..ba7565c32bee22 100644
--- a/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js
+++ b/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js
@@ -328,7 +328,17 @@ ${ flowData.code }
 
 				const vectorType = this.getVectorType( uniform.type );
 
-				snippet = `${vectorType} ${uniform.name};`;
+				if ( Array.isArray( uniform.value ) === true ) {
+
+					const length = uniform.value.length;
+
+					snippet = `${vectorType} ${uniform.name}[${length}];`;
+
+				} else {
+
+					snippet = `${vectorType} ${uniform.name};`;
+
+				}
 
 				group = true;
 
diff --git a/examples/jsm/renderers/webgpu/WebGPUBackend.js b/examples/jsm/renderers/webgpu/WebGPUBackend.js
index 8a4686c2b9d535..ed56f7fa0bad21 100644
--- a/examples/jsm/renderers/webgpu/WebGPUBackend.js
+++ b/examples/jsm/renderers/webgpu/WebGPUBackend.js
@@ -929,7 +929,8 @@ class WebGPUBackend extends Backend {
 			data.side !== material.side || data.alphaToCoverage !== material.alphaToCoverage ||
 			data.sampleCount !== sampleCount || data.colorSpace !== colorSpace ||
 			data.colorFormat !== colorFormat || data.depthStencilFormat !== depthStencilFormat ||
-			data.primitiveTopology !== primitiveTopology
+			data.primitiveTopology !== primitiveTopology ||
+			data.clippingContextVersion !== renderObject.clippingContextVersion
 		) {
 
 			data.material = material; data.materialVersion = material.version;
@@ -947,6 +948,7 @@ class WebGPUBackend extends Backend {
 			data.colorFormat = colorFormat;
 			data.depthStencilFormat = depthStencilFormat;
 			data.primitiveTopology = primitiveTopology;
+			data.clippingContextVersion = renderObject.clippingContextVersion
 
 			needsUpdate = true;
 
@@ -975,7 +977,8 @@ class WebGPUBackend extends Backend {
 			material.side,
 			utils.getSampleCount( renderContext ),
 			utils.getCurrentColorSpace( renderContext ), utils.getCurrentColorFormat( renderContext ), utils.getCurrentDepthStencilFormat( renderContext ),
-			utils.getPrimitiveTopology( object, material )
+			utils.getPrimitiveTopology( object, material ),
+			renderObject.clippingContextVersion
 		].join();
 
 	}
diff --git a/examples/jsm/renderers/webgpu/WebGPURenderer.js b/examples/jsm/renderers/webgpu/WebGPURenderer.js
index c4360d78a88103..b33e26755416f4 100644
--- a/examples/jsm/renderers/webgpu/WebGPURenderer.js
+++ b/examples/jsm/renderers/webgpu/WebGPURenderer.js
@@ -23,7 +23,7 @@ class WebGPURenderer extends Renderer {
 
 		let BackendClass;
 
-		if ( parameters.forceWebGL ) {
+		if ( ! parameters.forceWebGL ) {
 
 			BackendClass = WebGLBackend;
 
diff --git a/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js b/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js
index a86e35580374dc..d102d2ce486133 100644
--- a/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js
+++ b/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js
@@ -783,7 +783,17 @@ ${ flowData.code }
 					snippets: []
 				} );
 
-				group.snippets.push( `\t${ uniform.name } : ${ vectorType }` );
+				if ( Array.isArray( uniform.value ) === true ) {
+
+					const length = uniform.value.length;
+
+					group.snippets.push( `\t${uniform.name} : array<${vectorType}, ${length}>` );
+
+				} else {
+
+					group.snippets.push( `\t${uniform.name} : ${ vectorType}` );
+
+				}
 
 			}
 
diff --git a/examples/screenshots/webgpu_clipping.jpg b/examples/screenshots/webgpu_clipping.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c02bb5bae6e92110c3a4c42157dc2b5c53fd0832
GIT binary patch
literal 22470
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

literal 0
HcmV?d00001

diff --git a/examples/webgpu_clipping.html b/examples/webgpu_clipping.html
new file mode 100644
index 00000000000000..768b5e401f3829
--- /dev/null
+++ b/examples/webgpu_clipping.html
@@ -0,0 +1,292 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<title>three.js webgpu - clipping planes</title>
+		<meta charset="utf-8">
+		<meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
+		<link type="text/css" rel="stylesheet" href="main.css">
+	</head>
+	<body>
+		<div id="info">
+			<a href="https://threejs.org" target="_blank" rel="noopener">three.js</a> webgpu - clipping
+		</div>
+		<script type="importmap">
+			{
+				"imports": {
+					"three": "../build/three.module.js",
+					"three/addons/": "./jsm/",
+					"three/nodes": "./jsm/nodes/Nodes.js"
+				}
+			}
+		</script>
+
+		<script type="module">
+
+			import * as THREE from 'three';
+			import { vec4, MeshPhongNodeMaterial } from 'three/nodes';
+
+			import WebGPU from 'three/addons/capabilities/WebGPU.js';
+			import WebGL from 'three/addons/capabilities/WebGL.js';
+
+			import WebGPURenderer from 'three/addons/renderers/webgpu/WebGPURenderer.js';
+
+			import Stats from 'three/addons/libs/stats.module.js';
+
+			import { GUI } from 'three/addons/libs/lil-gui.module.min.js';
+
+			import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
+
+			let camera, scene, renderer, startTime, object, stats;
+
+			init();
+			animate();
+
+			function init() {
+
+				if ( WebGPU.isAvailable() === false && WebGL.isWebGL2Available() === false ) {
+
+					document.body.appendChild( WebGPU.getErrorMessage() );
+
+					throw new Error( 'No WebGPU or WebGL2 support' );
+
+				}
+
+				camera = new THREE.PerspectiveCamera( 36, window.innerWidth / window.innerHeight, 0.25, 16 );
+
+				camera.position.set( 0, 1.3, 3 );
+
+				scene = new THREE.Scene();
+
+				// Lights
+
+				scene.add( new THREE.AmbientLight( 0xcccccc ) );
+
+				const spotLight = new THREE.SpotLight( 0xffffff, 60 );
+				spotLight.angle = Math.PI / 5;
+				spotLight.penumbra = 0.2;
+				spotLight.position.set( 2, 3, 3 );
+				spotLight.castShadow = true;
+				spotLight.shadow.camera.near = 3;
+				spotLight.shadow.camera.far = 10;
+				spotLight.shadow.mapSize.width = 2048;
+				spotLight.shadow.mapSize.height = 2048;
+				spotLight.shadow.bias = - 0.002;
+				spotLight.shadow.radius = 4;
+				scene.add( spotLight );
+
+				const dirLight = new THREE.DirectionalLight( 0x55505a, 3 );
+				dirLight.position.set( 0, 3, 0 );
+				dirLight.castShadow = true;
+				dirLight.shadow.camera.near = 1;
+				dirLight.shadow.camera.far = 10;
+
+				dirLight.shadow.camera.right = 1;
+				dirLight.shadow.camera.left = - 1;
+				dirLight.shadow.camera.top	= 1;
+				dirLight.shadow.camera.bottom = - 1;
+
+				dirLight.shadow.mapSize.width = 1024;
+				dirLight.shadow.mapSize.height = 1024;
+				scene.add( dirLight );
+
+				// ***** Clipping planes: *****
+
+				const localPlane = new THREE.Plane( new THREE.Vector3( 0, - 1, 0 ), 0.8 );
+				const localPlane2 = new THREE.Plane( new THREE.Vector3( 0, 0, -1 ), 0.1 );
+				const globalPlane = new THREE.Plane( new THREE.Vector3( - 1, 0, 0 ), 0.1 );
+
+				// Geometry
+
+				const material = new MeshPhongNodeMaterial( {
+					color: 0x80ee10,
+					shininess: 0,
+					side: THREE.DoubleSide,
+
+					// ***** Clipping setup (material): *****
+					clippingPlanes: [ localPlane, localPlane2 ],
+					clipShadows: true,
+					alphaToCoverage: true,
+					clipIntersection: true
+
+				} );
+
+				material.isClipping = true;
+				const geometry = new THREE.TorusKnotGeometry( 0.4, 0.08, 95, 20 );
+
+				object = new THREE.Mesh( geometry, material );
+				object.castShadow = true;
+				scene.add( object );
+
+				const ground = new THREE.Mesh(
+					new THREE.PlaneGeometry( 9, 9, 1, 1 ),
+					new MeshPhongNodeMaterial( { color: 0xa0adaf, shininess: 150 } )
+				);
+
+				ground.rotation.x = - Math.PI / 2; // rotates X/Y to X/Z
+				ground.receiveShadow = true;
+				scene.add( ground );
+
+				// Stats
+
+				stats = new Stats();
+				document.body.appendChild( stats.dom );
+
+				// Renderer
+
+				renderer = new WebGPURenderer( { antialias: true } );
+				renderer.shadowMap.enabled = true;
+				renderer.setPixelRatio( window.devicePixelRatio );
+				renderer.setSize( window.innerWidth, window.innerHeight );
+				window.addEventListener( 'resize', onWindowResize );
+				document.body.appendChild( renderer.domElement );
+
+				// ***** Clipping setup (renderer): *****
+				const globalPlanes = [ globalPlane ];
+				const Empty = Object.freeze( [] );
+
+				renderer.clippingPlanes = Empty; // GUI sets it to globalPlanes
+				renderer.localClippingEnabled = true;
+
+				// Controls
+
+				const controls = new OrbitControls( camera, renderer.domElement );
+				controls.target.set( 0, 1, 0 );
+				controls.update();
+
+				// GUI
+
+				const gui = new GUI(),
+					props = {
+						alphaToCoverage: false,
+					},
+					folderLocal = gui.addFolder( 'Local Clipping' ),
+					propsLocal = {
+
+						get 'Enabled'() {
+
+							return renderer.localClippingEnabled;
+
+						},
+						set 'Enabled'( v ) {
+
+							renderer.localClippingEnabled = v;
+
+						},
+
+						get 'Shadows'() {
+
+							return material.clipShadows;
+
+						},
+						set 'Shadows'( v ) {
+
+							material.clipShadows = v;
+
+						},
+
+						get 'Intersection'() {
+
+							return material.clipIntersection;
+
+						},
+
+						set 'Intersection'( v ) {
+
+							material.clipIntersection = v;
+
+						},
+
+						get 'Plane'() {
+
+							return localPlane.constant;
+
+						},
+						set 'Plane'( v ) {
+
+							localPlane.constant = v;
+
+						}
+
+					},
+
+					folderGlobal = gui.addFolder( 'Global Clipping' ),
+					propsGlobal = {
+
+						get 'Enabled'() {
+
+							return renderer.clippingPlanes !== Empty;
+
+						},
+						set 'Enabled'( v ) {
+
+							renderer.clippingPlanes = v ? globalPlanes : Empty;
+
+						},
+
+						get 'Plane'() {
+
+							return globalPlane.constant;
+
+						},
+						set 'Plane'( v ) {
+
+							globalPlane.constant = v;
+
+						}
+
+					};
+
+				gui.add( props, 'alphaToCoverage' ).onChange( function ( value ) {
+
+					ground.material.alphaToCoverage = value;
+					ground.material.needsUpdate = true;
+
+					material.alphaToCoverage = value;
+					material.needsUpdate = true;
+
+				} );
+
+				folderLocal.add( propsLocal, 'Enabled' );
+				folderLocal.add( propsLocal, 'Shadows' );
+				folderLocal.add( propsLocal, 'Intersection' );
+				folderLocal.add( propsLocal, 'Plane', 0.3, 1.25 );
+
+				folderGlobal.add( propsGlobal, 'Enabled' );
+				folderGlobal.add( propsGlobal, 'Plane', - 0.4, 3 );
+
+				// Start
+
+				startTime = Date.now();
+
+			}
+
+			function onWindowResize() {
+
+				camera.aspect = window.innerWidth / window.innerHeight;
+				camera.updateProjectionMatrix();
+
+				renderer.setSize( window.innerWidth, window.innerHeight );
+
+			}
+
+			function animate( currentTime ) {
+
+				const time = ( currentTime - startTime ) / 1000;
+
+				requestAnimationFrame( animate );
+
+				object.position.y = 0.8;
+				object.rotation.x = time * 0.5;
+				object.rotation.y = time * 0.2;
+				object.scale.setScalar( Math.cos( time ) * 0.125 + 0.875 );
+
+				stats.begin();
+				renderer.render( scene, camera );
+				stats.end();
+
+			}
+
+		</script>
+
+	</body>
+</html>

From 8036ee7031ed9cdbaacde01b3e408dc240c7d659 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Tue, 6 Feb 2024 09:33:29 +0000
Subject: [PATCH 02/14] add ;

---
 examples/jsm/renderers/webgpu/WebGPUBackend.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/jsm/renderers/webgpu/WebGPUBackend.js b/examples/jsm/renderers/webgpu/WebGPUBackend.js
index ed56f7fa0bad21..56c8548a6a6632 100644
--- a/examples/jsm/renderers/webgpu/WebGPUBackend.js
+++ b/examples/jsm/renderers/webgpu/WebGPUBackend.js
@@ -948,7 +948,7 @@ class WebGPUBackend extends Backend {
 			data.colorFormat = colorFormat;
 			data.depthStencilFormat = depthStencilFormat;
 			data.primitiveTopology = primitiveTopology;
-			data.clippingContextVersion = renderObject.clippingContextVersion
+			data.clippingContextVersion = renderObject.clippingContextVersion;
 
 			needsUpdate = true;
 

From b0f76fdcc97366b2f3706e4fe4f9ec2c260b0c66 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Tue, 6 Feb 2024 10:57:04 +0000
Subject: [PATCH 03/14] remove testing code

---
 examples/jsm/renderers/webgpu/WebGPURenderer.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/jsm/renderers/webgpu/WebGPURenderer.js b/examples/jsm/renderers/webgpu/WebGPURenderer.js
index b33e26755416f4..c4360d78a88103 100644
--- a/examples/jsm/renderers/webgpu/WebGPURenderer.js
+++ b/examples/jsm/renderers/webgpu/WebGPURenderer.js
@@ -23,7 +23,7 @@ class WebGPURenderer extends Renderer {
 
 		let BackendClass;
 
-		if ( ! parameters.forceWebGL ) {
+		if ( parameters.forceWebGL ) {
 
 			BackendClass = WebGLBackend;
 

From 6f1752d80bb314adb11ead97568c1f508607f8fb Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Tue, 6 Feb 2024 11:20:50 +0000
Subject: [PATCH 04/14] cleanup and adjust default settiing in example

---
 examples/jsm/nodes/materials/NodeMaterial.js | 11 ++++++-----
 examples/webgpu_clipping.html                |  2 +-
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/examples/jsm/nodes/materials/NodeMaterial.js b/examples/jsm/nodes/materials/NodeMaterial.js
index 2c493fc3363744..59cae53cdd4bb4 100644
--- a/examples/jsm/nodes/materials/NodeMaterial.js
+++ b/examples/jsm/nodes/materials/NodeMaterial.js
@@ -55,7 +55,6 @@ class NodeMaterial extends ShaderMaterial {
 
 		this.depthNode = null;
 		this.shadowNode = null;
-		this.clippingNode = null;
 
 		this.outputNode = null;
 
@@ -92,7 +91,7 @@ class NodeMaterial extends ShaderMaterial {
 
 		let resultNode;
 
-		this.setupClipping( builder );
+		const clippingNode = this.setupClipping( builder );
 
 		if ( this.fragmentNode === null ) {
 
@@ -105,7 +104,7 @@ class NodeMaterial extends ShaderMaterial {
 
 			const outgoingLightNode = this.setupLighting( builder );
 
-			if ( this.clippingNode ) builder.stack.add( this.clippingNode );
+			if ( clippingNode !== null ) builder.stack.add( clippingNode );
 
 			resultNode = this.setupOutput( builder, vec4( outgoingLightNode, diffuseColor.a ) );
 
@@ -133,14 +132,14 @@ class NodeMaterial extends ShaderMaterial {
 
 		const { globalClippingCount, localClippingCount, localClippingEnabled } = builder.clippingContext;
 
-		this.clippingNode = null;
+		let result = null;
 
 		if ( globalClippingCount || ( localClippingEnabled && localClippingCount > 0 ) ) {
 
 			if ( this.alphaToCoverage ) {
 
 				// to be added to flow when the color/alpha value has been determined
-				this.clippingNode = clippingAlpha();
+				result = clippingAlpha();
 
 			} else {
 
@@ -150,6 +149,8 @@ class NodeMaterial extends ShaderMaterial {
 
 		}
 
+		return result;
+
 	}
 
 	setupDepth( builder ) {
diff --git a/examples/webgpu_clipping.html b/examples/webgpu_clipping.html
index 768b5e401f3829..0d71c4244d39a6 100644
--- a/examples/webgpu_clipping.html
+++ b/examples/webgpu_clipping.html
@@ -157,7 +157,7 @@
 
 				const gui = new GUI(),
 					props = {
-						alphaToCoverage: false,
+						alphaToCoverage: true,
 					},
 					folderLocal = gui.addFolder( 'Local Clipping' ),
 					propsLocal = {

From db465a72c701a103068cf28c018791a68c5e3253 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Tue, 6 Feb 2024 11:25:08 +0000
Subject: [PATCH 05/14] remove unused import

---
 examples/webgpu_clipping.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/webgpu_clipping.html b/examples/webgpu_clipping.html
index 0d71c4244d39a6..06b8c6eb94afaa 100644
--- a/examples/webgpu_clipping.html
+++ b/examples/webgpu_clipping.html
@@ -23,7 +23,7 @@
 		<script type="module">
 
 			import * as THREE from 'three';
-			import { vec4, MeshPhongNodeMaterial } from 'three/nodes';
+			import { MeshPhongNodeMaterial } from 'three/nodes';
 
 			import WebGPU from 'three/addons/capabilities/WebGPU.js';
 			import WebGL from 'three/addons/capabilities/WebGL.js';

From cbea4ed24036378d6b621e029f13e90e7d305d36 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Tue, 6 Feb 2024 12:06:07 +0000
Subject: [PATCH 06/14] cleanup ClippingNode

---
 examples/jsm/nodes/accessors/ClippingNode.js | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/examples/jsm/nodes/accessors/ClippingNode.js b/examples/jsm/nodes/accessors/ClippingNode.js
index eda576434bb0fd..00d9dcf25f2dfd 100644
--- a/examples/jsm/nodes/accessors/ClippingNode.js
+++ b/examples/jsm/nodes/accessors/ClippingNode.js
@@ -88,16 +88,14 @@ class ClippingNode extends Node {
 
 		if ( this.scope === ClippingNode.ALPHA_TO_COVERAGE ) {
 
-			this.setupAlphaToCoverage();
+			return this.setupAlphaToCoverage();
 
 		} else {
 
-			this.setupDefault();
+			return this.setupDefault();
 
 		}
 
-		return this.clippingNode;
-
 	}
 
 	setupAlphaToCoverage() {
@@ -105,7 +103,7 @@ class ClippingNode extends Node {
 		const numClippingPlanes = this._numClippingPlanes;
 		const numUnionClippingPlanes = this._numUnionClippingPlanes;
 
-		this.clippingNode = tslFn( () => {
+		return tslFn( () => {
 
 			const clippingPlanes = uniform( this.planes, 'vec4' );
 
@@ -165,7 +163,7 @@ class ClippingNode extends Node {
 		const numClippingPlanes = this._numClippingPlanes;
 		const numUnionClippingPlanes = this._numUnionClippingPlanes;
 
-		this.clippingNode = tslFn( () => {
+		return tslFn( () => {
 
 			const clippingPlanes = uniform( this.planes, 'vec4' );
 

From 88fb72cceff27e63bfd6b1c306c0e173d6febac7 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Tue, 6 Feb 2024 21:35:46 +0000
Subject: [PATCH 07/14] combine methods

---
 .../jsm/renderers/common/ClippingContext.js   | 29 +++++++++----------
 examples/jsm/renderers/common/RenderObject.js |  3 +-
 2 files changed, 14 insertions(+), 18 deletions(-)

diff --git a/examples/jsm/renderers/common/ClippingContext.js b/examples/jsm/renderers/common/ClippingContext.js
index afc96ba4f0ef20..2b270c170cad3d 100644
--- a/examples/jsm/renderers/common/ClippingContext.js
+++ b/examples/jsm/renderers/common/ClippingContext.js
@@ -19,19 +19,6 @@ class ClippingContext {
 
 	}
 
-	inherit( parent ) {
-
-		if ( this === parent || parent.version === this.parentVersion ) return;
-
-		this.globalClippingPlanes = parent.globalClippingPlanes;
-		this.globalClippingCount = parent.globalClippingCount;
-		this.localClippingEnabled = parent.localClippingEnabled;
-        this.parentVersion = parent.version;
-
-		this.version = _clippingContextVersion ++;
-
-	}
-
 	updateGlobal( renderer ) {
 
 		let update = false;
@@ -60,10 +47,20 @@ class ClippingContext {
 
 	}
 
-	updateMaterial( material ) {
+	update( parent, material ) {
 
 		let update = false;
 
+		if ( this !== parent && parent.version !== this.parentVersion ) {
+
+			this.globalClippingPlanes = parent.globalClippingPlanes;
+			this.globalClippingCount = parent.globalClippingCount;
+			this.localClippingEnabled = parent.localClippingEnabled;
+   	    	this.parentVersion = parent.version;
+			update = true;
+
+		}
+
 		if ( this.localClippingEnabled ) {
 
 			if ( material.clippingPlanes != this.localClippingPlanes && Array.isArray( material.clippingPlanes ) ) {
@@ -86,10 +83,10 @@ class ClippingContext {
 
 			}
 
-			if ( update ) this.version = _clippingContextVersion ++;
-
 		}
 
+		if ( update ) this.version = _clippingContextVersion ++;
+
 	}
 
 }
diff --git a/examples/jsm/renderers/common/RenderObject.js b/examples/jsm/renderers/common/RenderObject.js
index 8bca34cf803c50..26f075072ab6fc 100644
--- a/examples/jsm/renderers/common/RenderObject.js
+++ b/examples/jsm/renderers/common/RenderObject.js
@@ -65,8 +65,7 @@ export default class RenderObject {
 
 			}
 
-			clippingContext.inherit( parent );
-			clippingContext.updateMaterial( material );
+			clippingContext.update( parent, material );
 
 		} else if ( this.clippingContext !== parent ) {
 

From a6522ad9a36a30b83aafea608e3301bea2c1a5a4 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Wed, 7 Feb 2024 21:35:35 +0000
Subject: [PATCH 08/14] rework to increase efficiency

---
 examples/jsm/nodes/accessors/ClippingNode.js  |  73 ++---------
 examples/jsm/nodes/materials/NodeMaterial.js  |   4 +-
 .../jsm/renderers/common/ClippingContext.js   | 115 ++++++++++++++----
 examples/jsm/renderers/common/RenderObject.js |   4 +-
 .../jsm/renderers/common/RenderObjects.js     |  12 +-
 examples/jsm/renderers/common/Renderer.js     |   6 +-
 examples/webgpu_clipping.html                 |   1 -
 7 files changed, 114 insertions(+), 101 deletions(-)

diff --git a/examples/jsm/nodes/accessors/ClippingNode.js b/examples/jsm/nodes/accessors/ClippingNode.js
index 00d9dcf25f2dfd..1ffe3aab9f942f 100644
--- a/examples/jsm/nodes/accessors/ClippingNode.js
+++ b/examples/jsm/nodes/accessors/ClippingNode.js
@@ -6,13 +6,8 @@ import { diffuseColor, property } from '../core/PropertyNode.js';
 import { tslFn } from '../shadernode/ShaderNode.js';
 import { loop } from '../utils/LoopNode.js';
 import { smoothstep  } from '../math/MathNode.js';
-import { NodeUpdateType } from '../core/constants.js';
-import { Matrix3, Plane, Vector4 } from 'three';
 import { uniform } from '../core/UniformNode.js';
 
-const _plane = new Plane();
-const _viewNormalMatrix = new Matrix3();
-
 class ClippingNode extends Node {
 
 	constructor( scope = ClippingNode.DEFAULT ) {
@@ -20,47 +15,6 @@ class ClippingNode extends Node {
 		super();
 
 		this.scope = scope;
-		this.updateType = NodeUpdateType.FRAME;
-		this.planes = [];
-
-	}
-
-	projectPlanes( source, offset, viewMatrix ) {
-
-		const l = source.length;
-		const planes = this.planes;
-
-		for ( let i = 0; i < l; i ++ ) {
-
-			_plane.copy( source[ i ] ).applyMatrix4( viewMatrix, _viewNormalMatrix );
-
-			const v = planes[ offset + i ];
-			const normal = _plane.normal;
-
-			v.x = - normal.x;
-			v.y = - normal.y;
-			v.z = - normal.z;
-			v.w = _plane.constant;
-
-		}
-
-	}
-
-	update( frame ) {
-
-		const viewMatrix = frame.camera.matrixWorldInverse;
-
-		_viewNormalMatrix.getNormalMatrix( viewMatrix );
-
-		const globalClippingPlanes = this._globalClippingPlanes;
-		const localClippingPlanes = this._localClippingPlanes;
-
-		const lg = globalClippingPlanes.length;
-		const ll = localClippingPlanes.length;
-
-		if ( lg > 0 ) this.projectPlanes( globalClippingPlanes, 0, viewMatrix );
-
-		if ( ll > 0 ) this.projectPlanes( localClippingPlanes, lg, viewMatrix );
 
 	}
 
@@ -68,44 +22,33 @@ class ClippingNode extends Node {
 
 		super.setup( builder );
 
-		const { localClippingEnabled, localClipIntersection } = builder.clippingContext;
-		const { localClippingCount, globalClippingCount } = builder.clippingContext;
-		const { globalClippingPlanes, localClippingPlanes } = builder.clippingContext;
-
-		this._globalClippingPlanes = globalClippingPlanes;
-		this._localClippingPlanes = localClippingEnabled ? localClippingPlanes : [];
-
+		const clippingContext = builder.clippingContext;
+		const { localClipIntersection, localClippingCount, globalClippingCount } = clippingContext;
 		const l = globalClippingCount + localClippingCount;
 
 		this._numClippingPlanes = l;
 		this._numUnionClippingPlanes = localClipIntersection ? l - localClippingCount : l;
 
-		for ( let i = 0; i < l; i ++ ) {
-
-			this.planes.push( new Vector4() );
-
-		}
-
 		if ( this.scope === ClippingNode.ALPHA_TO_COVERAGE ) {
 
-			return this.setupAlphaToCoverage();
+			return this.setupAlphaToCoverage( clippingContext );
 
 		} else {
 
-			return this.setupDefault();
+			return this.setupDefault( clippingContext );
 
 		}
 
 	}
 
-	setupAlphaToCoverage() {
+	setupAlphaToCoverage( clippingContext ) {
 
 		const numClippingPlanes = this._numClippingPlanes;
 		const numUnionClippingPlanes = this._numUnionClippingPlanes;
 
 		return tslFn( () => {
 
-			const clippingPlanes = uniform( this.planes, 'vec4' );
+			const clippingPlanes = uniform( clippingContext.planes, 'vec4' );
 
 			const distanceToPlane = property( 'float', 'distanceToPlane' );
 			const distanceGradient = property( 'float', 'distanceToGradient' );
@@ -158,14 +101,14 @@ class ClippingNode extends Node {
 
 	}
 
-	setupDefault() {
+	setupDefault( clippingContext ) {
 
 		const numClippingPlanes = this._numClippingPlanes;
 		const numUnionClippingPlanes = this._numUnionClippingPlanes;
 
 		return tslFn( () => {
 
-			const clippingPlanes = uniform( this.planes, 'vec4' );
+			const clippingPlanes = uniform( clippingContext.planes, 'vec4' );
 
 			let plane;
 
diff --git a/examples/jsm/nodes/materials/NodeMaterial.js b/examples/jsm/nodes/materials/NodeMaterial.js
index 59cae53cdd4bb4..dbe5d6c596ccaa 100644
--- a/examples/jsm/nodes/materials/NodeMaterial.js
+++ b/examples/jsm/nodes/materials/NodeMaterial.js
@@ -130,11 +130,11 @@ class NodeMaterial extends ShaderMaterial {
 
 	setupClipping( builder ) {
 
-		const { globalClippingCount, localClippingCount, localClippingEnabled } = builder.clippingContext;
+		const { globalClippingCount, localClippingCount } = builder.clippingContext;
 
 		let result = null;
 
-		if ( globalClippingCount || ( localClippingEnabled && localClippingCount > 0 ) ) {
+		if ( globalClippingCount || localClippingCount ) {
 
 			if ( this.alphaToCoverage ) {
 
diff --git a/examples/jsm/renderers/common/ClippingContext.js b/examples/jsm/renderers/common/ClippingContext.js
index 2b270c170cad3d..dc71eb8c471996 100644
--- a/examples/jsm/renderers/common/ClippingContext.js
+++ b/examples/jsm/renderers/common/ClippingContext.js
@@ -1,3 +1,8 @@
+import { Matrix3, Plane, Vector4 } from 'three';
+
+const _plane = new Plane();
+const _viewNormalMatrix = new Matrix3();
+
 let _clippingContextVersion = 0;
 
 class ClippingContext {
@@ -6,39 +11,82 @@ class ClippingContext {
 
 		this.version = ++ _clippingContextVersion;
 
-		this.globalClippingPlanes = [];
 		this.globalClippingCount = 0;
 
-		this.localClippingEnabled = false;
-		this.localClippingPlanes = [];
 		this.localClippingCount = 0;
-
+		this.localClippingEnabled = false;
 		this.localClipIntersection = false;
 
+		this.planes = [];
+
 		this.parentVersion = 0;
 
 	}
 
-	updateGlobal( renderer ) {
+	projectPlanes( source, offset ) {
 
-		let update = false;
+		const l = source.length;
+		const planes = this.planes;
 
-		if ( renderer.localClippingEnabled !== this.localClippingEnabled ) {
+		_viewNormalMatrix.getNormalMatrix( this.viewMatrix );
 
-			this.localClippingEnabled = renderer.localClippingEnabled;
-			update = true;
+		for ( let i = 0; i < l; i ++ ) {
+
+			_plane.copy( source[ i ] ).applyMatrix4( this.viewMatrix, _viewNormalMatrix );
+
+			const v = planes[ offset + i ];
+			const normal = _plane.normal;
+
+			v.x = - normal.x;
+			v.y = - normal.y;
+			v.z = - normal.z;
+			v.w = _plane.constant;
 
 		}
 
-		if ( renderer.clippingPlanes !== this.globalClippingPlanes && Array.isArray( renderer.clippingPlanes )) {
+	}
+
+	updateGlobal( renderer, camera ) {
+
+		const rendererClippingPlanes = renderer.clippingPlanes;
+		this.viewMatrix = camera.matrixWorldInverse;
+
+		let update = false;
+
+		if ( Array.isArray( rendererClippingPlanes ) && rendererClippingPlanes.length !== 0 ) {
+
+			const l = rendererClippingPlanes.length;
+
+			if ( l !== this.globalClippingCount ) {
+
+				const planes = [];
+
+				for ( let i = 0; i < l; i ++ ) {
+
+					planes.push( new Vector4() );
+
+				}
 
-			this.globalClippingPlanes = renderer.clippingPlanes;
-			this.globalClippingCount = this.globalClippingPlanes.length;
+				this.globalClippingCount = l;
+				this.planes = planes;
+
+				update = true;
+
+			}
+
+			this.projectPlanes( rendererClippingPlanes, 0 );
+
+		} else if ( this.globalClippingCount !== 0 ) {
+
+			this.globalClippingCount = 0;
+			this.planes = [];
 			update = true;
 
-		} else if ( this.globalClippingPlanes.length !== this.globalClippingCount ) {
+		}
+
+		if ( renderer.localClippingEnabled !== this.localClippingEnabled ) {
 
-			this.globalClippingCount = this.globalClippingPlanes.length;
+			this.localClippingEnabled = renderer.localClippingEnabled;
 			update = true;
 
 		}
@@ -53,25 +101,48 @@ class ClippingContext {
 
 		if ( this !== parent && parent.version !== this.parentVersion ) {
 
-			this.globalClippingPlanes = parent.globalClippingPlanes;
-			this.globalClippingCount = parent.globalClippingCount;
+			this.globalClippingCount =  material.isShadowNodeMaterial ? 0 : parent.globalClippingCount;
 			this.localClippingEnabled = parent.localClippingEnabled;
+			this.planes = Array.from( parent.planes );
    	    	this.parentVersion = parent.version;
+			this.viewMatrix = parent.viewMatrix;
+
+
 			update = true;
 
 		}
 
 		if ( this.localClippingEnabled ) {
 
-			if ( material.clippingPlanes != this.localClippingPlanes && Array.isArray( material.clippingPlanes ) ) {
+			const localClippingPlanes = material.clippingPlanes;
+
+			if ( ( Array.isArray( localClippingPlanes ) && localClippingPlanes.length !== 0 ) ) {
+
+				const l = localClippingPlanes.length;
+				const planes = this.planes;
+				const offset = this.globalClippingCount;
+
+				if ( update || l !== this.localClippingCount ) {
+
+					planes.length = offset + l;
+
+					for ( let i = 0; i < l; i ++ ) {
+
+						planes[ offset + i ] = new Vector4();
+
+					}
+
+					this.localClippingCount = l;
+					update = true;
+
+				}
+
+				this.projectPlanes( localClippingPlanes, offset );
 
-				this.localClippingPlanes = material.clippingPlanes;
-				this.localClippingCount = this.localClippingPlanes.length;
-				update = true;
 
-			} else if ( this.localClippingCount !== this.localClippingPlanes.length ) {
+			} else if ( this.localClippingCount !== 0 ) {
 
-				this.localClippingCount = this.localClippingPlanes.length;
+				this.localClippingCount = 0;
 				update = true;
 
 			}
diff --git a/examples/jsm/renderers/common/RenderObject.js b/examples/jsm/renderers/common/RenderObject.js
index 26f075072ab6fc..2f0c0872444d41 100644
--- a/examples/jsm/renderers/common/RenderObject.js
+++ b/examples/jsm/renderers/common/RenderObject.js
@@ -4,7 +4,7 @@ let id = 0;
 
 export default class RenderObject {
 
-	constructor( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext ) {
+	constructor( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext ) {
 
 		this._nodes = nodes;
 		this._geometries = geometries;
@@ -26,7 +26,7 @@ export default class RenderObject {
 		this.pipeline = null;
 		this.vertexBuffers = null;
 
-		this.updateClipping( clippingContext );
+		this.updateClipping( renderContext.clippingContext );
 
 		this.clippingContextVersion = this.clippingContext.version;
 
diff --git a/examples/jsm/renderers/common/RenderObjects.js b/examples/jsm/renderers/common/RenderObjects.js
index 309cea3e0f3d98..e4bd3222cde20f 100644
--- a/examples/jsm/renderers/common/RenderObjects.js
+++ b/examples/jsm/renderers/common/RenderObjects.js
@@ -16,7 +16,7 @@ class RenderObjects {
 
 	}
 
-	get( object, material, scene, camera, lightsNode, renderContext, clippingContext, passId ) {
+	get( object, material, scene, camera, lightsNode, renderContext, passId ) {
 
 		const chainMap = this.getChainMap( passId );
 		const chainArray = [ object, material, renderContext, lightsNode ];
@@ -25,13 +25,13 @@ class RenderObjects {
 
 		if ( renderObject === undefined ) {
 
-			renderObject = this.createRenderObject( this.nodes, this.geometries, this.renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext, passId );
+			renderObject = this.createRenderObject( this.nodes, this.geometries, this.renderer, object, material, scene, camera, lightsNode, renderContext, passId );
 
 			chainMap.set( chainArray, renderObject );
 
 		} else {
 
-			renderObject.updateClipping( clippingContext );
+			renderObject.updateClipping( renderContext.clippingContext );
 
 			if ( renderObject.version !== material.version || renderObject.needsUpdate || renderObject.clippingNeedsUpdate() ) {
 
@@ -39,7 +39,7 @@ class RenderObjects {
 
 					renderObject.dispose();
 
-					renderObject = this.get( object, material, scene, camera, lightsNode, renderContext, clippingContext, passId );
+					renderObject = this.get( object, material, scene, camera, lightsNode, renderContext, passId );
 
 				} else {
 
@@ -67,11 +67,11 @@ class RenderObjects {
 
 	}
 
-	createRenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext, passId ) {
+	createRenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, passId ) {
 
 		const chainMap = this.getChainMap( passId );
 
-		const renderObject = new RenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext, clippingContext );
+		const renderObject = new RenderObject( nodes, geometries, renderer, object, material, scene, camera, lightsNode, renderContext );
 
 		renderObject.onDispose = () => {
 
diff --git a/examples/jsm/renderers/common/Renderer.js b/examples/jsm/renderers/common/Renderer.js
index a1509e59f30bd7..19f4317af18634 100644
--- a/examples/jsm/renderers/common/Renderer.js
+++ b/examples/jsm/renderers/common/Renderer.js
@@ -390,7 +390,8 @@ class Renderer {
 		renderContext.scissorValue.width >>= activeMipmapLevel;
 		renderContext.scissorValue.height >>= activeMipmapLevel;
 
-		this._clippingContext.updateGlobal( this );
+		if ( ! renderContext.clippingContext ) renderContext.clippingContext = new ClippingContext();
+		renderContext.clippingContext.updateGlobal( this, camera );
 
 		//
 
@@ -446,7 +447,6 @@ class Renderer {
 		renderContext.activeCubeFace = activeCubeFace;
 		renderContext.activeMipmapLevel = activeMipmapLevel;
 		renderContext.occlusionQueryCount = renderList.occlusionQueryCount;
-		renderContext.globalClippingCount = this.clippingPlanes !== null ? this.clippingPlanes.length: 0;
 
 		//
 
@@ -1197,7 +1197,7 @@ class Renderer {
 
 	_renderObjectDirect( object, material, scene, camera, lightsNode, passId ) {
 
-		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, this._clippingContext, passId );
+		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, passId );
 
 		//
 
diff --git a/examples/webgpu_clipping.html b/examples/webgpu_clipping.html
index 06b8c6eb94afaa..b672ca06485ebe 100644
--- a/examples/webgpu_clipping.html
+++ b/examples/webgpu_clipping.html
@@ -148,7 +148,6 @@
 				renderer.localClippingEnabled = true;
 
 				// Controls
-
 				const controls = new OrbitControls( camera, renderer.domElement );
 				controls.target.set( 0, 1, 0 );
 				controls.update();

From 9a6a2bb36eaefa2237d8b8df3c8a7c6730ae3bfe Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Thu, 8 Feb 2024 11:19:32 +0000
Subject: [PATCH 09/14] update screenshot

---
 examples/screenshots/webgpu_clipping.jpg | Bin 22470 -> 22464 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/examples/screenshots/webgpu_clipping.jpg b/examples/screenshots/webgpu_clipping.jpg
index c02bb5bae6e92110c3a4c42157dc2b5c53fd0832..e93b3c0f398d17658c8993bd8a41852e7a1fd175 100644
GIT binary patch
delta 19918
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
Nm>>5D;zG%Xe*imi)gJ%=

delta 19860
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
UfszRyoM`ekRxG|^*+T#S08wb(%m4rY


From 3ca3fb399f24e16788cc1cfd391c234dc69fc183 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Thu, 8 Feb 2024 11:41:52 +0000
Subject: [PATCH 10/14] fix asyncCompile

---
 examples/jsm/renderers/common/Renderer.js | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/examples/jsm/renderers/common/Renderer.js b/examples/jsm/renderers/common/Renderer.js
index 19f4317af18634..0c7c8a05195565 100644
--- a/examples/jsm/renderers/common/Renderer.js
+++ b/examples/jsm/renderers/common/Renderer.js
@@ -227,6 +227,9 @@ class Renderer {
 		renderContext.depth = this.depth;
 		renderContext.stencil = this.stencil;
 
+		if ( ! renderContext.clippingContext ) renderContext.clippingContext = new ClippingContext();
+		renderContext.clippingContext.updateGlobal( this, camera );
+
 		//
 
 		sceneRef.onBeforeRender( this, scene, camera, renderTarget );
@@ -1223,7 +1226,7 @@ class Renderer {
 
 	_createObjectPipeline( object, material, scene, camera, lightsNode, passId ) {
 
-		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, this._clippingContext, passId );
+		const renderObject = this._objects.get( object, material, scene, camera, lightsNode, this._currentRenderContext, passId );
 
 		//
 

From 93dc5a217d7b0801ce2b5bd18316057ee43b3463 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Thu, 8 Feb 2024 14:07:53 +0000
Subject: [PATCH 11/14] fix against upstream

---
 examples/jsm/nodes/accessors/ClippingNode.js  |  6 ++---
 examples/jsm/renderers/common/Uniform.js      |  7 +++---
 .../jsm/renderers/common/UniformsGroup.js     | 24 ++++---------------
 .../renderers/webgl/nodes/GLSLNodeBuilder.js  | 12 +---------
 .../renderers/webgpu/nodes/WGSLNodeBuilder.js | 12 +---------
 5 files changed, 12 insertions(+), 49 deletions(-)

diff --git a/examples/jsm/nodes/accessors/ClippingNode.js b/examples/jsm/nodes/accessors/ClippingNode.js
index 1ffe3aab9f942f..ba028108fa7605 100644
--- a/examples/jsm/nodes/accessors/ClippingNode.js
+++ b/examples/jsm/nodes/accessors/ClippingNode.js
@@ -6,7 +6,7 @@ import { diffuseColor, property } from '../core/PropertyNode.js';
 import { tslFn } from '../shadernode/ShaderNode.js';
 import { loop } from '../utils/LoopNode.js';
 import { smoothstep  } from '../math/MathNode.js';
-import { uniform } from '../core/UniformNode.js';
+import { uniforms } from './UniformsNode.js';
 
 class ClippingNode extends Node {
 
@@ -48,7 +48,7 @@ class ClippingNode extends Node {
 
 		return tslFn( () => {
 
-			const clippingPlanes = uniform( clippingContext.planes, 'vec4' );
+			const clippingPlanes = uniforms( clippingContext.planes );
 
 			const distanceToPlane = property( 'float', 'distanceToPlane' );
 			const distanceGradient = property( 'float', 'distanceToGradient' );
@@ -108,7 +108,7 @@ class ClippingNode extends Node {
 
 		return tslFn( () => {
 
-			const clippingPlanes = uniform( clippingContext.planes, 'vec4' );
+			const clippingPlanes = uniforms( clippingContext.planes );
 
 			let plane;
 
diff --git a/examples/jsm/renderers/common/Uniform.js b/examples/jsm/renderers/common/Uniform.js
index b90d375f864a5a..4386d3e755e025 100644
--- a/examples/jsm/renderers/common/Uniform.js
+++ b/examples/jsm/renderers/common/Uniform.js
@@ -7,8 +7,6 @@ class Uniform {
 		this.name = name;
 		this.value = value;
 
-		this.isArray = value && Array.isArray( value );
-		this.itemCount = this.isArray ? this.value.length : 1;
 		this.boundary = 0; // used to build the uniform buffer according to the STD140 layout
 		this.itemSize = 0;
 
@@ -82,8 +80,9 @@ class Vector4Uniform extends Uniform {
 		super( name, value );
 
 		this.isVector4Uniform = true;
-		this.boundary = this.itemCount * 16;
-		this.itemSize = this.itemCount * 4;
+
+		this.boundary = 16;
+		this.itemSize = 4;
 
 	}
 
diff --git a/examples/jsm/renderers/common/UniformsGroup.js b/examples/jsm/renderers/common/UniformsGroup.js
index 24ea9a021f6735..21bb2cd33010f4 100644
--- a/examples/jsm/renderers/common/UniformsGroup.js
+++ b/examples/jsm/renderers/common/UniformsGroup.js
@@ -116,11 +116,10 @@ class UniformsGroup extends UniformBuffer {
 
 	updateByType( uniform ) {
 
-		if ( uniform.isArray ) return this.updateArray( uniform );
 		if ( uniform.isFloatUniform ) return this.updateNumber( uniform );
 		if ( uniform.isVector2Uniform ) return this.updateVector2( uniform );
 		if ( uniform.isVector3Uniform ) return this.updateVector3( uniform );
-		if ( uniform.isVector4Uniform ) return this.updateVector4( uniform.getValue(), uniform.offset );
+		if ( uniform.isVector4Uniform ) return this.updateVector4( uniform );
 		if ( uniform.isColorUniform ) return this.updateColor( uniform );
 		if ( uniform.isMatrix3Uniform ) return this.updateMatrix3( uniform );
 		if ( uniform.isMatrix4Uniform ) return this.updateMatrix4( uniform );
@@ -129,23 +128,6 @@ class UniformsGroup extends UniformBuffer {
 
 	}
 
-	updateArray( uniform ) {
-
-		const values = uniform.getValue();
-		const l = values.length;
-
-		let updated = false;
-
-		for ( let i = 0; i < l; i ++ ) {
-
-			if ( uniform.isVector4Uniform ) updated = this.updateVector4( values[ i ], uniform.offset + i * 4 ) || updated;
-
-		}
-
-		return updated;
-
-	}
-
 	updateNumber( uniform ) {
 
 		let updated = false;
@@ -208,11 +190,13 @@ class UniformsGroup extends UniformBuffer {
 
 	}
 
-	updateVector4( v, offset ) {
+	updateVector4( uniform ) {
 
 		let updated = false;
 
 		const a = this.buffer;
+		const v = uniform.getValue();
+		const offset = uniform.offset;
 
 		if ( a[ offset + 0 ] !== v.x || a[ offset + 1 ] !== v.y || a[ offset + 2 ] !== v.z || a[ offset + 4 ] !== v.w ) {
 
diff --git a/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js b/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js
index ba7565c32bee22..53088cdcca6cd2 100644
--- a/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js
+++ b/examples/jsm/renderers/webgl/nodes/GLSLNodeBuilder.js
@@ -328,17 +328,7 @@ ${ flowData.code }
 
 				const vectorType = this.getVectorType( uniform.type );
 
-				if ( Array.isArray( uniform.value ) === true ) {
-
-					const length = uniform.value.length;
-
-					snippet = `${vectorType} ${uniform.name}[${length}];`;
-
-				} else {
-
-					snippet = `${vectorType} ${uniform.name};`;
-
-				}
+				snippet = `${vectorType} ${uniform.name};`;
 
 				group = true;
 
diff --git a/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js b/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js
index d102d2ce486133..a86e35580374dc 100644
--- a/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js
+++ b/examples/jsm/renderers/webgpu/nodes/WGSLNodeBuilder.js
@@ -783,17 +783,7 @@ ${ flowData.code }
 					snippets: []
 				} );
 
-				if ( Array.isArray( uniform.value ) === true ) {
-
-					const length = uniform.value.length;
-
-					group.snippets.push( `\t${uniform.name} : array<${vectorType}, ${length}>` );
-
-				} else {
-
-					group.snippets.push( `\t${uniform.name} : ${ vectorType}` );
-
-				}
+				group.snippets.push( `\t${ uniform.name } : ${ vectorType }` );
 
 			}
 

From bfb7311fdc8331ae23aa3d5ca7e7eaed663a938d Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Thu, 8 Feb 2024 14:39:01 +0000
Subject: [PATCH 12/14] cleanup

---
 examples/jsm/renderers/common/ClippingContext.js | 6 +++---
 examples/jsm/renderers/common/Renderer.js        | 1 -
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/examples/jsm/renderers/common/ClippingContext.js b/examples/jsm/renderers/common/ClippingContext.js
index dc71eb8c471996..085e5d591abc26 100644
--- a/examples/jsm/renderers/common/ClippingContext.js
+++ b/examples/jsm/renderers/common/ClippingContext.js
@@ -28,8 +28,6 @@ class ClippingContext {
 		const l = source.length;
 		const planes = this.planes;
 
-		_viewNormalMatrix.getNormalMatrix( this.viewMatrix );
-
 		for ( let i = 0; i < l; i ++ ) {
 
 			_plane.copy( source[ i ] ).applyMatrix4( this.viewMatrix, _viewNormalMatrix );
@@ -51,6 +49,8 @@ class ClippingContext {
 		const rendererClippingPlanes = renderer.clippingPlanes;
 		this.viewMatrix = camera.matrixWorldInverse;
 
+		_viewNormalMatrix.getNormalMatrix( this.viewMatrix );
+
 		let update = false;
 
 		if ( Array.isArray( rendererClippingPlanes ) && rendererClippingPlanes.length !== 0 ) {
@@ -104,7 +104,7 @@ class ClippingContext {
 			this.globalClippingCount =  material.isShadowNodeMaterial ? 0 : parent.globalClippingCount;
 			this.localClippingEnabled = parent.localClippingEnabled;
 			this.planes = Array.from( parent.planes );
-   	    	this.parentVersion = parent.version;
+			this.parentVersion = parent.version;
 			this.viewMatrix = parent.viewMatrix;
 
 
diff --git a/examples/jsm/renderers/common/Renderer.js b/examples/jsm/renderers/common/Renderer.js
index 0c7c8a05195565..9a5f3ee11cb8dd 100644
--- a/examples/jsm/renderers/common/Renderer.js
+++ b/examples/jsm/renderers/common/Renderer.js
@@ -164,7 +164,6 @@ class Renderer {
 			this._objects = new RenderObjects( this, this._nodes, this._geometries, this._pipelines, this._bindings, this.info );
 			this._renderLists = new RenderLists();
 			this._renderContexts = new RenderContexts();
-			this._clippingContext = new ClippingContext();
 
 			//
 

From ab19e461a75ada98d44d33f7a9628716e3a6b7f4 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Thu, 8 Feb 2024 16:06:34 +0000
Subject: [PATCH 13/14] simplify

---
 examples/jsm/nodes/accessors/ClippingNode.js | 23 +++++++-------------
 1 file changed, 8 insertions(+), 15 deletions(-)

diff --git a/examples/jsm/nodes/accessors/ClippingNode.js b/examples/jsm/nodes/accessors/ClippingNode.js
index ba028108fa7605..b3f67c84c8b0a6 100644
--- a/examples/jsm/nodes/accessors/ClippingNode.js
+++ b/examples/jsm/nodes/accessors/ClippingNode.js
@@ -24,31 +24,27 @@ class ClippingNode extends Node {
 
 		const clippingContext = builder.clippingContext;
 		const { localClipIntersection, localClippingCount, globalClippingCount } = clippingContext;
-		const l = globalClippingCount + localClippingCount;
 
-		this._numClippingPlanes = l;
-		this._numUnionClippingPlanes = localClipIntersection ? l - localClippingCount : l;
+		const numClippingPlanes = globalClippingCount + localClippingCount;
+		const numUnionClippingPlanes = localClipIntersection ? numClippingPlanes - localClippingCount : numClippingPlanes;
 
 		if ( this.scope === ClippingNode.ALPHA_TO_COVERAGE ) {
 
-			return this.setupAlphaToCoverage( clippingContext );
+			return this.setupAlphaToCoverage( clippingContext.planes, numClippingPlanes, numUnionClippingPlanes );
 
 		} else {
 
-			return this.setupDefault( clippingContext );
+			return this.setupDefault( clippingContext.planes, numClippingPlanes, numUnionClippingPlanes );
 
 		}
 
 	}
 
-	setupAlphaToCoverage( clippingContext ) {
-
-		const numClippingPlanes = this._numClippingPlanes;
-		const numUnionClippingPlanes = this._numUnionClippingPlanes;
+	setupAlphaToCoverage( planes, numClippingPlanes, numUnionClippingPlanes ) {
 
 		return tslFn( () => {
 
-			const clippingPlanes = uniforms( clippingContext.planes );
+			const clippingPlanes = uniforms( planes );
 
 			const distanceToPlane = property( 'float', 'distanceToPlane' );
 			const distanceGradient = property( 'float', 'distanceToGradient' );
@@ -101,14 +97,11 @@ class ClippingNode extends Node {
 
 	}
 
-	setupDefault( clippingContext ) {
-
-		const numClippingPlanes = this._numClippingPlanes;
-		const numUnionClippingPlanes = this._numUnionClippingPlanes;
+	setupDefault( planes, numClippingPlanes, numUnionClippingPlanes ) {
 
 		return tslFn( () => {
 
-			const clippingPlanes = uniforms( clippingContext.planes );
+			const clippingPlanes = uniforms( planes );
 
 			let plane;
 

From d44adb9453b1401a964888033f2d7cf7b0c1fd37 Mon Sep 17 00:00:00 2001
From: aardgoose <angus.sawyer@email.com>
Date: Thu, 8 Feb 2024 21:07:14 +0000
Subject: [PATCH 14/14] exclude tests

---
 test/e2e/puppeteer.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/test/e2e/puppeteer.js b/test/e2e/puppeteer.js
index 59134be10c8ba0..fe01ea5ccd622a 100644
--- a/test/e2e/puppeteer.js
+++ b/test/e2e/puppeteer.js
@@ -126,6 +126,7 @@ const exceptionList = [
 	'webgpu_postprocessing_afterimage',
 	'webgpu_backdrop_water',
 	'webgpu_camera_logarithmicdepthbuffer',
+	'webgpu_clipping',
 	'webgpu_loader_materialx',
 	'webgpu_materials_video',
 	'webgpu_materialx_noise',