OpenCasCade 教程-瓶子 （1）

目录

 

1. 项目概览.........................................................................................4

1.1. 先决条件.................................................................................4

1.2. 项目.........................................................................................4

1.3. 项目说明.................................................................................4

2. 技术描述..........................................................................................6

2.1. 点..............................................................................................6

2.2. 几何..........................................................................................7

2.3. 拓扑..........................................................................................8

2.4. 完整描述.................................................................................10

3. 构建主体.........................................................................................12

3.1. 柱体.........................................................................................12

3.2. 倒圆角.....................................................................................13

3.3. 瓶颈.........................................................................................15

3.4. 空洞.........................................................................................16

4. 构建螺纹.........................................................................................19

4.1. 创建表面.................................................................................19

4.2. 2D曲线.....................................................................................19

4.3. 边框.........................................................................................23

4.4. 螺纹.........................................................................................24

5. 组合部件..........................................................................................26

6. 附录..................................................................................................27

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1. 项目概览

这个教程将教你使用OCC建立3D模型。这个教程的目的不是描述所有的OCC类，而是让你开始思考OCC这个工具。

 

1.1.先决条件

 

这个教程假设你已经有了C++的经验。

因为OCC是一个用C++设计的高性能建模库。这样的组合将使你能够创建健壮的应用程序。

 

1.2. 项目

下图是使用这个3D几何建模库提供的方法创建的一个瓶子：

 

 

本教程将一步一步的教你创建这样一个瓶子。你也可以在OCC安装目录中找到教程的源码（Tutorial/src/MakeBottle.cxx.）

 

 

1.3.项目说明

瓶子的详细参数

参数	参数名称	参数值
瓶高	MyHeight	70mm
瓶宽	MyWidth	50mm
瓶厚	MyThickness	30mm

 

另外我们将采用笛卡尔坐标系的原点做为瓶子的中心

 

 

 

 

建立这个模型需要的四个步骤

 

• 构建瓶子的轮廓

 

• 构建瓶子的主体

 

• 构建瓶颈上的螺纹

 

• 组合部件

 

 

2. 描述

 

2.1. 点

创建瓶子轮廓，首先要在XOY平面上创建特征点（下图）。这些点将用来定义几何体的轮廓。

 

 

 

在OCC里有2个类可以用来描述3D坐标点：

• gp_Pnt 类

 

• Geom_CartesianPoint 类（句柄操作）

 

这里句柄是一种提供自动内存管理的智能指针。

如何选择最合适类，考虑下列因素：

 

• gp_Pnt 通过值操作。所有像它这样的类型，都有有限的生存域。

 

• Geom_CartesianPoint 是通过句柄操作的，而且可能有多重引用，这将使他有较长的生存域。

 

因为所有的点你仅仅是用来创建轮廓的曲线，一个实体有有限的生存时间。选择 gp_Pnt 类。

初始化这些点需要它们的坐标值：

 

gp_Pnt aPnt1(-myWidth / 2. , 0 , 0); gp_Pnt aPnt2(-myWidth / 2. , -myThickness / 4. , 0); gp_Pnt aPnt3(0 , -myThickness / 2. , 0); gp_Pnt aPnt4(myWidth / 2. , -myThickness / 4. , 0); gp_Pnt aPnt5(myWidth / 2. , 0 , 0);

 

如果使用Geom_CartesianPoint，语法将不太一样。所有的操作是通过一个句柄，需要使用new操作符：

 

Handle(Geom_CartesianPoint) aPnt1 = new Geom_CartesianPoint(-myWidth / 2. , 0 , 0);

 

一旦定义了对象，你就可以按照C++的方式访问这些类的属性，比如得到坐标的X值：

 

gp_Pnt aPnt1(0,0,0); Handle(Geom_CartesianPoint) aPnt2 = new Geom_CartesianPoint(0 , 0 , 0); Standard_Real xValue1 = aPnt1.X(); Standard_Real xValue2 = aPnt2->X();

 

