@aibee/owlly 1.0.25

package/lib/src/owlly/stage/externals.js

@@ -0,0 +1,25 @@
+import * as THREE from 'three';
+import Konva from 'konva';
+/**
+ * 外部库
+ */
+class Externals {
+    setKonvaInstance(konva) {
+        this.Konva = konva;
+    }
+    setThreeInstance(three) {
+        this.THREE = three;
+    }
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new Externals();
+        return this.instance;
+    }
+}
+function SetExternal(three, optionals = {}) {
+    Externals.getInstance().setThreeInstance(three);
+    if (optionals && optionals.konva)
+        Externals.getInstance().setKonvaInstance(optionals.konva);
+}
+export { Externals, THREE as NS_THREE, Konva as NS_KONVA, SetExternal, };
+//# sourceMappingURL=externals.js.map

package/lib/src/owlly/stage/externals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externals.js","sourceRoot":"","sources":["../../../../src/owlly/stage/externals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;GAEG;AACH,MAAM,SAAS;IAOb,gBAAgB,CAAC,KAAmB;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,gBAAgB,CAAC,KAAmB;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,SAAS,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAED,SAAS,WAAW,CAClB,KAAmB,EACnB,YAGI,EAAE;IAEN,SAAS,CAAC,WAAW,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,SAAS,IAAI,SAAS,CAAC,KAAK;QAAE,SAAS,CAAC,WAAW,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED,OAAO,EACL,SAAS,EACT,KAAK,IAAI,QAAQ,EACjB,KAAK,IAAI,QAAQ,EACjB,WAAW,GACZ,CAAC"}

package/lib/src/owlly/stage/index.d.ts

@@ -0,0 +1,4 @@
+export * from './stage';
+export { NS_THREE as THREE, NS_KONVA as Konva, } from './externals';
+export { Externals, SetExternal, } from './externals';
+export { updateTick } from './owlly';

package/lib/src/owlly/stage/index.js

@@ -0,0 +1,7 @@
+export * from './stage';
+// #if WEB_ONLY
+export { NS_THREE as THREE, NS_KONVA as Konva, } from './externals';
+// #endif
+export { Externals, SetExternal, } from './externals';
+export { updateTick } from './owlly';
+//# sourceMappingURL=index.js.map

package/lib/src/owlly/stage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/owlly/stage/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,eAAe;AACf,OAAO,EACL,QAAQ,IAAI,KAAK,EACjB,QAAQ,IAAI,KAAK,GAClB,MAAM,aAAa,CAAC;AACrB,SAAS;AACT,OAAO,EACL,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/lib/src/owlly/stage/owlly.d.ts

@@ -0,0 +1,38 @@
+import { Stage } from './stage';
+import { Screen } from '../screen/screen';
+import { Controller } from '../controller/controller';
+declare class Owlly {
+    private static SHARED_INSTANCE;
+    private static RequestAnimationFrame;
+    private stages;
+    private screens;
+    private controllers;
+    private timeProfiler;
+    private statsEnabled;
+    private selfManageTick;
+    private forceRender;
+    private listeners;
+    private constructor();
+    static GetSharedInstance(): Owlly;
+    /**
+     * 时钟函数
+     * @param time 距离上一帧的时间, ms
+     */
+    tick(time: number): void;
+    private registerEvents;
+    private onWindowResize;
+    private beforeWindowUnload;
+    registerStage(stage: Stage): void;
+    unregisterStage(stage: Stage): void;
+    registerScreen(screen: Screen): void;
+    unregisterScreen(screen: Screen): void;
+    registerController(controller: Controller): void;
+    unregisterController(controller: Controller): void;
+    setStatsEnabled(value: boolean): void;
+    setRequestAnimationFrameFunction(requestAnimationFrame: Function): void;
+    toggleTickSelfManagement(value: boolean): void;
+    renderNextFrame(): void;
+}
+declare function updateTick(): void;
+declare function forceRender(): void;
+export { Owlly, updateTick, forceRender };

package/lib/src/owlly/stage/owlly.js

