@realsee/dnalogel 2.0.0-alpha.8 → 2.0.0-alpha.9

package/dist/shared-utils/Preloader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 预载器
+ */
+export declare const Preloader: {
+    blob: (url: string) => Promise<string>;
+};

package/dist/shared-utils/Subscribe.d.ts

@@ -0,0 +1,45 @@
+declare const __EVENT__ = "__events__";
+/**
+ * 订阅类。
+ * 观察者模式（供前端使用），Node端推荐<a href="https://nodejs.org/api/events.html#events_class_eventemitter">EventEmitter</a>。
+ */
+export default class Subscribe {
+    private [__EVENT__];
+    constructor();
+    /**
+     * 判断是否注册时事件
+     * @param  {string|[string]}  name     事件类型
+     */
+    hasListener(name: string): any;
+    /**
+     * 注册事件
+     * @param  {string|[string]}  names    事件类型
+     * @param  {function}         callback 事件回调函数
+     * @param  {any}              context  事件回调函数调用的上下文
+     * @param  {boolean}          once     是否只执行一次
+     */
+    on(names: string | string[], callback: (...args: any[]) => void, context?: any, once?: boolean): () => this;
+    /**
+     * 注册事件(是否只执行一次)
+     * @param  {string|[string]}  names    事件类型
+     * @param  {function}         callback 事件回调函数
+     * @param  {any}              context  事件回调函数调用的上下文
+     */
+    once(names: string | string[], callback: (...args: any[]) => void, context?: any): () => this;
+    /**
+     * 解除事件
+     * @param  {string|[string]}  names    事件类型
+     * @param  {function}         callback 事件回调函数
+     *
+     * 如果 name 不传的话解除对应所有事件
+     * 如果 name, callback 不传的话解除所有name的所有事件
+     */
+    off(names?: string | string[], callback?: (...args: any[]) => void): this;
+    /**
+     * 触发事件
+     * @param  {string|[string]}    name      事件类型
+     * @param  {...any}             data      触发事件的数据
+     */
+    emit(name: string, ...data: any[]): boolean;
+}
+export {};

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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>;

package/dist/shared-utils/five/changeMode.d.ts

@@ -0,0 +1,2 @@
+import type { Five } from '@realsee/five';
+export default function changeMode(five: Five, ...changeModeParams: Parameters<Five['changeMode']>): Promise<void>;

package/dist/shared-utils/five/useFivePlugin.d.ts

@@ -0,0 +1 @@
+export declare function useFivePlugin<T extends (...args: any) => any>(name: string): ReturnType<T>;

package/dist/shared-utils/formatRad.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 将弧度转成 0 - 2PI 中的值
+ * @param rad - 任意弧度值
+ * @return 0 - 2PI 的数值
+ */
+declare function formatRad(rad: number): number;
+export { formatRad };

package/dist/shared-utils/getPxmm.d.ts

@@ -0,0 +1,11 @@
+import type { Five } from '@realsee/five';
+import { FLOOR_PLAN_ATTACHED_TO } from '../floorplan/constant';
+interface GetPxmmOption {
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+}
+/**
+ * 获取「在俯视图」状态下，模型 mm 与屏幕像素 px 的对应关系，即每 mm 对应多少 px
+ * @param five five
+ */
+export default function getPxmm(five: Five, container: Element, floorIndex: number, options?: GetPxmmOption): number;
+export {};

package/dist/shared-utils/getRandomColor.d.ts

@@ -0,0 +1 @@
+export default function getRandomColor(): string;

package/dist/shared-utils/isNil.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 判断对象是否为`null`或`undefined`。
+ * @param
+ * @return
+ */
+export declare function isNil<T>(value: T): value is Extract<T, undefined | null>;
+/**
+ * 判断对象不为`null`或`undefined`。
+ */
+export declare function notNil<T>(value: T | null | undefined): value is T;

package/dist/shared-utils/isTruelyObject.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 检查一个值是否是狭义上的对象
+ * @param {any} value 要检查的值
+ *
+ * isTruelyObject({})
+ * // => true
+ *
+ * isObjectLike([1, 2, 3])
+ * // => false
+ *
+ * isObjectLike(Function)
+ * // => false
+ *
+ * isObjectLike(null)
+ * // => false
+ *
+ */
+export default function isTruelyObject(value: any): boolean;

package/dist/shared-utils/math/evenNumber.d.ts

@@ -0,0 +1,3 @@
+export default function evenNumber(num: number, config?: {
+    smaller?: boolean;
+}): number;