2.2. 轮廓: 定义几何体

我们借助于先前定义的特征点，可以知道瓶子轮廓，如下图所示，它是由2个线段和一个圆弧组成：

为了创建这样一个实体，需要一个用来实现3D几何对象的数据结构。这些可以在OCC的Geom开发包中找到。

一个OCC开发包是由一组类构成的，它们通常有相同或类似的结构。

OCC 类使用类名称前缀来标识这样一组类，比如 Geom_Line,Geom_Circle 这2个类属于Geom开发包。这个开发包实现3D几何对象：基本曲线和曲面（比如Bezier和BSpline）。

但是，Geom开发包仅仅提供几何对象的数据结构。你可以直接使用这些数据结构定义几何体。因此GC开发包提供了更简单的生成这些基本几何对象的方法。

GC开发包提供了2个算法类，它对通过参数计算得到几何对象更容易：

• 类 GC_MakeSegment 创建线段。它的其中一个构造函数支持使用2个点P1，P2来构造线段。

• 类 GC_MakeArcOfCircle 创建圆弧和圆。一个常用的方法是通过圆弧的2个端点和圆弧所通过的一个点来生成圆弧。

这些类返回一个Geom_TrimmedCurve 句柄。这是基本曲线的一个基类。距离：

 

Handle(Geom_TrimmedCurve) aArcOfCircle = GC_MakeArcOfCircle(aPnt2,aPnt3 ,aPnt4); Handle(Geom_TrimmedCurve) aSegment1 = GC_MakeSegment(aPnt1 , aPnt2); Handle(Geom_TrimmedCurve) aSegment2 = GC_MakeSegment(aPnt4 , aPnt5);

 

所有的GC类提供重载方法，所以基类可以调用任何派生类的方法。你可以通过IsDone和Value方法来保证更安全的使用这些类：

 

GC_MakeSegment mkSeg (aPnt1 , aPnt2); Handle(Geom_TrimmedCurve) aSegment1; if(mkSegment.IsDone()){ aSegment1 = mkSeg.Value(); ... }

 

2.3. 轮廓: 拓扑结构

现在已经创建了一部分几何对象，但他们没有任何关系。

为了方便建模，需要将3个曲线变成一个实体。

这将用到OCC中的TopoDS开发包：这个开发包可以将几何对象关联在一起，让它们生成一个复合对象。

TopoDS开发包的所有对象都是由TopoDS_Shape 类派生而来，下面是对这种拓扑结构的描述：

 

 

图形	Open CASCADE Class		描述
Vertex（顶点）	TopoDS_Vertex		表示几何体上的一个点
Edge （边）	TopoDS_Edge		表示一个曲线和一个有边界的向量
Wire （网格）	TopoDS_Wire		由顶点连起来的一系列边
Face （面）	TopoDS_Face		由闭合的网格组成的边界平面
Shell （壳）	TopoDS_Shell		通过边连接起起来一组面
Solid （体）	TopoDS_Solid		由壳组成的有边界的三维空间
CompSolid （复合体）		TopoDS_CompSolid	通过面连接的一组体
Compound （复合对象）		TopoDS_Compound	由上面各种图形形成的一个集合

 

参考前面的表格，可以看出来，构建轮廓需要先创建：

 

• 用前面的曲线构建3条边。

• 用这些边形成一个网格。

TopoDS包中只提供了拓扑实体的数据结构。在BRepBuilderAPI包中，可以找到计算标准拓朴对象的算法类。

为了创建一个边，通过前面得出曲线，使用BRepBuilderAPI_MakeEdge类来完成：

 

TopoDS_Edge aEdge1 = BRepBuilderAPI_MakeEdge(aSegment1); TopoDS_Edge aEdge2 = BRepBuilderAPI_MakeEdge(aArcOfCircle); TopoDS_Edge aEdge3 = BRepBuilderAPI_MakeEdge(aSegment2);

 

