@types/three 0.137.0 → 0.138.0

three/src/textures/DataTexture2DArray.d.ts

@@ -1,33 +1,6 @@
-import { Texture } from './Texture';
-import { TextureFilter } from '../constants';
+import { DataArrayTexture } from './DataArrayTexture';
 
-export class DataTexture2DArray extends Texture {
-    constructor(data?: BufferSource, width?: number, height?: number, depth?: number);
-
-    /**
-     * @default THREE.NearestFilter
-     */
-    magFilter: TextureFilter;
-
-    /**
-     * @default THREE.NearestFilter
-     */
-    minFilter: TextureFilter;
-
-    /**
-     * @default THREE.ClampToEdgeWrapping
-     */
-    wrapR: boolean;
-
-    /**
-     * @default false
-     */
-    flipY: boolean;
-
-    /**
-     * @default false
-     */
-    generateMipmaps: boolean;
-
-    readonly isDataTexture2DArray: true;
-}
+/**
+ * @deprecated THREE.DataTexture2DArray has been renamed to DataArrayTexture.
+ */
+export class DataTexture2DArray extends DataArrayTexture {}

three/src/textures/DataTexture3D.d.ts

@@ -1,33 +1,6 @@
-import { Texture } from './Texture';
-import { TextureFilter } from '../constants';
+import { Data3DTexture } from './Data3DTexture';
 
-export class DataTexture3D extends Texture {
-    constructor(data: BufferSource, width: number, height: number, depth: number);
-
-    /**
-     * @default THREE.NearestFilter
-     */
-    magFilter: TextureFilter;
-
-    /**
-     * @default THREE.NearestFilter
-     */
-    minFilter: TextureFilter;
-
-    /**
-     * @default THREE.ClampToEdgeWrapping
-     */
-    wrapR: boolean;
-
-    /**
-     * @default false
-     */
-    flipY: boolean;
-
-    /**
-     * @default false
-     */
-    generateMipmaps: boolean;
-
-    readonly isDataTexture3D: true;
-}
+/**
+ * @deprecated THREE.DataTexture3D has been renamed to Data3DTexture.
+ */
+export class DataTexture3D extends Data3DTexture {}

three/src/textures/DepthTexture.d.ts

@@ -25,7 +25,8 @@ export class DepthTexture extends Texture {
         anisotropy?: number,
     );
 
-    image: { width: number; height: number };
+    get image(): { width: number; height: number };
+    set image(value: { width: number; height: number });
 
     /**
      * @default false

three/src/textures/Source.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Represents the data source of a texture.
+ */
+export class Source {
+    /**
+     * @param [data] The data definition of a texture. default is **null**.
+     */
+    constructor(data: any);
+
+    /**
+     * The actual data of a texture. The type of this property depends on the texture that uses this instance.
+     */
+    data: any;
+
+    /**
+     * Set this to **true** to trigger a data upload to the GPU next time the source is used.
+     */
+    set needsUpdate(value: boolean);
+
+    /**
+     * [UUID](http://en.wikipedia.org/wiki/Universally_unique_identifier) of this object instance.
+     * This gets automatically assigned, so this shouldn't be edited.
+     */
+    uuid: string;
+
+    /**
+     * This starts at **0** and counts how many times [property:Boolean needsUpdate] is set to **true**.
+     */
+    version: number;
+
+    /**
+     * Convert the data source to three.js [JSON Object/Scene format](https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4).
+     *
+     * @param [meta] optional object containing metadata.
+     */
+    toJSON(meta: any): any;
+
+    readonly isTexture: true;
+}

three/src/textures/Texture.d.ts

@@ -1,5 +1,6 @@
 import { Vector2 } from './../math/Vector2';
 import { Matrix3 } from './../math/Matrix3';