@@ -0,0 +1,168 @@
+import TWEEN from '@tweenjs/tween.js';
+// #if WEB_ONLY
+// import Stats from 'stats.js';
+// #endif
+import { TimeProfiler } from '../utils/time-profiler';
+// #if WEB_ONLY
+import { Owlly2D } from '../owlly-2d';
+// #endif
+import { EventHub } from '../utils/event-hub';
+import { Events } from '../utils/events';
+import { EnvironmentUtils, Env } from '../utils/environment-utils';
+let frameTime;
+let timeSaver;
+let now;
+class Owlly {
+    constructor() {
+        this.stages = new Set();
+        this.screens = new Set();
+        this.controllers = new Set();
+        this.timeProfiler = new TimeProfiler();
+        this.selfManageTick = true;
+        // #if WEB_ONLY
+        // if (EnvironmentUtils.GetEnv() === Env.Web) {
+        //   this.stats = new Stats();
+        //   this.stats.showPanel(0);
+        //   this.stats.dom.style.setProperty('display', 'none');
+        //   this.statsEnabled = false;
+        //   if (document) document.body.appendChild(this.stats.dom);
+        // }
+        // #endif
+        this.listeners = {
+            windowResizeListener: () => { this.onWindowResize(); },
+            windowUnloadListener: () => { this.beforeWindowUnload(); },
+            onTick: this.tick.bind(this),
+        };
+        this.registerEvents();
+        if (EnvironmentUtils.GetEnv() === Env.Web && requestAnimationFrame) {
+            this.setRequestAnimationFrameFunction(requestAnimationFrame);
+        }
+    }
+    static GetSharedInstance() {
+        if (!this.SHARED_INSTANCE)
+            this.SHARED_INSTANCE = new Owlly();
+        return this.SHARED_INSTANCE;
+    }
+    /**
+     * 时钟函数
+     * @param time 距离上一帧的时间, ms
+     */
+    tick(time) {
+        this.timeProfiler.tick(time);
+        // EventHub.emit(Events.FPS_UPDATED, this.timeProfiler.getFPS());
+        EventHub.emit(Events.TICK);
+        const screenNeedsUpdate = Array.from(this.screens).reduce((tf, screen) => (screen.update() || tf), false);
+        const controllersNeedsUpdate = Array.from(this.controllers).reduce((tf, controller) => (controller.update() || tf), false);
+        const elementsNeedsUpdate = Array.from(this.stages).reduce((tf, stage) => (stage.tick() || tf), false);
+        if (this.forceRender || screenNeedsUpdate || controllersNeedsUpdate || elementsNeedsUpdate) {
+            this.screens.forEach((screen) => {
+                screen.renderScreen();
+            });
+        }
+        TWEEN.update();
+        // #if WEB_ONLY
+        // if (this.statsEnabled) {
+        //   this.stats.end();
+        //   this.stats.begin();
+        // }
+        // #endif
+        if (this.selfManageTick)
+            Owlly.RequestAnimationFrame(this.listeners.onTick);
+    }
+    registerEvents() {
+        if (EnvironmentUtils.GetEnv() === Env.Web)
+            window.addEventListener('resize', this.listeners.windowResizeListener);
+    }
+    onWindowResize() {
+        this.screens.forEach((screen) => {
+            screen.resize(window.innerWidth, window.innerHeight);
+        });
+        // #if WEB_ONLY
+        if (Owlly2D.initialized)
+            Owlly2D.resize();
+        // #endif
+    }
+    beforeWindowUnload() {
+        Array.from(this.stages).forEach((s) => {
+            s.dispose();
+        });
+        if (window)
+            window.removeEventListener('resize', this.listeners.windowResizeListener);
+        // #if WEB_ONLY
+        if (Owlly2D.initialized)
+            Owlly2D.dispose();
+        // if (document) document.body.removeChild(this.stats.dom);
+        // #endif
+    }
+    registerStage(stage) {
+        this.stages.add(stage);
+    }
+    unregisterStage(stage) {
+        this.stages.delete(stage);
+    }
+    registerScreen(screen) {
+        this.screens.add(screen);
+    }
+    unregisterScreen(screen) {
+        this.screens.delete(screen);
+    }
+    registerController(controller) {
+        this.controllers.add(controller);
+    }
+    unregisterController(controller) {
+        this.controllers.delete(controller);
+    }
+    setStatsEnabled(value) {
+        if (EnvironmentUtils.GetEnv() !== Env.Web)
+            return;
+        // #if WEB_ONLY
+        this.statsEnabled = value;
+        // this.stats.dom.style.setProperty('display', value ? 'block' : 'none');
+        // #endif
+    }
+    setRequestAnimationFrameFunction(requestAnimationFrame) {
+        // if (Owlly.RequestAnimationFrame) return;
+        Owlly.RequestAnimationFrame = requestAnimationFrame.bind(
+        // TODO: 此处小程序可能存在问题
+        // eslint-disable-next-line no-nested-ternary
+        EnvironmentUtils.GetEnv() === Env.Web
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            ? (window.IS_DELEGATE ? window.delegateWindow : window) : this);
+        if (this.selfManageTick)
+            Owlly.RequestAnimationFrame(this.listeners.onTick);
+    }
+    toggleTickSelfManagement(value) {
+        if (this.selfManageTick === value)
+            return;
+        this.selfManageTick = value;
+        if (this.selfManageTick)
+            Owlly.RequestAnimationFrame(this.listeners.onTick);
+    }
+    renderNextFrame() {
+        this.forceRender = true;
+    }
+}
+function updateTick() {
+    const owlly = Owlly.GetSharedInstance();
+    if (!timeSaver) {
+        frameTime = 0;
+        timeSaver = Date.now();
+    }
+    now = Date.now();
+    frameTime += now - timeSaver;
+    owlly.tick(frameTime);
+    timeSaver = now;
+}
+function forceRender() {
+    const owlly = Owlly.GetSharedInstance();
+    owlly.renderNextFrame();
+}
+// only for debugging
+// declare global {
+//   interface Window {
+//     Owlly: any; // eslint-disable-line
+//   }
+// }
+// if (window) window.Owlly = Owlly;
+export { Owlly, updateTick, forceRender };
+//# sourceMappingURL=owlly.js.map

