diff --git a/src/components/engine/index.ts b/src/components/engine/index.ts index 18e03ca..1688a2a 100644 --- a/src/components/engine/index.ts +++ b/src/components/engine/index.ts @@ -44,10 +44,8 @@ export class Engine implements IBimComponent { private currentMeasureType: MeasureMode | null = null; /** 主测量功能是否已激活 */ private isMeasureActive: boolean = false; - /** 当前激活的剖切轴向 */ - private currentSectionAxis: 'x' | 'y' | 'z' | null = null; - /** 剖切盒是否激活 */ - private isSectionBoxActive: boolean = false; + /** 当前激活的剖切模式 */ + private currentSectionMode: 'x' | 'y' | 'z' | 'box' | 'face' | null = null; /** 当前选中的构件信息 */ private selectedComponent: { url: string; id: string } | null = null; @@ -425,182 +423,45 @@ export class Engine implements IBimComponent { // ==================== 结束：测量功能方法 ==================== - // ==================== 轴向剖切功能 ==================== + // ==================== 剖切功能（统一 API） ==================== - /** - * 激活轴向剖切 - * @param axis 要激活的轴向 ('x' | 'y' | 'z') - * @remarks - * - 如果传入的轴向与当前激活的轴向相同，则静默返回（幂等操作） - * - 如果当前有不同的轴向激活，先调用该轴向的 disActive() 再激活新轴向 - * - 使用单个 plane 的 disActive() 而非 clipping.disActive()，避免影响其他剖切功能 - * - 如果引擎未初始化或 clipping 模块不可用，方法会静默返回并输出错误日志 - */ - public activateSectionAxis(axis: 'x' | 'y' | 'z'): void { - // 1. 检查引擎初始化 - if (!this._isInitialized || !this.engine) { - console.error('[Engine] Cannot activate section axis: engine not initialized.'); - return; - } - - // 2. 检查 clipping 模块 - if (!this.engine.clipping) { - console.error('[Engine] Clipping module not available.'); - return; - } - - // 3. 如果是同一轴向，静默返回（幂等操作） - if (this.currentSectionAxis === axis) { - console.log(`[Engine] Section axis ${axis} already active, skipping.`); - return; - } - - // 4. 如果当前有激活的轴向且不同，先停用当前轴向 - if (this.currentSectionAxis) { - this.deactivateCurrentSectionAxis(); - } - - // 5. 激活新轴向 - const planeMap: Record<'x' | 'y' | 'z', any> = { - 'x': this.engine.clipping.sectionPlaneX, - 'y': this.engine.clipping.sectionPlaneY, - 'z': this.engine.clipping.sectionPlaneZ - }; - const plane = planeMap[axis]; - - if (plane && typeof plane.active === 'function') { - console.log(`[Engine] Activating section axis: ${axis}`); - plane.active(); - this.currentSectionAxis = axis; - } else { - console.error(`[Engine] Section plane ${axis} not available.`); - } - } - - /** - * 停用当前轴向剖切（内部方法） - * @remarks 只停用当前激活的单个轴向，不影响其他剖切功能 - */ - private deactivateCurrentSectionAxis(): void { - if (!this.currentSectionAxis || !this.engine?.clipping) { - return; - } - - const planeMap: Record<'x' | 'y' | 'z', any> = { - 'x': this.engine.clipping.sectionPlaneX, - 'y': this.engine.clipping.sectionPlaneY, - 'z': this.engine.clipping.sectionPlaneZ - }; - const plane = planeMap[this.currentSectionAxis]; - - if (plane && typeof plane.disActive === 'function') { - console.log(`[Engine] Deactivating section axis: ${this.currentSectionAxis}`); - plane.disActive(); - } - } - - /** - * 停用轴向剖切（公共方法，关闭弹窗时调用） - * @remarks 使用 clipping.disActive() 停用所有剖切，清理状态 - */ - public deactivateSectionAxis(): void { + public activeSection(mode: 'x' | 'y' | 'z' | 'box' | 'face'): void { if (!this._isInitialized || !this.engine?.clipping) { + console.error('[Engine] Cannot activate section: engine not initialized.'); return; } - - if (this.currentSectionAxis) { - console.log('[Engine] Deactivating all section axis'); - this.engine.clipping.disActive(); - this.currentSectionAxis = null; + if (this.currentSectionMode === mode) { + console.log(`[Engine] Section ${mode} already active, skipping.`); + return; } + console.log(`[Engine] Activating section: ${mode}`); + this.engine.clipping.active(mode); + this.currentSectionMode = mode; } - /** - * 获取当前剖切轴向 - * @returns 当前激活的轴向，如果未激活则返回 null - */ - public getCurrentSectionAxis(): 'x' | 'y' | 'z' | null { - return this.currentSectionAxis; + public getCurrentSectionMode(): 'x' | 'y' | 'z' | 'box' | 'face' | null { + return this.currentSectionMode; } - // ==================== 结束：轴向剖切功能 ==================== - - // ==================== 剖切盒功能 ==================== - - /** 激活剖切盒 */ - public activateSectionBox(): void { - if (!this._isInitialized || !this.engine) { - console.error('[Engine] Cannot activate section box: engine not initialized.'); - return; - } - - if (!this.engine.clipping?.sectionBox) { - console.error('[Engine] Section box module not available.'); - return; - } - - if (this.isSectionBoxActive) { - console.log('[Engine] Section box already active, skipping.'); - return; - } - - console.log('[Engine] Activating section box'); - this.engine.clipping.sectionBox.active(); - this.isSectionBoxActive = true; - } - - /** 停用剖切盒 */ - public deactivateSectionBox(): void { - if (!this._isInitialized || !this.engine?.clipping?.sectionBox) { - return; - } - - if (!this.isSectionBoxActive) { - return; - } - - console.log('[Engine] Deactivating section box'); - this.engine.clipping.sectionBox.disActive(); - this.isSectionBoxActive = false; - } - - /** 设置剖切盒范围（百分比 0-100） */ public setSectionBoxRange(range: SectionBoxRange): void { - if (!this._isInitialized || !this.engine?.clipping?.sectionBox) { + if (!this._isInitialized || !this.engine?.clipping) { console.error('[Engine] Cannot set section box range: engine not initialized.'); return; } - console.log('[Engine] Setting section box range:', range); - this.engine.clipping.sectionBox.setboxPercent(range); + this.engine.clipping.updateClippingValue(range); } - /** 适应剖切盒到模型（将范围设置为整个模型包围盒） */ - public fitSectionBoxToModel(): void { - if (!this._isInitialized || !this.engine?.clipping?.sectionBox) { - console.error('[Engine] Cannot fit section box: engine not initialized.'); + public deactivateSection(): void { + if (!this._isInitialized || !this.engine?.clipping) { return; } - - const box = this.engine.octreeBox?.getBoundingBox(); - if (!box) { - console.error('[Engine] Cannot fit section box: model bounding box not available.'); - return; - } - - console.log('[Engine] Fitting section box to model'); - this.engine.clipping.sectionBox.setBox(box); + console.log('[Engine] Deactivating all sections'); + this.engine.clipping.disActive(); + this.currentSectionMode = null; } - /** - * 重置剖切盒 - * @remarks 将剖切盒范围恢复为整个模型的包围盒 - */ - public resetSectionBox(): void { - this.fitSectionBoxToModel(); - } - - // ==================== 结束：剖切盒功能 ==================== + // ==================== 结束：剖切功能 ==================== // ==================== 漫游功能 ====================