@realsee/five/five/controllers/floorplan.d.ts

Realsee Renderer SDK

import * as THREE from "three";
import { GestureEvent } from "../utils/event";
import { TextureLoader } from "../texture/loader";
import { BaseController, BaseControllerInitArgs } from "./base";
import { State } from "../types/state";
import { Pose } from "../types/pose";
import { MovePanoEffect } from "../types/movePanoEffect";
import { Works, WorkObserver } from "../work";
import { ModelScene } from "../model";
import { Motion } from "../utils/motion";
import { IntersectMeshInterface } from "../types/intersectMeshInterface";
type LocationMotion = Motion<"x" | "y" | "z" | "distance">;
type ModelAlphaMotion = Motion<"modelAlpha">;
type PerspToOrthoMotion = Motion<"perspToOrtho">;
interface FloorplanControllerCustomInitArgs {
    /** 默认水平角 */
    defaultLongitude?: number;
    /** 默认俯仰角 */
    defaultLatitude?: number;
    /** 最大俯仰角 */
    maxLatitude?: number | ((fov: number) => number);
    /** 最小俯仰角 */
    minLatitude?: number | ((fov: number) => number);
    /** 默认相机可视角度（垂直），可作为 `zoom` */
    defaultFov?: number;
    /** 最大相机可视角度 */
    maxFov?: number;
    /** 最小相机可视角度 */
    minFov?: number;
    /** 鼠标焦点环自定义创建器 */
    intersectMeshCreator?: () => IntersectMeshInterface;
}
declare const defaultFloorplanControllerCustomInitArgs: Required<FloorplanControllerCustomInitArgs>;
type FloorplanControllerInitArgs = BaseControllerInitArgs & FloorplanControllerCustomInitArgs;
declare class FloorplanController extends BaseController implements Required<FloorplanControllerInitArgs> {
    defaultLongitude: number;
    defaultLatitude: number;
    maxLatitude: number | ((fov: number) => number);
    minLatitude: number | ((fov: number) => number);
    defaultFov: number;
    maxFov: number;
    minFov: number;
    intersectMeshCreator: () => IntersectMeshInterface;
    locationMotion: LocationMotion;
    modelAlphaMotion: ModelAlphaMotion;
    perspToOrthoMotion: PerspToOrthoMotion;
    protected pinchState?: {
        x: number;
        y: number;
        fov: number;
    };
    protected pendingTextureId: string | null;
    protected intersectMesh: IntersectMeshInterface;
    protected textureLoader: TextureLoader;
    static distanceFromModel(modelScene: ModelScene, fov: number, aspect: number): number;
    static parseArgs(args: FloorplanControllerInitArgs): Required<FloorplanControllerInitArgs>;
    static initAnimationEndState(args: FloorplanControllerInitArgs): State;
    constructor(args: FloorplanControllerInitArgs);
    updateConfiguration(args: FloorplanControllerCustomInitArgs): boolean;
    /** 析构函数 */
    destroy(): void;
    /** 是否准备好，即不在用户操作中，并且不再动画中 */
    isReady(): boolean;
    /** 生命周期：更新 Work */
    updateWork(works: Works, state: Partial<State>, options: {
        duration: number;
        effect: MovePanoEffect;
    }, userAction: boolean): boolean;
    /** 生命周期：更新模型 */
    updateModel(modelScene: ModelScene): void;
    /** 转动摄像头 */
    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
    /** 通过帧动画转动摄像头 */
    updateCameraWithKeyframes(keyframes: {
        progress: number;
        value: Pose;
        key?: string;
    }[], duration: number, userAction: boolean): Promise<void>;
    /** 生命周期：时间迭代 */
    updateTime(time: number, deltaTime: number, ...args: any[]): void;
    /** 获取目标姿态 */
    getTargetState(): State;
    /** 初始化动画 */
    protected initAnimation(): Promise<void>;
    updateRenderSize(size: THREE.Vector2): void;
    /**
     * 方向射线上寻找下一个目标点位
     * @param raycaster - 方向射线
     * @returns 方向射线上寻找下一个目标点位
     */
    protected getForwardObserverOrNot(raycaster: THREE.Raycaster): WorkObserver | null;
    protected coordinatesForOffset(offset: {
        x: number;
        y: number;
    }): {
        longitude: number;
        latitude: number;
    };
    /** 惯性滚动 */
    protected requestMomentumMovement(event: GestureEvent, isFirst: boolean, velocity: {
        longitude: number;
        latitude: number;
    }, duration: number): void;
    /** 触摸 Pan 事件，相机转动 */
    protected onPanGesture(event: GestureEvent): void;
    /** 触摸 Pinch 事件， 相机缩放 */
    protected onPinchGesture(event: GestureEvent): void;
    /** 鼠标移动事件 展示交点环 */
    protected onMouseMove(event: GestureEvent): void;
    /** 鼠标滚轮事件 相机缩放 */
    protected onMouseWheel(event: GestureEvent): void;
    /** 触摸 点击屏幕 */
    protected onTapGesture(event: GestureEvent): void;
    /** 触摸 双点屏幕 */
    protected onDblTapGesture(event: GestureEvent): void;
    /** 隐藏焦点环 */
    protected hideIntersectMesh(): void;
}
export { LocationMotion, ModelAlphaMotion, PerspToOrthoMotion, FloorplanController, FloorplanControllerInitArgs, FloorplanControllerCustomInitArgs, defaultFloorplanControllerCustomInitArgs, };