@xviewer.js/core 1.0.0-alpha.5 → 1.0.0-alpha.50

package/types/math/Interpolation.d.ts

@@ -1,9 +1,9 @@
-import { Quaternion } from "three";
-export declare function VInterpTo(current: any, target: any, deltaTime: any, speed: any, out?: any): any;
-export declare function VInterpConstantTo(current: any, target: any, deltaTime: any, speed: any, out?: any): any;
+import { Quaternion, Vector3 } from "three";
+export declare function VInterpTo(current: Vector3, target: Vector3, deltaTime: number, speed: number, out?: Vector3): Vector3;
+export declare function VInterpConstantTo(current: Vector3, target: Vector3, deltaTime: number, speed: number, out?: Vector3): Vector3;
 export declare function Quat_Equals(a: Quaternion, b: Quaternion, epsilon?: number): boolean;
 export declare function Quat_AngularDistance(a: Quaternion, b: Quaternion): number;
 export declare function QInterpTo(current: Quaternion, target: Quaternion, deltaTime: number, speed: number): Quaternion;
-export declare function QInterpConstantTo(current: any, target: any, deltaTime: any, speed: any, out?: any): any;
-export declare function FInterpTo(current: any, target: any, deltaTime: any, speed: any): any;
-export declare function FInterpConstantTo(current: any, target: any, deltaTime: any, speed: any): any;
+export declare function QInterpConstantTo(current: Quaternion, target: Quaternion, deltaTime: number, speed: number, out?: Quaternion): Quaternion;
+export declare function FInterpTo(current: number, target: number, deltaTime: number, speed: number): number;
+export declare function FInterpConstantTo(current: number, target: number, deltaTime: number, speed: number): number;

package/types/math/Perlin.d.ts

@@ -0,0 +1,12 @@
+export declare class Perlin {
+    static Noise(x: number): number;
+    static Noise(x: number, y: number): number;
+    static Noise(x: number, y: number, z: number): number;
+    static Fbm(octave: number, x: number): number;
+    static Fbm(octave: number, x: number, y: number): number;
+    static Fbm(octave: number, x: number, y: number, z: number): number;
+    private static _Fade;
+    private static _Lerp;
+    private static _Grad;
+    private static _Permutation;
+}

package/types/math/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./Damp";
+export * from "./Constant";
+export * from "./Interpolation";
+export { AnimationCurve } from "./AnimationCurve";
+export { Perlin } from "./Perlin";

package/types/passes/MipBlurPass.d.ts

@@ -0,0 +1,27 @@
+import { CubeTexture, Texture, WebGLCubeRenderTarget } from "three";
+import { Viewer } from "../Viewer";
+export declare class MipBlurPass {
+    private _viewer;
+    private _mipmapRenderTargets;
+    private _cubeRenderTarget;
+    private _blurMaterial;
+    private _blurIntensity;
+    private _sigma;
+    private _minLod;
+    private _maxLod;
+    private _onChanged?;
+    private _uniforms;
+    get exposure(): number;
+    set exposure(v: number);
+    get blurIntensity(): number;
+    set blurIntensity(v: number);
+    getBlurTexture(): CubeTexture;
+    constructor(props: {
+        viewer: Viewer;
+        cubeRenderTarget: WebGLCubeRenderTarget;
+        onChanged?: (tex: Texture) => void;
+    });
+    dispose(): void;
+    update(): void;
+    private _blur;
+}

package/types/passes/cubeuv/MergeBlurPass.d.ts

@@ -0,0 +1,21 @@
+import { CubeTexture, Texture, WebGLRenderTarget } from "three";
+import { Viewer } from "../../Viewer";
+import { MergeInfo } from "./MergeInfo";
+export declare class MergeMipBlurPass {
+    private _pmremGenerator;
+    private _sigma;
+    private _blurMinLod;
+    private _blurMaxLod;
+    private _blurIntensity;
+    private _envMapTarget;
+    private _reflectMap;
+    get envMapTarget(): WebGLRenderTarget<Texture>;
+    constructor({ viewer, reflectMap, }: {
+        viewer: Viewer;
+        reflectMap: CubeTexture;
+    });
+    dispose(): void;
+    mergeMipBlur(info: MergeInfo): void;
+    private _setBlurIntensity;
+    private _getPMREMExtension;
+}

package/types/passes/cubeuv/MergeInfo.d.ts

