@realsee/dnalogel 2.1.0-alpha.13 → 2.1.0-alpha.15

package/libs/src/shared-utils/Subscribe.js

@@ -0,0 +1,117 @@
+function createSymbol(description) {
+    // @ts-ignore
+    return typeof Symbol === 'undefined' ? `$Symbol<${description}>$` : Symbol(description);
+}
+const EVENT_SYMBOL = createSymbol('$$EVENT$$');
+function __generateEventIfNotExisted(instance) {
+    if (!instance[EVENT_SYMBOL]) {
+        instance[EVENT_SYMBOL] = {};
+    }
+    return instance[EVENT_SYMBOL];
+}
+function __removeEventIfNotExisted(instance) {
+    if (!instance[EVENT_SYMBOL]) {
+        delete instance[EVENT_SYMBOL];
+    }
+}
+/**
+ * 监听者模式
+ * @template T - 预设的监听回调类型
+ * @example
+ * ```
+ * new Subscribe<{
+ * "foo": [arg1: number, arg2: string],
+ * "bar": [arg: boolean],
+ * }>()
+ * ```
+ */
+class Subscribe {
+    /**
+     * 判断是否注册了事件
+     * @param name - 事件类型
+     */
+    hasListener(name) {
+        const events = __generateEventIfNotExisted(this);
+        return Boolean((events === null || events === void 0 ? void 0 : events[name]) && events[name].length > 0);
+    }
+    /**
+     * 注册事件
+     * @param name - 事件类型
+     * @param callback - 事件回调函数
+     * @param once - 是否只执行一次
+     * @returns 解除事件
+     * @template K - 预设的监听事件名称
+     * @template C - 回调函数函数上下文
+     */
+    on(name, callback, once) {
+        const events = __generateEventIfNotExisted(this);
+        if (!events[name])
+            events[name] = [];
+        events[name].push([callback, once || false]);
+        return () => this.off(name, callback);
+    }
+    /**
+     * 注册事件(是否只执行一次)
+     * @param name - 事件类型
+     * @param callback - 事件回调函数
+     * @returns 解除事件
+     * @template K - 预设的监听事件名称
+     * @template C - 回调函数函数上下文
+     */
+    once(name, callback) {
+        return this.on(name, callback, true);
+    }
+    /**
+     * 解除事件
+     *
+     * 如果 name 不传的话解除对应所有事件
+     * 如果 name, callback 不传的话解除所有name的所有事件
+     * @param name - 事件类型
+     * @param callback - 事件回调函数
+     * @template K - 预设的监听事件名称
+     */
+    off(name, callback) {
+        if (name === undefined) {
+            __removeEventIfNotExisted(this);
+            return;
+        }
+        const events = __generateEventIfNotExisted(this);
+        if (!events[name])
+            events[name] = [];
+        if (callback === undefined) {
+            events[name].length = 0;
+            return;
+        }
+        let index = 0;
+        for (; index < events[name].length; index++) {
+            if (events[name][index][0] === callback)
+                break;
+        }
+        if (index < events[name].length) {
+            events[name].splice(index, 1);
+        }
+    }
+    /**
+     * 触发事件
+     * @param name - 事件类型
+     * @param data - 触发事件的数据
+     * @returns canceled 是否被触发取消
+     * @template K - 预设的监听事件名称
+     */
+    emit(name, ...data) {
+        let canceled = false;
+        const events = __generateEventIfNotExisted(this);
+        const event = events[name] || [];
+        for (let one of event.slice()) {
+            const [callback, once = false] = one;
+            const result = callback(...data);
+            if (once)
+                this.off(name, callback);
+            if (result === false)
+                canceled = true;
+        }
+        return canceled;
+    }
+}
+export default Subscribe;
+export { Subscribe };

package/libs/src/shared-utils/animationFrame/BetterTween.d.ts

