OpenCascade中BRepBuilderAPI_GTransform加圆角报错的原因与解决

使用OpenCascade的BRepBuilderAPI_GTransform处理模型后，执行圆角操作（BRepFilletAPI_MakeFillet2d）总会抛出StdFail_NotDone错误；而使用BRepBuilderAPI_Transform则可正常完成圆角，但该方法不支持非均匀轴缩放。请问GTransform引发问题的原因是什么，是否存在解决办法？

以下是最小错误示例代码：

// 单位三角形
BRepBuilderAPI_MakePolygon polyMaker;
polyMaker.Add(BRepBuilderAPI_MakeVertex(gp_XYZ(0, 0, 0)));
polyMaker.Add(BRepBuilderAPI_MakeVertex(gp_XYZ(1, 0, 0)));
polyMaker.Add(BRepBuilderAPI_MakeVertex(gp_XYZ(0, 1, 0)));
polyMaker.Close();
TopoDS_Shape face = BRepBuilderAPI_MakeFace(polyMaker.Wire());

// 应用单位广义变换
gp_GTrsf gtrsf;
face = BRepBuilderAPI_GTransform(face, gtrsf, true);

// 对顶点1做圆角
TopTools_IndexedMapOfShape vmap;
TopExp::MapShapes(face, TopAbs_VERTEX, vmap);
BRepFilletAPI_MakeFillet2d filletMaker(TopoDS::Face(face));
filletMaker.AddFillet(TopoDS::Vertex(vmap(1)), 0.1);
TopoDS_Shape fillet = filletMaker.Shape();

// 错误：抛出'StdFail_NotDone'异常

问题原因 #

BRepBuilderAPI_GTransform的核心特性是创建带附加变换的形状——它不会修改形状的原始几何数据，只是给形状关联一个变换矩阵，后续访问形状时才会实时计算变换后的坐标。而BRepFilletAPI_MakeFillet2d这类2D圆角工具依赖于直接读取形状的原始几何信息（比如边的曲线参数、顶点的原始坐标），无法正确解析这种带间接变换的形状表示，导致圆角计算无法完成，最终抛出StdFail_NotDone异常。

相比之下，BRepBuilderAPI_Transform会直接将变换应用到形状的所有几何元素上，生成全新的、不依赖附加变换的原始形状，因此能被圆角工具正常处理，但它仅支持刚体变换和均匀缩放，无法处理非均匀轴缩放需求。

解决办法 #

办法1：固化GTransform处理后的形状 #

通过工具将附加的变换矩阵实际应用到形状的几何数据上，生成不带变换的原始形状，再进行圆角操作。可以使用BRepBuilderAPI_Copy或BRepLib::Transform实现：

使用BRepBuilderAPI_Copy的示例：

// 用GTransform处理后，固化形状
BRepBuilderAPI_Copy copyTransformer(face);
TopoDS_Shape solidifiedFace = copyTransformer.Shape();

// 用固化后的形状执行圆角操作
TopTools_IndexedMapOfShape vmap;
TopExp::MapShapes(solidifiedFace, TopAbs_VERTEX, vmap);
BRepFilletAPI_MakeFillet2d filletMaker(TopoDS::Face(solidifiedFace));
filletMaker.AddFillet(TopoDS::Vertex(vmap(1)), 0.1);
TopoDS_Shape fillet = filletMaker.Shape(); // 正常执行

使用BRepLib::Transform的示例（直接在变换时固化）：

gp_GTrsf gtrsf;
// 第三个参数设为true，直接将变换应用到几何数据，生成固化后的形状
TopoDS_Shape solidifiedFace;
BRepLib::Transform(face, gtrsf, solidifiedFace, Standard_True);

// 后续圆角操作同上述代码

办法2：替换GTransform为非均匀缩放+几何固化组合 #

如果场景允许，也可以手动构造非均匀缩放的变换逻辑，先对原始形状的几何元素执行非均匀缩放计算，再生成新的形状。不过这种方式需要手动处理顶点、边、面的几何数据，复杂度较高，不如办法1便捷。

内容的提问来源于stack exchange，提问作者Patrick Kwok