@realsee/five-webgpu 1.0.0-alpha.4 → 1.0.0-alpha.6

package/plugins/CSS2DPlugin/Controller.d.ts

@@ -0,0 +1,59 @@
+import type { Five } from '@realsee/five-webgpu';
+import { BasePlugin } from '../BasePlugin';
+import * as THREE from 'three/webgpu';
+import { CSS2DRenderer, CSS2DObject } from '../thirdParty/CSS2DRenderer.js';
+import type * as PluginType from './typing';
+export declare class Controller extends BasePlugin.Controller<PluginType.State, PluginType.EventMap, PluginType.ServerData, PluginType.PluginData> {
+    /** 当前使用的数据 */
+    data?: PluginType.PluginData;
+    /** 插件当前状态 */
+    state: PluginType.State;
+    /** CSS2D 渲染器实例 */
+    renderer: CSS2DRenderer;
+    scene: THREE.Scene;
+    styleSheet: CSSStyleSheet;
+    camera: THREE.PerspectiveCamera;
+    private resizeObserver?;
+    private updateState;
+    constructor(five: Five, params?: PluginType.Params);
+    load(data: PluginType.ServerData): Promise<void>;
+    createCSS2DObject: ({ id, name, innerHTML, center, position, visible, timeout, }: PluginType.CreateCSS2DObjectType) => CSS2DObject;
+    render: () => void;
+    private _addEventListener;
+    private _removeEventListener;
+    /**
+     * 将插件 DOM 挂载到指定容器
+     */
+    appendToFiveContainer(): void;
+    add(...object: THREE.Object3D[]): void;
+    remove(object: THREE.Object3D): void;
+    removeAll(): void;
+    /**
+     * 淡入指定的 CSS2DObject
+     */
+    fadeInObjects(...objects: THREE.Object3D[]): void;
+    /**
+     * 淡出指定的 CSS2DObject
+     */
+    fadeOutObjects(...objects: THREE.Object3D[]): void;
+    private _enable;
+    private _disable;
+    /**
+     * 启用插件
+     */
+    enable(options?: BasePlugin.BaseOptions): void;
+    /**
+     * 禁用插件
+     */
+    disable(options?: BasePlugin.BaseOptions): void;
+    /**
+     * 显示场景
+     */
+    show(options?: BasePlugin.BaseOptions): void;
+    /**
+     * 隐藏场景
+     */
+    hide(options?: BasePlugin.BaseOptions): void;
+    /** 销毁插件 */
+    dispose: () => void;
+}

package/plugins/CSS2DPlugin/index.d.ts

@@ -0,0 +1,5 @@
+import type { Five } from '@realsee/five-webgpu';
+import type * as CSS2DPluginType from './typing';
+import { Controller } from './Controller';
+export declare const CSS2DPlugin: (five: Five, params?: CSS2DPluginType.Params) => Controller;
+export type { CSS2DPluginType, Controller as CSS2DPluginController };

package/plugins/CSS2DPlugin/typing.d.ts

@@ -0,0 +1,31 @@
+import type * as THREE from 'three/webgpu';
+import type { BasePlugin } from '../BasePlugin';
+export type PluginData = any;
+export type ServerData = any;
+export interface CreateCSS2DObjectType {
+    id?: string;
+    name?: string;
+    innerHTML: string;
+    center?: THREE.Vector2;
+    position?: THREE.Vector3;
+    visible?: boolean;
+    timeout?: number;
+}
+/** 插件配置 */
+export interface Config {
+}
+/** 插件初始化参数 */
+export interface Params {
+    config?: Partial<Config>;
+    initialState?: Partial<State>;
+}
+/** 插件状态 */
+export interface State extends BasePlugin.State {
+    /** 插件是否启用 */
+    enabled: boolean;
+    /** 插件整体是否可见 */
+    visible: boolean;
+}
+/** 插件事件 */
+export interface EventMap extends BasePlugin.EventMap<State, ServerData> {
+}

package/plugins/CSS3DPlugin/Controller.d.ts

