@aibee/owlly 1.0.25 → 1.0.29

package/lib/prod/src/owlly/controller/basic-controller.d.ts

@@ -0,0 +1,324 @@
+import { NS_THREE } from '../stage/externals';
+import { Controller } from './controller';
+import { OrthographicView } from '../view/orthographic-view';
+import { PerspectiveView } from '../view/perspective-view';
+declare type MouseButtons = {
+    LEFT: NS_THREE.MOUSE;
+    MIDDLE: NS_THREE.MOUSE;
+    RIGHT: NS_THREE.MOUSE;
+};
+declare type Touches = {
+    ONE: NS_THREE.TOUCH;
+    TWO: NS_THREE.TOUCH | 'map';
+};
+declare class BasicController extends Controller {
+    private bindingView;
+    private camera;
+    private target;
+    private enabled;
+    private state;
+    private eventListeners;
+    private needUpdate;
+    private enableDamping;
+    private dampingFactor;
+    private mouseButtons;
+    private touches;
+    private boundaryEnabled;
+    private boundary;
+    private lastTick;
+    private timeStart;
+    private timeEnd;
+    private touchCenter;
+    private inertiaFactor;
+    private enableRotate;
+    private rotateMode;
+    private rotateSpeed;
+    private rotateStart;
+    private rotateDelta;
+    private rotateEnd;
+    private rotateLineStart;
+    private rotateLineEnd;
+    private rotateInertiaType;
+    private spherical;
+    private sphericalDelta;
+    private maxSpherical;
+    private minSpherical;
+    private lastQuaternion;
+    private rotateInertiaDirection;
+    private rotateInertiaEnabled;
+    private rotateInertiaBase;
+    private rotateInertia;
+    private rotateInertiaDuration;
+    private enableZoom;
+    private dollyStart;
+    private dollyEnd;
+    private zoomMode;
+    private zoomDelta;
+    private zoomRange;
+    private fovRange;
+    private zoomInertiaEnabled;
+    private zoomInertiaBase;
+    private zoomInertia;
+    private zoomInertiaDuration;
+    private enablePan;
+    private panStart;
+    private panDelta;
+    private panEnd;
+    private panOffset;
+    private panSpeed;
+    private lastPosition;
+    private screenSpacePanning;
+    private panInertiaDirection;
+    private panInertiaEnabled;
+    private panInertiaBase;
+    private panInertia;
+    private panInertiaDuration;
+    zoomScale: number;
+    followMouse: boolean;
+    private mouseXY;
+    constructor(view: PerspectiveView | OrthographicView);
+    private registerEvents;
+    private unregisterEvents;
+    private onMouseDown;
+    private onMouseMove;
+    private onMouseUp;
+    private onMouseWheel;
+    private onContextMenu;
+    private onTouchStart;
+    private onTouchMove;
+    private onTouchEnd;
+    private handleMouseDownRotate;
+    private handleMouseMoveSelfRotate;
+    private handleTouchStartRotate;
+    private handleTouchMoveSelfRotate;
+    private handleDownRotate;
+    private handleMoveRotate;
+    private handleRotateDelta;
+    private handleRotateSphericalDelta;
+    private handleUpRotate;
+    private handleMouseDownPan;
+    private handleMouseMovePan;
+    private handleTouchStartPan;
+    private handleTouchMovePan;
+    private handleDownPan;
+    private handleMovePan;
+    private handlePanDelta;
+    private handleUpPan;
+    private handleMouseWheel;
+    private handleZoom;
+    private handleUpZoom;
+    private handleMouseDownDolly;
+    private handleMouseMoveDolly;
+    private handleTouchStartDolly;
+    private handleTouchMoveDolly;
+    private handleTouchStartDollyRotate;
+    private handleTouchMoveDollyRotate;
+    private handleTouchStartDollyPan;
+    private handleTouchMoveDollyPan;
+    private handleTouchStartMap;
+    private handleTouchMoveAll;
+    private handleUpAll;
+    private resetVectors;
+    /** @ignore 暂缓开放 */
+    moveCameraTo(position: NS_THREE.Vector3, duration?: number, callbacks?: {
+        onUpdate?: (progress: number) => void;
+    }): Promise<void>;
+    /**
+     * 设置相机位置坐标
+     * @param position 位置坐标
+     * @param updateTarget 是否更新目标点坐标, 默认为true
+     */
+    setCameraPosition(position: NS_THREE.Vector3, updateTarget?: boolean): void;
+    /**
+     * 获取相机位置坐标
+     */
+    getCameraPosition(): NS_THREE.Vector3;
+    /**
+     * 设置当前相机看向目标位置
+     * @param target 目标点坐标
+     * @param updateCameraPosition 是否同步更新相机位置, 默认值为false
+     */
+    setCameraLookAt(target: NS_THREE.Vector3, updateCameraPosition?: boolean): void;
+    /**
+     * 获取相机看向目标位置
+     * @returns vec3
+     */
+    getCameraTarget(): NS_THREE.Vector3;
+    /**
+     * 设置当前相机视线方向
+     * @param direction 方向向量
+     * @param distance 目标距离, 默认值为1
+     */
+    setCameraLookAtVector(direction: NS_THREE.Vector3, distance?: number): void;
+    /**
+     * 设置是否开启阻尼
+     * @param enable 布尔值
+     */
+    setDampingEnabled(enable: boolean): void;
+    /**
+     * 设置阻尼系数, 默认值为0
+     * @param factor 阻尼系数
+     */
+    setDampingFactor(factor: number): void;
+    /**
+     * 获取阻尼系数
+     */
+    getDampingFactor(): number;
+    /**
+     * 设置是否激活缩放
+     * @param enable 布尔值
+     */
+    setZoomEnabled(enable: boolean): void;
+    /**
+     * 设置放大模式, 可选值: 'zoom': 使用变焦放大, 'fov': 使用fov放大
+     * @param mode 放大模式
+     */
+    setZoomMode(mode: 'zoom' | 'fov'): void;
+    /**
+     * 设置相机fov范围, 默认值为[60, 90]
+     * @param min 最小值
+     * @param max 最大值
+     */
+    setFovRange(min: number, max: number): void;
+    /**
+     * 设置当前相机fov, 仅限透视投影相机使用
+     * @param fov FOV值
+     */
+    setFov(fov: number): void;
+    /**
+     * 获取当前相机fov, 仅限透视投影相机使用
+     */
+    getFov(): number | null;
+    /**
+     * 设置变焦倍数范围, 默认值为[0, 10]
+     * @param min 最小值
+     * @param max 最大值
+     */
+    setZoomRange(min: number, max: number): void;
+    /**
+     * 设置当前变焦倍数, 倍数受倍数范围影响
+     * @param zoom 变焦倍数
+     */
+    setZoom(zoom: number): void;
+    /**
+     * 获取当前变焦倍数
+     */
+    getZoom(): number;
+    /**
+     * 设置是否激活变焦的惯性
+     * @param enabled 布尔值
+     */
+    setZoomInertiaEnabled(enabled: boolean): void;
+    /**
+     * 设置是否激活旋转
+     * @param enable 布尔值
+     */
+    setRotateEnabled(enable: boolean): void;
+    /**
+     * 设置旋转模式, 可选值 'self':自转, 'orbit': 公转
+     * @param mode 旋转模式
+     */
+    setRotateMode(mode: 'self' | 'orbit'): void;
+    /**
+     * 设置旋转速度
+     * @param speed 旋转速度倍数
+     */
+    setRotateSpeed(speed: number): void;
+    /**
+     * 获取旋转速度
+     */
+    getRotateSpeed(): number;
+    /**
+     * 设置是否激活旋转运动的惯性
+     * @param enabled 布尔值
+     */
+    setRotateInertiaEnabled(enabled: boolean): void;
+    /**
+     * 设置横向转动角度
+     * @param azimuth 弧度
+     */
+    setAzimuthAngle(azimuth: number): void;
+    /**
+     * 获取当前横向转动值, 范围区间为[-2 * PI, 2 * PI]
+     */
+    getAzimuthAngle(): number;
+    /**
+     * 设置纵向旋转角度
+     * @param polar 弧度
+     */
+    setPolarAngle(polar: number): void;
+    /**
+     * 获取当前纵向转动值
+     */
+    getPolarAngle(): number;
+    /**
+     * 设置横向转动范围, 范围区间为[-2 * PI, 2 * PI]
+     * @param min 最小值
+     * @param max 最大值
+     */
+    setAzimuthRange(min: number, max: number): void;
+    /**
+     * 设置纵向旋转范围, 范围区间为[0, PI]
+     * @param min 最小值
+     * @param max 最大值
+     */
+    setPolarRange(min: number, max: number): void;
+    /**
+     * 设置是否激活摇镜运动的惯性
+     * @param enabled 布尔值
+     */
+    setPanInertiaEnabled(enabled: boolean): void;
+    /**
+     * 设置惯性系数
+     * @param factor 惯性系数
+     */
+    setInertiaFactor(factor: number): void;
+    /**
+     * 设置是否激活摇镜(移动)
+     * @param enable 布尔值
+     */
+    setPanEnabled(enable: boolean): void;
+    /**
+     * 设置摇镜操作是否跟随屏幕空间朝向
+     * @param enabled 布尔值
+     */
+    setScreenSpacePanning(enabled: boolean): void;
+    /**
+     * 设置鼠标操作关联
+     * @param mouseButtons 鼠标操作关联
+     */
+    setMouseButtons(mouseButtons: MouseButtons): void;
+    /**
+     * 设置触摸操作关联
+     * @param touches 触摸操作关联
+     */
+    setTouches(touches: Touches): void;
+    /**
+     * 设置是否限制相机运动范围
+     * @param enable 是否限制
+     */
+    setBoundaryEnabled(enable: boolean): void;
+    /**
+     * 设置相机运动范围, 范围是一个包围盒, 使用最小值点与最大值点描述
+     * @param min 包围盒最小值点坐标, 默认值为无限小
+     * @param max 包围盒最大值点坐标, 默认值为无限大
+     */
+    setBoundary(min: NS_THREE.Vector3, max: NS_THREE.Vector3): void;
+    /**
+     * 设置BasicController是否激活可用
+     * @param enabled 是否激活
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * 获取当前激活状态
+     */
+    getEnabled(): boolean;
+    /** @ignore */
+    bindView(view: PerspectiveView | OrthographicView): void;
+    /** @ignore */
+    update(): boolean;
+    /** @ignore */
+    unbind(): void;
+    unbindView(): void;
+}
+export { BasicController };

