@realsee/five-webgpu 1.0.0-alpha.5 → 1.0.0-alpha.7

package/plugins/FloorplanPlugin/typings/floorplanJson.d.ts

@@ -0,0 +1,167 @@
+/**
+ * doctorstrange 户型图编辑器导出的原始 json 数据结构
+ * @description formatFloorplanJson 以此为输入，转换成 FloorplanServerData（snake_case）
+ */
+export interface FloorplanJsonVrData {
+    origin: {
+        left: number;
+        top: number;
+    };
+}
+export interface FloorplanJsonItem {
+    id: string;
+    x: number;
+    y: number;
+    area: string;
+    type: number;
+    width: number;
+    height: number;
+    locked: boolean;
+    rotateZ: number;
+    rotateX: boolean;
+    rotateY: boolean;
+    displayName: string;
+}
+export interface FloorplanJsonPoint {
+    id: string;
+    x: number;
+    y: number;
+    rules: string;
+    lines: string[];
+    locked: boolean;
+    displayName: string;
+}
+export interface FloorplanJsonAreaAttachmentArea {
+    id: string;
+    type: number;
+    roomType: string;
+    direction: string;
+    towardsRad: number;
+    directionCode: string;
+    sharedLines: string[];
+    sharedLineItems: string[];
+}
+export interface FloorplanJsonLine {
+    align: number;
+    curve: number;
+    displayName: string;
+    edgeComputed: boolean;
+    id: string;
+    isLoadBearing: boolean;
+    items: string[];
+    offsetComputed: number;
+    points: string[];
+    thickness: null;
+    thicknessComputed: number;
+    type: number;
+}
+export interface FloorplanJsonLineItem {
+    displayName: string;
+    endPointAt: {
+        x: number;
+        y: number;
+    };
+    entrance: number;
+    id: string;
+    is: 'window' | 'door' | 'other';
+    length: number;
+    line: string;
+    noAnalysis: boolean;
+    offsetY?: number;
+    height?: number;
+    rotateX: boolean;
+    rotateY: boolean;
+    start: number;
+    startIndex: number;
+    startPointAt: {
+        x: number;
+        y: number;
+    };
+    type: number;
+}
+export interface FloorplanJsonArea {
+    attachments: {
+        areas: FloorplanJsonAreaAttachmentArea[];
+        lineItems: {
+            direction: string;
+            directionCode: string;
+            edge: boolean;
+            id: string;
+            is: string;
+            length: number;
+            towardsRad: number;
+        }[];
+    };
+    points: string[];
+    roomName: string;
+    roomType: string;
+    roomTypeName: number;
+    typeName: string;
+    type: number;
+    id: string;
+    empty: boolean;
+    roomTypeLabelMod: boolean;
+    labelX: number;
+    labelY: number;
+    hideName: boolean;
+    size: number;
+    customizedName: string;
+    displayName: string;
+    floorType: number;
+    hideSize: boolean;
+    nameIndex: string;
+    simpleLabelMod: boolean;
+    sizeWithoutLine: number;
+    subLabelX: number;
+    subLabelY: number;
+    subType: number;
+}
+export interface FloorplanJsonFloorplan {
+    name: string;
+    items: FloorplanJsonItem[];
+    points: FloorplanJsonPoint[];
+    floorIndex: string;
+    lineItems: FloorplanJsonLineItem[];
+    areas: FloorplanJsonArea[];
+    lines: FloorplanJsonLine[];
+    templates: {
+        areaLabelName: string;
+    };
+    info: {
+        description: string;
+        height: number;
+        ruleType: number;
+        subheight: number;
+        tags: unknown[];
+    };
+}
+export interface FloorplanJsonCheckMessage {
+    desc: string;
+    tag: string;
+    text: string;
+}
+/** doctorstrange 编辑器导出的原始户型图 json（IFloorplanJson，命名与后端服务保持一致，便于对照） */
+export interface IFloorplanJson {
+    nonce: string;
+    version: string;
+    vrData: FloorplanJsonVrData;
+    structure: string;
+    floorplans: FloorplanJsonFloorplan[];
+    checkMessages: FloorplanJsonCheckMessage[];
+    canvasSize: {
+        height: number;
+        width: number;
+    };
+    property: {
+        isAreaNameCustomized: boolean;
+        scanSize: number;
+        sourceType: number;
+    };
+}
+/** 观察点（point 位）传入格式，用于计算每个点位所在房间 */
+export interface FloorplanJsonObserver {
+    index: number;
+    floor_index: number;
+    /** [x, y, z]，米单位，与 five work.observers 的 standingPosition 对应 */
+    position: [number, number, number];
+}