@@ -0,0 +1,64 @@
+import type { Five } from '@realsee/five-webgpu';
+import { BasePlugin } from '../BasePlugin';
+import * as THREE from 'three/webgpu';
+import { CSS3DRenderer, CSS3DObject } from '../thirdParty/CSS3DRenderer.js';
+import type * as PluginType from './typing';
+export declare class Controller extends BasePlugin.Controller<PluginType.State, PluginType.EventMap, PluginType.ServerData, PluginType.PluginData> {
+    /** 当前使用的数据 */
+    data?: PluginType.PluginData;
+    /** 插件当前状态 */
+    state: PluginType.State;
+    /** CSS3D 渲染器实例 */
+    renderer: CSS3DRenderer;
+    scene: THREE.Scene;
+    styleSheet: CSSStyleSheet;
+    camera: THREE.PerspectiveCamera;
+    cacheMap: WeakMap<object, any>;
+    private resizeObserver?;
+    private updateState;
+    constructor(five: Five, params?: PluginType.Params);
+    load(data: PluginType.ServerData): Promise<void>;
+    createCSS3DObject: ({ id, name, innerHTML, sprite, normal, position, scalar, visible, timeout, }: PluginType.CreateCSS3DObjectType) => CSS3DObject;
+    render: () => void;
+    /**
+     * 强制标脏并重新渲染所有 objects
+     */
+    forceRender: () => void;
+    private _addEventListener;
+    private _removeEventListener;
+    /**
+     * 将插件 DOM 挂载到指定容器
+     */
+    appendToFiveContainer(): void;
+    add(...object: THREE.Object3D[]): void;
+    remove(object: THREE.Object3D): void;
+    removeAll(): void;
+    /**
+     * 淡入指定的 CSS3DObject，设置 object.userData.visible = true
+     */
+    fadeInObjects(...objects: THREE.Object3D[]): void;
+    /**
+     * 淡出指定的 CSS3DObject，设置 object.userData.visible = false
+     */
+    fadeOutObjects(...objects: THREE.Object3D[]): void;
+    private _enable;
+    private _disable;
+    /**
+     * 启用插件，让插件能够响应交互
+     */
+    enable(options?: BasePlugin.BaseOptions): void;
+    /**
+     * 禁用插件，让插件停止响应交互
+     */
+    disable(options?: BasePlugin.BaseOptions): void;
+    /**
+     * 显示场景，设置 scene.visible = true
+     */
+    show(options?: BasePlugin.BaseOptions): void;
+    /**
+     * 隐藏场景，设置 scene.visible = false
+     */
+    hide(options?: BasePlugin.BaseOptions): void;
+    /** 销毁插件，移除所有副作用 */
+    dispose: () => void;
+}

package/plugins/CSS3DPlugin/index.d.ts

@@ -0,0 +1,5 @@
+import type { Five } from '@realsee/five-webgpu';
+import type * as CSS3DPluginType from './typing';
+import { Controller } from './Controller';
+export declare const CSS3DPlugin: (five: Five, params?: CSS3DPluginType.Params) => Controller;
+export type { CSS3DPluginType, Controller as CSS3DPluginController };

package/plugins/CSS3DPlugin/typing.d.ts

@@ -0,0 +1,33 @@
+import type * as THREE from 'three/webgpu';
+import type { BasePlugin } from '../BasePlugin';
+export type PluginData = any;
+export type ServerData = any;
+export interface CreateCSS3DObjectType {
+    id?: string;
+    name?: string;
+    innerHTML: string;
+    sprite?: boolean;
+    normal?: THREE.Vector3;
+    position?: THREE.Vector3;
+    scalar?: number;
+    visible?: boolean;
+    timeout?: number;
+}
+/** 插件配置 */
+export interface Config {
+}
+/** 插件初始化参数 */
+export interface Params {
+    config?: Partial<Config>;
+    initialState?: Partial<State>;
+}
+/** 插件状态 */
+export interface State extends BasePlugin.State {
+    /** 插件是否启用 */
+    enabled: boolean;
+    /** 插件整体是否可见 */
+    visible: boolean;
+}
+/** 插件事件 */
+export interface EventMap extends BasePlugin.EventMap<State, ServerData> {
+}

