WebGPURenderer: support using 3d textures (#976)

* WebGPURenderer: support using 3d textures

* Update three.js

* Add examples

* Update

* Fix

examples-testing/index.js

@@ -100,6 +100,8 @@ const exceptionList = [
     'webgpu_multisampled_renderbuffers',
     'webgpu_storage_buffer',
     'webgpu_texturegrad',
+    'webgpu_volume_cloud',
+    'webgpu_volume_perlin',
     'webxr_vr_handinput_cubes',
     'webxr_vr_handinput_profiles',
     'webxr_vr_handinput_pointerclick',

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

@@ -276,6 +276,7 @@ export { default as RendererReferenceNode, rendererReference } from "./accessors
 export { default as SkinningNode, skinning } from "./accessors/SkinningNode.js";
 export { default as StorageBufferNode, storage, storageObject } from "./accessors/StorageBufferNode.js";
 export * from "./accessors/TangentNode.js";
+export { default as Texture3DNode } from "./accessors/Texture3DNode.js";
 export { default as TextureBicubicNode, textureBicubic } from "./accessors/TextureBicubicNode.js";
 export { default as TextureNode, sampler, texture } from "./accessors/TextureNode.js";
 export { default as UniformsNode, uniforms } from "./accessors/UniformsNode.js";

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

@@ -8,7 +8,7 @@ export default class CubeTextureNode extends TextureNode {
     uvNode: ShaderNodeObject<Node> | null;
     levelNode: ShaderNodeObject<Node> | null;
 
-    constructor(value: CubeTexture, uvNode?: Node | null, levelNode?: Node | null);
+    constructor(value: CubeTexture, uvNode?: ShaderNodeObject<Node> | null, levelNode?: ShaderNodeObject<Node> | null);
 
     getDefaultUV(): Node;
 }

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

@@ -0,0 +1,16 @@
+import { CubeTexture, Texture } from "three";
+import Node from "../core/Node.js";
+import { NodeRepresentation, ShaderNodeObject } from "../shadernode/ShaderNode.js";
+import TextureNode from "./TextureNode.js";
+
+export default class Texture3DNode extends TextureNode {
+    readonly isTexture3DNode: true;
+
+    constructor(value: Texture, uvNode?: ShaderNodeObject<Node> | null, levelNode?: ShaderNodeObject<Node> | null);
+}
+
+export const texture3D: (
+    value: CubeTexture,
+    uvNode?: NodeRepresentation,
+    levelNode?: NodeRepresentation,
+) => ShaderNodeObject<Texture3DNode>;

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

@@ -17,7 +17,7 @@ export default class TextureNode extends UniformNode<Texture> {
 
     referenceNode: Node | null;
 
-    constructor(value: Texture, uvNode?: ShaderNodeObject<Node>, levelNode?: ShaderNodeObject<Node> | null);
+    constructor(value: Texture, uvNode?: ShaderNodeObject<Node> | null, levelNode?: ShaderNodeObject<Node> | null);
 
     getDefaultUV(): Node;
 

types/three/examples/jsm/nodes/materials/Materials.d.ts

@@ -11,3 +11,4 @@ export { default as NodeMaterial } from "./NodeMaterial.js";
 export { default as PointsNodeMaterial } from "./PointsNodeMaterial.js";
 export { default as ShadowNodeMaterial } from "./ShadowNodeMaterial.js";
 export { default as SpriteNodeMaterial } from "./SpriteNodeMaterial.js";
+export { default as VolumeNodeMaterial } from "./VolumeNodeMaterial.js";

types/three/examples/jsm/nodes/materials/VolumeNodeMaterial.d.ts

@@ -0,0 +1,10 @@
+import Node from "../core/Node.js";
+import NodeMaterial, { NodeMaterialParameters } from "./NodeMaterial.js";
+
+export default class VolumeNodeMaterial extends NodeMaterial {
+    lights: boolean;
+    readonly isVolumeNodeMaterial: true;
+    testNode: Node | null;
+
+    constructor(parameters?: NodeMaterialParameters);
+}