@@ -0,0 +1,9 @@
+import { WebGLRenderTarget } from "three";
+export interface MergeInfo {
+    quality: number;
+    envMapTarget: WebGLRenderTarget;
+    envMapIntensity: number;
+    blurIntensity: number;
+    lodMax: number;
+    exposure: number;
+}

package/types/passes/cubeuv/MergeReflectPass.d.ts

@@ -0,0 +1,18 @@
+import { CubeTexture, Texture, WebGLRenderTarget } from "three";
+import { Viewer } from "../../Viewer";
+import { MergeInfo } from "./MergeInfo";
+export declare class MergeRefectPass {
+    private _pmremGenerator;
+    private _reflectMap;
+    private _envMapTarget;
+    private _sourceTarget;
+    get envMapTarget(): WebGLRenderTarget<Texture>;
+    constructor({ envMap, reflectMap, viewer, }: {
+        envMap?: Texture;
+        reflectMap: CubeTexture;
+        viewer: Viewer;
+    });
+    dispose(): void;
+    mergeReflect(info: MergeInfo): void;
+    private _getPMREMExtension;
+}

package/types/passes/cubeuv/utils.d.ts

@@ -0,0 +1,16 @@
+import { OrthographicCamera, ShaderMaterial, Vector3, WebGLRenderTarget } from "three";
+export declare const LOD_MIN = 4;
+export declare const _flatCamera: OrthographicCamera;
+export declare const _axisDirections: Vector3[];
+export declare const _Quality: {
+    LOW: number;
+    MEDIUM: number;
+    HIGH: number;
+    ULTRA: number;
+};
+export declare function _setViewport(target: WebGLRenderTarget, x: number, y: number, width: number, height: number): void;
+export declare function _getCommonVertexShader(): string;
+export declare function _getClearMaterial(): ShaderMaterial;
+export declare function _getCubeMapMaterial(): ShaderMaterial;
+export declare function _getMipCopyMaterial(lodMax: number, width: number, height: number): ShaderMaterial;
+export declare function _getMipBlurMaterial(lodMax: number, width: number, height: number): ShaderMaterial;

package/types/passes/mipGaussianBlendWeight.d.ts

@@ -0,0 +1 @@
+export declare function mipGaussianBlendWeight(sigma: number, lod: number): number;

package/types/plugins/BoxProjectionPlugin.d.ts

@@ -0,0 +1,20 @@
+import { Vector3, Vector4, WebGLProgramParametersWithUniforms } from "three";
+import { Plugin } from "../Plugin";
+export declare class BoxProjectionPlugin extends Plugin {
+    private _center;
+    private _boxMin;
+    private _boxMax;
+    private _helper;
+    private _debug;
+    get debug(): boolean;
+    set debug(v: boolean);
+    get center(): Vector4;
+    set center(v: Vector4);
+    get boxMin(): Vector3;
+    set boxMin(v: Vector3);
+    get boxMax(): Vector3;
+    set boxMax(v: Vector3);
+    constructor();
+    onUpdate(dt: number): void;
+    useBoxProjection(shader: WebGLProgramParametersWithUniforms): void;
+}

package/types/plugins/DebugPlugin.d.ts

@@ -0,0 +1,10 @@
+import { Object3D, Scene } from "three";
+import { Plugin } from "../Plugin";
+import { Viewer } from "../Viewer";
+export declare class DebugPlugin extends Plugin {
+    static Instance(viewer: Viewer): DebugPlugin;
+    scene: Scene;
+    add(node: Object3D): Object3D<import("three").Object3DEventMap>;
+    remove(node: Object3D): Object3D<import("three").Object3DEventMap>;
+    onRender(dt: number): void;
+}

package/types/plugins/EnvironmentPlugin.d.ts

@@ -0,0 +1,40 @@
+import { Object3D, Scene, Texture, TextureDataType, Vector3 } from "three";
+import { Plugin } from "../Plugin";
+export declare class EnvironmentPlugin extends Plugin {
+    static readonly Quality: {
+        LOW: number;
+        MEDIUM: number;
+        HIGH: number;
+        ULTRA: number;
+    };
+    private _scene;
+    private _cubeCamera;
+    private _reflectPass;
+    private _mipBlurPass;
+    private _mergeInfo;
+    private _debug;
+    private _debugNode;
+    private _elapsed;
+    get debug(): boolean;
+    set debug(v: boolean);
+    quality: number;
+    envMapIntensity: number;
+    reflectExposure: number;
+    reflectBlurIntensity: number;
+    interval: number;
+    manual: boolean;
+    constructor({ envMap, scene, near, far, layer, resolution, floatType, position, }?: {
+        envMap?: Texture;
+        scene?: Scene | Object3D;
+        performance?: number;
+        resolution?: number;
+        layer?: number;
+        near?: number;
+        far?: number;
+        floatType?: boolean | TextureDataType;
+        position?: Vector3;
+    });
+    onRender(dt: number): void;
+    manualFrame(): void;
+    private _renderFrame;
+}