package/dist/shared-utils/math/planimetry.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 平面几何相关数学函数
+ */
+/**
+ * 平面点坐标。
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * 检查两个点是否位置相同
+ * @param point1
+ * @param point2
+ * @return
+ */
+export declare function samePointAt(point1: Point, point2: Point): boolean;
+/**
+ * 计算两个点之间的位置
+ * @param  {point} point1
+ * @param  {point} point2
+ * @return {number}
+ */
+export declare function distance(point1: Point, point2: Point): number;
+/**
+ * 两个计算的斜率是否相同
+ * @param  {number} k1
+ * @param  {number} k2
+ * @return
+ */
+export declare function sameK(k1: number, k2: number): boolean;
+/**
+ * 获取两点之间的斜率
+ * @param  {point} point1
+ * @param  {point} point2
+ * @return {number}
+ */
+export declare function getK(point1: Point, point2: Point): number;
+/**
+ * 获取一点对于线段上最近的一点，
+ * 如果可以是过直线垂线的垂足，不行的话取线段的两端
+ * @param  {point} point1
+ * @param  {linePoints} linePoints
+ * @return {point}
+ */
+export declare function closestPointOnLine(point: Point, linePoints: Point[]): {
+    x: any;
+    y: any;
+};
+/**
+ * 点到线段的距离，
+ * 如果可以是过直线垂线的垂足的距离，不行的话取线段的两端的距离
+ * @param  {point} point1
+ * @param  {linePoints} linePoints
+ * @return {number}
+ */
+export declare function pointDistanceFromLine(point: Point, linePoints: Point[]): number;
+/**
+ * 做线段的距离一定值的平行线段
+ * @param  {number} distanceOfLine
+ * @param  {linePoints} linePoints
+ * @return {[linePoints, linePoints]}
+ */
+export declare function linesWithDistanceOfLine(distanceOfLine: number, linePoints: Point[]): {
+    x: any;
+    y: any;
+}[][];
+/**
+ * 做线段的距离一定值的平行线段 (如果线段是弧形的)
+ * @param  {number} distanceOfLine
+ * @param  {linePoints} linePoints
+ * @param  {number} 弧形定点到线段的距离
+ * @return {[linePoints, linePoints]}
+ */
+export declare function linesWithDistanceOfLineWithCurve(distanceOfLine: number, linePoints: Point[], curve: number): {
+    x: number;
+    y: number;
+}[][];
+/**
+ * 两条线段(包括延长线)的交点点
+ * @param  {linePoints} linePoints1
+ * @param  {linePoints} linePoints2
+ * @param   needIntersectionInLine 是否是延长线的相交
+ * @return {point || false}
+ */
+export declare function intersectionOfLine(linePoints1: Point[], linePoints2: Point[], needIntersectionInLine: boolean): false | Point;
+/**
+ * 是否点在线段上
+ * @param  {point} point
+ * @param  {linePoints} linePoints
+ * @return
+ */
+export declare function pointOnLine(point: Point, linePoints: Point[]): boolean;
+/**
+ * 让点按照另一个点为圆心，一定弧度的情况下转动得到下一个点
+ * @param  {point} point
+ * @param  {point} centerPoint
+ * @param  {number} rad
+ * @return {point}
+ */
+export declare function pointRotateByCenterPoint(point: Point, centerPoint: Point, rad: number): {
+    x: number;
+    y: number;
+};
+/**
+ * 获取一些点的中心点
+ * @param  {points} point
+ * @return {point}
+ */
+export declare function getCenterPointOfPoints(points: Point[]): {
+    x: number;
+    y: number;
+};
+export declare function isIntersect(linePoints1: Point[], linePoints2: Point[]): 1 | 0;
+export declare function getAreaSize(points: Point[]): number;
+export declare function getAreaSizeWithoutLine(points: Point[]): number;

package/dist/shared-utils/math/rad2Deg.d.ts

@@ -0,0 +1 @@
+export default function rad2Deg(rad: number): number;

package/dist/shared-utils/nearlyEqual.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 比较两个数字近似相等
+ * @param num1 数字1
+ * @param num2 数字2
+ * @param accuracy 精度：精确到小数点后几位，默认精确到 小数点后四位
+ */
+export default function nearlyEqual(num1: number, num2: number, accuracy?: number): boolean;

package/dist/shared-utils/nextFrame.d.ts

@@ -0,0 +1 @@
+export declare function nextFrame(fn: () => void, delay?: number): void;

package/dist/shared-utils/noop.d.ts

@@ -0,0 +1,5 @@
+declare function noop(): void;
+/**
+ * 空函数
+ */
+export default noop;

package/dist/shared-utils/object3d2LocalMatrix.d.ts

@@ -0,0 +1,12 @@
+import * as THREE from 'three';
+export declare const genRotationMatrix: (x: number, y: number, z: number) => THREE.Matrix4;
+declare const bject3d2LocalMatrix: (mesh: THREE.Object3D, { scale, rotation, position, }: {
+    scale: number;
+    rotation: number[];
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}) => THREE.Object3D;
+export default bject3d2LocalMatrix;

package/dist/shared-utils/px2rem.d.ts

@@ -0,0 +1 @@
+export default function px2rem(_px: number | string, precision?: number): string;

package/dist/shared-utils/removeArrayItem.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 从数组中删除
+ * @param   item
+ * @param   array
+ * @return  如果删除返回 item
+ */
+export default function removeArrayItem<T>(item: T, array: T[]): T;