在Open CASCADE中，有几种创建边的方法。可以直接通过两点来创建一个边，在这种情况下所生成的边是直线。输入的两个顶点是直线的两个端点。比如：

 

TopoDS_Edge aEdge1 = BRepBuilderAPI_MakeEdge(aPnt1 , aPnt3); TopoDS_Edge aEdge2 = BRepBuilderAPI_MakeEdge(aPnt4 , aPnt5);

 

可以这样简单地生成边aEdge1和 aEdge3 。

 

为了将边链接起来，需要通过 BRepBuilderAPI_MakeWire 创建网格。有2种方法创建网格：

• 直接通过1至4个边来生成。

 

• 在一个现有的网格上添加边。

当使用少于4个边构建网格时，可以使用下面的构造函数生成：

 

TopoDS_Wire aWire = BRepBuilderAPI_MakeWire(aEdge1 , aEdge2 , aEdge3);

 

 

2.4. 轮廓: 完成轮廓

一旦你网格的第一部分完成，就可以生成完整的轮廓了，下面是一个简单的方法：

 

 

•  通过镜像原有的网格生成一个新的网格 。

 

• 添加镜像出来的新网格到原有的网格中。

要完成上面的操作，需要一个gp_Trsf 类。它可以在3D图形上应用变换。变换方式包含 移动，旋转，缩放，镜像，或者几种的组合。

在我们现在的情况下，需要的是一个镜像变换，它以世界坐标系下的X轴作为对称轴。

需要先用一个点和一个法向创建一个轴（gp_Ax1）。

 

定义轴的第一种方法：

 

• X 轴的原点在（0，0，0） 使用 gp_Pnt。

 

• X 轴的方向为（1，0，0） 使用gp_Dir。

 

gp_Pnt aOrigin(0 , 0 , 0); gp_Dir xDir(1 , 0 , 0); gp_Ax1 xAxis(aOrigin , xDir);

 

定义轴的第二种方法：

可以直接使用gp 开发包中的几何常量来初始化轴

 

gp_Ax1 xAxis = gp::OX();

 

下面看看 gp_Trsf 类的2种不同的使用方法：

 

•  直接设置变换矩阵

• 使用合适的方法计算生成所需的变换（移动使用 SetTranslation 镜像使用 SetMirror 等等）

下面是用最简单的方法SetMirror 设定x轴为对称轴：

 

gp_Trsf aTrsf; aTrsf.SetMirror(xAxis);

 

现在数据已经准备完毕，下面将使用BRepBuilderAPI_Transform 进行变换：

参数为要变换的几何对象和gp_Trsf指定的变化方式：

BRepBuilderAPI_Transform aBRepTrsf(aWire , aTrsf);

 

BRepBuilderAPI_Transform 并不会修改aWire中的原始形状，镜像的结果仍然是一个网格。这个结果需要调用BRepBuilderAPI_Transform::Shape 方法返回一个TopoDS_Shape 对象：

 

TopoDS_Shape aMirroredShape = aBRepTrsf.Shape();

 

还可以通过下面的方法将返回的TopoDS_Shape类转换为TopoDS_Wire（这是因为TopoDS_Shape是所有拓扑类的基类）：

 

TopoDS_Wire aMirroredWire = TopoDS::Wire(aMirroredShape);

 

瓶子的轮廓已经完成了。我们已经创建了2个网格： aWire 和 aMirroredWire。现在需要将它们连接成一个单一的图形。

BRepBuilderAPI_MakeWire 这个类可以帮助我们完成这个任务：

 

• 创建一个 BRepBuilderAPI_MakeWire 实例 。

• 使用 Add  方法将2个网格的所有的边添加到这个实体上。

 

BRepBuilderAPI_MakeWire mkWire; mkWire.Add(aWire); mkWire.Add(aMirroredWire); TopoDS_Wire myWireProfile = mkWire.Wire();