@@ -0,0 +1,11 @@
+import TWEEN from '@tweenjs/tween.js';
+export declare class BetterTween<G> extends TWEEN.Tween<G> {
+    private disposeMethods;
+    private animationFrameDisposer?;
+    onDispose: (callback: () => void) => this;
+    play: () => this;
+    dispose: () => void;
+}
+export declare function tweenProgress(duration?: number, easing?: (amount: number) => number): BetterTween<{
+    progress: number;
+}>;

package/libs/src/shared-utils/animationFrame/BetterTween.js

@@ -0,0 +1,59 @@
+import TWEEN from '@tweenjs/tween.js';
+import { requestAnimationFrameInterval } from './index';
+export class BetterTween extends TWEEN.Tween {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "disposeMethods", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "animationFrameDisposer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "onDispose", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (callback) => {
+                this.disposeMethods.push(callback);
+                return this;
+            }
+        });
+        Object.defineProperty(this, "play", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                this.start(0);
+                this.animationFrameDisposer = requestAnimationFrameInterval((time) => this.update(time));
+                return this;
+            }
+        });
+        Object.defineProperty(this, "dispose", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                var _a;
+                this.stop();
+                (_a = this.animationFrameDisposer) === null || _a === void 0 ? void 0 : _a.call(this);
+                this.disposeMethods.forEach((fn) => fn());
+                this.disposeMethods = [];
+                TWEEN.remove(this);
+            }
+        });
+    }
+}
+export function tweenProgress(duration, easing = TWEEN.Easing.Linear.None) {
+    const tween = new BetterTween({ progress: 0 }).to({ progress: 1 });
+    if (duration !== undefined)
+        tween.duration(duration);
+    if (easing !== undefined)
+        tween.easing(easing);
+    return tween;
+}

package/libs/src/shared-utils/animationFrame/calculateProgress.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 线性过程插值
+ */
+export declare function progressNumber(from: number, to: number, pst: number): number;
+/**
+ * 弧度过程插值值,会取锐角进行插值
+ */
+export declare function progressRad(from: number, to: number, pst: number): number;

package/libs/src/shared-utils/animationFrame/calculateProgress.js

@@ -0,0 +1,23 @@
+import { formatRad } from './formatRad';
+const PI = Math.PI;
+const PI_2 = PI * 2;
+/**
+ * 线性过程插值
+ */
+export function progressNumber(from, to, pst) {
+    return from + (to - from) * pst;
+}
+/**
+ * 弧度过程插值值,会取锐角进行插值
+ */
+export function progressRad(from, to, pst) {
+    from = formatRad(from);
+    to = formatRad(to);
+    if (to - from > PI) {
+        return formatRad(progressNumber(from + PI_2, to, pst));
+    }
+    if (from - to > PI) {
+        return formatRad(progressNumber(from - PI_2, to, pst));
+    }
+    return progressNumber(from, to, pst);
+}