package/types/plugins/PerformanceMonitorPlugin.d.ts

@@ -0,0 +1,48 @@
+import { Plugin } from "../Plugin";
+type PerformanceMonitorProps = {
+    /** How much time in milliseconds to collect an average fps, 250 */
+    ms?: number;
+    /** How many interations of averages to collect, 10 */
+    iterations?: number;
+    /** The percentage of iterations that are matched against the lower and upper bounds, 0.75 */
+    threshold?: number;
+    /** A function that receive the max device refreshrate to determine lower and upper bounds which create a margin where neither incline nor decline should happen, (refreshrate) => (refreshrate > 90 ? [50, 90] : [50, 60]) */
+    bounds?: (refreshrate: number) => [lower: number, upper: number];
+    /** How many times it can inline or decline before onFallback is called, Infinity */
+    flipflops?: number;
+    /** The factor increases and decreases between 0-1, this prop sets the starting value, 0.5 */
+    factor?: number;
+    /** The step that gets added or subtracted to or from the factor on each incline/decline, 0.1 */
+    step?: number;
+    /** When performance is higher than the upper bound (good!) */
+    onIncline?: (monitor: PerformanceMonitorPlugin) => void;
+    /** When performance is lower than the upper bound (bad!) */
+    onDecline?: (monitor: PerformanceMonitorPlugin) => void;
+    /** Incline and decline will change the factor, this will trigger when that happened */
+    onChange?: (monitor: PerformanceMonitorPlugin) => void;
+    /** Called after when the number of flipflops is reached, it indicates instability, use the function to set a fixed baseline */
+    onFallback?: (monitor: PerformanceMonitorPlugin) => void;
+};
+type PerformanceMonitorSubscriber = {
+    onIncline?: (monitor: PerformanceMonitorPlugin) => void;
+    /** When performance is lower than the upper bound (bad!) */
+    onDecline?: (monitor: PerformanceMonitorPlugin) => void;
+    /** Incline and decline will change the factor, this will trigger when that happened */
+    onChange?: (monitor: PerformanceMonitorPlugin) => void;
+    /** Called after when the number of flipflops is reached, it indicates instability, use the function to set a fixed baseline */
+    onFallback?: (monitor: PerformanceMonitorPlugin) => void;
+};
+export declare class PerformanceMonitorPlugin extends Plugin {
+    fps: number;
+    index: number;
+    factor: number;
+    flipped: number;
+    refreshrate: number;
+    fallback: boolean;
+    frames: any[];
+    averages: any[];
+    subscriptions: Map<any, any>;
+    subscribe(subscriber: PerformanceMonitorSubscriber): void;
+    constructor({ iterations, ms, threshold, step, factor: _factor, flipflops, bounds, onIncline, onDecline, onChange, onFallback, }: PerformanceMonitorProps);
+}
+export {};

package/types/plugins/index.d.ts

@@ -0,0 +1,4 @@
+export { DebugPlugin } from "./DebugPlugin";
+export { EnvironmentPlugin } from "./EnvironmentPlugin";
+export { BoxProjectionPlugin } from "./BoxProjectionPlugin";
+export { PerformanceMonitorPlugin } from "./PerformanceMonitorPlugin";

package/types/tween/Easing.d.ts