package/plugins/FloorplanPlugin/typings/floorplanServerData.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 户型图服务端原始数据（snake_case），与 formatData 配合转换成内部使用的 FloorplanData（camelCase）
+ */
+export interface FloorplanServerPosition {
+    x: number;
+    y: number;
+}
+export interface FloorplanServerImagePosition {
+    x: number;
+    y: number;
+}
+export interface FloorplanServerOutlineItem {
+    url: string;
+    index: number;
+    svg_url?: string;
+}
+export interface FloorplanServerEntrance {
+    position_in_image: FloorplanServerImagePosition;
+    north_rad: number;
+    room_id: string;
+    floor_index: number;
+}
+export interface FloorplanServerBounding {
+    max: FloorplanServerPosition;
+    min: FloorplanServerPosition;
+    origin: FloorplanServerPosition;
+}
+export interface FloorplanServerRoomLabelItem {
+    position: FloorplanServerPosition;
+    position_in_image: FloorplanServerImagePosition;
+}
+export interface FloorplanServerDimension {
+    width: number;
+    height: number;
+    /** 垂直方向标注箭头定位点（一般为 2 个点：下端点、上端点） */
+    vertical?: FloorplanServerPosition[];
+    /** 水平方向标注箭头定位点（一般为 2 个点：左端点、右端点） */
+    horizontal?: FloorplanServerPosition[];
+}
+export interface FloorplanServerRoomItem {
+    id: string;
+    size: number;
+    name: string;
+    customized_name?: string;
+    path: FloorplanServerPosition[];
+    room_type: string;
+    floor_type: number;
+    room_label: FloorplanServerRoomLabelItem;
+    observer_indexs: number[];
+    dimension?: FloorplanServerDimension;
+}
+export interface FloorplanServerRuleLabels {
+    top: FloorplanServerPosition[][];
+    right: FloorplanServerPosition[][];
+    bottom: FloorplanServerPosition[][];
+    left: FloorplanServerPosition[][];
+}
+export interface FloorplanServerFloorData {
+    floor_name: string;
+    floor_index: number;
+    rooms: FloorplanServerRoomItem[];
+    rules: FloorplanServerRuleLabels;
+    is_has_wall: boolean;
+}
+export interface FloorplanServerObserver {
+    floor_index: number;
+    position_in_image: FloorplanServerImagePosition;
+}
+export interface FloorplanServerComputedData {
+    floor_datas: FloorplanServerFloorData[];
+    entrance: FloorplanServerEntrance | null;
+    bounding: FloorplanServerBounding;
+    observers: FloorplanServerObserver[];
+}
+export interface FloorplanServerData {
+    outlines: FloorplanServerOutlineItem[];
+    computed_data: FloorplanServerComputedData;
+}

package/plugins/FloorplanPlugin/typings/index.d.ts

@@ -0,0 +1,3 @@
+export * from './floorplanData';
+export * from './floorplanServerData';
+export * from './floorplanJson';

package/plugins/FloorplanPlugin/utils/changeMode.d.ts

@@ -0,0 +1,5 @@
+import type { Five } from '@realsee/five-webgpu';
+/**
+ * 等待 five.changeMode 真正的动画结束（changeMode 返回的 Promise 只代表切换请求被接受，不代表动画播放完毕）
+ */
+export declare function changeMode(five: Five, changeModeParams: Parameters<Five['changeMode']>): Promise<void>;