package/lib/prod/src/owlly/controller/camera-controller.d.ts

@@ -0,0 +1,37 @@
+import { Controller } from './controller';
+import { CameraView } from '../view/camera-view';
+/**
+ * 相机元素控制器, 需要升级
+ */
+declare class CameraController extends Controller {
+    private enabled;
+    private view;
+    private target;
+    private mousePosition;
+    private mouseDownPosition;
+    private state;
+    private cameraInfoHolder;
+    private listeners;
+    private renderThisFrame;
+    /**
+     * @param view 需要绑定的View
+     */
+    constructor(view: CameraView);
+    private onPointerDown;
+    private onPointerUpOrLeave;
+    private onPointerMove;
+    /**
+     * 绑定视图
+     * @param view 需要绑定的CameraView
+     */
+    bindCameraView(view: CameraView): void;
+    unbind(): void;
+    /** @ignore */
+    update(): boolean;
+    /**
+     * 启用/禁用该控制器
+     * @param enabled 目标值
+     */
+    setEnabled(enabled: boolean): void;
+}
+export { CameraController };

package/lib/prod/src/owlly/controller/controller.d.ts

@@ -0,0 +1,61 @@
+import { NS_THREE } from '../stage/externals';
+import { View } from '../view/view';
+import { Element } from '../element/element';
+import { EventHubClassic } from '../utils/event-hub';
+/**
+ * @ignore
+ */
+interface ListenerSet {
+    pointerdown(e: PointerEvent): void;
+    pointerup(e: PointerEvent): void;
+    pointerleave(e: PointerEvent): void;
+    pointermove(e: PointerEvent): void;
+}
+/**
+ * 控制器
+ */
+declare class Controller extends EventHubClassic {
+    constructor();
+    /**
+     * @deprecated
+     * 解除当前绑定的视图
+     */
+    unbind(): void;
+    dispose(): void;
+}
+interface Controller {
+    /**
+     * 绑定视图到当前控制器
+     * @param view 需要绑定的视图
+     */
+    bindView(view: View): void;
+    /**
+     * 解除当前绑定的视图
+     */
+    unbindView(): void;
+    /**
+     * @ignore
+     */
+    update(): boolean;
+    /**
+     * 绑定元素到当前控制器
+     * @param element 需要绑定的元素或元素数组
+     */
+    bindElement?(element: Element | Element[]): void;
+    /**
+     * 将目标元素解除绑定, 解除绑定的元素将不再被该控制器所管理
+     * @param element 需要解绑的元素或元素数组
+     */
+    unbindElement?(element: Element | Element[]): void;
+    /**
+     * 对于需要Scene的controller, 初始化时会传递scene
+     * @param scene 传入的Scene
+     */
+    initWithScene?(scene: NS_THREE.Scene): void;
+    /**
+     * 对于需要根据View变化的Controller, 使用该钩子函数进行处理
+     * @param view 当前view
+     */
+    renderingViewChanged?(view: View): void;
+}
+export { Controller, ListenerSet };

