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

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

@@ -0,0 +1,53 @@
+import tap from './tap';
+/**
+ * 对象属性筛选函数。
+ * 基于已有对象生成一个满足条件(属性)新的对象。
+ * @param {object} object
+ * @param {Function} check
+ */
+export function filter(object, check) {
+    return tap({}, (result) => {
+        Object.keys(object).forEach((key) => {
+            const _key = key;
+            if (check(_key, object[_key])) {
+                result[_key] = object[_key];
+            }
+        });
+    });
+}
+/**
+ * 对象镜子函数。
+ * 生成一个"镜子"对象：对象的属性名与其值相同。
+ * @param  {string[]} strings 对象属性
+ */
+export function mirror(strings) {
+    return tap({}, (result) => {
+        for (const string of strings)
+            result[string] = string;
+    });
+}
+/**
+ * 过滤掉不需要的对象字段函数：实现从一个对象中排除某些指定属性后生成的新对象。
+ * @param object
+ * @param props 排除的属性
+ * @return
+ */
+export function omit(object, props) {
+    return tap({}, (result) => {
+        for (const name in object) {
+            if (props.indexOf(name) !== -1)
+                continue;
+            result[name] = object[name];
+        }
+    });
+}
+/**
+ * 筛选需要的对象字段：实现从一个对象中选择某些指定属性生成新的对象（与`omit()`功能相反）。
+ * @param  {object}    object
+ * @param  {string[]} props
+ * @return {object}
+ */
+export function pick(object, props) {
+    // eslint-disable-next-line no-return-assign
+    return tap({}, (result) => props.forEach((prop) => (result[prop] = object[prop])));
+}

package/libs/src/shared-utils/five/changeMode.d.ts

@@ -0,0 +1,5 @@
+import type { Five } from '@realsee/five';
+/** 等待 five changeMode 结束
+ * @description Promise 的状态只代表 mode 与预期是否一致，不保证参数的一致性
+ */
+export default function changeMode(five: Five, changeModeParams: Parameters<Five['changeMode']>): Promise<void>;

package/libs/src/shared-utils/five/changeMode.js

@@ -0,0 +1,36 @@
+import nearlyEqual from '../nearlyEqual';
+/** 等待 five changeMode 结束
+ * @description Promise 的状态只代表 mode 与预期是否一致，不保证参数的一致性
+ */
+export default async function changeMode(five, changeModeParams) {
+    await new Promise((resolve, reject) => {
+        // 虽然 changeMode 是异步函数，但不代表异步流程结束代表切换 Mode 动画结束
+        five.changeMode(...changeModeParams).catch((error) => reject(error));
+        five.once('initAnimationEnded', () => {
+            const fiveCurrentState = five.getCurrentState();
+            const correctMode = changeModeParams[0];
+            if (fiveCurrentState.mode !== correctMode)
+                reject(new Error('mode 与预期不符'));
+            /** 检测当前的 current pose 和传入的 pose 是否一致 */
+            const checkPose = () => {
+                const correctPose = changeModeParams[1];
+                if (!correctPose)
+                    return true;
+                return Object.keys(correctPose).every((key) => {
+                    const fivePoseItem = fiveCurrentState[key];
+                    if (fivePoseItem === undefined)
+                        return true;
+                    const correctPoseItem = correctPose[key];
+                    if (typeof fivePoseItem === 'number' && typeof correctPoseItem === 'number') {
+                        return nearlyEqual(fivePoseItem, correctPoseItem, 2);
+                    }
+                    return fivePoseItem === correctPoseItem;
+                });
+            };
+            const checkPoseResult = checkPose();
+            if (!checkPoseResult)
+                reject(new Error('five pose 与预期不符'));
+            resolve();
+        });
+    });
+}

package/libs/src/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/libs/src/shared-utils/formatRad.js

@@ -0,0 +1,10 @@
+const PI_2 = Math.PI * 2;
+/**
+ * 将弧度转成 0 - 2PI 中的值
+ * @param rad - 任意弧度值
+ * @return 0 - 2PI 的数值
+ */
+function formatRad(rad) {
+    return ((rad % PI_2) + PI_2) % PI_2;
+}
+export { formatRad };

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

@@ -0,0 +1,19 @@
+import type { Five } from '@realsee/five';
+import { FLOOR_PLAN_ATTACHED_TO } from '../floorplan/constant';
+interface GetPxmmOption {
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+}
+/** 获取当前楼层地面的 Y 值 */
+export declare function getFloorY(five: Five, floorIndex: number): number;
+/** 获取当前吸附类型的 Y 值
+ * * FLOOR_PLAN_ATTACHED_TO.FLOOR：当前楼层地板的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前模型中心的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前楼层天花板的 Y
+*/
+export declare function getAttachedY(five: Five, floorIndex: number, attachedTo?: FLOOR_PLAN_ATTACHED_TO): number;
+/**
+ * 获取「在俯视图」状态下，模型 mm 与屏幕像素 px 的对应关系，即每 mm 对应多少 px
+ * @param five five
+ */
+export default function getPxmm(five: Five, container: Element, floorIndex: number, options?: GetPxmmOption): number;
+export {};

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