package/plugins/FloorplanPlugin/utils/changeModelCanvasOpacity.d.ts

@@ -0,0 +1,6 @@
+import type { Five } from '@realsee/five-webgpu';
+/**
+ * 通过 CSS opacity 让 five 渲染画布（及标记了 data-infive="1" 的兄弟 DOM）淡入 / 淡出
+ * @description 只改 DOM 透明度，不修改模型材质，代价小、可随时中断
+ */
+export declare function changeModelCanvasOpacity(five: Five, opacity: number, duration?: number): void;

package/plugins/FloorplanPlugin/utils/correctFiveState.d.ts

@@ -0,0 +1,11 @@
+import type { Five } from '@realsee/five-webgpu';
+import { type ShowState } from '../typing';
+/** 展示户型图所需的相机默认 fov */
+export declare const FIVE_CAMERA_DEFAULT_FOV = 80;
+/**
+ * 把当前 five 相机 / 模式状态纠正为展示户型图所需的目标状态
+ * @description
+ * - 模式不一致：调用 five.changeMode 切换模式（同时切到目标 pose）
+ * - 模式一致但相机状态不一致：调用 five.updateCamera 纠正相机
+ */
+export declare function correctFiveState(five: Five, showState: ShowState, userAction?: boolean): Promise<void>;

package/plugins/FloorplanPlugin/utils/equal.d.ts

@@ -0,0 +1,9 @@
+export declare function isShallowEqual(value: unknown, other: unknown): boolean;
+export declare function isDeepEqual(value: unknown, other: unknown): boolean;
+/**
+ * 比较两个值是否相等
+ * @param opt.deep - 是否深比较，默认 false（浅比较）
+ */
+export declare function equal(value: unknown, other: unknown, opt?: {
+    deep?: boolean;
+}): boolean;

package/plugins/FloorplanPlugin/utils/filter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 排除指定属性名数组，返回剩余属性组成的新对象
+ */
+export declare function omit<T extends object, K extends keyof T>(object: T, props: K[]): Omit<T, K>;
+/**
+ * 只保留指定属性名数组，返回剩余属性组成的新对象
+ */
+export declare function pick<T extends object, K extends keyof T>(object: T, props: K[]): Pick<T, K>;

package/plugins/FloorplanPlugin/utils/fiveModelLoad.d.ts

@@ -0,0 +1,6 @@
+import type { Five } from '@realsee/five-webgpu';
+/** 取「当前 work」对应的 model（多 work/model 场景下按 workCode 匹配，找不到则回退到 five.model） */
+export declare function getFiveModel(five: Five): import("@realsee/five-webgpu").Model;
+export declare function fiveModelIsLoaded(five: Five): boolean;
+/** 等待「当前 work」对应的 model 加载完成 */
+export declare function waitFiveModelLoaded(five: Five): Promise<void>;

package/plugins/FloorplanPlugin/utils/formatData.d.ts

@@ -0,0 +1,6 @@
+import type { FloorplanServerData, FloorplanData } from '../typings';
+/**
+ * 把后端返回的下划线风格 FloorplanServerData 转换成驼峰风格的 FloorplanData
+ */
+export declare function formatData(data: FloorplanServerData): Promise<FloorplanData>;
+export default formatData;

package/plugins/FloorplanPlugin/utils/formatFloorplanJson.d.ts

