f6257f5162
- 重构测量激活逻辑，在 Engine 组件中添加统一的 activateMeasure(mode) 方法 - 简化 MeasureDialogManager，移除冗余的 handleMeasureTypeChange 方法 - 添加 EngineManager.activateMeasure 转发方法 - 修复 loadModel 错误，正确调用 Engine 组件方法 - 为 Engine 组件设置固定背景渐变色 - MeasurePanel 初始化时触发 onModeChange 回调 - 添加 MeasureMode 共享类型定义 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1433 lines
38 KiB
TypeScript
1433 lines
38 KiB
TypeScript
/**
|
||
* 通用按钮组组件 (BimButtonGroup)
|
||
*/
|
||
declare class BimButtonGroup implements IBimComponent {
|
||
private container;
|
||
private options;
|
||
private groups;
|
||
private activeBtnIds;
|
||
private btnRefs;
|
||
private dropdownElement;
|
||
private hoverTimeout;
|
||
private customColors;
|
||
private unsubscribeLocale;
|
||
private unsubscribeTheme;
|
||
protected engine: BimEngine | null;
|
||
private readonly DEFAULT_ICON;
|
||
constructor(options: ButtonGroupOptions);
|
||
setEngine(engine: BimEngine): void;
|
||
protected emit<K extends keyof EngineEvents>(event: K, payload: EngineEvents[K]): void;
|
||
private initContainer;
|
||
/**
|
||
* 设置事件拦截，防止事件冒泡到下层元素（如 3D 引擎）
|
||
*/
|
||
private setupEventInterception;
|
||
private updatePosition;
|
||
/**
|
||
* 应用样式到容器
|
||
*/
|
||
private applyStyles;
|
||
/**
|
||
* 设置主题的primary颜色（用于边框等）
|
||
*/
|
||
private setPrimaryColor;
|
||
/**
|
||
* 设置主题颜色
|
||
* 只会应用到没有被用户自定义的颜色属性上
|
||
*/
|
||
setTheme(theme: ThemeConfig): void;
|
||
/**
|
||
* 直接设置颜色（强制覆盖）
|
||
* 设置的颜色会被标记为自定义，后续的 setTheme 不会覆盖它们
|
||
*/
|
||
setColors(colors: ButtonGroupColors): void;
|
||
init(): Promise<void>;
|
||
setLocales(): void;
|
||
addGroup(groupId: string, beforeGroupId?: string): void;
|
||
addButton(config: ButtonConfig): void;
|
||
private findButton;
|
||
render(): void;
|
||
private renderGroup;
|
||
private renderButton;
|
||
/**
|
||
* 设置按钮的激活状态
|
||
* @param id 按钮 ID
|
||
* @param active 可选，如果不传则切换(toggle)当前状态
|
||
*/
|
||
setBtnActive(id: string, active?: boolean): void;
|
||
private handleClick;
|
||
/**
|
||
* 互斥关闭同范围内的其它已激活按钮，并触发它们的 onClick
|
||
* @param button 当前被激活的按钮
|
||
*/
|
||
private deactivateExclusiveSiblings;
|
||
private handleMouseEnter;
|
||
private handleMouseLeave;
|
||
private showDropdown;
|
||
private renderDropdownItem;
|
||
private closeDropdown;
|
||
private updateButtonState;
|
||
private getIcon;
|
||
updateButtonVisibility(id: string, visible: boolean): void;
|
||
setShowLabel(show: boolean): void;
|
||
private updateLabelsVisibility;
|
||
private findButtonById;
|
||
setBackgroundColor(color: string): void;
|
||
private isVisible;
|
||
destroy(): void;
|
||
}
|
||
|
||
declare abstract class BimComponent {
|
||
protected engine: BimEngine;
|
||
constructor(engine: BimEngine);
|
||
/**
|
||
* Helper to send events easily
|
||
*/
|
||
protected emit<K extends keyof EngineEvents>(event: K, payload: EngineEvents[K]): void;
|
||
/**
|
||
* Helper to listen to events easily
|
||
* Returns an unsubscribe function
|
||
*/
|
||
protected on<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): () => void;
|
||
abstract destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 通用弹窗组件类
|
||
* 支持拖拽、缩放、自定义内容和位置。
|
||
*/
|
||
declare class BimDialog implements IBimComponent {
|
||
private element;
|
||
private options;
|
||
private container;
|
||
private header;
|
||
private contentArea;
|
||
private _isDestroyed;
|
||
private _isInitialized;
|
||
private unsubscribeTheme;
|
||
private unsubscribeLocale;
|
||
private rafId;
|
||
/**
|
||
* 构造函数
|
||
* @param options 弹窗配置选项
|
||
*/
|
||
constructor(options: DialogOptions);
|
||
/**
|
||
* 设置主题
|
||
* @param theme 全局主题配置
|
||
*/
|
||
setTheme(theme: ThemeConfig): void;
|
||
/**
|
||
* 初始化组件功能 (接口实现)
|
||
*/
|
||
init(): void;
|
||
setLocales(): void;
|
||
/**
|
||
* 创建弹窗的 DOM 结构
|
||
*/
|
||
private createDom;
|
||
/**
|
||
* 设置元素尺寸
|
||
*/
|
||
private setSize;
|
||
/**
|
||
* 根据内容自动调整弹窗宽度
|
||
* @param recenter 是否重新计算定位（例如保持居中），默认 true
|
||
*/
|
||
fitWidth(recenter?: boolean): void;
|
||
/**
|
||
* 根据内容自动调整弹窗高度
|
||
*
|
||
* 设计说明：
|
||
* - 主要用于“内容展开/收起”场景（比如测量面板展开后，Dialog 高度跟随变化）
|
||
* - 默认不改变用户拖拽后的当前位置，只做边界夹紧，避免弹窗超出容器
|
||
*
|
||
* @param recenter 是否根据 options.position 重新定位（默认 false）
|
||
*/
|
||
fitHeight(recenter?: boolean): void;
|
||
/**
|
||
* 边界夹紧：保持当前 left/top 不变的前提下，确保弹窗不超出容器
|
||
* 说明：用于 fitHeight / fitWidth 后的“尺寸变化”场景，避免弹窗被裁切。
|
||
*/
|
||
private clampToContainer;
|
||
/**
|
||
* 初始化弹窗位置
|
||
*/
|
||
private initPosition;
|
||
/**
|
||
* 初始化拖拽功能 (性能优化 + 解决粘手)
|
||
*/
|
||
private initDrag;
|
||
/**
|
||
* 初始化缩放功能 (性能优化 + 解决粘手)
|
||
*/
|
||
private initResize;
|
||
/**
|
||
* 动态设置内容
|
||
* @param content 内容元素或 HTML 字符串
|
||
*/
|
||
setContent(content: HTMLElement | string): void;
|
||
/**
|
||
* 关闭弹窗并销毁
|
||
*/
|
||
close(): void;
|
||
/**
|
||
* 销毁组件 (接口实现)
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
export declare class BimEngine extends EventEmitter {
|
||
container: HTMLElement;
|
||
private wrapper;
|
||
toolbar: ToolbarManager | null;
|
||
constructTreeBtn: ConstructTreeManagerBtn | null;
|
||
buttonGroup: ButtonGroupManager | null;
|
||
dialog: DialogManager | null;
|
||
engine: EngineManager | null;
|
||
rightKey: RightKeyManager | null;
|
||
propertyPanel: PropertyPanelManager | null;
|
||
measure: MeasureDialogManager | null;
|
||
sectionPlane: SectionPlaneDialogManager | null;
|
||
sectionAxis: SectionAxisDialogManager | null;
|
||
sectionBox: SectionBoxDialogManager | null;
|
||
walkControl: WalkControlManager | null;
|
||
map: MapDialogManager | null;
|
||
constructor(container: HTMLElement | string, options?: {
|
||
locale?: LocaleType;
|
||
theme?: ThemeType;
|
||
});
|
||
emit<K extends keyof EngineEvents>(event: K, payload: EngineEvents[K]): void;
|
||
on<K extends keyof EngineEvents>(event: K, listener: (payload: EngineEvents[K]) => void): () => void;
|
||
setLocale(locale: LocaleType): void;
|
||
getLocale(): LocaleType;
|
||
setTheme(theme: 'dark' | 'light'): void;
|
||
setCustomTheme(theme: ThemeConfig): void;
|
||
private init;
|
||
private updateTheme;
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 树节点类
|
||
* 负责渲染单个节点、处理交互和递归
|
||
*/
|
||
declare class BimTreeNode {
|
||
config: TreeNodeConfig;
|
||
element: HTMLElement;
|
||
children: BimTreeNode[];
|
||
parent: BimTreeNode | null;
|
||
checkState: TreeNodeCheckState;
|
||
private contentEl;
|
||
private switcherEl;
|
||
private checkboxEl;
|
||
private titleEl;
|
||
private actionsEl;
|
||
private childrenContainer;
|
||
private onExpandChange;
|
||
private onCheckChange;
|
||
private onNodeClick;
|
||
private renderActions?;
|
||
constructor(config: TreeNodeConfig, options: TreeOptions, callbacks: {
|
||
onExpand: (n: BimTreeNode) => void;
|
||
onCheck: (n: BimTreeNode) => void;
|
||
onClick: (n: BimTreeNode) => void;
|
||
});
|
||
/**
|
||
* 创建节点 DOM
|
||
*/
|
||
private createDom;
|
||
/**
|
||
* 设置高亮选中状态 (Select 模式下)
|
||
*/
|
||
setSelected(selected: boolean): void;
|
||
/**
|
||
* 更新显示文本 (国际化支持) -> 移除国际化，直接显示
|
||
*/
|
||
updateLabel(): void;
|
||
/**
|
||
* 切换展开状态
|
||
*/
|
||
toggleExpand(force?: boolean): void;
|
||
/**
|
||
* 切换选中状态 (用户点击)
|
||
*/
|
||
toggleCheck(): void;
|
||
/**
|
||
* 设置选中状态 (API调用或联动)
|
||
* @param state 新状态
|
||
* @param fireEvent 是否触发事件
|
||
*/
|
||
setChecked(state: TreeNodeCheckState, fireEvent?: boolean): void;
|
||
/**
|
||
* 更新复选框 UI 样式
|
||
*/
|
||
updateCheckboxUI(): void;
|
||
/**
|
||
* 添加子节点实例
|
||
*/
|
||
appendChild(childNode: BimTreeNode): void;
|
||
/**
|
||
* 销毁
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
/** 按钮内部文字图标排列 */
|
||
declare type ButtonAlign = 'vertical' | 'horizontal';
|
||
|
||
/** 按钮配置 */
|
||
export declare interface ButtonConfig {
|
||
id: string;
|
||
type: ButtonType;
|
||
label: string;
|
||
icon?: string;
|
||
keepActive?: boolean;
|
||
/**
|
||
* 是否互斥（开关互斥）
|
||
*
|
||
* 行为说明：
|
||
* - 当按钮从“未激活”切换到“激活”时，如果该按钮开启了 exclusive，
|
||
* 会自动关闭同互斥范围内的其它已激活按钮，并触发它们的 onClick（用于执行关闭逻辑）。
|
||
* - 一级按钮：互斥范围 = 同 groupId 下的一级按钮
|
||
* - 二级按钮：互斥范围 = 同 groupId 且同 parentId 下的二级按钮
|
||
*
|
||
* 注意：该能力通常与 keepActive 搭配使用。
|
||
*/
|
||
exclusive?: boolean;
|
||
isActive?: boolean;
|
||
disabled?: boolean;
|
||
onClick?: (button: OptButton) => void;
|
||
children?: ButtonConfig[];
|
||
groupId?: string;
|
||
parentId?: string;
|
||
/** 按钮内部图标文字排列 (默认 vertical，即图标在上) */
|
||
align?: ButtonAlign;
|
||
/** 图标大小 (正方形，单位 px，默认 32) */
|
||
iconSize?: number;
|
||
/** 按钮最小宽度 (单位 px，默认 50) */
|
||
minWidth?: number;
|
||
}
|
||
|
||
declare interface ButtonGroupColors {
|
||
backgroundColor?: string;
|
||
btnBackgroundColor?: string;
|
||
btnHoverColor?: string;
|
||
btnActiveColor?: string;
|
||
iconColor?: string;
|
||
iconActiveColor?: string;
|
||
textColor?: string;
|
||
textActiveColor?: string;
|
||
}
|
||
|
||
/**
|
||
* 通用按钮组管理器 (ButtonGroupManager)
|
||
* 负责创建和管理通用的按钮组实例。
|
||
*/
|
||
declare class ButtonGroupManager extends BimComponent {
|
||
private groups;
|
||
private container;
|
||
constructor(engine: BimEngine, container: HTMLElement);
|
||
create(id: string, options: Omit<ButtonGroupOptions, 'container'>): BimButtonGroup;
|
||
get(id: string): BimButtonGroup | undefined;
|
||
updateTheme(theme: ThemeConfig): void;
|
||
destroy(): void;
|
||
}
|
||
|
||
export declare interface ButtonGroupOptions extends ButtonGroupColors {
|
||
container: HTMLElement | string;
|
||
/** 屏幕位置 (如 top-left) */
|
||
position?: GroupPosition;
|
||
/** 按钮组排列方向 (默认 row) */
|
||
direction?: GroupDirection;
|
||
/** 按钮内部图标文字排列 (默认 vertical) */
|
||
align?: ButtonAlign;
|
||
/** 菜单展开方向 */
|
||
expand?: ExpandDirection;
|
||
showLabel?: boolean;
|
||
visibility?: Record<string, boolean>;
|
||
className?: string;
|
||
}
|
||
|
||
declare type ButtonType = 'button' | 'menu';
|
||
|
||
/**
|
||
* 角色模型类型
|
||
*/
|
||
declare type CharacterModel = 'office-male' | 'construction-worker';
|
||
|
||
export declare interface CollapseItemConfig {
|
||
/** 唯一标识符 */
|
||
id: string;
|
||
/** 标题文本的翻译键 (例如 'panel.attributes') */
|
||
title: string;
|
||
/** 内容: HTML字符串 或 HTMLElement */
|
||
content: string | HTMLElement;
|
||
/** 标题栏左侧图标 (SVG 字符串, 可选) */
|
||
icon?: string;
|
||
/** 标题栏右侧额外内容 (可选) */
|
||
extra?: string | HTMLElement;
|
||
/** 是否禁用 */
|
||
disabled?: boolean;
|
||
/** 自定义类名 */
|
||
className?: string;
|
||
}
|
||
|
||
export declare interface CollapseOptions {
|
||
/** 挂载容器 */
|
||
container: HTMLElement | string;
|
||
/** 面板项列表 */
|
||
items: CollapseItemConfig[];
|
||
/** 是否开启手风琴模式 (默认 false) */
|
||
accordion?: boolean;
|
||
/** 初始展开的面板 ID 列表 */
|
||
activeIds?: string[];
|
||
/** 是否显示边框 (默认 true) */
|
||
bordered?: boolean;
|
||
/** 是否幽灵模式 (默认 false) */
|
||
ghost?: boolean;
|
||
/** 自定义类名 */
|
||
className?: string;
|
||
/** 切换面板时的回调 */
|
||
onChange?: (activeIds: string[]) => void;
|
||
}
|
||
|
||
/**
|
||
* 底部工具栏管理器 (ToolbarManager)
|
||
* 仅负责管理底部工具栏实例。
|
||
*/
|
||
declare class ConstructTreeManagerBtn extends BimComponent {
|
||
private toolbar;
|
||
private toolbarContainer;
|
||
private container;
|
||
private dialog;
|
||
constructor(engine: BimEngine, container: HTMLElement);
|
||
private init;
|
||
openConstructTreeDialog(): void;
|
||
refresh(): void;
|
||
destroy(): void;
|
||
addGroup(groupId: string, beforeGroupId?: string): void;
|
||
addButton(config: ButtonConfig): void;
|
||
setButtonVisibility(id: string, v: boolean): void;
|
||
setShowLabel(show: boolean): void;
|
||
setVisible(visible: boolean): void;
|
||
setBackgroundColor(color: string): void;
|
||
setColors(colors: ButtonGroupColors): void;
|
||
}
|
||
|
||
/**
|
||
* 描述列表项配置
|
||
*/
|
||
export declare interface DescriptionItem {
|
||
/** 标签文本 (直接显示，组件内部不翻译) */
|
||
label: string;
|
||
/** 内容文本或元素 */
|
||
value: string | HTMLElement;
|
||
/** 行级自定义标签颜色 */
|
||
labelColor?: string;
|
||
/** 行级自定义内容颜色 */
|
||
valueColor?: string;
|
||
/** 自定义类名 */
|
||
className?: string;
|
||
}
|
||
|
||
/**
|
||
* 描述列表组件配置
|
||
*/
|
||
export declare interface DescriptionOptions {
|
||
/** 挂载容器 */
|
||
container: HTMLElement | string;
|
||
/** 数据项列表 */
|
||
items: DescriptionItem[];
|
||
/**
|
||
* 是否显示边框 (默认 false)
|
||
* 开启后，将显示行间分割线以及 Key-Value 之间的纵向分割线
|
||
*/
|
||
bordered?: boolean;
|
||
/** 标签固定宽度 (例如 '80px')，若不设置则自适应 */
|
||
labelWidth?: string;
|
||
/** 全局标签颜色 */
|
||
labelColor?: string;
|
||
/** 全局内容颜色 */
|
||
valueColor?: string;
|
||
/** 全局字体大小 */
|
||
fontSize?: string;
|
||
/** 标签内边距 (默认 '0 4px') */
|
||
labelPadding?: string;
|
||
/** 内容内边距 (默认 '0 4px') */
|
||
valuePadding?: string;
|
||
/** 自定义类名 */
|
||
className?: string;
|
||
}
|
||
|
||
/**
|
||
* 弹窗颜色配置
|
||
*/
|
||
declare interface DialogColors {
|
||
/** 窗体背景颜色，默认 rgba(17, 17, 17, 0.95) */
|
||
backgroundColor?: string;
|
||
/** 标题栏背景颜色，默认 #2a2a2a */
|
||
headerBackgroundColor?: string;
|
||
/** 标题文字颜色，默认 #fff */
|
||
titleColor?: string;
|
||
/** 内容文字颜色，默认 #ccc */
|
||
textColor?: string;
|
||
/** 边框颜色，默认 #444 */
|
||
borderColor?: string;
|
||
}
|
||
|
||
/**
|
||
* 弹窗管理器
|
||
* 负责创建和管理应用中的各类弹窗。
|
||
*/
|
||
declare class DialogManager extends BimComponent {
|
||
/** 弹窗挂载的父容器 */
|
||
private container;
|
||
/** 活跃的弹窗实例列表 */
|
||
private activeDialogs;
|
||
/**
|
||
* 构造函数
|
||
* @param engine 引擎实例
|
||
* @param container 弹窗挂载的目标容器
|
||
*/
|
||
constructor(engine: BimEngine, container: HTMLElement);
|
||
/**
|
||
* 创建一个通用弹窗
|
||
* @param options 弹窗配置选项（不需要传 container，自动使用管理器绑定的容器）
|
||
* @returns BimDialog 实例
|
||
*/
|
||
create(options: Omit<DialogOptions, 'container'>): BimDialog;
|
||
/**
|
||
* 显示二次封装的模型信息弹窗
|
||
* 演示如何调用特定的业务弹窗组件
|
||
*/
|
||
showInfoDialog(): void;
|
||
/**
|
||
* 响应全局主题变更
|
||
* @param theme 全局主题配置
|
||
*/
|
||
updateTheme(theme: ThemeConfig): void;
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 弹窗配置选项接口
|
||
*/
|
||
export declare interface DialogOptions extends DialogColors {
|
||
/** 弹窗挂载的父容器 */
|
||
container: HTMLElement;
|
||
/** 弹窗标题 */
|
||
title?: string;
|
||
/** 弹窗内容，支持 HTML 字符串或 HTMLElement */
|
||
content?: HTMLElement | string;
|
||
/** 弹窗宽度，数字（像素）或字符串（如 '50%'） */
|
||
width?: number | string;
|
||
/** 弹窗高度 */
|
||
height?: number | string;
|
||
/** 弹窗位置 */
|
||
position?: DialogPosition;
|
||
/** 是否可拖拽 */
|
||
draggable?: boolean;
|
||
/** 是否可调整大小 */
|
||
resizable?: boolean;
|
||
/** 最小宽度限制 */
|
||
minWidth?: number;
|
||
/** 最小高度限制 */
|
||
minHeight?: number;
|
||
/** 关闭时的回调函数 */
|
||
onClose?: () => void;
|
||
/** 打开时的回调函数 */
|
||
onOpen?: () => void;
|
||
/** 弹窗唯一标识 ID (可选) */
|
||
id?: string;
|
||
}
|
||
|
||
/**
|
||
* 弹窗位置类型定义
|
||
* 可以是预设的字符串位置（如 'center', 'top-left' 等），
|
||
* 也可以是具体的坐标对象 { x, y }
|
||
*/
|
||
export declare type DialogPosition = 'center' | 'top-left' | 'top-center' | 'top-right' | 'left-center' | 'right-center' | 'bottom-left' | 'bottom-center' | 'bottom-right' | {
|
||
x: number;
|
||
y: number;
|
||
};
|
||
|
||
export declare interface EngineEvents {
|
||
'ui:open-dialog': {
|
||
id: string;
|
||
data?: any;
|
||
};
|
||
'ui:close-dialog': {
|
||
id: string;
|
||
};
|
||
'engine:model-loaded': {
|
||
url: string;
|
||
};
|
||
'engine:object-clicked': {
|
||
objectId: string;
|
||
position: {
|
||
x: number;
|
||
y: number;
|
||
z: number;
|
||
};
|
||
};
|
||
'ui:tree-node-check': {
|
||
id: string;
|
||
checked: boolean;
|
||
node: any;
|
||
};
|
||
'ui:tree-node-select': {
|
||
id: string;
|
||
selected: boolean;
|
||
node: any;
|
||
};
|
||
'ui:tree-node-expand': {
|
||
id: string;
|
||
expanded: boolean;
|
||
};
|
||
'ui:collapse-change': {
|
||
activeIds: string[];
|
||
};
|
||
'sys:theme-changed': {
|
||
theme: string;
|
||
};
|
||
'sys:locale-changed': {
|
||
locale: string;
|
||
};
|
||
'walk:path-mode-toggle': {
|
||
isActive: boolean;
|
||
};
|
||
'walk:walk-mode-toggle': {
|
||
isActive: boolean;
|
||
};
|
||
'walk:plan-view-toggle': {
|
||
isActive: boolean;
|
||
};
|
||
'walk:speed-change': {
|
||
speed: number;
|
||
};
|
||
'walk:gravity-toggle': {
|
||
enabled: boolean;
|
||
};
|
||
'walk:collision-toggle': {
|
||
enabled: boolean;
|
||
};
|
||
'map:opened': {};
|
||
'map:closed': {};
|
||
}
|
||
|
||
/**
|
||
* 3D 引擎管理器
|
||
* 负责连接 Engine 组件和 BimEngine，向外部暴露简化的 API
|
||
* 采用延迟初始化模式，用户需主动调用 initialize() 方法
|
||
*/
|
||
declare class EngineManager extends BimComponent {
|
||
/** 3D 引擎挂载的父容器 */
|
||
private container;
|
||
/** 3D 引擎组件实例 */
|
||
private engineInstance;
|
||
rightKey: RightKeyManager | null;
|
||
/**
|
||
* 构造函数
|
||
* @param engine 引擎实例
|
||
* @param container 3D 引擎挂载的目标容器
|
||
*/
|
||
constructor(engine: BimEngine, container: HTMLElement);
|
||
/**
|
||
* 初始化 3D 引擎
|
||
* @param options 引擎配置选项（可选，如果不提供则使用默认配置）
|
||
* @returns 是否初始化成功
|
||
*/
|
||
initialize(options?: Omit<EngineOptions, 'container'>): boolean;
|
||
/**
|
||
* 检<><E6A380><EFBFBD> 3D 引擎是否已初始化
|
||
*/
|
||
isInitialized(): boolean;
|
||
/**
|
||
* 加载 3D 模型
|
||
* @param url 模型文件 URL
|
||
* @param options 加载选项（位置、旋转、缩放）
|
||
*/
|
||
loadModel(url: string, options?: ModelLoadOptions): void;
|
||
/**
|
||
* 获取原始 3D 引擎实例
|
||
* 用于直接调用第三方引擎的其他 API
|
||
*/
|
||
getEngine(): any;
|
||
/**
|
||
* 回到主视角
|
||
*/
|
||
CameraGoHome(): void;
|
||
/**
|
||
* 激活测量功能
|
||
* @param mode 测量类型
|
||
*/
|
||
activateMeasure(mode: MeasureMode): void;
|
||
/**
|
||
* 停用测量功能
|
||
*/
|
||
deactivateMeasure(): void;
|
||
/**
|
||
* 获取当前激活的测量类型
|
||
*/
|
||
getCurrentMeasureType(): MeasureMode | null;
|
||
/**
|
||
* 销毁 3D 引擎实例
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 引擎配置选项
|
||
* 用于 Engine 组件的初始化
|
||
*/
|
||
export declare interface EngineOptions {
|
||
/** 容器元素 */
|
||
container: HTMLElement;
|
||
/** 背景颜色（十六进制数字如 0x333333，或 CSS 字符串如 'linear-gradient(...)'） */
|
||
backgroundColor?: number | string;
|
||
/** WebGL 版本 */
|
||
version?: 'v1' | 'v2';
|
||
/** 是否显示性能统计 */
|
||
showStats?: boolean;
|
||
/** 是否显示视图立方体 */
|
||
showViewCube?: boolean;
|
||
}
|
||
|
||
declare class EventEmitter {
|
||
private events;
|
||
on(event: string, listener: Listener): () => void;
|
||
off(event: string, listener: Listener): void;
|
||
emit(event: string, payload?: any): void;
|
||
clear(): void;
|
||
}
|
||
|
||
/** 二级菜单展开方向 */
|
||
declare type ExpandDirection = 'up' | 'down' | 'left' | 'right';
|
||
|
||
/** 按钮组排列方向 (Flex-direction) */
|
||
declare type GroupDirection = 'row' | 'column';
|
||
|
||
/** 弹窗/按钮组位置 */
|
||
declare type GroupPosition = 'center' | 'top-left' | 'top-center' | 'top-right' | 'left-center' | 'right-center' | 'bottom-left' | 'bottom-center' | 'bottom-right' | {
|
||
x: number;
|
||
y: number;
|
||
} | 'static';
|
||
|
||
/**
|
||
* BIM 引擎组件通用接口
|
||
* 所有受引擎管理的 UI 组件都必须实现此接口
|
||
*/
|
||
export declare interface IBimComponent {
|
||
/**
|
||
* 初始化组件
|
||
* 用于创建 DOM、绑定事件、加载资源等
|
||
* 支持同步或异步操作
|
||
*/
|
||
init(): void | Promise<void>;
|
||
/**
|
||
* 设置主题
|
||
* 组件应在此方法中将 ThemeConfig 映射为自身的 CSS 变量或样式
|
||
*/
|
||
setTheme(theme: ThemeConfig): void;
|
||
/**
|
||
* 设置语言
|
||
*/
|
||
setLocales(): void;
|
||
/**
|
||
* 销毁组件
|
||
* 清理 DOM 事件监听、定时器和引用
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
declare type Listener<T = any> = (payload: T) => void;
|
||
|
||
/**
|
||
* 语言<E8AFAD><E8A880>码类型
|
||
*/
|
||
declare type LocaleType = 'zh-CN' | 'en-US';
|
||
|
||
/**
|
||
* 地图弹窗管理器（独立通用组件）
|
||
*/
|
||
declare class MapDialogManager extends BimComponent {
|
||
private dialogId;
|
||
private dialog;
|
||
private panel;
|
||
constructor(engine: BimEngine);
|
||
init(): void;
|
||
/**
|
||
* 显示弹窗
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 隐藏弹窗
|
||
*/
|
||
hide(): void;
|
||
/**
|
||
* 检查地图是否打开
|
||
*/
|
||
isOpen(): boolean;
|
||
/**
|
||
* 销毁弹窗和面板
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 测量配置项（由组件内部维护默认值，并读取/写入缓存）
|
||
*/
|
||
declare interface MeasureConfig {
|
||
unit: MeasureUnit;
|
||
precision: MeasurePrecision;
|
||
}
|
||
|
||
/**
|
||
* 测量弹窗管理器
|
||
*/
|
||
declare class MeasureDialogManager extends BimComponent {
|
||
private dialogId;
|
||
private dialog;
|
||
private panel;
|
||
/**
|
||
* 测量配置项（单位/精度）
|
||
* 说明：MeasurePanel 会自行从缓存加载默认配置，Manager 这里只做“对外读取/设置”的镜像。
|
||
*/
|
||
private config;
|
||
constructor(engine: BimEngine);
|
||
init(): void;
|
||
/**
|
||
* 显示测量弹窗
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 获取当前测量方式
|
||
* 说明：如果面板未创建，则返回 null
|
||
*/
|
||
getActiveMode(): MeasureMode | null;
|
||
/**
|
||
* 切换测量方式（你要求的“切换类型的方法”）
|
||
* @param mode 测量方式
|
||
*/
|
||
switchMode(mode: MeasureMode): void;
|
||
/**
|
||
* 设置测量结果（推荐使用的新方法名）
|
||
* 说明：内部直接调用 MeasurePanel.setResult()
|
||
* @param result 测量结果；传 null 表示清空
|
||
*/
|
||
setMeasureResult(result: MeasureResult | null): void;
|
||
/**
|
||
* 获取测量配置（单位/精度）
|
||
* - 如果面板存在：返回面板当前配置
|
||
* - 否则：返回 Manager 缓存的最后一次配置（可能为 null）
|
||
*/
|
||
getConfig(): MeasureConfig | null;
|
||
/**
|
||
* 设置测量配置（单位/精度）
|
||
* @param partial 部分更新
|
||
* @param persist 是否写入缓存（默认 true）
|
||
*/
|
||
setConfig(partial: Partial<MeasureConfig>, persist?: boolean): void;
|
||
/**
|
||
* 删除全部（仅清空 UI；真实测量清理逻辑后续再接）
|
||
*/
|
||
clearAll(): void;
|
||
/**
|
||
* 打开设置（仅预留方法/回调）
|
||
*/
|
||
openSettings(): void;
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 测量相关的通用类型定义
|
||
*
|
||
* 说明：
|
||
* - 这些类型定义在通用 types 目录下，避免组件间直接耦合
|
||
* - Engine 组件、MeasurePanel 组件、Manager 都可以引用这些类型
|
||
*/
|
||
/**
|
||
* 测量方式（8 种）
|
||
*
|
||
* 说明：
|
||
* - id 采用英文驼峰/小写，便于程序内部使用
|
||
* - 显示名称必须通过国际化 key 获取（见 locales）
|
||
*/
|
||
declare type MeasureMode = 'distance' | 'minDistance' | 'angle' | 'elevation' | 'volume' | 'laserDistance' | 'slope' | 'spaceVolume';
|
||
|
||
/**
|
||
* 精度（小数位数）
|
||
* - 0 -> 0
|
||
* - 1 -> 0.0
|
||
* - 2 -> 0.00
|
||
* - 3 -> 0.000
|
||
*/
|
||
declare type MeasurePrecision = 0 | 1 | 2 | 3;
|
||
|
||
/**
|
||
* 测量结果数据
|
||
*
|
||
* 说明：
|
||
* - 真实测量未实现，因此结果由外部通过 setResult 传入。
|
||
* - 不同测量方式对应不同字段；未传入则 UI 显示 “--”。
|
||
*/
|
||
declare interface MeasureResult {
|
||
/** 距离（单位：mm） */
|
||
distanceMm?: number;
|
||
/** 最小距离（单位：mm） */
|
||
minDistanceMm?: number;
|
||
/** 角度（单位：deg） */
|
||
angleDeg?: number;
|
||
/** 标高（单位：mm） */
|
||
elevationMm?: number;
|
||
/** 体积（单位：m³） */
|
||
volumeM3?: number;
|
||
/** 激光测距（单位：mm） */
|
||
laserDistanceMm?: number;
|
||
/** 坡度（单位：%） */
|
||
slopePercent?: number;
|
||
/** 空间体积（单位：m³） */
|
||
spaceVolumeM3?: number;
|
||
/** 可选：展示测量点/结果点坐标（单位由引擎侧定义，这里只负责显示） */
|
||
xyz?: MeasureXYZ;
|
||
}
|
||
|
||
/**
|
||
* 距离/标高等“长度类”单位
|
||
*/
|
||
declare type MeasureUnit = 'm' | 'cm' | 'mm' | 'km';
|
||
|
||
/**
|
||
* 3D 坐标（可选展示）
|
||
*/
|
||
declare interface MeasureXYZ {
|
||
x: number;
|
||
y: number;
|
||
z: number;
|
||
}
|
||
|
||
/**
|
||
* 菜单项配置接口 (用于简化的对象配置)
|
||
*/
|
||
declare interface MenuItemConfig {
|
||
id: string;
|
||
label: string;
|
||
onClick?: () => void;
|
||
icon?: string;
|
||
group?: string;
|
||
order?: number;
|
||
children?: MenuItemConfig[];
|
||
disabled?: boolean;
|
||
visible?: boolean;
|
||
}
|
||
|
||
/**
|
||
* 模型加载选项
|
||
* 用于配置模型的位置、旋转和缩放
|
||
*/
|
||
export declare interface ModelLoadOptions {
|
||
/** 模型初始位置 [x, y, z] */
|
||
position?: [number, number, number];
|
||
/** 模型初始旋转 [x, y, z]（弧度） */
|
||
rotation?: [number, number, number];
|
||
/** 模型初始缩放 [x, y, z] */
|
||
scale?: [number, number, number];
|
||
/** 模型 ID（可选，如果不提供则自动生成） */
|
||
id?: string;
|
||
}
|
||
|
||
/**
|
||
* 节点点击行为类型
|
||
*/
|
||
export declare type NodeClickAction = 'select' | 'expand';
|
||
|
||
declare interface OptButton extends ButtonConfig {
|
||
children?: OptButton[];
|
||
}
|
||
|
||
/**
|
||
* 属性面板管理器
|
||
* 负责展示和管理属性面板弹窗 (演示 Tab + Collapse + Description 组件)
|
||
*/
|
||
declare class PropertyPanelManager extends BimComponent {
|
||
private dialogId;
|
||
private dialog;
|
||
constructor(engine: BimEngine);
|
||
init(): void;
|
||
/**
|
||
* 显示属性面板
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 创建"属性"标签页的内容 (包含 Collapse)
|
||
*/
|
||
private createPropsTabContent;
|
||
/**
|
||
* 创建"材质"标签页的内容 (包含 Collapse)
|
||
*/
|
||
private createMaterialTabContent;
|
||
private createBaseInfoContent;
|
||
private createAdvancedInfoContent;
|
||
private createMaterialContent;
|
||
/**
|
||
* 检查属性面板是否打开
|
||
*/
|
||
isOpen(): boolean;
|
||
/**
|
||
* 隐藏属性面板
|
||
*/
|
||
hide(): void;
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 右键菜单管理器 (RightKeyManager)
|
||
* 负责协调右键交互流程：
|
||
* 1. 监听 Canvas/容器的 contextmenu 事件
|
||
* 2. 通过注册的处理器 (Handler) 获取需要显示的菜单项
|
||
* 3. 实例化 Menu 组件并装载到 RightKey 容器中显示
|
||
*/
|
||
declare class RightKeyManager extends BimComponent {
|
||
private container;
|
||
private rightKeyPanel;
|
||
private contextHandlers;
|
||
constructor(engine: BimEngine, container: HTMLElement);
|
||
destroy(): void;
|
||
/**
|
||
* 注册上下文菜单处理器
|
||
* @param handler 处理函数，接收鼠标事件，返回菜单项数组
|
||
*/
|
||
registerHandler(handler: (e: MouseEvent) => MenuItemConfig[] | null): void;
|
||
/**
|
||
* 手动显示菜单
|
||
* 允许外部直接调用以显示特定的菜单，不一定依赖右键事件
|
||
* @param x 屏幕 X 坐标
|
||
* @param y 屏幕 Y 坐标
|
||
* @param items 菜单项列表
|
||
* @param groupOrder 可选的分组顺序
|
||
*/
|
||
showMenu(x: number, y: number, items: MenuItemConfig[], groupOrder?: string[]): void;
|
||
/**
|
||
* 隐藏右键菜单
|
||
*/
|
||
hide(): void;
|
||
/**
|
||
* 处理右键点击事件
|
||
* 由 BimRightKey 组件在检测到有效右键点击时调用
|
||
*/
|
||
private handleContextMenu;
|
||
}
|
||
|
||
/**
|
||
* 轴向类型
|
||
*/
|
||
declare type SectionAxis = 'x' | 'y' | 'z';
|
||
|
||
/**
|
||
* 轴向剖切弹窗管理器
|
||
*/
|
||
declare class SectionAxisDialogManager extends BimComponent {
|
||
private dialogId;
|
||
private dialog;
|
||
private panel;
|
||
constructor(engine: BimEngine);
|
||
init(): void;
|
||
/**
|
||
* 显示弹窗
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 隐藏弹窗
|
||
*/
|
||
hide(): void;
|
||
/**
|
||
* 获取隐藏状态
|
||
*/
|
||
getHiddenState(): boolean;
|
||
/**
|
||
* 设置隐藏状态
|
||
*/
|
||
setHiddenState(isHidden: boolean): void;
|
||
/**
|
||
* 获取当前激活的轴向
|
||
*/
|
||
getActiveAxis(): SectionAxis;
|
||
/**
|
||
* 设置激活的轴向
|
||
*/
|
||
setActiveAxis(axis: SectionAxis): void;
|
||
/**
|
||
* 销毁弹窗和面板
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 剖切盒轴向范围
|
||
*/
|
||
declare interface SectionBoxAxisRange {
|
||
/** 最小值（0-100的百分比） */
|
||
min: number;
|
||
/** 最大值（0-100的百分比） */
|
||
max: number;
|
||
}
|
||
|
||
/**
|
||
* 剖切盒弹窗管理器
|
||
*/
|
||
declare class SectionBoxDialogManager extends BimComponent {
|
||
private dialogId;
|
||
private dialog;
|
||
private panel;
|
||
constructor(engine: BimEngine);
|
||
init(): void;
|
||
/**
|
||
* 显示弹窗
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 隐藏弹窗
|
||
*/
|
||
hide(): void;
|
||
/**
|
||
* 获取隐藏状态
|
||
*/
|
||
getHiddenState(): boolean;
|
||
/**
|
||
* 设置隐藏状态
|
||
*/
|
||
setHiddenState(isHidden: boolean): void;
|
||
/**
|
||
* 获取反向状态
|
||
*/
|
||
getReversedState(): boolean;
|
||
/**
|
||
* 设置反向状态
|
||
*/
|
||
setReversedState(isReversed: boolean): void;
|
||
/**
|
||
* 获取范围值
|
||
*/
|
||
getRange(): SectionBoxRange | null;
|
||
/**
|
||
* 设置范围值
|
||
*/
|
||
setRange(range: Partial<SectionBoxRange>): void;
|
||
/**
|
||
* 销毁弹窗和面板
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 剖切盒范围数据
|
||
*/
|
||
declare interface SectionBoxRange {
|
||
/** X轴范围 */
|
||
x: SectionBoxAxisRange;
|
||
/** Y轴范围 */
|
||
y: SectionBoxAxisRange;
|
||
/** Z轴范围 */
|
||
z: SectionBoxAxisRange;
|
||
}
|
||
|
||
/**
|
||
* 拾取面剖切弹窗管理器
|
||
*/
|
||
declare class SectionPlaneDialogManager extends BimComponent {
|
||
private dialogId;
|
||
private dialog;
|
||
private panel;
|
||
constructor(engine: BimEngine);
|
||
init(): void;
|
||
/**
|
||
* 显示拾取面剖切弹窗
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 隐藏弹窗
|
||
*/
|
||
hide(): void;
|
||
/**
|
||
* 销毁弹窗
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 全局主题配置接口
|
||
* 定义系统通用的语义化颜色
|
||
*/
|
||
export declare interface ThemeConfig {
|
||
/** 主题名称 */
|
||
name: string;
|
||
/** 品牌色/主色 */
|
||
primary: string;
|
||
/** 主色悬停/激活态 */
|
||
primaryHover: string;
|
||
/** 基础背景色 (应用整体背景) */
|
||
background: string;
|
||
/** 面板背景色 (工具栏、弹窗背景) */
|
||
panelBackground: string;
|
||
/** 主要文字颜色 */
|
||
textPrimary: string;
|
||
/** 次要文字颜色 */
|
||
textSecondary: string;
|
||
/** 边框/分割线颜色 */
|
||
border: string;
|
||
/** 图标默认颜色 */
|
||
icon: string;
|
||
/** 图标激活颜色 */
|
||
iconActive: string;
|
||
/** 交互组件背景 (如按钮默认背景) */
|
||
componentBackground: string;
|
||
/** 交互组件悬停背景 */
|
||
componentHover: string;
|
||
/** 交互组件激活背景 */
|
||
componentActive: string;
|
||
}
|
||
|
||
/**
|
||
* 主题类型定义
|
||
*/
|
||
export declare type ThemeType = 'dark' | 'light' | 'custom';
|
||
|
||
/**
|
||
* 底部工具栏管理器 (ToolbarManager)
|
||
* 仅负责管理底部工具栏实例。
|
||
*/
|
||
declare class ToolbarManager extends BimComponent {
|
||
private toolbar;
|
||
private toolbarContainer;
|
||
private container;
|
||
constructor(engine: BimEngine, container: HTMLElement);
|
||
private init;
|
||
updateTheme(theme: ThemeConfig): void;
|
||
refresh(): void;
|
||
destroy(): void;
|
||
addGroup(groupId: string, beforeGroupId?: string): void;
|
||
addButton(config: ButtonConfig): void;
|
||
setButtonVisibility(id: string, v: boolean): void;
|
||
setShowLabel(show: boolean): void;
|
||
setBtnActive(id: string, active?: boolean): void;
|
||
setVisible(visible: boolean): void;
|
||
setBackgroundColor(color: string): void;
|
||
setColors(colors: ButtonGroupColors): void;
|
||
/**
|
||
* 隐藏工具栏
|
||
*/
|
||
hide(): void;
|
||
/**
|
||
* 显示工具栏
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 获取工具栏容器
|
||
*/
|
||
getContainer(): HTMLElement | null;
|
||
}
|
||
|
||
/**
|
||
* 节点勾选状态枚举
|
||
*/
|
||
export declare enum TreeNodeCheckState {
|
||
Unchecked = 0,
|
||
Checked = 1,
|
||
Indeterminate = 2
|
||
}
|
||
|
||
/**
|
||
* 树节点配置接口
|
||
*/
|
||
export declare interface TreeNodeConfig {
|
||
/** 唯一标识符 */
|
||
id: string;
|
||
/** 显示文本的翻译键 */
|
||
label: string;
|
||
/** 节点图标 (SVG string 或 URL) */
|
||
icon?: string;
|
||
/** 子节点列表 */
|
||
children?: TreeNodeConfig[];
|
||
/** 初始展开状态 (默认 false) */
|
||
expanded?: boolean;
|
||
/** 初始选中状态 (默认 false) */
|
||
checked?: boolean;
|
||
/** 是否禁用 (默认 false) */
|
||
disabled?: boolean;
|
||
/** 自定义业务数据 */
|
||
data?: any;
|
||
/** 是否是叶子节点 (用于异步加载场景，暂留接口) */
|
||
isLeaf?: boolean;
|
||
/** 点击整行的行为 (默认 'select') */
|
||
clickAction?: NodeClickAction;
|
||
}
|
||
|
||
/**
|
||
* 树组件配置选项
|
||
*/
|
||
export declare interface TreeOptions {
|
||
/** 树的数据源 */
|
||
data: TreeNodeConfig[];
|
||
/** 是否显示复选框 (默认 true) */
|
||
checkable?: boolean;
|
||
/**
|
||
* 父子节点选中状态是否关联 (默认 true)
|
||
* true: 选中父选子，子全选自动选父
|
||
* false: 独立选中
|
||
*/
|
||
checkStrictly?: boolean;
|
||
/** 默认展开所有节点 (默认 false) */
|
||
defaultExpandAll?: boolean;
|
||
/** 缩进宽度 (像素，默认 24) */
|
||
indent?: number;
|
||
/** 是否启用搜索功能 (默认 false) */
|
||
enableSearch?: boolean;
|
||
/** 搜索框占位符 */
|
||
searchPlaceholder?: string;
|
||
/** 节点勾选回调 */
|
||
onNodeCheck?: (node: BimTreeNode) => void;
|
||
/** 节点选择回调 */
|
||
onNodeSelect?: (node: BimTreeNode) => void;
|
||
/** 节点展开/折叠回调 */
|
||
onNodeExpand?: (node: BimTreeNode) => void;
|
||
/**
|
||
* 选中时显示的自定义操作栏渲染函数
|
||
* 返回 HTML 字符串或 HTMLElement
|
||
*/
|
||
renderActions?: (node: TreeNodeConfig) => HTMLElement | string;
|
||
}
|
||
|
||
/**
|
||
* 漫游控制管理器
|
||
*/
|
||
declare class WalkControlManager extends BimComponent {
|
||
panel: WalkControlPanel | null;
|
||
private pathManager;
|
||
constructor(engine: BimEngine);
|
||
init(): void;
|
||
/**
|
||
* 显示漫游控制面板
|
||
*/
|
||
show(): void;
|
||
/**
|
||
* 隐藏漫游控制面板
|
||
*/
|
||
hide(): void;
|
||
/**
|
||
* 销毁管理器
|
||
*/
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 漫游控制模式
|
||
*/
|
||
declare type WalkControlMode = 'none' | 'path' | 'walk';
|
||
|
||
declare class WalkControlPanel implements IBimComponent {
|
||
element: HTMLElement;
|
||
private options;
|
||
private state;
|
||
private planViewBtn;
|
||
private pathModeBtn;
|
||
private walkModeBtn;
|
||
private settingsContainer;
|
||
private speedControl;
|
||
private speedDecreaseBtn;
|
||
private speedIncreaseBtn;
|
||
private speedDisplay;
|
||
private gravityCheckbox;
|
||
private gravityLabel;
|
||
private collisionCheckbox;
|
||
private collisionLabel;
|
||
private characterModelSelect;
|
||
private characterModelLabel;
|
||
private walkModeSelect;
|
||
private walkModeLabel;
|
||
private exitBtn;
|
||
private unsubscribeLocale;
|
||
private unsubscribeTheme;
|
||
constructor(options?: WalkControlPanelOptions);
|
||
init(): void;
|
||
setPlanViewActive(active: boolean): void;
|
||
setPathModeActive(active: boolean): void;
|
||
getState(): WalkControlState;
|
||
private createPanel;
|
||
private createLeftButtons;
|
||
private createSettingsContainer;
|
||
private createSpeedControl;
|
||
private createIconButton;
|
||
private createExitButton;
|
||
private setMode;
|
||
private updateButtonStates;
|
||
private updateSettingsView;
|
||
private updateSpeedDisplay;
|
||
private updateSpeedButtonStates;
|
||
private getIconSVG;
|
||
setLocales(): void;
|
||
setTheme(theme: ThemeConfig): void;
|
||
destroy(): void;
|
||
}
|
||
|
||
/**
|
||
* 漫游控制面板配置选项
|
||
*/
|
||
declare interface WalkControlPanelOptions {
|
||
/** 平面图切换回调 */
|
||
onPlanViewToggle?: (isActive: boolean) => void;
|
||
/** 路径漫游模式切换回调 */
|
||
onPathModeToggle?: (isActive: boolean) => void;
|
||
/** 漫游模式切换回调 */
|
||
onWalkModeToggle?: (isActive: boolean) => void;
|
||
/** 速度变化回调 */
|
||
onSpeedChange?: (speed: number) => void;
|
||
/** 重力切换回调 */
|
||
onGravityToggle?: (enabled: boolean) => void;
|
||
/** 碰撞切换回调 */
|
||
onCollisionToggle?: (enabled: boolean) => void;
|
||
/** 角色模型变化回调 */
|
||
onCharacterModelChange?: (model: CharacterModel) => void;
|
||
/** 行走模式变化回调 */
|
||
onWalkModeChange?: (mode: WalkMode) => void;
|
||
/** 退出回调 */
|
||
onExit?: () => void;
|
||
/** 默认速度 (0-100) */
|
||
defaultSpeed?: number;
|
||
/** 默认重力状态 */
|
||
defaultGravity?: boolean;
|
||
/** 默认碰撞状态 */
|
||
defaultCollision?: boolean;
|
||
/** 默认角色模型 */
|
||
defaultCharacterModel?: CharacterModel;
|
||
/** 默认行走模式 */
|
||
defaultWalkMode?: WalkMode;
|
||
}
|
||
|
||
/**
|
||
* 漫游控制状态
|
||
*/
|
||
declare interface WalkControlState {
|
||
/** 当前模式 */
|
||
mode: WalkControlMode;
|
||
/** 平面图是否激活 */
|
||
isPlanViewActive: boolean;
|
||
/** 移动速度 (0-100) */
|
||
speed: number;
|
||
/** 重力是否启用 */
|
||
gravity: boolean;
|
||
/** 碰撞是否启用 */
|
||
collision: boolean;
|
||
/** 当前角色模型 */
|
||
characterModel: CharacterModel;
|
||
/** 当前行走模式 */
|
||
walkMode: WalkMode;
|
||
}
|
||
|
||
/**
|
||
* 行走模式类型
|
||
*/
|
||
declare type WalkMode = 'walk' | 'run';
|
||
|
||
export { }
|