package/dist/shared-utils/tap.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 把第一个参数传入第二个参数（函数）中并执行
+ * 一般用于执行函数后返回变量。
+ * @param {any} something
+ * @param {function} callback
+ * @return {any}
+ */
+export default function tap<T>(something: T, callback: (p: T) => any): T;

package/dist/shared-utils/three/centerPoint.d.ts

@@ -0,0 +1,2 @@
+import { Vector3 } from 'three';
+export default function centerPoint(point1: Vector3, point2: Vector3): Vector3;

package/dist/shared-utils/three/getExtraModelLoader.d.ts

@@ -0,0 +1,6 @@
+import * as THREE from 'three';
+/** 模型资源加载器，用于满足资源共用 */
+export declare function getExtraModelLoader(): {
+    load: (url: string, type?: string) => Promise<THREE.Group>;
+    dispose: () => void;
+};

package/dist/shared-utils/three/getNormal.d.ts

@@ -0,0 +1,2 @@
+import { Vector3 } from 'three';
+export default function getNormal(a: Vector3, b: Vector3, c: Vector3): Vector3;

package/dist/shared-utils/three/getTextureLoader.d.ts

@@ -0,0 +1,6 @@
+import * as THREE from 'three';
+/** 贴图加载器，用于满足资源共用 */
+export declare function getTextureLoader(): {
+    load: (url: string) => Promise<THREE.Texture>;
+    dispose: () => void;
+};

package/dist/shared-utils/three/loadFbxObj.d.ts

@@ -0,0 +1,2 @@
+import { Group } from 'three';
+export declare function loadFbxObj(url: string): Promise<Group>;

package/dist/shared-utils/three/loadTexture.d.ts

@@ -0,0 +1,2 @@
+import * as THREE from 'three';
+export declare function loadTexture(url: string): Promise<THREE.Texture>;

package/dist/shared-utils/three/transformPositionToVector3.d.ts

@@ -0,0 +1,7 @@
+import { Vector3 } from 'three';
+declare const transformPositionToVector3: ({ x, y, z }: {
+    x: number;
+    y: number;
+    z: number;
+}) => Vector3;
+export default transformPositionToVector3;

package/dist/shared-utils/three/transfromToMeshBasicMaterial.d.ts

@@ -0,0 +1,2 @@
+import { MeshBasicMaterialParameters, Object3D } from 'three';
+export default function transfromToMeshBasicMaterial(object: Object3D, options?: MeshBasicMaterialParameters): void;

package/dist/shared-utils/throttle.d.ts

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

package/dist/shared-utils/to.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 传入一个 Promise
+ * 无异常，返回 [null, data]
+ * 有异常，则返回 [Error, undefined]
+ * 用于替代 try&catch 处理 await 异常的方案
+ */
+export declare function to<T>(promise: Promise<T>): Promise<[null, T] | [Error, null]>;
+export default to;

package/dist/shared-utils/useDebounce.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 函数防抖：指触发事件后，在 `n` 秒内函数只能执行一次，如果触发事件后在 `n` 秒内又触发了事件，则会重新计算函数延执行时间。
+ * @param callback 回调函数
+ * @param waitFor 等待时间
+ * @returns
+ */
+export declare const useDebounce: <F extends (...args: any) => any>(callback: F, waitFor?: number) => (...args: Parameters<F>) => ReturnType<F>;
+export default useDebounce;

package/dist/shared-utils/useThrottle.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 函数节流：控制频率，限制在 `n` 秒时间。
+ * @param callback 回调函数
+ * @param waitFor 等待时间
+ * @returns
+ */
+export declare const useThrottle: <F extends (...args: any) => any>(callback: F, waitFor: number) => (...args: Parameters<F>) => ReturnType<F>;
+export default useThrottle;

package/dist/shared-utils/uuid.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 随机生成一个uuid值
+ */
+export default function uuid(): string;

package/dist/shared-utils/vectorTocoordinates.d.ts

@@ -0,0 +1,7 @@
+import * as THREE from 'three';
+/** 单位向量转换成坐标 */
+declare function vectorTocoordinates(vector: THREE.Vector3): {
+    longitude: number;
+    latitude: number;
+};
+export { vectorTocoordinates };

package/dist/typings/math.type.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 三维向量
+ */
+export interface Vector3Position {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * 三维向量数组表示
+ */
+export declare type Vector3WithArray = [number, number, number];
+/**
+ * 二维向量
+ */
+export interface Vector2Position {
+    x: number;
+    y: number;
+}
+/**
+ * 二维向量数组展示
+ */
+export declare type Vector2WithArray = [number, number];
+/**
+ * 4 * 4 矩阵数组表示
+ */
+export declare type Matrix4_4 = [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];

package/dist/typings/utils.type.d.ts

@@ -0,0 +1,2 @@
+export declare type Omit<T, K> = Pick<T, Exclude<keyof T, K>>;
+export declare type Overwrite<T, K> = Omit<T, keyof K> & K;