@@ -0,0 +1,20 @@
+import type { FloorplanJsonObserver, FloorplanServerData, FloorplanServerOutlineItem, IFloorplanJson } from '../typings';
+export interface FormatFloorplanJsonOptions {
+    /** 点位（拍摄点）列表，用于计算每个点位在户型图上的位置及所属房间 */
+    observers?: FloorplanJsonObserver[];
+    /** 房间名称使用的语言，默认中文 */
+    locate?: string;
+    /** 户型图线框图列表 */
+    outlines?: FloorplanServerOutlineItem[];
+}
+/**
+ * 从 doctorstrange 户型图编辑器导出的原始 json（IFloorplanJson）+ 点位信息，格式化为 FloorplanServerData
+ * @description 迁移自服务端 FloorplanComputer（service.realsee.com/server/routers/services/ironbox/floorplanComputer），
+ * 迁移到客户端后可离线（不依赖后端接口）把编辑器导出的 json 转换为 FloorplanPlugin.load 所需的数据结构。
+ * @param floorplanJson doctorstrange 编辑器导出的原始 json
+ * @param options.observers 点位（拍摄点）列表，用于计算每个点位在户型图上的位置及所属房间
+ * @param options.locate 房间名称使用的语言，默认中文
+ * @param options.outlines 户型图线框图列表
+ */
+export declare function formatFloorplanJson(floorplanJson: IFloorplanJson, options?: FormatFloorplanJsonOptions): FloorplanServerData | null;
+export default formatFloorplanJson;

package/plugins/FloorplanPlugin/utils/formatPosition.d.ts

@@ -0,0 +1,33 @@
+import type { Five } from '@realsee/five-webgpu';
+import type { FloorplanBounding, FloorplanData, FloorplanPosition, FloorplanImagePosition } from '../typings';
+/**
+ * 拼接 SVG path 的 d 属性字符串
+ */
+export declare function pathD(points: FloorplanPosition[], options?: {
+    needZ?: boolean;
+    format?: (point: FloorplanPosition) => FloorplanPosition;
+}): string;
+/**
+ * 把户型图坐标系（原点在中心）的点转换到 SVG 坐标系（原点在左上角，y 轴向下）
+ */
+export declare function formatFloorplanPoint({ x, y }: FloorplanPosition, bounding: FloorplanBounding): FloorplanPosition;
+/**
+ * 三维模型坐标（米）转户型图坐标（毫米，原点在中心）
+ */
+export declare function modelPosition2FloorplanPosition(position: {
+    x: number;
+    y: number;
+    z: number;
+}, floorplanData: FloorplanData): FloorplanPosition;
+/**
+ * 户型图坐标转图片相对坐标 [0,1]
+ */
+export declare function floorplanPosition2ImagePosition(position: FloorplanPosition, floorplanData: FloorplanData): FloorplanImagePosition;
+/**
+ * 求三维世界坐标点所在的楼层
+ */
+export declare function getFloorIndexFromModelPosition(position: {
+    x: number;
+    y: number;
+    z: number;
+}, five: Five): number;

package/plugins/FloorplanPlugin/utils/getDistanceFromModel.d.ts

@@ -0,0 +1,6 @@
+import type { Five } from '@realsee/five-webgpu';
+/**
+ * 根据模型整体包围盒和目标 fov/aspect，反算相机取景合适的距离
+ * @description 与 five 内部 FloorplanController.distanceFromModel 等价（该方法未对外导出，故在插件内重新实现）
+ */
+export declare function getDistanceFromModel(five: Five, fov: number, aspect: number): number;

package/plugins/FloorplanPlugin/utils/getPxmm.d.ts

@@ -0,0 +1,19 @@
+import type { Five } from '@realsee/five-webgpu';
+import { FLOOR_PLAN_ATTACHED_TO } from '../typing';
+export interface GetPxmmOption {
+    attachedTo?: FLOOR_PLAN_ATTACHED_TO;
+}
+/**
+ * 取指定楼层的地面高度（该楼层所有点位站立位置 y 的最大值）
+ * @description 若 floorIndex 超过实际最大楼层（比如查询顶层的天花板），退化为取整模型包围盒顶部
+ */
+export declare function getFloorY(five: Five, floorIndex: number): number;
+/**
+ * 根据吸附方式获取户型图应当吸附的世界坐标高度（y）
+ */
+export declare function getAttachedY(five: Five, floorIndex: number, attachedTo?: FLOOR_PLAN_ATTACHED_TO): number;
+/**
+ * 计算「每毫米对应多少像素」（用于把 3D 世界的毫米尺寸换算为户型图 DOM 的像素尺寸）
+ * @description 在吸附高度上取原点与 x 方向单位点，分别投影到屏幕 NDC 坐标，用横向偏移量换算比例
+ */
+export declare function getPxmm(five: Five, container: Element, floorIndex: number, options?: GetPxmmOption): number;