@@ -0,0 +1,39 @@
+import { FLOOR_PLAN_ATTACHED_TO } from '../floorplan/constant';
+import * as THREE from 'three';
+/** 获取当前楼层地面的 Y 值 */
+export function getFloorY(five, floorIndex) {
+    const maxFloorIndex = Math.max(...five.work.observers.map((ob) => ob.floorIndex));
+    return floorIndex > maxFloorIndex
+        ? five.model.bounding.max.y
+        : Math.max(...five.work.observers
+            .filter((ob) => ob.floorIndex === floorIndex)
+            .map((ob) => ob.standingPosition.y));
+}
+/** 获取当前吸附类型的 Y 值
+ * * FLOOR_PLAN_ATTACHED_TO.FLOOR：当前楼层地板的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前模型中心的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前楼层天花板的 Y
+*/
+export function getAttachedY(five, floorIndex, attachedTo = FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER) {
+    const currentFloorY = getFloorY(five, floorIndex);
+    const nextFloorY = getFloorY(five, floorIndex + 1);
+    if (attachedTo === FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER)
+        return (five.model.bounding.max.y + five.model.bounding.min.y) / 2;
+    else if (attachedTo === FLOOR_PLAN_ATTACHED_TO.CEILING)
+        return nextFloorY;
+    else
+        return currentFloorY;
+}
+/**
+ * 获取「在俯视图」状态下，模型 mm 与屏幕像素 px 的对应关系，即每 mm 对应多少 px
+ * @param five five
+ */
+export default function getPxmm(five, container, floorIndex, options) {
+    const y = getAttachedY(five, floorIndex, options === null || options === void 0 ? void 0 : options.attachedTo);
+    const originPosition = new THREE.Vector3(0, y, 0);
+    const originPositionXUnit = new THREE.Vector3(1, y, 0);
+    const mouse = originPosition.clone().project(five.camera);
+    const xUnitMouse = originPositionXUnit.clone().project(five.camera);
+    const pxmm = Math.abs((xUnitMouse.x - mouse.x) / 1000) * (container.getBoundingClientRect().width / 2);
+    return pxmm;
+}

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

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

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

@@ -0,0 +1,10 @@
+export default function getRandomColor() {
+    const color = '#' +
+        '0123456789abcdef'
+            .split('')
+            .map((_v, i, a) => {
+            return i > 5 ? null : a[Math.floor(Math.random() * 16)];
+        })
+            .join('');
+    return color;
+}

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

@@ -0,0 +1 @@
+export * from './math';

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

@@ -0,0 +1 @@
+export * from './math';

package/libs/src/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/libs/src/shared-utils/isNil.js

@@ -0,0 +1,14 @@
+/**
+ * 判断对象是否为`null`或`undefined`。
+ * @param
+ * @return
+ */
+export function isNil(value) {
+    return !notNil(value);
+}
+/**
+ * 判断对象不为`null`或`undefined`。
+ */
+export function notNil(value) {
+    return value !== null && value !== undefined;
+}

package/libs/src/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/libs/src/shared-utils/isTruelyObject.js

@@ -0,0 +1,20 @@
+/**
+ * 检查一个值是否是狭义上的对象
+ * @param {any} value 要检查的值
+ *
+ * isTruelyObject({})
+ * // => true
+ *
+ * isObjectLike([1, 2, 3])
+ * // => false
+ *
+ * isObjectLike(Function)
+ * // => false
+ *
+ * isObjectLike(null)
+ * // => false
+ *
+ */
+export default function isTruelyObject(value) {
+    return Object.prototype.toString.call(value) === '[object Object]';
+}

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

@@ -0,0 +1,16 @@
+/**
+ * 输出格式化日志
+ */
+export declare enum LOG_LEVEL {
+    info = "INFO",
+    log = "LOG",
+    error = "ERROR",
+    warn = "WARN"
+}
+export declare const logger: {
+    log: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+};
+export default logger;

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

