WebGPURenderer: Introduce dispersion (#974)

* WebGPURenderer: Introduce dispersion

* Update three.js

* Add examples

* Update patch

* Delete examples

* Format

Author: Methuselah96

examples-testing/changes.patch

@@ -211,6 +211,7 @@ export {
     materialClearcoatNormal,
     materialClearcoatRoughness,
     materialColor,
+    materialDispersion,
     materialEmissive,
     materialIridescence,
     materialIridescenceIOR,

three.js

@@ -37,7 +37,8 @@ export type MaterialNodeScope =
     | typeof MaterialNode.LINE_GAP_SIZE
     | typeof MaterialNode.LINE_WIDTH
     | typeof MaterialNode.LINE_DASH_OFFSET
-    | typeof MaterialNode.POINT_WIDTH;
+    | typeof MaterialNode.POINT_WIDTH
+    | typeof MaterialNode.DISPERSION;
 
 export default class MaterialNode extends Node {
     static ALPHA_TEST: "alphaTest";
@@ -74,6 +75,7 @@ export default class MaterialNode extends Node {
     static LINE_WIDTH: "linewidth";
     static LINE_DASH_OFFSET: "dashOffset";
     static POINT_WIDTH: "pointWidth";
+    static DISPERSION: "dispersion";
 
     scope: MaterialNodeScope;
     constructor(scope?: MaterialNodeScope);
@@ -115,4 +117,5 @@ export const materialLineGapSize: ShaderNodeObject<MaterialNode>;
 export const materialLineWidth: ShaderNodeObject<MaterialNode>;
 export const materialLineDashOffset: ShaderNodeObject<MaterialNode>;
 export const materialPointWidth: ShaderNodeObject<MaterialNode>;
+export const materialDispersion: ShaderNodeObject<MaterialNode>;
 export const materialAnisotropyVector: ShaderNodeObject<UniformNode<Vector2>>;

types/three/examples/jsm/nodes/Nodes.d.ts

@@ -40,3 +40,4 @@ export const transmission: ShaderNodeObject<PropertyNode>;
 export const thickness: ShaderNodeObject<PropertyNode>;
 export const attenuationDistance: ShaderNodeObject<PropertyNode>;
 export const attenuationColor: ShaderNodeObject<PropertyNode>;
+export const dispersion: ShaderNodeObject<PropertyNode>;

types/three/examples/jsm/nodes/accessors/MaterialNode.d.ts

@@ -7,6 +7,7 @@ export default class PhysicalLightingModel extends LightingModel {
     iridescence: boolean;
     anisotropy: boolean;
     transmission: boolean;
+    dispersion: boolean;
 
     clearcoatRadiance: Node | null;
     clearcoatSpecularDirect: Node | null;
@@ -22,6 +23,7 @@ export default class PhysicalLightingModel extends LightingModel {
         iridescence?: boolean,
         anisotropy?: boolean,
         transmission?: boolean,
+        dispersion?: boolean,
     );
 
     computeMultiscattering(singleScatter: Node, multiScatter: Node, specularF90: Node): void;

types/three/examples/jsm/nodes/core/PropertyNode.d.ts

@@ -32,6 +32,7 @@ export default class MeshPhysicalNodeMaterial extends MeshStandardNodeMaterial {
     thicknessNode: ShaderNodeObject<Node> | null;
     attenuationDistanceNode: ShaderNodeObject<Node> | null;
     attenuationColorNode: ShaderNodeObject<Node> | null;
+    dispersionNode: ShaderNodeObject<Node> | null;
 
     anisotropyNode: ShaderNodeObject<Node> | null;
 
@@ -78,4 +79,11 @@ export default class MeshPhysicalNodeMaterial extends MeshStandardNodeMaterial {
     set transmission(value: number);
 
     constructor(parameters?: MeshPhysicalNodeMaterialParameters);
+
+    get useClearcoat(): boolean;
+    get useIridescence(): boolean;
+    get useSheen(): boolean;
+    get useAnisotropy(): boolean;
+    get useTransmission(): boolean;
+    get useDispersion(): boolean;
 }