package/plugins/FloorplanPlugin/utils/isTruelyObject.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 判断是否是「纯对象」（排除数组、null、Map、Set 等）
+ */
+export declare function isTruelyObject(value: unknown): value is Record<string, unknown>;

package/plugins/FloorplanPlugin/utils/nearlyEqual.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断两个数字四舍五入到 precision 位小数后是否相等
+ */
+export declare function nearlyEqual(x: number, y: number, precision?: number): boolean;
+/**
+ * 判断两个弧度值是否近似相等，处理 0 / 2π 边界（角度环绕）
+ */
+export declare function nearlyEqualRad(x: number, y: number, precision?: number): boolean;

package/plugins/FloorplanPlugin/utils/polylabel.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 计算多边形的「不可达极点」（visual center），用于房间标签定位
+ * @description 基于 mapbox/polylabel 算法移植，去除了 tinyqueue 依赖（用数组 + 排序模拟优先队列，量级较小，性能影响可忽略）
+ */
+type Point = [number, number];
+type Polygon = Point[][];
+export declare function polylabel(polygon: Polygon, precision?: number): Point;
+export {};

package/plugins/FloorplanPlugin/utils/to.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Go 风格的错误处理封装：`const [err, data] = await to(promise)`
+ */
+export declare function to<T>(promise: Promise<T>): Promise<[null, T] | [Error, null]>;
+export default to;

package/plugins/Object3DHelperPlugin/Controller.d.ts