package/lib/src/owlly/stage/owlly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owlly.js","sourceRoot":"","sources":["../../../../src/owlly/stage/owlly.ts"],"names":[],"mappings":"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"}

package/lib/src/owlly/stage/stage.d.ts

@@ -0,0 +1,108 @@
+import { NS_THREE } from './externals';
+import { Element } from '../element/element';
+import { View } from '../view';
+import { Controller } from '../controller';
+/**
+ * 场景类, 所有元素应当置于场景中, 视图与场景绑定后可渲染内容
+ */
+declare class Stage {
+    /**
+     * Stage 所使用的 THREE Scene
+     */
+    scene: NS_THREE.Scene;
+    private elements;
+    private lights;
+    private axesHelper;
+    private stageListeners;
+    private disposed;
+    constructor();
+    private registerEvents;
+    private initLights;
+    /**
+     * 旧的时钟函数, 后期应删除
+     * @deprecated
+     */
+    tick(): boolean;
+    /**
+     * 时钟钩子函数
+     * @returns 是否需要重新渲染
+     */
+    update(): boolean;
+    private handleElementUpdate;
+    /**
+     * 绑定视图至场景
+     * @param view 需要添加的视图
+     */
+    bindView(view: View): void;
+    /**
+     * 销毁视图
+     * @param view 需要销毁的视图
+     */
+    disposeView(view: View): void;
+    /**
+     * 绑定一个新的控制器到场景
+     * @param controller 添加的控制器
+     */
+    bindController(controller: Controller): void;
+    /**
+     * 销毁控制器
+     * @param controller 销毁的控制器
+     */
+    disposeController(controller?: Controller): Promise<void>;
+    /**
+     * 绑定元素至场景
+     * @param element 需要绑定的元素
+     */
+    bindElement(element: Element): void;
+    /**
+     * 销毁元素
+     * @param element 需要销毁的元素
+     */
+    disposeElement(element: Element): void;
+    /**
+     * 解绑元素, 元素仅会从 Stage 中移除而非销毁
+     * @param element 需要解绑的元素
+     */
+    unbindElement(element: Element): void;
+    /**
+     * (调试用) 开关性能统计
+     * @param value 开关值
+     */
+    setStatsEnabled(value: boolean): void;
+    /**
+     * (调试用) 开关场景xyz轴指示器
+     * @param value 开关值
+     */
+    setAxesEnabled(value: boolean): void;
+    /**
+     * 强制渲染
+     * @deprecated
+     */
+    render(): void;
+    /**
+     * 销毁场景
+     */
+    dispose(): void;
+    resizeElements(viewWidth: number, viewHeight: number): void;
+    renderElements(): void;
+    /**
+     * 强制重新计算绘制区域
+     * @deprecated
+     */
+    forceResize(): void;
+    /**
+     * 设置全场景背景色
+     * @param hexColor 颜色, 可以使用字符串
+     */
+    setBackgroundColor(hexColor: number | string): void;
+    /**
+     * 设置帧函数
+     * @param requestAnimationFrame
+     */
+    setFrameTickFunction(requestAnimationFrame: Function): void;
+    /**
+     * @ignore
+     */
+    toggleTickSelfManagement(value: boolean): void;
+}
+export { Stage };

