WebGPURenderer: Introduce NodeMaterialObserver and updates

src-testing/create-src.js

@@ -4,6 +4,7 @@ import * as path from 'node:path';
 import prettier from 'prettier';
 
 const files = [
+    'materials/nodes/manager/NodeMaterialObserver',
     'materials/nodes/NodeMaterial',
     'nodes/accessors/BufferAttributeNode',
     'nodes/accessors/TextureNode',

src-testing/declarations.js

@@ -3,6 +3,7 @@ import * as path from 'node:path';
 import { argv } from 'node:process';
 
 const files = [
+    'materials/nodes/manager/NodeMaterialObserver',
     'nodes/accessors/BufferAttributeNode',
     'nodes/core/constants',
     'nodes/core/Node',

types/three/src/materials/nodes/manager/NodeMaterialObserver.d.ts

@@ -0,0 +1,80 @@
+import { Matrix4 } from "../../../math/Matrix4.js";
+import NodeBuilder from "../../../nodes/core/NodeBuilder.js";
+import NodeFrame from "../../../nodes/core/NodeFrame.js";
+import RenderObject from "../../../renderers/common/RenderObject.js";
+import { Material } from "../../Material.js";
+declare const refreshUniforms: readonly [
+    "alphaMap",
+    "alphaTest",
+    "anisotropy",
+    "anisotropyMap",
+    "anisotropyRotation",
+    "aoMap",
+    "attenuationColor",
+    "attenuationDistance",
+    "bumpMap",
+    "clearcoat",
+    "clearcoatMap",
+    "clearcoatNormalMap",
+    "clearcoatNormalScale",
+    "clearcoatRoughness",
+    "color",
+    "dispersion",
+    "displacementMap",
+    "emissive",
+    "emissiveMap",
+    "envMap",
+    "gradientMap",
+    "ior",
+    "iridescence",
+    "iridescenceIOR",
+    "iridescenceMap",
+    "iridescenceThicknessMap",
+    "lightMap",
+    "map",
+    "matcap",
+    "metalness",
+    "metalnessMap",
+    "normalMap",
+    "normalScale",
+    "opacity",
+    "roughness",
+    "roughnessMap",
+    "sheen",
+    "sheenColor",
+    "sheenColorMap",
+    "sheenRoughnessMap",
+    "shininess",
+    "specular",
+    "specularColor",
+    "specularColorMap",
+    "specularIntensity",
+    "specularIntensityMap",
+    "specularMap",
+    "thickness",
+    "transmission",
+    "transmissionMap",
+];
+type RefreshUniform = (typeof refreshUniforms)[number];
+type MaterialData = {
+    [K in RefreshUniform]?: unknown;
+};
+interface RenderObjectData {
+    material: MaterialData;
+    worldMatrix: Matrix4;
+    version?: number;
+}
+declare class NodeMaterialObserver {
+    renderObjects: WeakMap<RenderObject, RenderObjectData>;
+    hasNode: boolean;
+    refreshUniforms: readonly RefreshUniform[];
+    renderId: number;
+    constructor(builder: NodeBuilder);
+    firstInitialization(renderObject: RenderObject): boolean;
+    getRenderObjectData(renderObject: RenderObject): RenderObjectData;
+    containsNode(builder: NodeBuilder): boolean;
+    getMaterialData(material: Material): MaterialData;
+    equals(renderObject: RenderObject): boolean;
+    needsRefresh(renderObject: RenderObject, nodeFrame: NodeFrame): boolean;
+}
+export default NodeMaterialObserver;

types/three/src/renderers/common/BundleGroup.d.ts

@@ -2,6 +2,9 @@ import { Group } from "../../objects/Group.js";
 declare class BundleGroup extends Group {
     readonly isBundleGroup: true;
     readonly type: string;
+    static: boolean;
+    version: number;
     constructor();
+    set needsUpdate(value: boolean);
 }
 export default BundleGroup;

types/three/src/renderers/common/RenderObject.d.ts

@@ -5,9 +5,11 @@ import { InterleavedBuffer } from "../../core/InterleavedBuffer.js";
 import { InterleavedBufferAttribute } from "../../core/InterleavedBufferAttribute.js";
 import { Object3D } from "../../core/Object3D.js";
 import { Material } from "../../materials/Material.js";
+import NodeMaterialObserver from "../../materials/nodes/manager/NodeMaterialObserver.js";
 import { LightsNode } from "../../nodes/Nodes.js";
 import { Scene } from "../../scenes/Scene.js";
 import BindGroup from "./BindGroup.js";
+import BundleGroup from "./BundleGroup.js";
 import ClippingContext from "./ClippingContext.js";
 import Geometries from "./Geometries.js";
 import NodeBuilderState from "./nodes/NodeBuilderState.js";
@@ -41,12 +43,14 @@ export default class RenderObject {
         instanceCount: number;
         firstInstance: number;
     } | null;
+    bundle: BundleGroup | null;
     clippingContext: ClippingContext;
     clippingContextVersion: number;
     initialNodesCacheKey: string;
     initialCacheKey: string;
     _nodeBuilderState: NodeBuilderState | null;
     _bindings: BindGroup[] | null;
+    _monitor: NodeMaterialObserver | null;
     onDispose: (() => void) | null;
     readonly isRenderObject: true;
     onMaterialDispose: () => void;
@@ -64,6 +68,7 @@ export default class RenderObject {
     updateClipping(parent: ClippingContext): void;
     get clippingNeedsUpdate(): boolean;
     getNodeBuilderState(): NodeBuilderState;
+    getMonitor(): NodeMaterialObserver;
     getBindings(): BindGroup[];
     getIndex(): BufferAttribute | null;
     getChainArray(): readonly [

types/three/src/renderers/common/nodes/NodeBuilderState.d.ts

@@ -1,3 +1,4 @@
+import NodeMaterialObserver from "../../../materials/nodes/manager/NodeMaterialObserver.js";
 import Node from "../../../nodes/core/Node.js";
 import NodeAttribute from "../../../nodes/core/NodeAttribute.js";
 import BindGroup from "../BindGroup.js";
@@ -11,6 +12,7 @@ declare class NodeBuilderState {
     updateNodes: Node[];
     updateBeforeNodes: Node[];
     updateAfterNodes: Node[];
+    monitor: NodeMaterialObserver;
     instanceBindGroups: boolean;
     usedTimes: number;
     constructor(
@@ -22,6 +24,7 @@ declare class NodeBuilderState {
         updateNodes: Node[],
         updateBeforeNodes: Node[],
         updateAfterNodes: Node[],
+        monitor: NodeMaterialObserver,
         instanceBindGroups?: boolean,
         transforms?: never[],
     );

types/three/src/renderers/common/nodes/Nodes.d.ts

@@ -108,6 +108,7 @@ declare class Nodes extends DataMap<{
     updateAfter(renderObject: RenderObject): void;
     updateForCompute(computeNode: ComputeNode): void;
     updateForRender(renderObject: RenderObject): void;
+    needsRefresh(renderObject: RenderObject): boolean;
     dispose(): void;
 }
 export default Nodes;