package/lib/prod/src/owlly/controller/index.d.ts

@@ -0,0 +1,2 @@
+export * from './controller';
+export * from './basic-controller';

package/lib/prod/src/owlly/controller/mouse-indicator-controller.d.ts

@@ -0,0 +1,34 @@
+import { NS_THREE } from '../stage/externals';
+import { Controller } from './controller';
+import { View } from '../view/view';
+import { FloorModel } from '../element/floor-model';
+/**
+ * 鼠标位置控制器, 用于展示鼠标位置, vr.aibee.cn
+ */
+declare class MouseIndicatorController extends Controller {
+    indicator: NS_THREE.Mesh;
+    indicatorUrl: string;
+    view: View;
+    target: FloorModel;
+    enabled: boolean;
+    scene: NS_THREE.Scene;
+    protected renderFrame: boolean;
+    protected mouseEventHandlers: {
+        onPointerMove: (ev: MouseEvent) => void;
+        onPointerEnter: (ev: MouseEvent) => void;
+        onPointerLeave: (ev: MouseEvent) => void;
+    };
+    constructor(indicatorUrl: string);
+    private onPointerEnter;
+    private onPointerLeave;
+    private onPointerMove;
+    initWithScene(scene: NS_THREE.Scene): void;
+    bindView(view: View): void;
+    unbind(): void;
+    update(): boolean;
+    setTarget(target: FloorModel): void;
+    setEnabled(enabled: boolean): void;
+    protected registerPointerEvents(dom: HTMLElement): void;
+    protected unregisterPointerEvents(dom: HTMLElement): void;
+}
+export { MouseIndicatorController };