@@ -0,0 +1,25 @@
+export type EasingFunction = (amount: number) => number;
+export type EasingFunctionGroup = {
+    In: EasingFunction;
+    Out: EasingFunction;
+    InOut: EasingFunction;
+};
+/**
+ * The Ease class provides a collection of easing functions for use with tween.js.
+ */
+export declare const Easing: Readonly<{
+    Linear: Readonly<EasingFunctionGroup & {
+        None: EasingFunction;
+    }>;
+    Quadratic: Readonly<EasingFunctionGroup>;
+    Cubic: Readonly<EasingFunctionGroup>;
+    Quartic: Readonly<EasingFunctionGroup>;
+    Quintic: Readonly<EasingFunctionGroup>;
+    Sinusoidal: Readonly<EasingFunctionGroup>;
+    Exponential: Readonly<EasingFunctionGroup>;
+    Circular: Readonly<EasingFunctionGroup>;
+    Elastic: Readonly<EasingFunctionGroup>;
+    Back: Readonly<EasingFunctionGroup>;
+    Bounce: Readonly<EasingFunctionGroup>;
+    generatePow(power?: number): EasingFunctionGroup;
+}>;

package/types/tween/Group.d.ts

@@ -0,0 +1,16 @@
+import type { Tween, UnknownProps } from './Tween';
+/**
+ * Controlling groups of tweens
+ *
+ * Using the TWEEN singleton to manage your tweens can cause issues in large apps with many components.
+ * In these cases, you may want to create your own smaller groups of tween
+ */
+export declare class Group {
+    private _tweens;
+    private _tweensAddedDuringUpdate;
+    getAll(): Array<Tween<UnknownProps>>;
+    removeAll(): void;
+    add(tween: Tween<UnknownProps>): void;
+    remove(tween: Tween<UnknownProps>): void;
+    update(time?: number, preserve?: boolean): boolean;
+}

package/types/tween/Interpolation.d.ts

@@ -0,0 +1,19 @@
+/**
+ *
+ */
+export type InterpolationFunction = (v: number[], k: number) => number;
+/**
+ *
+ */
+declare const Interpolation: {
+    Linear: (v: number[], k: number) => number;
+    Bezier: (v: number[], k: number) => number;
+    CatmullRom: (v: number[], k: number) => number;
+    Utils: {
+        Linear: (p0: number, p1: number, t: number) => number;
+        Bernstein: (n: number, i: number) => number;
+        Factorial: (n: number) => number;
+        CatmullRom: (p0: number, p1: number, p2: number, p3: number, t: number) => number;
+    };
+};
+export { Interpolation };

package/types/tween/Now.d.ts

@@ -0,0 +1,2 @@
+declare const now: () => number;
+export { now };

package/types/tween/Sequence.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utils
+ */
+export declare class Sequence {
+    private static _nextId;
+    static nextId(): number;
+}

package/types/tween/Tween.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Tween.js - Licensed under the MIT license
+ * https://github.com/tweenjs/tween.js
+ * ----------------------------------------------
+ *
+ * See https://github.com/tweenjs/tween.js/graphs/contributors for the full list of contributors.
+ * Thank you all, you're awesome!
+ */
+import type { EasingFunction } from './Easing';
+import type { InterpolationFunction } from './Interpolation';
+import type { Group } from './Group';
+export declare class Tween<T extends UnknownProps> {
+    private _object;
+    private _group;
+    private _isPaused;
+    private _pauseStart;
+    private _valuesStart;
+    private _valuesEnd;
+    private _valuesStartRepeat;
+    private _duration;
+    private _isDynamic;
+    private _initialRepeat;
+    private _repeat;
+    private _repeatDelayTime?;
+    private _yoyo;
+    private _isPlaying;
+    private _reversed;
+    private _delayTime;
+    private _startTime;
+    private _easingFunction;
+    private _interpolationFunction;
+    private _chainedTweens;
+    private _onStartCallback?;
+    private _onStartCallbackFired;
+    private _onEveryStartCallback?;
+    private _onEveryStartCallbackFired;
+    private _onUpdateCallback?;
+    private _onRepeatCallback?;
+    private _onCompleteCallback?;
+    private _onStopCallback?;
+    private _onFinishCallback?;
+    private _id;
+    private _isChainStopped;
+    private _propertiesAreSetUp;
+    private _headTween;
+    private _tailTween;
+    private _headTweenStartFired;
+    constructor(_object: T, _group?: Group | false);
+    getId(): number;
+    isPlaying(): boolean;
+    isPaused(): boolean;
+    getDuration(): number;
+    from(properties: UnknownProps): this;
+    to(target: UnknownProps, duration?: number): this;
+    duration(duration?: number): this;
+    dynamic(dynamic?: boolean): this;
+    start(time?: number, overrideStartingValues?: boolean): this;
+    startFromCurrentValues(time?: number): this;
+    private _setupProperties;
+    stop(): this;
+    end(): this;
+    pause(time?: number): this;
+    resume(time?: number): this;
+    stopChainedTweens(): this;
+    group(group?: Group): this;
+    call(callback: (object: T) => void): this;
+    delay(amount?: number): this;
+    union(headTween: Tween<T>, tailTween: Tween<T>): this;
+    repeat(times?: number): this;
+    repeatDelay(amount?: number): this;
+    yoyo(yoyo?: boolean): this;
+    easing(easingFunction?: EasingFunction): this;
+    interpolation(interpolationFunction?: InterpolationFunction): this;
+    chain(...tweens: Array<Tween<any>>): this;
+    unchain(...tweens: Array<Tween<any>>): this;
+    onStart(callback?: (object: T) => void): this;
+    onEveryStart(callback?: (object: T) => void): this;
+    onUpdate(callback?: (object: T, elapsed: number) => void): this;
+    onRepeat(callback?: (object: T) => void): this;
+    onComplete(callback?: (object: T) => void): this;
+    onStop(callback?: (object: T) => void): this;
+    private _goToEnd;
+    /**
+     * @returns true if the tween is still playing after the update, false
+     * otherwise (calling update on a paused tween still returns true because
+     * it is still playing, just paused).
+     */
+    update(time?: number, autoStart?: boolean): boolean;
+    private _calculateElapsedPortion;
+    private _calculateCompletionStatus;
+    private _processRepetition;
+    private _updateProperties;
+    private _handleRelativeValue;
+    private _swapEndStartRepeatValues;
+}
+export type UnknownProps = Record<string, any>;