@@ -0,0 +1,99 @@
+import type { Five } from '@realsee/five-webgpu';
+import { BasePlugin } from '../BasePlugin';
+import * as THREE from 'three/webgpu';
+import type { Object3DHelperEventMap, Object3DHelperState, ObjectHelperControllers, PositionFrom } from './typing';
+import type { HelperConfig, HelperOffset, Object3DHelperPluginEventMap, Object3DHelperPluginState } from './typing';
+import { Subscribe } from '@realsee/five-webgpu';
+export declare const PLUGIN = "Object3DHelperPlugin";
+export type AddObject3DHelperConfig = {
+    positionFrom?: PositionFrom;
+    offset?: HelperOffset;
+    /** Helpers 的世界坐标偏移量 */
+    helperOffset?: THREE.Vector3;
+    yAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    xAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    zAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    moveHelper?: HelperConfig<{
+        xArrowEnable?: boolean;
+        yArrowEnable?: boolean;
+        zArrowEnable?: boolean;
+    }>;
+    /** 是否展示 MoveHelper 拖拽时的坐标提示，默认 false */
+    moveHelperTips?: boolean;
+    rotateHelper?: HelperConfig<{
+        yzCircleEnable?: boolean;
+        xzCircleEnable?: boolean;
+        xyCircleEnable?: boolean;
+        angleTipsEnable?: boolean;
+    }>;
+    boundingBoxHelper?: HelperConfig;
+};
+export declare class Object3DHelper {
+    controllers: ObjectHelperControllers;
+    state: Object3DHelperState;
+    hooks: Subscribe<Object3DHelperEventMap>;
+    constructor(controllers?: ObjectHelperControllers);
+    show(options?: {
+        userAction?: boolean;
+    }): void;
+    hide(options?: {
+        userAction?: boolean;
+    }): void;
+    enable(options?: {
+        userAction?: boolean;
+    }): void;
+    disable(options?: {
+        userAction?: boolean;
+    }): void;
+    dispose(): void;
+    setState(state: Partial<Object3DHelperState>, _options?: {
+        userAction?: boolean;
+    }): void;
+    addControllers(controllers: ObjectHelperControllers): void;
+    initialHelperMatrix(): void;
+    private handleEnable;
+    private handleVisible;
+    private handleDispose;
+    private everyControllerDo;
+}
+export declare class Controller extends BasePlugin.Controller<Object3DHelperPluginState, Object3DHelperPluginEventMap & BasePlugin.EventMap<Object3DHelperPluginState, any>, any, any> {
+    name: string;
+    data?: any;
+    state: Object3DHelperState;
+    objectHelperMap: Map<THREE.Object3D, {
+        helper: Object3DHelper;
+        disposers: (() => any)[];
+        helperGroup: THREE.Group;
+    }>;
+    constructor(five: Five);
+    show(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    hide(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    enable(options?: {
+        userAction?: boolean;
+    }): void;
+    disable(options?: {
+        userAction?: boolean;
+    }): void;
+    dispose(): void;
+    load(_data: any): Promise<void>;
+    setState(state: Partial<Object3DHelperState>, options?: {
+        userAction?: boolean;
+    } & Record<string, any>): void;
+    getObject3DHelper(object3D: THREE.Object3D): {
+        helper: Object3DHelper;
+        disposers: (() => any)[];
+        helperGroup: THREE.Group;
+    } | undefined;
+    addObject3DHelper(object3D: THREE.Object3D, paramsConfig?: AddObject3DHelperConfig): ObjectHelperControllers | undefined;
+    removeObject3DHelper(object3D: THREE.Object3D): void;
+    private handleEnable;
+    private handleVisible;
+    private handleDispose;
+    private everyHelperDo;
+    private actionIfStateIsEnabled;
+    private getConfig;
+}

package/plugins/Object3DHelperPlugin/Controllers/BaseController.d.ts

@@ -0,0 +1,142 @@
+import * as THREE from 'three/webgpu';
+import { Subscribe } from '@realsee/five-webgpu';
+import type { SolidGuideOptions } from '../utils/solidGuide';
+import type { HelperEventMap, HelperOffset, InternalHelperEventMap, ScaleCallback } from '../typing';
+import type { BaseHelper } from '../Helper/BaseHelper';
+import DomEvents from '../../thirdParty/domevents';
+export declare let originOpacity: {
+    opacity: number;
+} | null;
+type Config = {
+    offset?: HelperOffset;
+    yAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    xAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    zAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    scaleCallback?: ScaleCallback;
+    /** 实线样式与行为配置（透传给 SolidGuideLine） */
+    solidGuide?: SolidGuideOptions;
+};
+export declare abstract class BaseController<T extends BaseHelper = BaseHelper, K extends THREE.Object3D = THREE.Object3D> {
+    originObject3D: K;
+    hooks: Subscribe<HelperEventMap>;
+    preventTapDefaultEvent: boolean;
+    protected internalHooks: Subscribe<InternalHelperEventMap>;
+    protected readonly disposers: (() => void)[];
+    protected helperObject3D: T;
+    protected camera: THREE.Camera;
+    protected model: THREE.Object3D;
+    protected scene: THREE.Object3D;
+    protected container: HTMLElement;
+    protected domEvents: DomEvents;
+    protected isDragging: boolean;
+    protected enabled: boolean;
+    protected name: string;
+    protected boundingBox?: THREE.Box3;
+    protected config: Config;
+    private onRender;
+    protected cameraHooks: Subscribe<{
+        cameraUpdate: () => any;
+    }>;
+    /** 其他控制器的引用，用于跨控制器状态检查 */
+    protected otherControllers?: {
+        moveController?: BaseController;
+        rotateController?: BaseController;
+        scaleController?: BaseController;
+    };
+    /**
+     * 更新其他控制器的引用
+     */
+    updateOtherControllers(otherControllers: {
+        moveController?: BaseController;
+        rotateController?: BaseController;
+        scaleController?: BaseController;
+    }): void;
+    /**
+     * 获取当前控制器的拖拽状态
+     */
+    getIsDragging(): boolean;
+    constructor(params: {
+        camera: THREE.Camera;
+        model: THREE.Object3D;
+        originObject3D: K;
+        helperObject3D: T;
+        container: HTMLElement;
+        domEvents: DomEvents;
+        scene: THREE.Object3D;
+        onRender?: () => void;
+        sharedHooks?: Subscribe<HelperEventMap>;
+        sharedInternalHooks?: Subscribe<InternalHelperEventMap>;
+        /** 其他控制器的引用，用于跨控制器状态检查 */
+        otherControllers?: {
+            moveController?: BaseController;
+            rotateController?: BaseController;
+            scaleController?: BaseController;
+        };
+    }, config?: Config);
+    initialHelperPosition(): void;
+    initialHelperQuaternion(): void;
+    enable(): void;
+    disable(): void;
+    show(): void;
+    hide(): void;
+    dispose(): void;
+    /**
+     * @description: applyHelperMatrix4
+     * @param {THREE.Matrix4} matrix position 偏移量
+     */
+    applyHelperMatrix4(matrix: THREE.Matrix4): void;
+    /**
+     * @description: applyHelperQuaternion
+     * @param {THREE.Quaternion} quaternion 旋转四元数
+     * @param {THREE.Vector3} origin 旋转中心
+     */
+    applyHelperQuaternion(quaternion: THREE.Quaternion, origin: THREE.Vector3): void;
+    /**
+     * @description: applyHelperScaleMatrix4
+     * @param {THREE.Matrix4} matrix 缩放矩阵
+     * @param {THREE.Vector3} origin 缩放中心
+     */
+    applyHelperScaleMatrix4(matrix: THREE.Matrix4, origin?: THREE.Vector3): void;
+    onWantsTapGesture: (raycaster: THREE.Raycaster) => false | void;
+    updateHelperScale: () => void;
+    onWantsGesture(type: 'press' | 'pan' | string, pointers: {
+        x: number;
+        y: number;
+    }[], final: boolean): false | void;
+    onIntersectionOnModelUpdate(intersection: THREE.Intersection): void;
+    /**
+     * @description: onApplyOriginObjectScale
+     * @param {THREE.Matrix4} params.matrix 缩放矩阵
+     * @param {THREE.Vector3} params.origin 缩放中心
+     */
+    protected onApplyOriginObjectScale(params: {
+        matrix: THREE.Matrix4;
+        origin?: THREE.Vector3;
+    }): void;
+    /**
+     * @description: onApplyOriginObjectRotate
+     * @param {THREE.Quaternion} params.quaternion 旋转四元数
+     * @param {THREE.Vector3} params.origin 旋转中心
+     */
+    protected onApplyOriginObjectRotate(params: {
+        quaternion: THREE.Quaternion;
+        origin: THREE.Vector3;
+    }): void;
+    /**
+     * @description: onApplyOriginObjectPosition
+     * @param {THREE.Matrix4} params.matrix position 偏移量
+     */
+    protected onApplyOriginObjectPosition(params: {
+        matrix: THREE.Matrix4;
+    }): void;
+    protected onSetOriginObjectScale(scale: THREE.Vector3): void;
+    protected onSetOriginObjectRotate(_quaternion: THREE.Quaternion, _origin?: THREE.Vector3): void;
+    protected onSetOriginObjectPosition(position: THREE.Vector3): void;
+    protected render(): void;
+    protected updateOffsetByScale(scale: THREE.Vector3): void;
+    protected hoverListener(object3D: THREE.Object3D | undefined | THREE.Group | (THREE.Object3D | undefined | THREE.Group)[], hoverColor?: THREE.Color | string | number, hoverOpacity?: number): () => void;
+    private getIntersectObject;
+    private getBox;
+    private calculateOffset;
+}
+export {};