package/lib/prod/src/owlly/controller/orbit-control.d.ts

@@ -0,0 +1,147 @@
+import { NS_THREE } from '../stage/externals';
+import { OrbitControls } from '../../external/orbit-controls';
+import { Controller } from './controller';
+import { View } from '../view/view';
+/**
+ * 使用Three.js OrbitControls实现的场景控制器
+ */
+declare class OrbitControl extends Controller {
+    controls: OrbitControls;
+    protected renderFrame: boolean | undefined;
+    private view;
+    private enabled;
+    private box;
+    private prevPosition;
+    /**
+     * @param view 需要绑定的View
+     */
+    constructor(view: View);
+    protected renderThisFrame(): void;
+    /**
+     * 绑定视图
+     * @param view 需要绑定的View
+     */
+    bindView(view: View): void;
+    unbind(): void;
+    /** @ignore */
+    update(): boolean;
+    /**
+     * 设置视图中心点位
+     * @param x x
+     * @param y y
+     */
+    setPosition(x: number, y: number): void;
+    /**
+     * 设置键盘控制启用
+     * @param value 是否启用键盘控制
+     */
+    setKeysEnabled(value: boolean): void;
+    /**
+     * 设置是否启用惯性
+     * @param value 开关值
+     */
+    setDampingEnabled(value: boolean): void;
+    /**
+     * 设置位移速度
+     * @param value 位移速度
+     */
+    setPanSpeed(value: number): void;
+    /**
+     * 设置是否启用旋转功能
+     * @param value 开关值
+     */
+    setRotateEnabled(value: boolean): void;
+    /**
+     * 设置是否启用平移功能
+     * @param value 开关值
+     */
+    setPanEnabled(value: boolean): void;
+    /**
+     * 设置是否启用缩放功能
+     * @param value 开关值
+     */
+    setZoomEnabled(value: boolean): void;
+    /**
+     * 设置是否启用该控制器
+     * @param value 开关值
+     */
+    setEnabled(value: boolean): void;
+    /**
+     * 设置惯性阻尼
+     * @param value 衰减值
+     */
+    setDampingFactor(value: number): void;
+    /**
+     * 设置触摸操作模式
+     * @param touches 触摸配置
+     */
+    setTouchControls(touches: {
+        ONE: NS_THREE.TOUCH;
+        TWO: NS_THREE.TOUCH;
+    }): void;
+    /**
+     * 设置鼠标操作模式
+     * @param mouseButtons 鼠标按键配置
+     */
+    setMouseControls(mouseButtons: {
+        LEFT: NS_THREE.MOUSE;
+        MIDDLE: NS_THREE.MOUSE;
+        RIGHT: NS_THREE.MOUSE;
+    }): void;
+    /**
+     * 设置控制中心点
+     * @param x 世界坐标X
+     * @param y 世界坐标Y
+     * @param z 世界坐标Z
+     */
+    setTarget(x: number, y: number, z: number): void;
+    /**
+     * 设置纵向转动范围, 最低为0, 最高为Math.PI
+     * @param min 纵向转动范围最小值
+     * @param max 纵向转动范围最大值
+     */
+    setPolarAngle(min: number, max: number): void;
+    /**
+     * 设置zoom范围
+     * @param min zoom最小值
+     * @param max zoom最大值
+     */
+    setZoomRange(min: number, max: number): void;
+    /**
+     * 设置横向转动范围, 最低为-Math.PI, 最高为Math.PI
+     * @param min 横向转动范围最小值
+     * @param max 横向转动范围最大值
+     */
+    setAzimuthAngle(min: number, max: number): void;
+    /**
+     * 获取相机缩放
+     */
+    getZoom(): number | null;
+    /**
+     * 设置相机缩放
+     * @param zoom 目标缩放值
+     */
+    setZoom(zoom: number): void;
+    /**
+     * 获得相机旋转
+     * @returns 当前相机的旋转, 单位为弧度
+     */
+    getCameraRotation(): number;
+    /**
+     * 设置相机的旋转
+     * @param radius 目标弧度
+     */
+    setCameraRotation(radius: number): void;
+    /**
+     * 设置相机姿态
+     * @param worldMatrix 相机的姿态矩阵
+     */
+    setCameraWorldMatrix(worldMatrix: number[]): void;
+    /**
+     * 设置旋转速度
+     * @param speed 速度, 默认为1, 不传值时为重置为默认值
+     */
+    setRotateSpeed(speed?: number): void;
+    setPositionRange(min: NS_THREE.Vector3, max: NS_THREE.Vector3): void;
+}
+export { OrbitControl };