package/libs/src/shared-utils/animationFrame/formatRad.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 把一个任意角度的弧度值转换为一个 [0, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export declare function formatLongitude(rad: number): number;
+/**
+ * 把一个任意角度的弧度值转换为一个 [-2PI, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export declare function formatLatitude(rad: number): number;
+/**
+ * 把一个任意角度的弧度值转换为一个 [0, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export declare const formatRad: typeof formatLongitude;

package/libs/src/shared-utils/animationFrame/formatRad.js

@@ -0,0 +1,20 @@
+const PI_2 = Math.PI * 2;
+/**
+ * 把一个任意角度的弧度值转换为一个 [0, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export function formatLongitude(rad) {
+    return ((rad % PI_2) + PI_2) % PI_2;
+}
+/**
+ * 把一个任意角度的弧度值转换为一个 [-2PI, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export function formatLatitude(rad) {
+    return rad % PI_2;
+}
+/**
+ * 把一个任意角度的弧度值转换为一个 [0, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export const formatRad = formatLongitude;

package/libs/src/shared-utils/animationFrame/index.d.ts

@@ -0,0 +1,15 @@
+declare const _requestAnimationFrame: ((callback: FrameRequestCallback) => number) & typeof requestAnimationFrame;
+export default _requestAnimationFrame;
+export declare function nextFrame(fn: FrameRequestCallback, delay?: number): void;
+/**
+ * 在每个 AnimationFrame 中调用传入的函数
+ * @param callback 每次 AnimationFrame 中调用的函数
+ * @param frame 每秒运行多少次
+ * @returns 返回一个函数，调用可以停止 AnimationFrameLoop
+ */
+export declare function requestAnimationFrameInterval(callback?: (time: number) => any, frame?: number): () => void;
+/**
+ * 获取两个 AnimationFrame 间隔的时间
+ * @returns 返回一个 Promise，resolve 的结果是两个 AnimationFrame 间隔的时间
+ */
+export declare function getFrameTime(): Promise<unknown>;

package/libs/src/shared-utils/animationFrame/index.js

@@ -0,0 +1,48 @@
+const _requestAnimationFrame = window.requestAnimationFrame || ((fn) => setTimeout(fn, 16));
+const _cancelAnimationFrame = window.cancelAnimationFrame || clearTimeout;
+export default _requestAnimationFrame;
+export function nextFrame(fn, delay = 0) {
+    if (delay <= 0)
+        _requestAnimationFrame(fn);
+    else
+        _requestAnimationFrame(() => nextFrame(fn, delay - 1));
+}
+/**
+ * 在每个 AnimationFrame 中调用传入的函数
+ * @param callback 每次 AnimationFrame 中调用的函数
+ * @param frame 每秒运行多少次
+ * @returns 返回一个函数，调用可以停止 AnimationFrameLoop
+ */
+export function requestAnimationFrameInterval(callback, frame = 60) {
+    let index = -1;
+    let oldTime = 0;
+    let startTime = -1;
+    const minDeltaTime = 1000 / frame;
+    function loop(time) {
+        startTime === -1 && (startTime = time);
+        index = _requestAnimationFrame(loop);
+        const deltaTime = time - oldTime;
+        if (deltaTime < minDeltaTime)
+            return;
+        oldTime = time;
+        callback && callback(time - startTime);
+    }
+    index = _requestAnimationFrame(loop);
+    return function stop() {
+        _cancelAnimationFrame(index);
+    };
+}
+/**
+ * 获取两个 AnimationFrame 间隔的时间
+ * @returns 返回一个 Promise，resolve 的结果是两个 AnimationFrame 间隔的时间
+ */
+export function getFrameTime() {
+    const start = Date.now();
+    return new Promise((resolve) => {
+        _requestAnimationFrame(() => {
+            resolve(Date.now() - start);
+        });
+    });
+}
+// export { Easing } from './tween'
+// export { default as tween } from './tween'

package/libs/src/shared-utils/animationFrame/tween.d.ts

@@ -0,0 +1,75 @@
+import * as TWEEN from '@tweenjs/tween.js';
+export declare const Easing: {
+    Linear: {
+        None: (amount: number) => number;
+    };
+    Quadratic: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Cubic: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Quartic: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Quintic: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Sinusoidal: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Exponential: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Circular: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Elastic: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Back: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+    Bounce: {
+        In: (amount: number) => number;
+        Out: (amount: number) => number;
+        InOut: (amount: number) => number;
+    };
+};
+interface ITween<T> extends TWEEN.Tween<T> {
+    onDestroy: (fn: () => void) => TWEEN.Tween<T>;
+    destroy: () => void;
+}
+/**
+ * 对象变化的补间动画
+ * 1. 应用 requestAnimationFrameInterval 做 update
+ * 2. 在原生 tween 上新增 destroy 方法和 onDestroy 监听
+ * DOC： https://github.com/tweenjs/tween.js
+ * @param from 对象起始状态
+ * @param to 对象末尾状态
+ * @param duration 经历时间（s）
+ * @param easing 过程动画，默认是 Easing.Linear.None
+ */
+export default function tween<T>(from: T, to: T, duration: number, easing?: (amount: number) => number): ITween<T>;
+export declare function tweenProgress(duration: number, easing: typeof Easing.Linear.None): ITween<{
+    progress: number;
+}>;
+export {};

package/libs/src/shared-utils/animationFrame/tween.js

@@ -0,0 +1,44 @@
+import * as TWEEN from '@tweenjs/tween.js';
+import { nextFrame, requestAnimationFrameInterval } from './index';
+export const Easing = TWEEN.Easing;
+/**
+ * 对象变化的补间动画
+ * 1. 应用 requestAnimationFrameInterval 做 update
+ * 2. 在原生 tween 上新增 destroy 方法和 onDestroy 监听
+ * DOC： https://github.com/tweenjs/tween.js
+ * @param from 对象起始状态
+ * @param to 对象末尾状态
+ * @param duration 经历时间（s）
+ * @param easing 过程动画，默认是 Easing.Linear.None
+ */
+export default function tween(from, to, duration, easing = Easing.Linear.None) {
+    const tween = new TWEEN.Tween(from).to(to, duration).easing(easing);
+    // 这里注意一下，因为 requestAnimationFrameInterval 给的时间是从 0 开始的，tween 动画也从 0 开始
+    nextFrame(() => tween.start(0));
+    const cancelAnimationFrame = requestAnimationFrameInterval((time) => {
+        if (tween.update(time) === false)
+            cancelAnimationFrame();
+    });
+    const destroyMethods = [];
+    tween.onDestroy = (fn) => {
+        destroyMethods.push(fn);
+        return tween;
+    };
+    tween.destroy = function () {
+        this.stop();
+        Object.assign(tween, {
+            _onStartCallback: null,
+            _onUpdateCallback: null,
+            _onCompleteCallback: null,
+            _onStopCallbackL: null,
+        });
+        let destroyMethod;
+        while ((destroyMethod = destroyMethods.shift()))
+            destroyMethod();
+        cancelAnimationFrame();
+    };
+    return tween;
+}
+export function tweenProgress(duration, easing) {
+    return tween({ progress: 0 }, { progress: 1 }, duration, easing);
+}

package/libs/src/shared-utils/changeModelCanvasOpacity.d.ts

@@ -0,0 +1,2 @@
+import type { Five } from '@realsee/five';
+export default function changeModelCanvasOpacity(five: Five, opacity: number, duration?: number): void;

package/libs/src/shared-utils/changeModelCanvasOpacity.js

@@ -0,0 +1,15 @@
+export default function changeModelCanvasOpacity(five, opacity, duration = 300) {
+    const fiveEle = five.getElement();
+    if (!fiveEle)
+        return;
+    fiveEle.style.opacity = opacity + '';
+    fiveEle.style.transition = duration === 0 ? 'none' : `opacity ${duration}ms linear`;
+    if (duration === 0)
+        return;
+    Promise.race([
+        new Promise((res) => fiveEle.addEventListener('transitionend', res, { once: true })),
+        new Promise((res) => setTimeout(res, duration)),
+    ]).then(() => {
+        fiveEle.style.transition = 'none';
+    });
+}

package/libs/src/shared-utils/createCanvasTextTexture.d.ts

@@ -0,0 +1,8 @@
+import { CanvasTexture } from 'three';
+export default function createCanvasTextTexture(text: string, config?: {
+    size?: number;
+    fontSize?: number;
+    backgroundColor?: string;
+    fontColor?: string;
+    textAlign?: CanvasTextAlign;
+}): CanvasTexture;

package/libs/src/shared-utils/createCanvasTextTexture.js

@@ -0,0 +1,20 @@
+import { CanvasTexture } from 'three';
+export default function createCanvasTextTexture(text, config) {
+    var _a, _b, _c, _d, _e;
+    const size = (_a = config === null || config === void 0 ? void 0 : config.size) !== null && _a !== void 0 ? _a : 512;
+    const fontSize = (_b = config === null || config === void 0 ? void 0 : config.fontSize) !== null && _b !== void 0 ? _b : size * (35 / 256) * 1.2;
+    const backgroundColor = (_c = config === null || config === void 0 ? void 0 : config.backgroundColor) !== null && _c !== void 0 ? _c : 'rgba(0,0,0,0)';
+    const fontColor = (_d = config === null || config === void 0 ? void 0 : config.fontColor) !== null && _d !== void 0 ? _d : '#fff';
+    const textAlign = (_e = config === null || config === void 0 ? void 0 : config.textAlign) !== null && _e !== void 0 ? _e : 'center';
+    const canvas = document.createElement('canvas');
+    canvas.setAttribute('width', size + '');
+    canvas.setAttribute('height', size + '');
+    const context = canvas.getContext('2d');
+    context.fillStyle = backgroundColor;
+    context.fillRect(0, 0, size, size);
+    context.font = `${fontSize}px "微软雅黑"`;
+    context.textAlign = textAlign;
+    context.fillStyle = fontColor;
+    context.fillText(text, size / 2, size * 0.7);
+    return new CanvasTexture(canvas);
+}

package/libs/src/shared-utils/createLine/index.d.ts

@@ -0,0 +1,3 @@
+import { Line } from '@realsee/five/line';
+import { Vector3 } from 'three';
+export default function createLine(point1: Vector3, point2: Vector3, color?: Vector3, dashed?: boolean): Line;

package/libs/src/shared-utils/createLine/index.js

@@ -0,0 +1,8 @@
+import { Line } from '@realsee/five/line';
+import { Vector3 } from 'three';
+export default function createLine(point1, point2, color = new Vector3(1, 1, 1), dashed = false) {
+    const line = new Line(point1, point2);
+    line.setMaterial({ dashed, color, linewidth: 1 });
+    line.remove(line.points);
+    return line;
+}

package/libs/src/shared-utils/debounce.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 创建一个防抖动函数，该函数会在 wait 毫秒后调用 func 方法
+ * @param func - 要防抖动的函数
+ * @param [wait=0] - 需要延迟的毫秒数
+ */
+export default function debounce<T extends (...args: any[]) => any>(func: T, wait?: number): (...args: Parameters<T>) => void;

package/libs/src/shared-utils/debounce.js

@@ -0,0 +1,14 @@
+/**
+ * 创建一个防抖动函数，该函数会在 wait 毫秒后调用 func 方法
+ * @param func - 要防抖动的函数
+ * @param [wait=0] - 需要延迟的毫秒数
+ */
+export default function debounce(func, wait = 200) {
+    let last;
+    return function (...args) {
+        clearTimeout(last);
+        last = setTimeout(() => {
+            func(...args);
+        }, wait);
+    };
+}

package/libs/src/shared-utils/equal.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 对象比较
+ * @param {*} value 第一个比较的值
+ * @param {*} other 第二个比较的值
+ * @param {Object} options 可选参数，可选项包括：<br />
+ *    deep {Boolean} 是否深比较<br />
+ * @returns {boolean} 是否相等
+ */
+export default function equal(value: any, other: any, opt?: {
+    deep: boolean;
+}): boolean;

package/libs/src/shared-utils/equal.js

@@ -0,0 +1,84 @@
+/* eslint-disable @typescript-eslint/no-use-before-define */
+import isTruelyObject from './isTruelyObject';
+function baseIsEqual(value, other) {
+    if (value === other)
+        return true;
+    if (typeof value !== typeof other)
+        return false;
+    if (Number.isNaN(value) && Number.isNaN(other))
+        return true;
+    return false;
+}
+function objEqualShallow(value, other) {
+    const valueProps = Object.getOwnPropertyNames(value);
+    const otherProps = Object.getOwnPropertyNames(other);
+    if (valueProps.length !== otherProps.length)
+        return false;
+    for (let i = 0, len = valueProps.length; i < len; i++) {
+        const propName = valueProps[i];
+        if (!baseIsEqual(value[propName], other[propName]))
+            return false;
+    }
+    return true;
+}
+function arrayEqualShallow(value, other) {
+    if (value.length !== other.length)
+        return false;
+    for (let i = 0, len = value.length; i < len; i++) {
+        if (!baseIsEqual(value[i], other[i]))
+            return false;
+    }
+    return true;
+}
+function isShallowEqual(value, other) {
+    if (baseIsEqual(value, other))
+        return true;
+    if (isTruelyObject(value) && isTruelyObject(other))
+        return objEqualShallow(value, other);
+    if (Array.isArray(value) && Array.isArray(other))
+        return arrayEqualShallow(value, other);
+    return false;
+}
+function isDeepEqual(value, other) {
+    if (baseIsEqual(value, other))
+        return true;
+    if (isTruelyObject(value) && isTruelyObject(other))
+        return objEqualDeep(value, other);
+    if (Array.isArray(value) && Array.isArray(other))
+        return arrayEqualDeep(value, other);
+    return false;
+}
+function arrayEqualDeep(value, other) {
+    if (value.length !== other.length)
+        return false;
+    for (let i = 0, len = value.length; i < len; i++) {
+        if (!isDeepEqual(value[i], other[i]))
+            return false;
+    }
+    return true;
+}
+function objEqualDeep(value, other) {
+    const valueProps = Object.getOwnPropertyNames(value);
+    const otherProps = Object.getOwnPropertyNames(other);
+    if (valueProps.length !== otherProps.length)
+        return false;
+    for (let i = 0, len = valueProps.length; i < len; i++) {
+        const propName = valueProps[i];
+        if (!isDeepEqual(value[propName], other[propName]))
+            return false;
+    }
+    return true;
+}
+/**
+ * 对象比较
+ * @param {*} value 第一个比较的值
+ * @param {*} other 第二个比较的值
+ * @param {Object} options 可选参数，可选项包括：<br />
+ *    deep {Boolean} 是否深比较<br />
+ * @returns {boolean} 是否相等
+ */
+export default function equal(value, other, opt = { deep: false }) {
+    if (!opt.deep)
+        return isShallowEqual(value, other);
+    return isDeepEqual(value, other);
+}

package/libs/src/shared-utils/filter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 对象属性筛选函数。
+ * 基于已有对象生成一个满足条件(属性)新的对象。
+ * @param {object} object
+ * @param {Function} check
+ */
+export declare function filter<T, K extends keyof T>(object: T, check: (key: K, value: T[K]) => boolean): Record<K, T[K]>;
+/**
+ * 对象镜子函数。
+ * 生成一个"镜子"对象：对象的属性名与其值相同。
+ * @param  {string[]} strings 对象属性
+ */
+export declare function mirror(strings: string[]): Record<string, string>;
+/**
+ * 过滤掉不需要的对象字段函数：实现从一个对象中排除某些指定属性后生成的新对象。
+ * @param object
+ * @param props 排除的属性
+ * @return
+ */
+export declare function omit<T, K extends keyof T>(object: T, props: Extract<K[], string[]>): Omit<T, K>;
+/**
+ * 筛选需要的对象字段：实现从一个对象中选择某些指定属性生成新的对象（与`omit()`功能相反）。
+ * @param  {object}    object
+ * @param  {string[]} props
+ * @return {object}
+ */
+export declare function pick<T, K extends keyof T>(object: T, props: K[]): Pick<T, K>;