package/types/tween/TweenChain.d.ts

@@ -1,15 +1,25 @@
-import { Group, Tween } from "./tween";
+import { Tween } from "./Tween";
+import { Group } from "./Group";
 export declare class TweenChain {
     private _object;
+    private _group;
     private _tween;
     private _chainedTween;
     constructor(object: Object, group?: Group);
     start(): this;
     stop(): this;
-    repeat(times: any): this;
+    repeat(times: number): this;
     union(): this;
-    call(callback: any): this;
-    delay(amount: any): this;
-    to(properties: any, duration: any, props: any): this;
+    call(callback: (object: Object) => void): this;
+    delay(amount: number): this;
+    to(properties: Record<string, any>, duration?: number, props?: {
+        from?: Record<string, any>;
+        easing?: (amount: number) => number;
+        onStart?: (object: Object) => void;
+        onStop?: (object: Object) => void;
+        onComplete?: (object: Object) => void;
+        onUpdate?: (object: Object, elapsed: number) => void;
+        onRepeat?: (object: Object) => void;
+    }): this;
     _chainTween(): Tween<Object>;
 }

package/types/tween/TweenManager.d.ts

@@ -1,10 +1,8 @@
 import { TweenChain } from "./TweenChain";
-import { Tween } from "./tween";
 export declare class TweenManager {
     private _group;
     destroy(): void;
     update(time: number): void;
-    tween(target: Object): Tween<Object>;
     timeline(target: Object): TweenChain;
     killTweensOf(target: Object): void;
 }

package/types/tween/Version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "23.1.2";

package/types/tween/index.d.ts

@@ -1,3 +1,5 @@
 export { TweenChain } from "./TweenChain";
 export { TweenManager } from "./TweenManager";
-export { Tween } from "./tween";
+export { Tween } from "./Tween";
+export type { EasingFunction } from "./Easing";
+export { Easing } from "./Easing";

package/types/tween/mainGroup.d.ts

@@ -0,0 +1,2 @@
+import { Group } from './Group';
+export declare const mainGroup: Group;

package/types/types.d.ts

@@ -45,6 +45,10 @@ export type __P<T, K extends __C<T>> = __Properties<T> & {
      * Object's local rotation
      */
     rotation?: Euler;
+    /**
+     * Object's layer mask
+     */
+    layer?: number;
 };
 export type __Comp<T, K extends __C<T>> = __Properties<T> & {
     /**

package/types/material/glsl/copy.glsl.d.ts

@@ -1 +0,0 @@
-export declare const frag_Copy = "\nvarying vec2      vUv;\nuniform sampler2D tMain;\nuniform float     uLod;\n\nvoid main() {\n    gl_FragColor = texture(tMain, vUv, uLod);\n\t#include <encodings_fragment>\n}\n";