package/lib/prod/src/owlly/controller/panorama-adjust-controller.d.ts

@@ -0,0 +1,45 @@
+import { Controller } from './controller';
+import { Panorama } from '../element/panorama';
+import { View } from '../view/view';
+/**
+ * 全景图矫正控制器, 暂不使用
+ * @ignore
+ */
+declare class PanoramaAdjustController extends Controller {
+    private enabled;
+    private view;
+    private target;
+    private mousePosition;
+    private mouseDownPosition;
+    private state;
+    private cameraInfoHolder;
+    private listeners;
+    private renderThisFrame;
+    private activePanorama?;
+    /**
+     * @param view 需要绑定的View
+     */
+    constructor(view: View);
+    private onPointerDown;
+    private onPointerUpOrLeave;
+    private onPointerMove;
+    /**
+     * 绑定视图
+     * @param view 需要绑定的CameraView
+     */
+    bindView(view: View): void;
+    /**
+     * 绑定全景图元素
+     * @param element 设定控制器控制的全景图元素, 类型需要为Panorama
+     */
+    bindElement(element: Panorama): void;
+    unbind(): void;
+    /** @ignore */
+    update(): boolean;
+    /**
+     * 启用/禁用该控制器
+     * @param enabled 目标值
+     */
+    setEnabled(enabled: boolean): void;
+}
+export { PanoramaAdjustController };