package/plugins/FloorplanPlugin/Controller.d.ts

@@ -0,0 +1,100 @@
+import type { Five } from '@realsee/five-webgpu';
+import { BasePlugin } from '../BasePlugin';
+import type { State, Config, Params, EventMap, PluginData, PluginServerData, ShowState, ShowOptions, HideOptions, HighlightData } from './typing';
+export declare class Controller extends BasePlugin.Controller<State, EventMap, PluginServerData, PluginData> {
+    name: string;
+    state: State;
+    protected data?: PluginData;
+    /** 展示户型图时，five 需要处于的相机状态 */
+    protected showState: ShowState;
+    /** show 动画的公共 Promise */
+    protected showPromise?: Promise<void>;
+    /** show 过程中的 reject 方法，用于被 hide/disable 打断时抛出 */
+    private showRejection?;
+    private renderer;
+    private styleSheet;
+    private panoIndex;
+    private floorIndex;
+    /** 户型图父容器 */
+    private wrapper?;
+    /** five.addExtraElement 的解绑函数：户型图 DOM 与 five 画布是兄弟节点而非子节点，
+     * wheel/pan/tap 等原生事件不会冒泡到 five 绑定监听的画布元素上，
+     * 必须显式注册为 extraElement 才能让 hover 在户型图 DOM（如房间高亮层）上时鼠标滚轮缩放等手势仍然生效 */
+    private removeExtraElement?;
+    /** 展示户型图前，Five 的 Panorama Longitude（用于相机图标朝向） */
+    private lastPanoramaLongitude;
+    /** 户型图 DOM 大小 */
+    private size;
+    /** 是否已经执行过事件监听 */
+    private hasAddedEventListener;
+    /** 上一次隐藏是否是用户调用了 hide 导致的（用于阻止随后的自动展示） */
+    private isHiddenByHideFunc;
+    /** 高亮区域 */
+    private highlightData;
+    /** 当前 hover 的房间，供 handleClick 读取 */
+    private store;
+    private resizeObserver?;
+    constructor(five: Five, params?: Params);
+    /** 加载户型图服务端数据 */
+    load(serverData: PluginServerData, state?: Partial<State>, userAction?: boolean): Promise<void>;
+    /** 把楼层数据里的家具数组填充进 floorDatas[i].items（数据结构与业务约定的家具数据源对齐，此处保留扩展点，调用方自行传入格式化后的数组） */
+    loadItems(itemsByFloor: PluginData['floorDatas'][number]['items'][]): void;
+    /** 把插件渲染 DOM 挂载到指定容器 */
+    appendTo(wrapper: Element): void;
+    enable(options?: BasePlugin.BaseOptions): void;
+    disable(options?: BasePlugin.BaseOptions): void;
+    dispose: () => void;
+    /**
+     * 展示户型图
+     * @description 多次调用只会触发一次 showAnimationEnded；如果参数不一致，上一次 show 的 Promise 会被 reject
+     */
+    show: (options?: Omit<Partial<ShowOptions>, "isAutoShow">) => Promise<void>;
+    /** 隐藏户型图 */
+    hide: (options?: Partial<HideOptions>) => Promise<void>;
+    setState(state: Partial<State>, options?: BasePlugin.BaseOptions): void;
+    changeConfigs(config: Partial<Config>, userAction?: boolean): void;
+    /** 更新户型图展示大小（根据吸附高度换算的 pxmm 计算 DOM 尺寸） */
+    updateSize(): boolean;
+    /** 更新户型图位置（跟随模型包围盒中心的屏幕投影） */
+    updatePosition(): void;
+    highlight: (highlightData: HighlightData) => void;
+    unhighlight: () => void;
+    /** 更新展示状态（longitude/latitude/offset 等），可用于自定义户型图展示角度 */
+    updateShowState: (showState: Partial<ShowState>) => void;
+    private getPxmmWithRotation;
+    private updateState;
+    private initContainer;
+    private registerExtraElement;
+    private observeResize;
+    /** 帧节流：把 resize 触发的 updateSize/updatePosition 合并到下一帧执行，避开与 five.refresh() 的调用顺序竞态 */
+    private pendingResizeFrame?;
+    private scheduleResizeUpdate;
+    private renderCurrent;
+    private onRoomHover;
+    private handleClick;
+    private addEventListener;
+    private removeEventListener;
+    private onFiveModelLoaded;
+    /** 模式切换后自动隐藏户型图 */
+    private onFiveModeChange;
+    /** 惯性结束后，判断能否自动展示户型图 */
+    private onFiveInertiaPan;
+    private onFivePanoArrived;
+    /** 相机变化时判断户型图是否应该自动隐藏 */
+    private onFiveCameraUpdate;
+    /** 帧节流：把 updatePosition/updateSize 合并到下一帧执行，避免逐帧触发同步重排 */
+    private pendingCameraUpdateFrame?;
+    private scheduleCameraUpdate;
+    private getRelativePose;
+    /** 户型图展示中转动模型，结束时自动修复模型状态 */
+    private onFiveWantsPanGesture;
+    private onFiveWantsTapGesture;
+    private onFiveWantsChangeMode;
+    /** 模型楼层高亮改变时，自动进行楼层切换 */
+    private onModelShownFloorChange;
+    private _enable;
+    private _disable;
+    private _show;
+    private _hide;
+    private renderWithDuration;
+}