package/lib/src/owlly/stage/stage.js

@@ -0,0 +1,235 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Externals } from './externals';
+import { EventHub } from '../utils/event-hub';
+import { OwllyEvents, Events } from '../utils/events';
+import { Owlly } from './owlly';
+/**
+ * 场景类, 所有元素应当置于场景中, 视图与场景绑定后可渲染内容
+ */
+class Stage {
+    constructor() {
+        const { THREE } = Externals.getInstance();
+        this.scene = new THREE.Scene();
+        this.elements = new Set();
+        this.lights = new THREE.Group();
+        this.initLights();
+        this.scene.add(this.lights);
+        this.axesHelper = new THREE.AxesHelper(10);
+        this.axesHelper.visible = false;
+        this.scene.add(this.axesHelper);
+        this.disposed = false;
+        this.stageListeners = {
+            onDisposeElement: (element) => {
+                if (Array.isArray(element)) {
+                    element.forEach((e) => { this.stageListeners.onDisposeElement(e); });
+                }
+                else {
+                    this.disposeElement(element);
+                }
+            },
+            onElementLoaded: (element) => {
+                EventHub.emit(Events.ELEMENT_LOADED, element);
+            },
+        };
+        this.registerEvents();
+        Owlly.GetSharedInstance().registerStage(this);
+    }
+    registerEvents() {
+        EventHub.on(OwllyEvents.DISPOSE_ELEMENT, this.stageListeners.onDisposeElement);
+        EventHub.on(OwllyEvents.ELEMENT_LOADED, this.stageListeners.onElementLoaded);
+    }
+    initLights() {
+        const { THREE } = Externals.getInstance();
+        const hemisphereLight = new THREE.HemisphereLight(0xffffff, 0xffffff, 0.75);
+        // hemisphereLight.color.setHSL(0.6, 0.75, 0.5);
+        // hemisphereLight.groundColor.setHSL(0.095, 0.5, 0.5);
+        hemisphereLight.position.set(0, 50, 0);
+        this.lights.add(hemisphereLight);
+        const directionalLight = new THREE.DirectionalLight(0xffffff, 0.23);
+        directionalLight.color.setHSL(0.1, 1, 0.95);
+        directionalLight.position.set(-0.5, 1, 0.75);
+        directionalLight.position.multiplyScalar(50);
+        // directionalLight.position.set(-50, 60, 50);
+        // directionalLight.castShadow = true;
+        // directionalLight.shadow.camera.bottom = -200;
+        // directionalLight.shadow.camera.top = 200;
+        // directionalLight.shadow.camera.left = -200;
+        // directionalLight.shadow.camera.right = 200;
+        this.lights.add(directionalLight);
+        this.lights.add(directionalLight.target);
+        directionalLight.target.updateMatrixWorld();
+        const directionalLight2 = new THREE.DirectionalLight(0xffffff, 0.23);
+        directionalLight2.color.setHSL(0.1, 1, 0.95);
+        directionalLight2.position.set(0.5, -1, 0.75);
+        directionalLight2.position.multiplyScalar(50);
+        this.lights.add(directionalLight2);
+        this.lights.add(directionalLight2.target);
+        directionalLight2.target.updateMatrixWorld();
+    }
+    /**
+     * 旧的时钟函数, 后期应删除
+     * @deprecated
+     */
+    tick() {
+        return this.update();
+    }
+    /**
+     * 时钟钩子函数
+     * @returns 是否需要重新渲染
+     */
+    update() {
+        if (this.disposed)
+            return false;
+        const elements = Array.from(this.elements);
+        const elementsNeedsUpdate = elements.reduce((tf, e) => (this.handleElementUpdate(e.update()) || tf), false);
+        return elementsNeedsUpdate;
+    }
+    handleElementUpdate(context) {
+        if (context.shouldPlaceElement) {
+            this.scene.add(context.element);
+        }
+        return context.needUpdate;
+    }
+    /**
+     * 绑定视图至场景
+     * @param view 需要添加的视图
+     */
+    bindView(view) {
+        view.bindStage(this);
+    }
+    /**
+     * 销毁视图
+     * @param view 需要销毁的视图
+     */
+    disposeView(view) {
+        view.dispose();
+    }
+    /**
+     * 绑定一个新的控制器到场景
+     * @param controller 添加的控制器
+     */
+    bindController(controller) {
+        if (controller.initWithScene)
+            controller.initWithScene(this.scene);
+    }
+    /**
+     * 销毁控制器
+     * @param controller 销毁的控制器
+     */
+    disposeController(controller) {
+        return __awaiter(this, void 0, void 0, function* () {
+        });
+    }
+    /**
+     * 绑定元素至场景
+     * @param element 需要绑定的元素
+     */
+    bindElement(element) {
+        this.elements.add(element);
+        // if (element.resize) this.forceResize();
+    }
+    /**
+     * 销毁元素
+     * @param element 需要销毁的元素
+     */
+    disposeElement(element) {
+        this.unbindElement(element);
+        if (element)
+            element.dispose();
+    }
+    /**
+     * 解绑元素, 元素仅会从 Stage 中移除而非销毁
+     * @param element 需要解绑的元素
+     */
+    unbindElement(element) {
+        if (!this.elements.has(element))
+            return;
+        this.scene.remove(element);
+        this.elements.delete(element);
+    }
+    /**
+     * (调试用) 开关性能统计
+     * @param value 开关值
+     */
+    setStatsEnabled(value) {
+        Owlly.GetSharedInstance().setStatsEnabled(value);
+    }
+    /**
+     * (调试用) 开关场景xyz轴指示器
+     * @param value 开关值
+     */
+    setAxesEnabled(value) {
+        this.axesHelper.visible = value;
+    }
+    /**
+     * 强制渲染
+     * @deprecated
+     */
+    render() {
+        throw new Error('[Owlly] This function is no longer being used. Use forceRender() exported from Owlly directly instead.');
+    }
+    /**
+     * 销毁场景
+     */
+    dispose() {
+        const elements = Array.from(this.elements);
+        elements.forEach((e) => {
+            this.elements.delete(e);
+            e.dispose();
+        });
+        EventHub.off(OwllyEvents.DISPOSE_ELEMENT, this.stageListeners.onDisposeElement);
+        EventHub.off(OwllyEvents.ELEMENT_LOADED, this.stageListeners.onElementLoaded);
+        this.disposed = true;
+        Owlly.GetSharedInstance().unregisterStage(this);
+    }
+    resizeElements(viewWidth, viewHeight) {
+        this.elements.forEach((element) => {
+            if (element.resize)
+                element.resize(viewWidth, viewHeight);
+        });
+    }
+    renderElements() {
+        this.elements.forEach((element) => {
+            if (element.render)
+                element.render();
+        });
+    }
+    /**
+     * 强制重新计算绘制区域
+     * @deprecated
+     */
+    forceResize() {
+        throw new Error('[Owlly] This function is no longer being used. Use Screen.resize() instead.');
+    }
+    /**
+     * 设置全场景背景色
+     * @param hexColor 颜色, 可以使用字符串
+     */
+    setBackgroundColor(hexColor) {
+        const { THREE } = Externals.getInstance();
+        this.scene.background = new THREE.Color(hexColor);
+    }
+    /**
+     * 设置帧函数
+     * @param requestAnimationFrame
+     */
+    setFrameTickFunction(requestAnimationFrame) {
+        Owlly.GetSharedInstance().setRequestAnimationFrameFunction(requestAnimationFrame);
+    }
+    /**
+     * @ignore
+     */
+    toggleTickSelfManagement(value) {
+        Owlly.GetSharedInstance().toggleTickSelfManagement(value);
+    }
+}
+export { Stage };
+//# sourceMappingURL=stage.js.map

package/lib/src/owlly/stage/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../../../../src/owlly/stage/stage.ts"],"names":[],"mappings":"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"}

package/lib/src/owlly/utils/alignment-utils.d.ts

@@ -0,0 +1,20 @@
+import { View } from '../view/view';
+declare class AlignmentUtils {
+    /**
+     * 获取2d与3d之间的对齐参数
+     * @param view 基准视图
+     * @param baseImageScale 底图缩放等级, 绝对值
+     * @param offset 底图整体偏移, 结构为 [ number, number ], 对应x, y轴偏移值
+     * @param imageSize 底图图片尺寸, 结构为 [ number, number ], 对应宽度, 高度
+     * @returns { upTrans: number[]; downTrans: number[]; matrixWorld: number[]; } 三个矩阵,
+     *  uptrans: 2d转3d, downTrans: 3d转2d, matrixWorld: 相机自身参数, 重设时使用
+     */
+    static getTransformMatrices(view: View, baseImageScale: number, offset: [number, number], imageSize: [number, number]): {
+        upTransOrigin: number[];
+        downTransOrigin: number[];
+        upTrans: number[];
+        downTrans: number[];
+        matrixWorld: number[];
+    };
+}
+export { AlignmentUtils };