@aibee/owlly 1.0.25 → 1.0.29

package/lib/owlly/controller/tile-panorama-controller.d.ts

@@ -0,0 +1,308 @@
+import { NS_THREE } from '../stage/externals';
+import { Controller, View } from '..';
+import { TilePanorama } from '../element/tile-panorama';
+import { TilePanoramaGroup } from '../element/tile-panorama-group';
+import { BasicController } from './basic-controller';
+declare class TilePanoramaController extends Controller {
+    static __instance: TilePanoramaController;
+    private container;
+    private view;
+    private panoramaGroups;
+    private pid2GroupMap;
+    private curPanoramaGroup;
+    private basicController;
+    private modelMaterial;
+    private instantTranslationMaterial;
+    private planeMap;
+    private levelMap;
+    private planeNeedUpdate;
+    private planeWillUpdate;
+    private handlePanoramaUpdate;
+    private handlePanoramaLevel;
+    private mouseDrag;
+    private showModel;
+    private curPanorama;
+    private initialized;
+    private panoramaGroupChanged;
+    private isAnimating;
+    private translatePromise;
+    private cancelAnimation;
+    private static DirectionVectorScalar;
+    private renderFrame;
+    private raycaster;
+    private onScreenDetectRadius;
+    /** 移动点击 */
+    moveOnClick: boolean;
+    private captureMove;
+    private levels;
+    private enabled;
+    /** 最大等级控制 */
+    levelMax: number;
+    private touches;
+    private eventListeners;
+    /**
+     * 构造
+     * @param view 视图
+     * @param panoramaGroup 全景组
+     * @param basicController 基础控制器
+     * @param showModel 是否显示模型
+     */
+    constructor(view?: View, panoramaGroup?: TilePanoramaGroup | TilePanoramaGroup[], basicController?: BasicController, showModel?: boolean);
+    /**
+     * 设置是否激活可用
+     * @param enabled 是否激活
+     */
+    setEnabled(enabled: boolean): void;
+    private registerEvents;
+    private unregisterEvents;
+    private onMouseDown;
+    private onMouseMove;
+    private onMouseUp;
+    private onMouseWheel;
+    private onTouchStart;
+    private onTouchMove;
+    private onTouchEnd;
+    setLevels(levels: number[]): void;
+    updateLevel(): void;
+    /**
+     * 更新最大等级
+     * @param levelMax 最大等级
+     */
+    updateLevelMax(levelMax: number): void;
+    private onMouseDrag;
+    /**
+     * 绑定视图
+     * @param view
+     */
+    bindView(view: View): void;
+    /**
+     * 从全景点看
+     * @param pid 全景点id
+     * @param lookDirection 看的方向 v3
+     * @param showModel 是否显示模型
+     * @param preInitPanoramasStrategy 初始化全景策略
+     */
+    lookFromPanorama(pid: number, lookDirection?: NS_THREE.Vector3, showModel?: boolean, preInitPanoramasStrategy?: 'all' | number | number[]): Promise<void>;
+    /**
+     * 仅显示指定全景图，但不操作摄像机
+     * @param pid 全景点PID
+     * @parama showModel 可选，是否一开始就显示模型
+     * @param preInitPanoramasStrategy 可选，预创建全景对象的顺序策略，详见[PanoramaGroup]的【initializePanoramasIfNecessary]方法说明
+     */
+    showPanorama(pid: number, options?: {
+        lookDirection?: NS_THREE.Vector3;
+        target?: NS_THREE.Vector3;
+        showModel?: boolean;
+        preInitPanoramasStrategy?: 'all' | number | number[];
+    }): Promise<TilePanorama | undefined>;
+    /**
+     * 设置摄像机按指定视线方向看向目标位置
+     * @param target 目标位置
+     * @param sightDirection 可选，视线方向，不设置则默认以摄像机当前方向
+     */
+    setCameraLookAt(target: NS_THREE.Vector3, sightDirection?: NS_THREE.Vector3): void;
+    private getPanoramaOfPID;
+    /**
+     * @ignore
+     * @param capture
+     */
+    setCaptureMove(capture: boolean): void;
+    /**
+     * 移动到指定的全景点处
+     * @param toPID 目标全景点ID
+     * @param interval 可选，过渡所用时长
+     * @param easing 可选，插值函数
+     * @param fadeInOut 可选，是否使用淡出淡入变换
+     * @param toDirection 可选，到达目的点时要转到的视线方向，
+     *    若不设置则默认以从起始点到目的点的连线为最终视线方向
+     * @param lookAtTarget 可选，到达目的点时视线看向的位置，优先于toDirection
+     * @param fov 可选，视场角度数
+     */
+    moveToPanorama(toPID: number, params?: {
+        toDirection?: NS_THREE.Vector3;
+        lookAtTarget?: NS_THREE.Vector3;
+        interval?: number;
+        fov?: number;
+        fadeInOut?: boolean;
+        easing?: {
+            (k: number): number;
+        };
+        showModel?: boolean;
+    }): Promise<void>;
+    /**
+     * 移动到指定的全景点处
+     * 此方法与[[moveToPanorama]]的不同点在于通过Promise机制实现同步阻塞，
+     * 在前一个Translation未完成时发起的Translation会自动被阻塞到前一个完成时再执行
+     * @param toPID 目标全景点ID
+     * @param interval 可选，过渡所用时长
+     * @param easing 可选，插值函数
+     * @param fadeInOut 可选，是否使用淡出淡入变换
+     * @param toDirection 可选，到达目的点时要转到的视线方向，
+     *  若不设置则默认以从起始点到目的点的连线为最终视线方向
+     * @param lookAtTarget 可选，到达目的点时视线看向的位置，优先于toDirection
+     * @param fov 可选，视场角度数
+     */
+    moveToPanoramaSync(toPID: number, params?: {
+        toDirection?: NS_THREE.Vector3;
+        lookAtTarget?: NS_THREE.Vector3;
+        interval?: number;
+        fov?: number;
+        fadeInOut?: boolean;
+        easing?: {
+            (k: number): number;
+        };
+        showModel?: boolean;
+    }): Promise<void>;
+    private static getModelMesh;
+    private getModelMaterial;
+    private preloadCubeTexturesOfPIDs;
+    private getInstantTranslationMaterial;
+    /**
+     * @ignore
+     * @param visible
+     */
+    setModelAppearance(modelElement: NS_THREE.Object3D, visible: boolean, meshMaterial?: NS_THREE.Material | NS_THREE.Material[], modelMesh?: NS_THREE.Mesh): void;
+    moveInPath(path: number[], params?: {
+        queueIfBusy?: boolean;
+        showModel?: boolean;
+        toDirections?: NS_THREE.Vector3 | NS_THREE.Vector3[];
+        lookAtTargets?: NS_THREE.Vector3 | NS_THREE.Vector3[];
+        intervals?: number | number[];
+        fovs?: number | number[];
+        fadeInOuts?: boolean | boolean[];
+        easings?: {
+            (k: number): number;
+        } | {
+            (k: number): number;
+        }[];
+        freeRotation?: boolean;
+        rotateDelays?: number | number[];
+    }): Promise<void>;
+    /**
+     * 根据路径移动相机
+     * @param pathPoints 摄像机运动的路径上每一段目的点的Vector3坐标数组
+     * @param queueIfBusy 可选，指示当当前有动画在进行中时，是把此次动作排队还是直接放弃
+     * @param intervals 可选，若为数组则依次是每一段路径所花费的时间间隔，若是一个数则全都用该时间间隔
+     * @param fovs 可选，若为数组则依次是每一段路径结束时的视场角，若是一个数则全都用该视场角
+     * @param toDirections 可选，若为数组则依次是每一段路径结束点的视线方向，若是单一Vector3对象则全用此视线方向
+     * @param lookAtTargets 可选，若为数组则依次是每一段路径所看向的位置，若是单一Vector3对象则始终看向此位置
+     * toDirections与lookAtTargets最多只能有一个，如果同时传入了则只以lookAtTargets为准
+     * @param easings 可选，若为数组则依次是每一段路径的动画插值函数，
+     * 若是单一{(k: number): number}对象则全用此插值函数
+     * @param rotateDelays 可选，旋转时的延迟时间
+     * @param progressTransforms 可选，转换progress的映射函数，从0~1之间的小数映射到另一个0~1之间的小数
+     * @param beforeAllMoves 整个路径移动即将开始前的回调
+     * @param onOneMoveStart 每段路径移动开始时的回调
+     * @param onOneMoveUpdate 每段路径移动进行中的进度回调
+     * @param onOneMoveComplete 每段路径移动结束时的回调
+     * @param afterAllMoves 整个路径移动结束时的回调
+     * @returns
+     */
+    moveCameraInPath(pathPoints: NS_THREE.Vector3[], params?: {
+        queueIfBusy?: boolean;
+        toDirections?: NS_THREE.Vector3 | NS_THREE.Vector3[];
+        lookAtTargets?: NS_THREE.Vector3 | NS_THREE.Vector3[];
+        intervals?: number | number[];
+        fovs?: number | number[];
+        easings?: {
+            (k: number): number;
+        } | {
+            (k: number): number;
+        }[];
+        progressTransforms?: {
+            (progress: number): number;
+        } | {
+            (progress: number): number;
+        }[];
+        rotateDelays?: number | number[];
+        beforeAllMoves?: {
+            (): Promise<void>;
+        };
+        onOneMoveStart?: {
+            (index: number, target0: NS_THREE.Vector3, eye0: NS_THREE.Vector3, target1: NS_THREE.Vector3, eye1: NS_THREE.Vector3, error?: {
+                loadedError?: boolean;
+            }): Promise<boolean>;
+        };
+        onOneMoveUpdate?: {
+            (index: number, progress0: number, progress: number): void;
+        };
+        onOneMoveComplete?: {
+            (index: number): void;
+        };
+        afterAllMoves?: {
+            (): Promise<void>;
+        };
+        freeRotation?: boolean;
+    }): Promise<void>;
+    /**
+     * 设置FOV, 不可以超过setFOVRange所设置的范围.
+     * @param fov 垂直方向视场角
+     */
+    setFOV(fov: number): void;
+    /**
+       * 设置FOV范围, 默认为[60, 90]
+       * @param min 垂直方向视场角最小值
+       * @param max 垂直方向视场角最大值
+       */
+    setFOVRange(min: number, max: number): void;
+    /**
+     * 设置摄像机观察方向和位置
+     * @param position 摄像机所在位置
+     * @param lookAt 观察目标点，同时也是[[OrbitControls]]的旋转中心
+     */
+    setCameraPose(position: NS_THREE.Vector3, lookAt: NS_THREE.Vector3, useLookAt?: boolean): void;
+    /**
+     * 渲染帧
+     */
+    protected renderThisFrame(): void;
+    /**
+     * 删除平面
+     * @param pid
+     */
+    private deletePlane;
+    /**
+     * 更新全景纹理信息
+     * @param updates
+     * @param deletes
+     */
+    private updatePanoramaTextureInfos;
+    /**
+     * 更新当前全景纹理信息
+     * @param waitPfids
+     */
+    private updateCurPanoramTextureInfo;
+    /**
+     * 删除全景点的纹理信息
+     * @param panorama
+     */
+    private deleteTextureInfos;
+    /**
+     * 清理全景点纹理信息
+     * @param panorama
+     */
+    private disposeTextureInfos;
+    private updateTexture;
+    /**
+     * 更新平面再相机中的信息
+     * @param view
+     * @returns
+     */
+    private updatePlaneInCamera;
+    private panoramaeUpdate;
+    update(): boolean;
+    /**
+     * 全景点挂载
+     * @param pano
+     */
+    private panoramaMount;
+    /**
+     * 全景点卸载
+     * @param pano
+     */
+    private panoramaUnmount;
+    /**
+     * 清理
+     */
+    dispose(): void;
+}
+export { TilePanoramaController };