package/plugins/FloorplanPlugin/index.d.ts

@@ -0,0 +1,5 @@
+import type { Five } from '@realsee/five-webgpu';
+import type * as FloorplanPluginType from './typing';
+import { Controller } from './Controller';
+export declare const FloorplanPlugin: (five: Five, params?: FloorplanPluginType.Params) => Controller;
+export type { FloorplanPluginType, Controller as FloorplanPluginController };

package/plugins/FloorplanPlugin/render/assets.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 相机（点位）朝向图标：一个指向朝向的扇形箭头，中心为当前点位
+ * 用轻量内联 SVG 代替原 dnalogelSDK 的位图资源，保留相近的视觉语义
+ */
+export declare const CAMERA_IMAGE = "data:image/png;base64,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";
+/**
+ * 指北针图标：一个简单的指针 + N 字标记
+ */
+export declare const COMPASS_IMAGE = "data:image/png;base64,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";

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

@@ -0,0 +1,35 @@
+import type { Config, FloorplanData, FloorplanRoomItem, HighlightData } from '../typing';
+export interface RenderProps {
+    visible: boolean;
+    duration: number;
+    panoIndex: number;
+    floorIndex: number;
+    floorplanData: FloorplanData;
+    lastPanoramaLongitude: number;
+    config: Config;
+    highlightData: HighlightData;
+    store: {
+        roomOnMouse: FloorplanRoomItem | null;
+    };
+    onRoomHover: (room: FloorplanRoomItem | null) => void;
+}
+/**
+ * 户型图纯 DOM/SVG 渲染器
+ * @description 替代 dnalogelSDK 的 Svelte 版本渲染层，管理每个楼层的 DOM 复用与展示态切换
+ */
+export declare class FloorplanRenderer {
+    readonly rootElement: HTMLElement;
+    /** floorIndex -> 楼层 DOM，缓存以避免每次 render 都重建整棵树 */
+    private floorElements;
+    private currentFloorIndex;
+    private isVisible;
+    constructor();
+    /**
+     * 根据最新的 props 全量刷新渲染结果
+     * @description 楼层 DOM 会被复用（数据没变时不重建），只有当前楼层可见（opacity/pointer-events 切换）
+     */
+    render(props: RenderProps): void;
+    /** 重新计算当前楼层房间标签的可见性（容器 resize 后调用） */
+    updateLabelsVisibility(floorplanData: FloorplanData, floorIndex: number, adaptiveEnable: boolean): void;
+    dispose(): void;
+}

package/plugins/FloorplanPlugin/render/isPointInPolygon.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 判断点是否在多边形内（ray casting 算法）
+ * @see https://wrf.ecse.rpi.edu//Research/Short_Notes/pnpoly.html
+ */
+export declare function isPointInPolygon(point: [number, number], polygon: [number, number][]): boolean;

