本文详细介绍了在cadquery或build123d中，如何通过编程方式检测导入的step文件中存在的圆角或倒角边。通过利用opencascade technology (ocp) 的底层工具`brep_tool`，我们可以检查边缘的几何类型，特别是识别“geom_trimmedcurve”来精确区分这些特殊边缘，从而克服了cadquery在读取现有几何信息方面的局限性。
在处理CAD模型时，尤其是在分析从外部导入的STEP文件时，我们经常需要识别模型中特定几何特征，例如圆角（fillets）或倒角（chamfers）。尽管CadQuery和build123d在创建几何体方面功能强大，但在读取和分析现有几何体的特定属性，如边缘类型时，其直接提供的API可能不够直观或全面。例如，直接查询边缘是否为圆角或倒角并非一个简单的操作，且用户可能希望避免直接使用底层的PythonOCC库。本文将介绍一种有效的方法，通过访问边缘的底层几何类型来识别这些特殊特征。
理解几何边缘的类型
在OpenCASCADE Technology (OCP) 中，几何实体（如曲线和曲面）都有其特定的类型。圆角和倒角通常不是简单的直线或圆弧，而是由更复杂的几何结构表示，或者它们是某种曲线的修剪（trimmed）部分。例如，一个圆角通常是圆弧的一部分，但它在拓扑上被定义为一个边缘，其底层几何曲线是修剪过的圆形曲线。
使用 BRep_Tool 识别边缘类型
BRep_Tool 是OpenCASCADE Technology (OCP) 库中的一个核心工具类，它提供了访问拓扑实体（如顶点、边、面）底层几何信息的方法。通过BRep_Tool，我们可以获取到边缘所对应的几何曲线的类型，进而判断其是否为圆角或倒角。
具体来说，我们可以通过以下步骤实现：
- 遍历模型中的所有边缘。
- 对于每个边缘，使用 BRep_Tool.Curve_s() 方法获取其底层的几何曲线。
- 通过几何曲线的 DynamicType().Name() 方法，获取曲线的动态类型名称。
- 检查类型名称是否为“Geom_TrimmedCurve”。在许多情况下，圆角和倒角的底层几何曲线会被表示为“Geom_TrimmedCurve”，因为它们是某个更大曲线（如圆或直线）的修剪部分。
示例代码
以下代码演示了如何在 build123d 环境中加载一个模型（或创建一个带圆角的模型），然后遍历其所有边缘，识别并高亮显示圆角边。
from build123d import *
from ocp_vscode import *
from OCP.BRep import BRep_Tool
from OCP.Geom import Geom_TrimmedCurve # 引入Geom_TrimmedCurve类型，方便理解
# 1. 创建一个带有圆角的示例模型
# 这里我们创建一个立方体并对其一个边进行圆角处理，
# 以模拟一个包含圆角特征的几何体。
b = Box(1, 1, 1)
b = fillet(b.edges().group_by(Axis.Z)[-1], 0.2) # 对顶部的一个边进行圆角处理
# 如果您是从STEP文件导入，可以替换为以下代码：
# b = import_step("your_step_file.step")
# 用于存储检测到的圆角边缘
fillets = []
# 2. 遍历模型中的所有边缘
for edge in b.edges():
# 3. 使用 BRep_Tool.Curve_s() 获取边缘的底层几何曲线
# edge.wrapped 是 build123d 边缘对象的底层 OCP 拓扑实体
# 0.0, 1.0 表示曲线的参数范围
curve_handle = BRep_Tool.Curve_s(edge.wrapped, 0.0, 1.0)
# 4. 获取几何曲线的动态类型名称
type_name = curve_handle.DynamicType().Name()
# 5. 检查类型名称是否为 "Geom_TrimmedCurve"
# 圆角和倒角通常表现为修剪过的曲线
if type_name == "Geom_TrimmedCurve":
fillets.append(edge)
# 6. 可视化原始模型和检测到的圆角边缘
# ocp_vscode 的 show 函数可以高亮显示特定的子元素
show(b, fillets, colors=[None, "red"]) # 将检测到的圆角显示为红色注意事项与总结
- Geom_TrimmedCurve 的含义： 在OpenCASCADE中，Geom_TrimmedCurve 表示一个被修剪过的曲线。一个圆角通常是一个圆弧的一部分，而倒角则可能是一个直线段或椭圆弧的修剪部分。因此，检测到“Geom_TrimmedCurve”可以作为识别圆角或倒角的一个强信号。
- 倒角识别： 尽管示例主要针对圆角，但倒角在许多情况下也会被表示为 Geom_TrimmedCurve。如果需要更精确地区分圆角和倒角，可能需要进一步检查 Geom_TrimmedCurve 所基于的原始曲线类型（例如，圆角基于 Geom_Circle，而某些倒角可能基于 Geom_Line 或 Geom_BSplineCurve）。
- 性能考量： 对于包含大量边缘的复杂模型，遍历所有边缘并查询其几何类型可能会有一定的性能开销。在实际应用中，可以考虑优化查询范围或在必要时进行缓存。
- CadQuery与OCP的桥梁： 这种方法展示了如何在不完全脱离CadQuery/build123d框架的情况下，利用其底层的OpenCASCADE能力进行更深层次的几何分析。build123d 对象（如 Edge）的 .wrapped 属性是访问底层OCP拓扑实体的关键。
通过上述方法，用户可以在CadQuery或build123d环境中有效地识别和分析模型中的圆角或倒角边，这对于自动化几何特征提取、质量检查或后续处理工作具有重要意义。