@@ -0,0 +1,47 @@
+/**
+ * 输出格式化日志
+ */
+// 获取当前时间
+const getTime = () => {
+    const date = new Date();
+    const year = date.getFullYear();
+    const month = (date.getMonth() + 1).toString().padStart(2, '0'); //月份是从0开始的
+    const day = date.getDate().toString().padStart(2, '0');
+    const hour = date.getHours().toString().padStart(2, '0');
+    const min = date.getMinutes().toString().padStart(2, '0');
+    const sec = date.getSeconds().toString().padStart(2, '0');
+    const ms = date.getMilliseconds();
+    return `[${year}-${month}-${day} ${hour}:${min}:${sec}.${ms}]`;
+};
+export var LOG_LEVEL;
+(function (LOG_LEVEL) {
+    LOG_LEVEL["info"] = "INFO";
+    LOG_LEVEL["log"] = "LOG";
+    LOG_LEVEL["error"] = "ERROR";
+    LOG_LEVEL["warn"] = "WARN";
+})(LOG_LEVEL || (LOG_LEVEL = {}));
+// 输出日志
+const echo = (logLevel, args = []) => {
+    args.unshift(`@realsee/dnalogel ${getTime()} <${logLevel}> `);
+    switch (logLevel) {
+        case LOG_LEVEL.info:
+            return console.info(...args);
+        case LOG_LEVEL.error:
+            return console.error(...args);
+        case LOG_LEVEL.warn:
+            return console.warn(...args);
+        default:
+            return console.log(...args);
+    }
+};
+const log = (...args) => echo(LOG_LEVEL.log, args);
+const info = (...args) => echo(LOG_LEVEL.info, args);
+const error = (...args) => echo(LOG_LEVEL.error, args);
+const warn = (...args) => echo(LOG_LEVEL.warn, args);
+export const logger = {
+    log,
+    info,
+    error,
+    warn,
+};
+export default logger;

package/libs/src/shared-utils/math/Interval.d.ts

@@ -0,0 +1,13 @@
+/** 一维区间 */
+declare class Interval {
+    min: number;
+    max: number;
+    isInterval: boolean;
+    constructor(min?: number, max?: number);
+    fromArray(array: number[]): Interval;
+    /** 两个区间是否重叠 */
+    isOverlap(target: Interval): boolean;
+    /** 是否包含区间 */
+    contains(target: Interval): boolean;
+}
+export { Interval };

package/libs/src/shared-utils/math/Interval.js

@@ -0,0 +1,40 @@
+/** 一维区间 */
+class Interval {
+    constructor(min = 0, max = 0) {
+        Object.defineProperty(this, "min", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "max", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isInterval", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        this.min = min;
+        this.max = max;
+    }
+    fromArray(array) {
+        this.min = array[0];
+        this.max = array[1];
+        return this;
+    }
+    /** 两个区间是否重叠 */
+    isOverlap(target) {
+        // 两个区间最大值中的最小值小于两个区间最小值中的最大值时，两个区间没有交集
+        return Math.min(this.max, target.max) < Math.max(this.min, target.min);
+    }
+    /** 是否包含区间 */
+    contains(target) {
+        return this.min < target.min && this.max > target.max;
+    }
+}
+export { Interval };

package/libs/src/shared-utils/math/Rectangle.d.ts

@@ -0,0 +1,27 @@
+import { Interval } from './';
+/** 矩形的数学方法合集 */
+declare class Rectangle {
+    min: {
+        x: number;
+        y: number;
+    };
+    max: {
+        x: number;
+        y: number;
+    };
+    xInterval: Interval;
+    yInterval: Interval;
+    isRectangle: boolean;
+    constructor(min: {
+        x: number;
+        y: number;
+    }, max: {
+        x: number;
+        y: number;
+    });
+    /** 是否与矩形是否重叠 */
+    isOverlapWithRectangle(target: Rectangle): boolean;
+    /** 是否包含目标矩形 */
+    containsRect(target: Rectangle): boolean;
+}
+export { Rectangle };

package/libs/src/shared-utils/math/Rectangle.js

@@ -0,0 +1,50 @@
+import { Interval } from './';
+/** 矩形的数学方法合集 */
+class Rectangle {
+    constructor(min, max) {
+        Object.defineProperty(this, "min", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "max", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "xInterval", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "yInterval", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isRectangle", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        this.min = min;
+        this.max = max;
+        this.xInterval = new Interval(this.min.x, this.max.x);
+        this.yInterval = new Interval(this.min.y, this.max.y);
+    }
+    /** 是否与矩形是否重叠 */
+    isOverlapWithRectangle(target) {
+        // X 轴投影无重叠 && 在 Y 轴投影无重叠
+        return (!this.xInterval.isOverlap(target.xInterval) && !this.yInterval.isOverlap(target.yInterval));
+    }
+    /** 是否包含目标矩形 */
+    containsRect(target) {
+        return this.xInterval.contains(target.xInterval) && this.yInterval.contains(target.yInterval);
+    }
+}
+export { Rectangle };

package/libs/src/shared-utils/math/evenNumber.d.ts

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

package/libs/src/shared-utils/math/evenNumber.js

@@ -0,0 +1,4 @@
+export default function evenNumber(num, config) {
+    const roundNum = Math.round(num);
+    return roundNum % 2 === 0 ? roundNum : roundNum + Number((config === null || config === void 0 ? void 0 : config.smaller) ? -1 : 1);
+}

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

@@ -0,0 +1,2 @@
+export * from './Interval';
+export * from './Rectangle';

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

@@ -0,0 +1,2 @@
+export * from './Interval';
+export * from './Rectangle';

package/libs/src/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;