package/plugins/FloorplanPlugin/render/renderFloor.d.ts

@@ -0,0 +1,22 @@
+import type { Config, FloorplanData, FloorplanRoomItem, HighlightData } from '../typing';
+export interface RenderFloorContext {
+    floorplanData: FloorplanData;
+    floorIndex: number;
+    panoIndex: number;
+    lastPanoramaLongitude: number;
+    config: Config;
+    highlightData: HighlightData;
+    /** 当前 hover 的房间，供外部（Controller.handleClick）读取 */
+    store: {
+        roomOnMouse: FloorplanRoomItem | null;
+    };
+    onRoomHover: (room: FloorplanRoomItem | null) => void;
+}
+/**
+ * 渲染单个楼层的完整 DOM 树（材质 -> 高亮 -> 线框 -> 家具 -> 标签 -> 相机 -> 指北针）
+ */
+export declare function renderFloor(ctx: RenderFloorContext): HTMLElement;
+/**
+ * 根据房间标签 DOM 的实际尺寸和 pxmm，更新标签的自适应显隐（需要在 DOM 挂载并有真实宽度后调用）
+ */
+export declare function updateRoomLabelsVisibility(floorEl: HTMLElement, floorplanData: FloorplanData, floorIndex: number, adaptiveEnable: boolean): void;

package/plugins/FloorplanPlugin/render/roomLabelVisibility.d.ts

@@ -0,0 +1,10 @@
+import type { FloorplanRoomItem } from '../typings';
+/**
+ * 判断房间标签 DOM（给定宽高，中心点对齐 room.roomLabel.position）在 pxmm 缩放下
+ * 是否整体落在房间轮廓内（四个角都在多边形内才算通过）
+ * @description 与 dnalogelSDK RoomLabel.svelte 的 isLabelInRoomCurry 等价
+ */
+export declare function isLabelInRoom(room: FloorplanRoomItem, labelSize: {
+    width: number;
+    height: number;
+}, pxmm: number): boolean;

package/plugins/FloorplanPlugin/typing.d.ts