+import { Source } from './Source';
 import { EventDispatcher } from './../core/EventDispatcher';
 import {
     Mapping,
@@ -47,9 +48,30 @@ export class Texture extends EventDispatcher {
     sourceFile: string;
 
     /**
-     * @default THREE.Texture.DEFAULT_IMAGE
+     * The data definition of a texture. A reference to the data source can be shared across textures.
+     * This is often useful in context of spritesheets where multiple textures render the same data but with different texture transformations.
      */
-    image: any; // HTMLImageElement or ImageData or { width: number, height: number } in some children;
+    source: Source;
+
+    /**
+     * An image object, typically created using the {@link TextureLoader.load} method.
+     * This can be any image (e.g., PNG, JPG, GIF, DDS) or video (e.g., MP4, OGG/OGV) type supported by three.js.
+     *
+     * To use video as a texture you need to have a playing HTML5
+     * video element as a source for your texture image and continuously update this texture
+     * as long as video is playing - the {@link VideoTexture} class handles this automatically.
+     */
+    get image(): any;
+
+    /**
+     * An image object, typically created using the {@link TextureLoader.load} method.
+     * This can be any image (e.g., PNG, JPG, GIF, DDS) or video (e.g., MP4, OGG/OGV) type supported by three.js.
+     *
+     * To use video as a texture you need to have a playing HTML5
+     * video element as a source for your texture image and continuously update this texture
+     * as long as video is playing - the {@link VideoTexture} class handles this automatically.
+     */
+    set image(data: any);
 
     /**
      * @default []
@@ -158,6 +180,11 @@ export class Texture extends EventDispatcher {
      */
     isRenderTargetTexture: boolean;
 
+    /**
+     * @default false
+     */
+    needsPMREMUpdate: boolean;
+
     /**
      * An object that can be used to store custom data about the Material. It should not hold references to functions as these will not be cloned.
      * @default {}
@@ -168,7 +195,7 @@ export class Texture extends EventDispatcher {
      * @default 0
      */
     version: number;
-    needsUpdate: boolean;
+    set needsUpdate(value: boolean);
     readonly isTexture: true;
 
     onUpdate: () => void;

three/examples/jsm/loaders/VRMLoader.d.ts

@@ -1,19 +0,0 @@
-import { Loader, LoadingManager } from '../../../src/Three';
-
-import { GLTFLoader, GLTF } from './GLTFLoader';
-import { DRACOLoader } from './DRACOLoader';
-
-export class VRMLoader extends Loader {
-    constructor(manager?: LoadingManager);
-    gltfLoader: GLTFLoader;
-
-    load(
-        url: string,
-        onLoad: (scene: GLTF) => void,
-        onProgress?: (event: ProgressEvent) => void,
-        onError?: (event: ErrorEvent) => void,
-    ): void;
-    loadAsync(url: string, onProgress?: (event: ProgressEvent) => void): Promise<GLTF>;
-    parse(gltf: GLTF, onLoad: (scene: GLTF) => void): void;
-    setDRACOLoader(dracoLoader: DRACOLoader): this;
-}

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

@@ -1,106 +0,0 @@
-// core
-
-export * from './core/Node';
-export * from './core/TempNode';
-export * from './core/InputNode';
-export * from './core/ConstNode';
-export * from './core/VarNode';
-export * from './core/StructNode';
-export * from './core/AttributeNode';
-export * from './core/FunctionNode';
-export * from './core/ExpressionNode';
-export * from './core/FunctionCallNode';
-export * from './core/NodeLib';
-export * from './core/NodeUtils';
-export * from './core/NodeFrame';
-export * from './core/NodeUniform';
-export * from './core/NodeBuilder';
-
-// inputs
-
-export * from './inputs/BoolNode';
-export * from './inputs/IntNode';
-export * from './inputs/FloatNode';
-export * from './inputs/Vector2Node';
-export * from './inputs/Vector3Node';
-export * from './inputs/Vector4Node';
-export * from './inputs/ColorNode';
-export * from './inputs/Matrix3Node';
-export * from './inputs/Matrix4Node';
-export * from './inputs/TextureNode';
-export * from './inputs/CubeTextureNode';
-export * from './inputs/ScreenNode';
-export * from './inputs/ReflectorNode';
-export * from './inputs/PropertyNode';
-export * from './inputs/RTTNode';
-
-// accessors
-
-export * from './accessors/UVNode';
-export * from './accessors/ColorsNode';
-export * from './accessors/PositionNode';
-export * from './accessors/NormalNode';
-export * from './accessors/CameraNode';
-export * from './accessors/LightNode';
-export * from './accessors/ReflectNode';
-export * from './accessors/ScreenUVNode';
-export * from './accessors/ResolutionNode';
-
-// math
-
-export * from './math/MathNode';
-export * from './math/OperatorNode';
-export * from './math/CondNode';
-
-// procedural
-
-export * from './procedural/NoiseNode';
-export * from './procedural/CheckerNode';
-
-// misc
-
-export * from './misc/TextureCubeUVNode';
-export * from './misc/TextureCubeNode';
-export * from './misc/NormalMapNode';
-export * from './misc/BumpMapNode';
-
-// utils
-
-export * from './utils/BypassNode';
-export * from './utils/JoinNode';
-export * from './utils/SwitchNode';
-export * from './utils/TimerNode';
-export * from './utils/VelocityNode';
-export * from './utils/UVTransformNode';
-export * from './utils/MaxMIPLevelNode';
-export * from './utils/SpecularMIPLevelNode';
-export * from './utils/ColorSpaceNode';
-
-// effects
-
-export * from './effects/BlurNode';
-export * from './effects/ColorAdjustmentNode';
-export * from './effects/LuminanceNode';
-
-// material nodes
-
-export * from './materials/nodes/RawNode';
-export * from './materials/nodes/BasicNode';
-export * from './materials/nodes/SpriteNode';
-export * from './materials/nodes/PhongNode';
-export * from './materials/nodes/StandardNode';
-export * from './materials/nodes/MeshStandardNode';
-
-// materials
-
-export * from './materials/NodeMaterial';
-export * from './materials/BasicNodeMaterial';
-export * from './materials/SpriteNodeMaterial';
-export * from './materials/PhongNodeMaterial';
-export * from './materials/StandardNodeMaterial';
-export * from './materials/MeshStandardNodeMaterial';
-
-// postprocessing
-
-export * from './postprocessing/NodePostProcessing';
-// export * from './postprocessing/NodePass';

three/examples/jsm/nodes/accessors/CameraNode.d.ts

@@ -1,29 +0,0 @@
-import { Camera } from '../../../../src/Three';
-
-import { NodeFrame } from '../core/NodeFrame';
-import { TempNode } from '../core/TempNode';
-import { FunctionNode } from '../core/FunctionNode';
-import { FloatNode } from '../inputs/FloatNode';
-
-export class CameraNode extends TempNode {
-    constructor(scope?: string, camera?: Camera);
-
-    scope: string;
-    near: FloatNode | undefined;
-    far: FloatNode | undefined;
-    camera: Camera | undefined;
-    updateFrame: boolean | undefined;
-    nodeType: string;
-
-    setCamera(camera: Camera): void;
-    setScope(scope: string): void;
-    onUpdateFrame(frame: NodeFrame): void;
-    copy(source: CameraNode): this;
-
-    static Nodes: {
-        depthColor: FunctionNode;
-    };
-    static POSITION: string;
-    static DEPTH: string;
-    static TO_VERTEX: string;
-}

three/examples/jsm/nodes/accessors/ColorsNode.d.ts

@@ -1,10 +0,0 @@
-import { TempNode } from '../core/TempNode';
-
-export class ColorsNode extends TempNode {
-    constructor(index?: number);
-
-    index: number;
-    nodeType: string;
-
-    copy(source: ColorsNode): this;
-}

three/examples/jsm/nodes/accessors/LightNode.d.ts

@@ -1,12 +0,0 @@
-import { TempNode } from '../core/TempNode';
-
-export class LightNode extends TempNode {
-    constructor(scope?: string);
-
-    scope: string;
-    nodeType: string;
-
-    copy(source: LightNode): this;
-
-    static TOTAL: string;
-}

three/examples/jsm/nodes/accessors/NormalNode.d.ts

@@ -1,13 +0,0 @@
-import { TempNode } from '../core/TempNode';
-
-export class NormalNode extends TempNode {
-    constructor(scope?: string);
-
-    scope: string;
-    nodeType: string;
-
-    copy(source: NormalNode): this;
-
-    static LOCAL: string;
-    static WORLD: string;
-}

three/examples/jsm/nodes/accessors/PositionNode.d.ts

@@ -1,15 +0,0 @@
-import { TempNode } from '../core/TempNode';
-
-export class PositionNode extends TempNode {
-    constructor(scope?: string);
-
-    scope: string;
-    nodeType: string;
-
-    copy(source: PositionNode): this;
-
-    static LOCAL: string;
-    static WORLD: string;
-    static VIEW: string;
-    static PROJECTION: string;
-}

three/examples/jsm/nodes/accessors/ReflectNode.d.ts

@@ -1,12 +0,0 @@
-import { TempNode } from '../core/TempNode';
-
-export class ReflectNode extends TempNode {
-    constructor(scope?: string);
-
-    scope: string;
-    nodeType: string;
-
-    static CUBE: string;
-    static SPHERE: string;
-    static VECTOR: string;
-}

three/examples/jsm/nodes/accessors/ResolutionNode.d.ts

@@ -1,14 +0,0 @@
-import { Vector2 } from '../../../../src/Three';
-
-import { NodeFrame } from '../core/NodeFrame';
-import { Vector2Node } from '../inputs/Vector2Node';
-
-export class ResolutionNode extends Vector2Node {
-    constructor();
-
-    size: Vector2;
-    nodeType: string;
-
-    updateFrame(frame: NodeFrame): void;
-    copy(source: ResolutionNode): this;
-}

three/examples/jsm/nodes/accessors/ScreenUVNode.d.ts

@@ -1,11 +0,0 @@
-import { TempNode } from '../core/TempNode';
-import { ResolutionNode } from './ResolutionNode';
-
-export class ScreenUVNode extends TempNode {
-    constructor(resolution?: ResolutionNode);
-
-    resolution: ResolutionNode;
-    nodeType: string;
-
-    copy(source: ScreenUVNode): this;
-}

three/examples/jsm/nodes/accessors/UVNode.d.ts

@@ -1,10 +0,0 @@
-import { TempNode } from '../core/TempNode';
-
-export class UVNode extends TempNode {
-    constructor(index?: number);
-
-    index: number;
-    nodeType: string;
-
-    copy(source: UVNode): this;
-}

three/examples/jsm/nodes/core/AttributeNode.d.ts

@@ -1,13 +0,0 @@
-import { TempNode } from './TempNode';
-import { NodeBuilder } from './NodeBuilder';
-
-export class AttributeNode extends TempNode {
-    constructor(name: string, type?: string);
-
-    name: string;
-    nodeType: string;
-
-    getAttributeType(builder: NodeBuilder): string;
-    getType(builder: NodeBuilder): string;
-    copy(source: AttributeNode): this;
-}

three/examples/jsm/nodes/core/ConstNode.d.ts

@@ -1,22 +0,0 @@
-import { TempNode } from './TempNode';
-import { NodeBuilder } from './NodeBuilder';
-
-export class ConstNode extends TempNode {
-    constructor(src: string, useDefine?: boolean);
-
-    src: string;
-    useDefine: boolean;
-    nodeType: string;
-
-    getType(builder: NodeBuilder): string;
-    parse(src: string, useDefine?: boolean): void;
-    build(builder: NodeBuilder, output: string): string;
-    copy(source: ConstNode): this;
-
-    static PI: string;
-    static PI2: string;
-    static RECIPROCAL_PI: string;
-    static RECIPROCAL_PI2: string;
-    static LOG2: string;
-    static EPSILON: string;
-}

three/examples/jsm/nodes/core/ExpressionNode.d.ts

@@ -1,5 +0,0 @@
-import { FunctionNode } from './FunctionNode';
-
-export class ExpressionNode extends FunctionNode {
-    constructor(src: string, type?: string, keywords?: object, extensions?: object, includes?: object[]);
-}

three/examples/jsm/nodes/core/FunctionCallNode.d.ts

@@ -1,17 +0,0 @@
-import { Node } from './Node';
-import { FunctionNode } from './FunctionNode';
-import { TempNode } from './TempNode';
-
-export class FunctionCallNode extends TempNode {
-    constructor(func: FunctionNode, inputs?: Node[]);
-
-    nodeType: string;
-
-    value: FunctionNode;
-    inputs: Node[];
-
-    setFunction(func: FunctionNode, inputs?: Node[]): void;
-    getFunction(): FunctionNode;
-    getType(): string;
-    copy(source: FunctionCallNode): this;
-}

three/examples/jsm/nodes/core/FunctionNode.d.ts

@@ -1,28 +0,0 @@
-import { TempNode } from './TempNode';
-import { NodeBuilder } from './NodeBuilder';
-
-export interface FunctionNodeInput {
-    name: string;
-    type: string;
-    qualifier: string;
-}
-
-export class FunctionNode extends TempNode {
-    constructor(src: string, includes?: object[], extensions?: object, keywords?: object, type?: string);
-
-    isMethod: boolean;
-    nodeType: string;
-    useKeywords: boolean;
-
-    inputs: FunctionNodeInput[] | undefined;
-    includes: object[] | undefined;
-    extensions: object | undefined;
-    keywords: object | undefined;
-
-    getShared(builder: NodeBuilder, output: string): boolean;
-    getType(builder: NodeBuilder): string;
-    getInputByName(name: string): FunctionNodeInput | undefined;
-    getIncludeByName(name: string): object | undefined;
-    parse(src: string, includes?: object[], extensions?: object, keywords?: object): void;
-    copy(source: FunctionNode): this;
-}

three/examples/jsm/nodes/core/InputNode.d.ts

@@ -1,12 +0,0 @@
-import { TempNode, TempNodeParams } from './TempNode';
-import { NodeBuilder } from './NodeBuilder';
-
-export class InputNode extends TempNode {
-    constructor(type: string, params?: TempNodeParams);
-
-    readonly: boolean;
-
-    setReadonly(value: boolean): this;
-    getReadonly(builder: NodeBuilder): boolean;
-    copy(source: InputNode): this;
-}

three/examples/jsm/nodes/core/Node.d.ts

@@ -1,34 +0,0 @@
-import { NodeBuilder } from './NodeBuilder';
-
-export interface Flow {
-    result: string;
-    code: string;
-    extra: object;
-}
-
-export class Node {
-    constructor(type?: string);
-
-    uuid: string;
-    name: string;
-    type: string | undefined;
-    userData: object;
-    readonly isNode: true;
-    frameId: number | undefined;
-    hashProperties: string[] | undefined;
-
-    analyze(builder: NodeBuilder, settings?: object): void;
-    analyzeAndFlow(builder: NodeBuilder, output: string, settings?: object): Flow;
-    flow(builder: NodeBuilder, output: string, settings?: object): Flow;
-    build(builder: NodeBuilder, output: string, uuid?: string): string;
-    generate(builder: NodeBuilder, output: string, uuid?: string, type?: string, ns?: string): string;
-    appendDepsNode(builder: NodeBuilder, data: object, output: string): void;
-    setName(name: string): this;
-    getName(builder: NodeBuilder): string;
-    getType(builder: NodeBuilder, output?: string): string;
-    getJSONNode(meta?: object | string): object | undefined;
-    getHash(): string;
-    copy(source: Node): this;
-    createJSONNode(meta?: object | string): object;
-    toJSON(meta?: object | string): object;
-}