98 lines
3.0 KiB
C++
98 lines
3.0 KiB
C++
|
#pragma once
|
||
|
|
/**
|
||
|
|
* @file brep_heal.h
|
||
|
|
* @brief B-Rep 拓扑修复
|
||
|
|
*
|
||
|
|
* 对 BrepModel 执行拓扑修复操作，处理导入 STEP/IGES 文件时常见的
|
||
|
|
* 几何缺陷：重复顶点、冗余边、间隙和方向不一致。
|
||
|
|
*
|
||
|
|
* ## 修复流水线
|
||
|
|
*
|
||
|
|
* 1. heal_merge_vertices — 合并重合顶点
|
||
|
|
* 2. heal_merge_edges — 合并重合边
|
||
|
|
* 3. heal_close_gaps — 闭合小间隙
|
||
|
|
* 4. heal_orientation — 统一面方向
|
||
|
|
*
|
||
|
|
* 建议通过 heal_topology() 一次性执行完整流水线。
|
||
|
|
*
|
||
|
|
* @ingroup brep
|
||
|
|
*/
|
||
|
|
#include "vde/brep/brep.h"
|
||
|
|
#include "vde/brep/brep_validate.h"
|
||
|
|
|
||
|
|
namespace vde::brep {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 合并重合顶点
|
||
|
|
*
|
||
|
|
* 扫描所有顶点对，将距离小于 tolerance 的顶点合并为一个。
|
||
|
|
* 更新所有引用被合并顶点的边，使其指向保留的顶点。
|
||
|
|
*
|
||
|
|
* @param body 待修复的 B-Rep 模型（原地修改）
|
||
|
|
* @param tolerance 距离容差，默认 1e-6
|
||
|
|
* @return 合并的顶点对数
|
||
|
|
*
|
||
|
|
* @note 合并后 body.vertices_ 的大小会减小。
|
||
|
|
* @note 顶点 ID 引用的重定向使用 Edges → Loops 层次。
|
||
|
|
*/
|
||
|
|
int heal_merge_vertices(BrepModel& body, double tolerance = 1e-6);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 合并重合边
|
||
|
|
*
|
||
|
|
* 查找共享端点且曲线几何几乎相同的边对，将其中一条边合并到另一条。
|
||
|
|
* 更新所有引用被合并边的环，使其指向保留的边。
|
||
|
|
*
|
||
|
|
* @param body 待修复的 B-Rep 模型（原地修改）
|
||
|
|
* @param tolerance 曲线几何比较容差，默认 1e-6
|
||
|
|
* @return 合并的边对数
|
||
|
|
*/
|
||
|
|
int heal_merge_edges(BrepModel& body, double tolerance = 1e-6);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 闭合面之间的微小间隙
|
||
|
|
*
|
||
|
|
* 检查每条边的端点是否在 max_gap 范围内接近另一条边的端点。
|
||
|
|
* 将接近的顶点吸附到一起，消除拓扑间隙。
|
||
|
|
*
|
||
|
|
* @param body 待修复的 B-Rep 模型（原地修改）
|
||
|
|
* @param max_gap 最大间隙尺寸，默认 1e-4
|
||
|
|
* @return 闭合的间隙数
|
||
|
|
*/
|
||
|
|
int heal_close_gaps(BrepModel& body, double max_gap = 1e-4);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 统一面方向（全部向外）
|
||
|
|
*
|
||
|
|
* 通过符号体积计算确保所有面法向量朝外。
|
||
|
|
* 对于方向朝内的面，翻转其 reversed 标志。
|
||
|
|
*
|
||
|
|
* @param body 待修复的 B-Rep 模型（原地修改）
|
||
|
|
* @return 翻转的面数
|
||
|
|
*/
|
||
|
|
int heal_orientation(BrepModel& body);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 执行完整拓扑修复流水线
|
||
|
|
*
|
||
|
|
* 按推荐顺序执行所有修复步骤：
|
||
|
|
* 顶点合并 → 边合并 → 间隙闭合 → 方向统一
|
||
|
|
* 最后调用 validate() 检查修复结果。
|
||
|
|
*
|
||
|
|
* @param body 待修复的 B-Rep 模型（原地修改）
|
||
|
|
* @param tolerance 用于顶点/边合并的距离容差，默认 1e-6
|
||
|
|
* @return true 如果修复后模型通过验证
|
||
|
|
*
|
||
|
|
* @code{.cpp}
|
||
|
|
* BrepModel body = import_step("part.step");
|
||
|
|
* if (heal_topology(body)) {
|
||
|
|
* // 模型已修复，可以安全执行布尔运算等操作
|
||
|
|
* auto result = validate(body);
|
||
|
|
* assert(result.valid);
|
||
|
|
* }
|
||
|
|
* @endcode
|
||
|
|
*/
|
||
|
|
bool heal_topology(BrepModel& body, double tolerance = 1e-6);
|
||
|
|
|
||
|
|
} // namespace vde::brep
|