@@ -0,0 +1,156 @@
+import type * as THREE from 'three/webgpu';
+import type { BasePlugin } from '../BasePlugin';
+import type { FloorplanData, FloorplanServerData, FloorplanRoomItem, FloorplanItem } from './typings';
+export * from './typings';
+/** 户型图在垂直方向上吸附的高度基准 */
+export declare const enum FLOOR_PLAN_ATTACHED_TO {
+    /** 吸附到楼层地面 */
+    FLOOR = 1,
+    /** 吸附到楼层天花板 */
+    CEILING = 2,
+    /** 吸附到模型整体包围盒中心高度 */
+    BOUNDING_CENTER = 3
+}
+export declare const enum FloorplanErrorType {
+    UnknownError = "UnknownError",
+    DataNotLoaded = "DataNotLoaded",
+    UpdateSizeError = "UpdateSizeError",
+    BreakOffByHide = "BreakOffByHide",
+    BreakOffByDisable = "BreakOffByDisable",
+    ModelNotLoaded = "ModelNotLoaded",
+    ChangeModeError = "ChangeModeError",
+    UpdateCameraError = "UpdateCameraError"
+}
+export type PluginData = FloorplanData;
+export type PluginServerData = FloorplanServerData | {
+    version: number;
+    data: FloorplanServerData;
+};
+export type ShowMode = 'Topview' | 'Mapview' | 'Floorplan';
+/** 展示户型图时，需要 five 处于的相机状态 */
+export interface ShowState {
+    latitude: number;
+    longitude: number;
+    fov?: number;
+    mode: ShowMode;
+    offset?: THREE.Vector3;
+    distance?: number;
+}
+export interface MissingFloorConfig {
+    imageURL: string;
+    imageWidth: number;
+    imageHeight: number;
+    text: string;
+    textFontSize: number;
+}
+export interface Config {
+    /** 指北针文字 */
+    northDesc: string;
+    /** 展示户型图时，模型/全景画面的透明度 */
+    modelOpacity: number;
+    /** 是否展示相机（点位）图标 */
+    cameraEnable: boolean;
+    /** 是否允许房间高亮 */
+    highlightEnable: boolean;
+    /** 鼠标 hover 房间时是否高亮 */
+    hoverEnable: boolean;
+    /** 是否展示指北针 */
+    compassEnable: boolean;
+    /** 相机静止一段时间后是否自动展示户型图 */
+    autoShowEnable: boolean;
+    /** 是否展示外墙标尺 */
+    ruleLabelsEnable: boolean;
+    /** 是否展示房间标签（名称/面积/尺寸的总开关） */
+    roomLabelsEnable: boolean;
+    /** 是否展示房间面积 */
+    roomAreaEnable: boolean;
+    /** 是否展示房间名称 */
+    roomNameEnable: boolean;
+    /** 其它类型房间是否展示名称 */
+    roomNameOtherTypeEnable: boolean;
+    /** 是否展示房间尺寸标注 */
+    roomDimensionEnable: boolean;
+    /** 相机（点位）图标使用的图片地址 */
+    cameraImageUrl: string;
+    /** 户型图在垂直方向上的吸附基准 */
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+    /** 自定义房间标签渲染，返回值将替代默认的名称/面积/尺寸 DOM */
+    getLabelElement?: (room: FloorplanRoomItem) => HTMLElement | undefined;
+    /** 房间标签是否根据房间大小自适应显隐 */
+    adaptiveRoomLabelVisibleEnable: boolean;
+    /** 无楼层数据时的占位配置 */
+    missingFloorConfig: Partial<MissingFloorConfig>;
+    /** 国际化转换函数 */
+    i18n: (key: string) => string;
+    /** 面积文案格式化 */
+    getRoomAreaText: (size: number) => string;
+    /** 尺寸文案格式化 */
+    getRoomDimensionText: (width: number, height: number) => string;
+    /** 标尺距离文案格式化 */
+    getRuleDistanceText: (distance: number) => string;
+}
+/** 插件初始化参数 */
+export interface Params {
+    config?: Partial<Config>;
+    initialState?: Partial<State>;
+    /** 展示户型图时期望 five 处于的相机状态，可通过 updateShowState 更新 */
+    showState?: Partial<ShowState>;
+}
+export interface State extends BasePlugin.State {
+    enabled: boolean;
+    visible: boolean;
+    config: Config;
+}
+export interface ShowOptions {
+    /** 展示的楼层 */
+    floorIndex: number;
+    /** 展示户型图时，模型 / 全景画面的透明度 */
+    modelOpacity: number;
+    /** 是否立即展示（不做渐显动画） */
+    immediately: boolean;
+    /** 是否是自动展示（惯性停止后触发），内部使用 */
+    isAutoShow: boolean;
+    /** 是否是用户行为 */
+    userAction: boolean;
+}
+export interface HideOptions {
+    userAction: boolean;
+    /** 是否是自动隐藏（相机大幅转动触发），内部使用 */
+    isAutoHide: boolean;
+}
+/** 高亮数据，key 为 `${floorIndex}_${roomId}` */
+export type HighlightData = Record<string, {
+    fill?: string;
+    opacity?: number;
+    disabled?: boolean;
+} | undefined>;
+export interface EventMap extends BasePlugin.EventMap<State, PluginData> {
+    /** enabled 从 false 到 true 的回调 */
+    enable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 true 到 false 的回调 */
+    disable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** 插件 dispose */
+    dispose: () => void;
+    /** 开始展示户型图 */
+    show: (event: {
+        userAction: boolean;
+        auto: boolean;
+    }) => void;
+    /** 户型图展示动画结束 */
+    showAnimationEnded: (event: {
+        userAction: boolean;
+        auto: boolean;
+    }) => void;
+    /** 隐藏户型图 */
+    hide: (event: {
+        auto: boolean;
+        userAction: boolean;
+    }) => void;
+    /** 点击房间，返回 false 可阻止默认的分间跳转行为 */
+    click: (room: FloorplanRoomItem | null) => void | false;
+}
+export type { FloorplanRoomItem, FloorplanItem };