@types/three 0.126.1 → 0.128.0

three/src/loaders/DataTextureLoader.d.ts

@@ -7,7 +7,7 @@ export class DataTextureLoader extends Loader {
 
     load(
         url: string,
-        onLoad: (dataTexture: DataTexture) => void,
+        onLoad: (dataTexture: DataTexture, texData: object) => void,
         onProgress?: (event: ProgressEvent) => void,
         onError?: (event: ErrorEvent) => void,
     ): DataTexture;

three/src/materials/Material.d.ts

@@ -15,6 +15,7 @@ import {
 
 export interface MaterialParameters {
     alphaTest?: number;
+    alphaToCoverage?: boolean;
     blendDst?: BlendingDstFactor;
     blendDstAlpha?: number;
     blendEquation?: BlendingEquation;
@@ -68,6 +69,12 @@ export class Material extends EventDispatcher {
      */
     alphaTest: number;
 
+    /**
+     * Enables alpha to coverage. Can only be used with MSAA-enabled rendering contexts.
+     * @default false
+     */
+    alphaToCoverage: boolean;
+
     /**
      * Blending destination. It's one of the blending mode constants defined in Three.js. Default is {@link OneMinusSrcAlphaFactor}.
      * @default THREE.OneMinusSrcAlphaFactor
@@ -354,7 +361,7 @@ export class Material extends EventDispatcher {
     /**
      * Return a new material with the same parameters as this material.
      */
-    clone(): Material;
+    clone(): this;
 
     /**
      * Copy the parameters from the passed material into this material.

three/src/math/Box2.d.ts

@@ -18,7 +18,7 @@ export class Box2 {
     set(min: Vector2, max: Vector2): Box2;
     setFromPoints(points: Vector2[]): Box2;
     setFromCenterAndSize(center: Vector2, size: Vector2): Box2;
-    clone(): Box2;
+    clone(): this;
     copy(box: Box2): this;
     makeEmpty(): Box2;
     isEmpty(): boolean;

three/src/math/Box3.d.ts

@@ -26,7 +26,7 @@ export class Box3 {
     setFromPoints(points: Vector3[]): this;
     setFromCenterAndSize(center: Vector3, size: Vector3): this;
     setFromObject(object: Object3D): this;
-    clone(): Box3;
+    clone(): this;
     copy(box: Box3): this;
     makeEmpty(): this;
     isEmpty(): boolean;

three/src/math/Color.d.ts

@@ -76,7 +76,7 @@ export class Color {
     /**
      * Clones this color.
      */
-    clone(): Color;
+    clone(): this;
 
     /**
      * Copies given color.

three/src/math/Cylindrical.d.ts

@@ -18,7 +18,7 @@ export class Cylindrical {
      */
     y: number;
 
-    clone(): Cylindrical;
+    clone(): this;
     copy(other: Cylindrical): this;
     set(radius: number, theta: number, y: number): this;
     setFromVector3(vec3: Vector3): this;

three/src/math/Euler.d.ts

@@ -29,10 +29,10 @@ export class Euler {
     _onChangeCallback: () => void;
 
     set(x: number, y: number, z: number, order?: string): Euler;
-    clone(): Euler;
+    clone(): this;
     copy(euler: Euler): this;
-    setFromRotationMatrix(m: Matrix4, order?: string): Euler;
-    setFromQuaternion(q: Quaternion, order?: string): Euler;
+    setFromRotationMatrix(m: Matrix4, order?: string, update?: boolean): Euler;
+    setFromQuaternion(q: Quaternion, order?: string, update?: boolean): Euler;
     setFromVector3(v: Vector3, order?: string): Euler;
     reorder(newOrder: string): Euler;
     equals(euler: Euler): boolean;

three/src/math/Frustum.d.ts

@@ -18,7 +18,7 @@ export class Frustum {
     planes: Plane[];
 
     set(p0: Plane, p1: Plane, p2: Plane, p3: Plane, p4: Plane, p5: Plane): Frustum;
-    clone(): Frustum;
+    clone(): this;
     copy(frustum: Frustum): this;
     setFromProjectionMatrix(m: Matrix4): this;
     intersectsObject(object: Object3D): boolean;

three/src/math/Line3.d.ts

@@ -15,7 +15,7 @@ export class Line3 {
     end: Vector3;
 
     set(start?: Vector3, end?: Vector3): Line3;
-    clone(): Line3;
+    clone(): this;
     copy(line: Line3): this;
     getCenter(target: Vector3): Vector3;
     delta(target: Vector3): Vector3;

three/src/math/MathUtils.d.ts

@@ -68,6 +68,8 @@ export namespace MathUtils {
 
     function isPowerOfTwo(value: number): boolean;
 
+    function inverseLerp(x: number, y: number, t: number): number;
+
     /**
      * Returns a value linearly interpolated from two known points based
      * on the given interval - t = 0 will return x and t = 1 will return y.

three/src/math/Matrix3.d.ts

@@ -72,7 +72,7 @@ export class Matrix3 implements Matrix {
         n33: number,
     ): Matrix3;
     identity(): Matrix3;
-    clone(): Matrix3;
+    clone(): this;
     copy(m: Matrix3): this;
     extractBasis(xAxis: Vector3, yAxis: Vector3, zAxis: Vector3): Matrix3;
     setFromMatrix4(m: Matrix4): Matrix3;

three/src/math/Matrix4.d.ts

@@ -1,7 +1,7 @@
 import { Vector3 } from './Vector3';
 import { Euler } from './Euler';
 import { Quaternion } from './Quaternion';
-import { Matrix } from './Matrix3';
+import { Matrix, Matrix3 } from './Matrix3';
 
 export type Matrix4Tuple = [
     number,
@@ -184,6 +184,11 @@ export class Matrix4 implements Matrix {
      */
     makeScale(x: number, y: number, z: number): Matrix4;
 
+    /**
+     * Sets this matrix as shear transform.
+     */
+    makeShear(x: number, y: number, z: number): Matrix4;
+
     /**
      * Sets this matrix to the transformation composed of translation, rotation and scale.
      */
@@ -234,6 +239,11 @@ export class Matrix4 implements Matrix {
      */
     toArray(array?: ArrayLike<number>, offset?: number): ArrayLike<number>;
 
+    /**
+     * Set the upper 3x3 elements of this matrix to the values of the Matrix3 m.
+     */
+    setFromMatrix3(m: Matrix3): Matrix4;
+
     /**
      * @deprecated Use {@link Matrix4#copyPosition .copyPosition()} instead.
      */

three/src/math/Plane.d.ts

@@ -24,7 +24,7 @@ export class Plane {
     setComponents(x: number, y: number, z: number, w: number): Plane;
     setFromNormalAndCoplanarPoint(normal: Vector3, point: Vector3): Plane;
     setFromCoplanarPoints(a: Vector3, b: Vector3, c: Vector3): Plane;
-    clone(): Plane;
+    clone(): this;
     copy(plane: Plane): this;
     normalize(): Plane;
     negate(): Plane;
@@ -32,7 +32,7 @@ export class Plane {
     distanceToSphere(sphere: Sphere): number;
     projectPoint(point: Vector3, target: Vector3): Vector3;
     orthoPoint(point: Vector3, target: Vector3): Vector3;
-    intersectLine(line: Line3, target: Vector3): Vector3 | undefined;
+    intersectLine(line: Line3, target: Vector3): Vector3 | null;
     intersectsLine(line: Line3): boolean;
     intersectsBox(box: Box3): boolean;
     intersectsSphere(sphere: Sphere): boolean;

three/src/math/Quaternion.d.ts

@@ -49,7 +49,7 @@ export class Quaternion {
     /**
      * Clones this quaternion.
      */
-    clone(): Quaternion;
+    clone(): this;
 
     /**
      * Copies values of q to this quaternion.
@@ -59,7 +59,7 @@ export class Quaternion {
     /**
      * Sets this quaternion from rotation specified by Euler angles.
      */
-    setFromEuler(euler: Euler): Quaternion;
+    setFromEuler(euler: Euler, update?: boolean): Quaternion;
 
     /**
      * Sets this quaternion from rotation specified by axis and angle.
@@ -110,6 +110,7 @@ export class Quaternion {
     multiplyQuaternions(a: Quaternion, b: Quaternion): Quaternion;
 
     slerp(qb: Quaternion, t: number): Quaternion;
+    slerpQuaternions(qa: Quaternion, qb: Quaternion, t: number): Quaternion;
     equals(v: Quaternion): boolean;
 
     /**
@@ -138,11 +139,6 @@ export class Quaternion {
     _onChange(callback: () => void): Quaternion;
     _onChangeCallback: () => void;
 
-    /**
-     * Adapted from http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/slerp/.
-     */
-    static slerp(qa: Quaternion, qb: Quaternion, qm: Quaternion, t: number): Quaternion;
-
     static slerpFlat(
         dst: number[],
         dstOffset: number,

three/src/math/Ray.d.ts

@@ -18,7 +18,7 @@ export class Ray {
     direction: Vector3;
 
     set(origin: Vector3, direction: Vector3): Ray;
-    clone(): Ray;
+    clone(): this;
     copy(ray: Ray): this;
     at(t: number, target: Vector3): Vector3;
     lookAt(v: Vector3): Ray;

three/src/math/Sphere.d.ts

@@ -18,8 +18,9 @@ export class Sphere {
 
     set(center: Vector3, radius: number): Sphere;
     setFromPoints(points: Vector3[], optionalCenter?: Vector3): Sphere;
-    clone(): Sphere;
+    clone(): this;
     copy(sphere: Sphere): this;
+    expandByPoint(point: Vector3): this;
     isEmpty(): boolean;
     makeEmpty(): this;
     containsPoint(point: Vector3): boolean;
@@ -32,6 +33,7 @@ export class Sphere {
     applyMatrix4(matrix: Matrix4): Sphere;
     translate(offset: Vector3): Sphere;
     equals(sphere: Sphere): boolean;
+    union(sphere: Sphere): this;
 
     /**
      * @deprecated Use {@link Sphere#isEmpty .isEmpty()} instead.

three/src/math/Spherical.d.ts

@@ -19,7 +19,7 @@ export class Spherical {
     theta: number;
 
     set(radius: number, phi: number, theta: number): this;
-    clone(): Spherical;
+    clone(): this;
     copy(other: Spherical): this;
     makeSafe(): this;
     setFromVector3(v: Vector3): this;

three/src/math/SphericalHarmonics3.d.ts

@@ -18,7 +18,7 @@ export class SphericalHarmonics3 {
     lerp(sh: SphericalHarmonics3, alpha: number): SphericalHarmonics3;
     equals(sh: SphericalHarmonics3): boolean;
     copy(sh: SphericalHarmonics3): SphericalHarmonics3;
-    clone(): SphericalHarmonics3;
+    clone(): this;
 
     /**
      * Sets the values of this spherical harmonics from the provided array or array-like.

three/src/math/Triangle.d.ts

@@ -23,7 +23,7 @@ export class Triangle {
 
     set(a: Vector3, b: Vector3, c: Vector3): Triangle;
     setFromPointsAndIndices(points: Vector3[], i0: number, i1: number, i2: number): Triangle;
-    clone(): Triangle;
+    clone(): this;
     copy(triangle: Triangle): this;
     getArea(): number;
     getMidpoint(target: Vector3): Vector3;

three/src/math/Vector2.d.ts

@@ -185,7 +185,7 @@ export class Vector2 implements Vector {
     /**
      * Returns a new Vector2 instance with the same `x` and `y` values.
      */
-    clone(): Vector2;
+    clone(): this;
 
     /**
      * Copies value of v to this vector.

three/src/math/Vector3.d.ts

@@ -73,7 +73,7 @@ export class Vector3 implements Vector {
     /**
      * Clones this vector.
      */
-    clone(): Vector3;
+    clone(): this;
 
     /**
      * Copies value of v to this vector.

three/src/math/Vector4.d.ts

@@ -74,7 +74,7 @@ export class Vector4 implements Vector {
     /**
      * Clones this vector.
      */
-    clone(): Vector4;
+    clone(): this;
 
     /**
      * Copies value of v to this vector.

three/src/objects/SkinnedMesh.d.ts

@@ -1,5 +1,6 @@
 import { Material } from './../materials/Material';
 import { Matrix4 } from './../math/Matrix4';
+import { Vector3 } from './../math/Vector3';
 import { Skeleton } from './Skeleton';
 import { Mesh } from './Mesh';
 import { BufferGeometry } from '../core/BufferGeometry';
@@ -20,4 +21,5 @@ export class SkinnedMesh<
     pose(): void;
     normalizeSkinWeights(): void;
     updateMatrixWorld(force?: boolean): void;
+    boneTransform(index: number, target: Vector3): Vector3;
 }

three/src/renderers/WebGLRenderTarget.d.ts

@@ -93,7 +93,7 @@ export class WebGLRenderTarget extends EventDispatcher {
 
     setTexture(texture: Texture): void;
     setSize(width: number, height: number, depth?: number): void;
-    clone(): WebGLRenderTarget;
+    clone(): this;
     copy(source: WebGLRenderTarget): this;
     dispose(): void;
 }

three/src/renderers/WebGLRenderer.d.ts

@@ -197,16 +197,6 @@ export class WebGLRenderer implements Renderer {
      */
     toneMappingExposure: number;
 
-    /**
-     * @default 8
-     */
-    maxMorphTargets: number;
-
-    /**
-     * @default 4
-     */
-    maxMorphNormals: number;
-
     info: WebGLInfo;
 
     shadowMap: WebGLShadowMap;
@@ -377,14 +367,6 @@ export class WebGLRenderer implements Renderer {
      */
     getActiveMipmapLevel(): number;
 
-    /**
-     * Sets the given WebGLFramebuffer. This method can only be used if no render target is set via
-     * {@link WebGLRenderer#setRenderTarget .setRenderTarget}.
-     *
-     * @param value The WebGLFramebuffer.
-     */
-    setFramebuffer(value: WebGLFramebuffer): void;
-
     /**
      * Returns the current render target. If no render target is set, null is returned.
      */

three/src/renderers/webgl/WebGLShadowMap.d.ts

@@ -1,3 +1,4 @@
+import { WebGLCapabilities } from './WebGLCapabilities';
 import { Scene } from './../../scenes/Scene';
 import { Camera } from './../../cameras/Camera';
 import { WebGLRenderer } from '../WebGLRenderer';
@@ -6,7 +7,7 @@ import { WebGLObjects } from './WebGLObjects';
 import { Light } from '../../lights/Light';
 
 export class WebGLShadowMap {
-    constructor(_renderer: WebGLRenderer, _objects: WebGLObjects, maxTextureSize: number);
+    constructor(_renderer: WebGLRenderer, _objects: WebGLObjects, _capabilities: WebGLCapabilities);
 
     /**
      * @default false

three/src/renderers/webgl/WebGLState.d.ts

@@ -66,6 +66,8 @@ export class WebGLState {
     ): void;
     enable(id: number): void;
     disable(id: number): void;
+    bindFramebuffer(target: number, framebuffer: WebGLFramebuffer | null): void;
+    bindXRFramebuffer(framebuffer: WebGLFramebuffer | null): void;
     useProgram(program: any): boolean;
     setBlending(
         blending: Blending,

three/src/renderers/webxr/WebXR.d.ts

@@ -78,13 +78,23 @@ export interface XRRenderStateInit {
     baseLayer?: XRWebGLLayer;
 }
 
+export interface XRGamepad {
+    readonly id: string;
+    readonly index: number; // long
+    readonly connected: boolean;
+    readonly timestamp: DOMHighResTimeStamp;
+    readonly mapping: GamepadMappingType;
+    readonly axes: Float32Array; // FrozenArray<double>;
+    readonly buttons: GamepadButton[]; // FrozenArray<GamepadButton>;
+}
+
 export interface XRInputSource {
     readonly handedness: XRHandedness;
     readonly targetRayMode: XRTargetRayMode;
     readonly targetRaySpace: EventTarget;
     readonly gripSpace?: EventTarget;
     readonly profiles: string[];
-    readonly gamepad: Gamepad;
+    readonly gamepad: XRGamepad;
     readonly hand?: XRHand;
 }