OpenCASCADE Make Face With Holes

OpenCASCADE Make Face With Holes

eryar@163.com

OpenCASCADE提供了构造Face的类BRepBuilderAPI_MakeFace，使用这个类可以构造出带孔的面。如下图所示：

当然，要得到上图所示的结果，还可以使用Boolean操作，用一个面去Cut几个圆柱。当使用布尔操作就会涉及到一些复杂算法，如求交，重构Topo体等，比较耗时。既然可以直接在生成面的时候挖孔，这个不涉及复杂算法，速度、稳定性都比使用布尔操作要好。本文主要来介绍如何使用BRepBuilderAPI_MakeFace来生成带孔的面，及其注意事项。直接上代码：

#include <gp_Circ.hxx>
#include <gp_Pln.hxx>

#include <BRepBuilderAPI_MakeEdge.hxx>
#include <BRepBuilderAPI_MakeWire.hxx>
#include <BRepBuilderAPI_MakeFace.hxx>

#include <BRepTools.hxx>

#pragma comment(lib, "TKernel.lib")
#pragma comment(lib, "TKMath.lib")

#pragma comment(lib, "TKG2d.lib")
#pragma comment(lib, "TKG3d.lib")
#pragma comment(lib, "TKGeomBase.lib")
#pragma comment(lib, "TKGeomAlgo.lib")

#pragma comment(lib, "TKBRep.lib")
#pragma comment(lib, "TKTopAlgo.lib")

void makeFaceTest()
{
    gp_Pln aPlane;

    gp_Circ aCircle1(gp::XOY(), 1.0);
    gp_Circ aCircle2(gp::XOY(), 1.0);
    gp_Circ aCircle3(gp::XOY(), 1.0);

    aCircle1.SetLocation(gp_Pnt(3.0, 3.0, 0.0));
    aCircle2.SetLocation(gp_Pnt(7.0, 3.0, 0.0));
    aCircle3.SetLocation(gp_Pnt(3.0, 7.0, 0.0));

    BRepBuilderAPI_MakeEdge anEdgeMaker1(aCircle1);
    BRepBuilderAPI_MakeEdge anEdgeMaker2(aCircle2);
    BRepBuilderAPI_MakeEdge anEdgeMaker3(aCircle3);

    BRepBuilderAPI_MakeWire aWireMaker1(anEdgeMaker1.Edge());
    BRepBuilderAPI_MakeWire aWireMaker2(anEdgeMaker2.Edge());
    BRepBuilderAPI_MakeWire aWireMaker3(anEdgeMaker3.Edge());

    BRepBuilderAPI_MakeFace aFaceMaker(aPlane, 0.0, 10.0, 0.0, 10.0);

    if (aWireMaker1.IsDone())
    {
        aFaceMaker.Add(aWireMaker1.Wire());
    }

    if (aWireMaker2.IsDone())
    {
        aFaceMaker.Add(aWireMaker2.Wire());
    }

    if (aWireMaker3.IsDone())
    {
        aFaceMaker.Add(aWireMaker3.Wire());
    }

    if (aFaceMaker.IsDone())
    {
        BRepTools::Write(aFaceMaker.Shape(), "d:/face.brep");
    }

}

int main(int argc, char* argv[])
{

    makeFaceTest();

    return ;

}

上面代码就是在一个平面上开三个孔，最后在D盘生成face.brep文件。在Draw Test Harness中加载并显示这个文件得到：

当切换到线框显示模式时，和预期效果一致。但是当切换到着色显示模式时，发现生成的面和预期的效果刚好相反。这是什么原因呢？

在Draw Test Harness中输入命令pcruve来检查，如下图所示：

根据pcurve命令的提示得知，蓝色的方向应该反向，红色的为外环。所以得知，内环孔的方向反了。修改代码，直接将Wire的方向Reverse。修改后的代码如下：

#include <gp_Circ.hxx>
#include <gp_Pln.hxx>

#include <TopoDS_Wire.hxx>

#include <BRepBuilderAPI_MakeEdge.hxx>
#include <BRepBuilderAPI_MakeWire.hxx>
#include <BRepBuilderAPI_MakeFace.hxx>

#include <BRepTools.hxx>

#pragma comment(lib, "TKernel.lib")
#pragma comment(lib, "TKMath.lib")

#pragma comment(lib, "TKG2d.lib")
#pragma comment(lib, "TKG3d.lib")
#pragma comment(lib, "TKGeomBase.lib")
#pragma comment(lib, "TKGeomAlgo.lib")

#pragma comment(lib, "TKBRep.lib")
#pragma comment(lib, "TKTopAlgo.lib")

void makeFaceTest()
{
    gp_Pln aPlane;

    gp_Circ aCircle1(gp::XOY(), 1.0);
    gp_Circ aCircle2(gp::XOY(), 1.0);
    gp_Circ aCircle3(gp::XOY(), 1.0);

    aCircle1.SetLocation(gp_Pnt(3.0, 3.0, 0.0));
    aCircle2.SetLocation(gp_Pnt(7.0, 3.0, 0.0));
    aCircle3.SetLocation(gp_Pnt(3.0, 7.0, 0.0));

    BRepBuilderAPI_MakeEdge anEdgeMaker1(aCircle1);
    BRepBuilderAPI_MakeEdge anEdgeMaker2(aCircle2);
    BRepBuilderAPI_MakeEdge anEdgeMaker3(aCircle3);

    BRepBuilderAPI_MakeWire aWireMaker1(anEdgeMaker1.Edge());
    BRepBuilderAPI_MakeWire aWireMaker2(anEdgeMaker2.Edge());
    BRepBuilderAPI_MakeWire aWireMaker3(anEdgeMaker3.Edge());

    BRepBuilderAPI_MakeFace aFaceMaker(aPlane, 0.0, 10.0, 0.0, 10.0);
    if (aWireMaker1.IsDone())
    {
        TopoDS_Wire aWire1 = aWireMaker1.Wire();
        aWire1.Reverse();

        aFaceMaker.Add(aWire1);
    }

    if (aWireMaker2.IsDone())
    {
        TopoDS_Wire aWire2 = aWireMaker2.Wire();
        aWire2.Reverse();

        aFaceMaker.Add(aWire2);
    }

    if (aWireMaker3.IsDone())
    {
        TopoDS_Wire aWire3 = aWireMaker3.Wire();
        aWire3.Reverse();

        aFaceMaker.Add(aWire3);
    }

    if (aFaceMaker.IsDone())
    {
        BRepTools::Write(aFaceMaker.Shape(), "d:/face.brep");
    }
}

int main(int argc, char* argv[])
{
    makeFaceTest();

    return ;
}

重新加载新生成的face.brep并使用pcurve查看，得到如下图所示的效果：

从上图可知，这时得到的为预期的效果。综上所述，如果要直接使用BRepBuilderAPI_MakeFace来生成带有孔的面，需要自己为外环和内环的方向负责，opencascade对此不作检查。当面显示不正确时，可以使用Draw Test Harness的pcurve命令来检查。一个带孔的面的pcurve的规则为：外环为逆时针方向；内环孔的方向为顺时针方向。

基于直接生成的带孔的面，还可以进一步使用放样算法来造型，如拉伸，旋转等，如下图所示。这样就可以避免使用布尔操作，提高造型算法的性能和稳定性。