OpenCASCADE 基础
OpenCASCADE 基础
转载▼一直在用OCC作项目，但这方面的中文资料很少，看来OCC在中国还不是十分普及；
后来，项目中使用OCC和DirectX结合使用，取得了很好的效果；
随着OCC6.3版本的推出，Open CASCADE在速度方面已有了很大的改变。以下为一些OCC的基础知识，愿与各位OCC爱好者共同学习；
在OCC中，gp_Pnt表示一个顶点，gp_Vec表示一个向量，可以用两个顶点来生成一个向量。
比如：
gp_Pnt P1(0,0,0);
gp_Pnt P2(5,0,0);
gp_Vec V1 (P1,P2);
向量有一个方法.IsOpposite（），可以用来测试两个向量的方向是相对还是平行;
比如：
gp_Pnt P3(-5,0,2);
gp_Vec V2 (P1,P3);
Standard_Boolean result =V1.IsOpposite(V2,Precision::Angular());
另外向量还有一些重要方法：
--Standard_Real Magnitude() const;计算向量的大小；
--Standard_Real SquareMagnitude() const;计算向量的平方；
--向量的加减乘除操作；
--向量的单位化；
--通过一个点，线，面得出其镜像的向量；
--向量的旋转，平移，缩放；
具体的函数名称可以看OCC的头文件说明；
有时需要决定一组空间点是位于一个点;一条直线,或一个平面,或一个空间:
OCC中提供了相应的算法；
比如：
TColgp_Array1OfPnt array (1,5); // sizing array
array.SetValue(1,gp_Pnt(0,0,1));
array.SetValue(2,gp_Pnt(1,2,2));
array.SetValue(3,gp_Pnt(2,3,3));
array.SetValue(4,gp_Pnt(4,4,4));
array.SetValue(5,gp_Pnt(5,5,5));
GProp_PEquation PE (array,1.5 );
if (PE.IsPoint()){ } //是否是同一个点
gp_Lin L;
if (PE.IsLinear()) { L = PE.Line(); } //是否位于一条直线上；
if (PE.IsPlanar()){ } //是否在一个平面内；
if (PE.IsSpace()) { }
此类用来描述3D空间中的一个单位向量;
常用方法:
(1):IsEqual(const gp_Dir& Other,const Standard_Real AngularTolerance) const;两个单位向量是否相等;
(2):IsNormal(const gp_Dir& Other,const Standard_Real AngularTolerance) const;两个单位向量的夹角是否是PI/2;
(3):IsOpposite(const gp_Dir& Other,const Standard_Real AngularTolerance) const;两个单位向量是否方向相反;
(4):IsParallel(const gp_Dir& Other,const Standard_Real AngularTolerance) const;两个单位向量夹角O或PI;
(5):Angle(const gp_Dir& Other) const;求两个向量之间的夹角;
(6):void CrossCross(const gp_Dir& V1,const gp_Dir& V2) ;计算三个向量之间的叉积；
(7)：Standard_Real Dot(const gp_Dir& Other) const;计算点积；
(8)：Standard_Real DotCross(const gp_Dir& V1,const gp_Dir& V2) const;计算叉积再点积；
(9):gp_Dir Reversed() const;得到反方向，
在OCC中用 gp_Lin2d 类，来生成一个二维空间的直线，有它的原点和单位向量；
通过原点和X方向单位和Y方向单位建立一个二维坐标系；利用sense参数可以决定是右手系还是左手系；
可以利用平移、旋转、缩放、镜像来更改坐标系；
类似地，gp_Ax3类：
用来描述一个3D空间的坐标系。而gp_Ax2类用来表示一个二维空间坐标系；可以为右手系，也可以是左手系；
GeomAPI开发包提供了一个几何体的可编程应用程序接口；
比如：
求点P和曲线C的距离D：
D = GeomAPI_ProjectPointOnCurve(P,C);
或者
GeomAPI_ProjectPointOnCurve PonC(P,C);
D = PonC.LowerDistance();
GeomConvert包提供了一些全局函数，可以用来实现转化一个Geom曲线为BSpline曲线等；
比如：
Handle(Geom_BSplineSurface) aPipeSurface =
Handle(Geom_BSplineSurface)::DownCast(aPipe.Surface());
Handle(Geom_BSplineSurface) anotherBSplineSurface =
GeomConvert::SplitBSplineSurface(aPipeSurface,1,2,3,6);
OCC中三维几何曲线的类型有：
--线
--园
--椭圆
--二次曲线
--抛物线
--Bezier曲线
--BSpline曲线
可以将一个二维的几何曲线转化为某个平面内的一个三维曲线：
比如：
Standard_Real radius = 5;
gp_Ax2d ax2d(gp_Pnt2d(2,3),gp_Dir2d(1,0));
//生成一个二维园
Handle(Geom2d_Circle) circ2d = new Geom2d_Circle(ax2d,radius);
gp_Ax2d circ2dXAxis = circ2d->XAxis();
// 然后，在这个平面里转化为三维曲线；
Handle(Geom_Curve) C3D = GeomAPI::To3d(circ2d,gp_Pln(gp_Ax3(gp::XOY())));
Handle(Geom_Circle) C3DCircle = Handle(Geom_Circle)::DownCast(C3D);
gp_Ax1 C3DCircleXAxis = C3DCircle->XAxis();
另外，可以以将一个三维曲线，投影到一个平面内，从而生成一个二维曲线
gp_Pln ProjectionPlane(gp_Pnt(1,1,0),gp_Dir( 1,1,1 ));
Handle(Geom2d_Curve) C2D = GeomAPI::To2d(C3D,ProjectionPlane);
Handle(Geom2d_Circle) C2DCircle =Handle(Geom2d_Circle)::DownCast(C2D);
gp_Ax2d C2DCircleXAxis = C2DCircle->XAxis();
将一个基本几何图形进行空间变换可以使用它自带的函数:
比如：
Handle(Geom_Geometry) aRotatedEntity = circle->Rotated(gp::OZ(),PI/4);
如果想获取图形的类型名称:
Standard_CString aRotatedEntityTypeName = aRotatedEntity->DynamicType()->Name();
描述一个平面内的抛物线；
示例：
gp_Pnt2d P(2,3);
gp_Dir2d D(4,5);
gp_Ax22d A(P,D);
gp_Parab2d Para(A,6);
生成一个抛物线图形；
描述样条曲线；
通过一组点来修改一个样条曲线；
用一个常量或线性增加的值来构造曲线；可以用来设计木纹或塑料板条；图形为二维的，可以模拟物理样条或板条.
此类通过两个值，定义曲线的一部分，
--可以用来计算曲线的参数值和点坐标；
--可以得到曲线的一般特征，比如连续的等级，封闭特点，周期性，边界参数；
--当用一个矩阵应用于曲线或原始曲线转化后进行相应参数的改变；
所有的曲线必须几何连续，曲线至少一阶可导。一般来说，在生成一个曲线时，要先检查一下所应用的参数是否可以生成一个光滑曲线；否则会出现错误；
另外注意一点：不可以构造空长度的曲线或自相交的曲线；
此类的基类是Geom2d_BoundedCurve类：
它是一个抽象类；描述二维空间中的边界曲线的一般行为；除了Geom2d_TrimmedCurve是它的一个派生类外，它还有二个派生类：
- Geom2d_BezierCurve
- Geom2d_BSplineCurve
Geom2d_BoundedCurve类的基类是Geom2d_Curve类：
Geom2d_Curve:抽象类；此抽象类描述了2D空间的曲线的一般特征；派生出的类有多个：包括直线，园，二次曲线，Bizier,BSpline曲线等；这些曲线的特点是可以参数化；
Geom2d_Curve类的基类是Geom2d_Geometry类；
此抽象类主要定义了曲线的变换，平移，旋转，缩放及拷贝等方法；
Geom2d_Geometry类的基类是MMgt_TShared类；
此抽象类为管理对象的基类，可以引用计数，及删除方法；
Standard_Transient：此抽象类为所有类共同的基类；
Geom2dAPI_InterCurveCurve类：
此类用来实现二维曲线的相交；
一种情况是曲线与曲线的相交，另外一种情况是曲线自身的相交；
主要方法有：
--Standard_Integer NbPoints() const;相交点数；
--Standard_Integer NbSegments() const;切线相交数；
--void Segment(const Standard_Integer Index,Handle(Geom2d_Curve)& Curve1,Handle(Geom2d_Curve)& Curve2)
const;返回其中一个线段；
下面的示例是两个曲线相交的例子：
首先，生成第一个曲线，在这里，应用点数组来生成一个曲线；
--定义数组
Handle(TColgp_HArray1OfPnt2d) harray = new TColgp_HArray1OfPnt2d (1,5); // sizing harray
--输入点数组的值
harray->SetValue(1,gp_Pnt2d (0,0));
harray->SetValue(2,gp_Pnt2d (-3,1));
harray->SetValue(3,gp_Pnt2d (-2,5));
harray->SetValue(4,gp_Pnt2d (2,9));
harray->SetValue(5,gp_Pnt2d (-4,14));
--检测一下点与点之间是否为同一点；0.01为公差值，依实际需要可以更改此参数；
Geom2dAPI_Interpolate anInterpolation(harray,Standard_False,0.01);
--生成曲线
anInterpolation.Perform();
Handle(Geom2d_BSplineCurve) SPL = anInterpolation.Curve();
--第二个曲线用两点来生成
gp_Pnt2d P1(-1,-2);gp_Pnt2d P2(0,15);gp_Dir2d V1 = gp::DY2d();
Handle(Geom2d_TrimmedCurve) TC1= GCE2d_MakeSegment(P1,V1,P2);
--下面进行曲线的求交
Standard_Real tolerance = Precision::Confusion();
Geom2dAPI_InterCurveCurve ICC (SPL,TC1,tolerance);
--得到交点
Standard_Integer NbPoints =ICC.NbPoints();
gp_Pnt2d PK;
for (Standard_Integer k = 1;k<=NbPoints;k++)
{
PK = ICC.Point(k);
// 针对每个交点，进行相应处理；
}
Geom2d_OffsetCurve类:
此类用来实现偏移曲线；
比如：
--生成一个曲线
TColgp_Array1OfPnt2d array (1,5); // sizing array
array.SetValue(1,gp_Pnt2d (-4,0)); array.SetValue(2,gp_Pnt2d (-7,2));
array.SetValue(3,gp_Pnt2d (-6,3)); array.SetValue(4,gp_Pnt2d (-4,3));
array.SetValue(5,gp_Pnt2d (-3,5));
Handle(Geom2d_BSplineCurve) SPL1 = Geom2dAPI_PointsToBSpline(array);
--生成一个偏移曲线
Standard_Real dist = 1;
Handle(Geom2d_OffsetCurve) OC =
new Geom2d_OffsetCurve(SPL1,dist);
Standard_Boolean result = OC->IsCN(2);
GccAna_Pnt2dBisec类
此类实现两点之间的等分线.
示例:
gp_Pnt2d P1(1,2);
gp_Pnt2d P2(4,5);
gp_Lin2d L;
GccAna_Pnt2dBisec B(P1,P2);
if (B.IsDone())
{ L = B.ThisSolution(); }
因为所生成的为直线,所以显示时要转化为线段:
if (B.IsDone())
{
Handle(Geom2d_TrimmedCurve) aLine = GCE2d_MakeSegment(L,-8,8);
Handle(ISession2D_Curve) aCurve = new ISession2D_Curve(aLine);
aDoc->GetISessionContext()->Display(aCurve, Standard_False);
}
gce_MakeCirc2d类
用来创建园:创建园的方法很多，主要构造方法有：
--园心和通过的一点;
--通过一个园和一个距离值,创建一个同心园;
--三点决定一个园;
--园心和半径;
gp_Elips2d类：
可以生成一个椭园,也可以生成椭园上的一段园弧;
比如：
Standard_Real major = 12;
Standard_Real minor = 4;
gp_Ax2d axis = gp::OX2d();
gp_Elips2d EE(axis,major,minor);;
Handle(Geom2d_TrimmedCurve) arc = GCE2d_MakeArcOfEllipse(EE,0.0,PI/4);
上面是利用长短轴的方法构造椭圆,也可以用二次方程的方式来构造椭园;
其中椭园类中方法可以求出焦点1和焦点2的位置,两焦点之间的位置,离心率;旋转,平移,缩放等操作.
定义一个平面,构造的方法可以是点法式,或通过ABCD系数;
另外，还提供了一些常用的方法，比如：
--求点到平面,线到平面,平面与平面的距离及平方距离;
--点是否在平面内,线是否在平面内;
--通过一个点,一个轴的镜像平面;
--平面的旋转,缩放与平移;
此类用来描述一个表面，此类的派生类有：
平面；园柱面；锥面；球面；园环面；
它的基类是Geom_Surface，是一个抽象类；
Geom_Surface类的基类是Geom_Geometry类；
Geom_RectangularTrimmedSurface类：
用来生成一个有边界的平面；
比如：
Handle(Geom_Plane) aProjectionPlane = GC_MakePlane(ProjectionPlane).Value();
Handle(Geom_RectangularTrimmedSurface) aProjectionPlaneSurface=
new Geom_RectangularTrimmedSurface(aProjectionPlane,-8.,8.,-12.,12.);
DisplaySurface(aDoc,aProjectionPlaneSurface);
此类的基类是Geom_BoundedSurface类；
此类的兄弟类还有
- Geom_BezierSurface,
- Geom_BSplineSurface
构造表面的方法有：
--已知一个园锥表面,和空间一点,过此点的平行于已知园锥表面;
--已知一个园锥表面,和一个距离,创建一个平行于已知园锥表面的园锥表面;
--通过四个点构造一个园锥表面;
--通过一个轴和两个点;
--通过两个点和两个半径;
GeomAPI_IntCS类：
此类用来计算一个园弧和和一个表面的交点或相交线段;
GeomFill_BSplineCurves类:
此类用来构造一个可以填充的BSpline表面,构造它可以用两个三个或四个BSpline曲线作为边界;
填充类型有三种:
enum GeomFill_FillingStyle {
GeomFill_StretchStyle,
GeomFill_CoonsStyle,
GeomFill_CurvedStyle
};
以下示例为用两个样条曲线生成一个表面:
GeomFill_FillingStyle Type = GeomFill_StretchStyle;
GeomFill_BSplineCurves aGeomFill1(SPL1,SPL2,Type);
Handle(Geom_BSplineSurface) aBSplineSurface1 = aGeomFill1.Surface();
GeomFill_Pipe类：
此类用来构造一个pipe,沿着一个路径sweep一个截面，这两个都是曲线类型；一般来说，结果是一个BSpline表面；
常见的有几种方法：
--给定一个路径和一个半径，截面是个园，位置是路径的第一个点，
比如：
GeomFill_Pipe aPipe(SPL1,1);
aPipe.Perform();
Handle(Geom_Surface) aSurface= aPipe.Surface();
Standard_CString aSurfaceEntityTypeName="Not Computed";
if (!aSurface.IsNull())
aSurfaceEntityTypeName = aSurface->DynamicType()->Name();
--给定一个路径和一个截面。
比如：
Handle(Geom_Ellipse) E = GC_MakeEllipse( gp::XOY() ,3,1).Value();
GeomFill_Pipe aPipe2(SPL1,E);
aPipe2.Perform();
Handle(Geom_Surface) aSurface2= aPipe2.Surface();
Standard_CString aSurfaceEntityTypeName2="Not Computed";
if (!aSurface2.IsNull()) {
aSurfaceEntityTypeName2 = aSurface2->DynamicType()->Name();
aSurface2->Translate(gp_Vec(5,0,0)); }
--给定一个路径和两个截面，中间截面为过度线；
示例：
Handle(Geom_TrimmedCurve) TC1 =
GC_MakeSegment(gp_Pnt(1,1,1),gp_Pnt(5,5,5));
Handle(Geom_TrimmedCurve) TC2 =
GC_MakeSegment(gp_Pnt(1,1,0),gp_Pnt(4,5,6));
GeomFill_Pipe aPipe3(SPL1,TC1,TC2);
aPipe3.Perform();
Handle(Geom_Surface) aSurface3 = aPipe3.Surface();
Standard_CString aSurfaceEntityTypeName3="Not Computed";
if (!aSurface3.IsNull())
{
aSurfaceEntityTypeName3 = aSurface3->DynamicType()->Name();
aSurface3->Translate(gp_Vec(10,0,0));
}
--给定一个路径和N个截面，中间为过渡线；
一般情况下，所生结果为：NURBS，但是，在一些特殊的情况下，可以生成平面，园柱，球，园锥等；
参数，U，沿着截面的方向，V沿着路径方向；
Geom_BezierSurface类：
生成一个Bezier表面；
Geom_OffsetSurface类：
用来偏移一个表面；
比如：
Standard_Real offset = 1;
Handle(Geom_OffsetSurface) GOS = new Geom_OffsetSurface(aGeomSurface, offset);
Geom_SweptSurface类：
有两个派生类，分别用来生成一个回转体表面和一个延展体表面；
Geom_SurfaceOfLinearExtrusion：用来描述一个线性延展表面；
它的基类是：Geom_Surface类
比如：
Handle(Geom_BSplineCurve) aCurve =GeomAPI_PointsToBSpline(array).Curve();
gp_Dir aDir(1,2,3);
Handle(Geom_SurfaceOfLinearExtrusion) SOLE =new Geom_SurfaceOfLinearExtrusion(aCurve,aDir);
Handle(Geom_RectangularTrimmedSurface) aTrimmedSurface =new Geom_RectangularTrimmedSurface(SOLE,-10,10,false);
Geom_SurfaceOfRevolution类，表示一个回转体表面；
比如：
Handle(Geom_BSplineCurve) aCurve = GeomAPI_PointsToBSpline(array).Curve();
Handle(Geom_SurfaceOfRevolution) SOR =new Geom_SurfaceOfRevolution(aCurve,gp::OX());
1:利用一个二维数组来生成曲面的方法:
TColgp_Array2OfPnt array3 (1,5,1,5);
array3.SetValue(1,1,gp_Pnt (-4,-4,5));
...
array3.SetValue(2,1,gp_Pnt (-2,-4,4));
...
Handle(Geom_BSplineSurface) aSurf2 =GeomAPI_PointsToBSplineSurface(array3).Surface();
2:GeomAPI_ExtremaSurfaceSurface类:
计算两个表面之间的极值点;
主要方法:
(1):Quantity_Length LowerDistance() const;计算两个表面的最短距离;
(2):Standard_EXPORT void LowerDistanceParameters(Quantity_Parameter& U1,Quantity_Parameter& V1,Quantity_Parameter& U2,Quantity_Parameter& V2) const;
得到第一个表面上的极值点的UV参数和第二个表面上的极值点的UV参数;
(3):void NearestPoints(gp_Pnt& P1,gp_Pnt& P2) const;得到第一个表面上的极值点和第二个表面上的极值点;
(4): Quantity_Length Distance(const Standard_Integer Index) const;得到第N个极值点的距离;
(5):Standard_Integer NbExtrema() const;极值的数目;
......
示例:
GeomAPI_ExtremaSurfaceSurface ESS(aSurf1,aSurf2);
Quantity_Length dist = ESS.LowerDistance();
gp_Pnt P1,P2;
ESS.NearestPoints(P1,P2);
gp_Pnt P3,P4;
Handle(Geom_Curve) aCurve;
Standard_Integer NbExtrema = ESS.NbExtrema();
for(Standard_Integer k=1;k<=NbExtrema;k++){
ESS.Points(k,P3,P4);
aCurve= GC_MakeSegment(P3,P4).Value();
DisplayCurve(aDoc,aCurve,Quantity_NOC_YELLOW3,false);
}
一些OCC的基础知识，愿与各位OCC爱好者共同学习；mail:tongabcd@yeah.net
一：关于体的类
BRepBuilderAPI_MakeVertex类
创建点；
BRepBuilderAPI_MakeEdge类
此类用来创建边；
比如，由直线生成边：
gp_Lin line(gp_Ax1(gp_Pnt(10,10,10),gp_Dir(1,0,0)));
WhiteEdge = BRepBuilderAPI_MakeEdge(line,-20,10);
下面为生成四分之一园边：
gp_Elips Elips(gp_Ax2(gp_Pnt(10,0,0),gp_Dir(1,1,1)),60,30);
RedEdge = BRepBuilderAPI_MakeEdge(Elips,0,PI/2);
下面是由曲线生成边：
Handle (Geom_BezierCurve) curve = new Geom_BezierCurve(array);
BRepBuilderAPI_MakeEdge ME (curve);
GreenEdge = ME;
V3 = ME.Vertex1();
V4 = ME.Vertex2();
BRepBuilderAPI_MakeWire类
用来创建一个Wire类；
用一个Wire和一个边来生成一个新的Wire：
ExistingWire = BRepBuilderAPI_MakeWire(Edge2);
Edge3 = BRepBuilderAPI_MakeEdge(gp_Pnt(-300,0,-80),gp_Pnt(-90,20,-30));
BRepBuilderAPI_MakeWire MW1(ExistingWire,Edge3);
if (MW1.IsDone()) {YellowWire = MW1;}
用一个Wire和添加边的方法来生成Wire：
BRepBuilderAPI_MakeWire MW;
MW.Add(ExistingWire2);
MW.Add(Edge5);
MW.Add(Edge6);
MW.Add(Edge7);
if (MW.IsDone()) {
WhiteWire = MW.Wire();
LastEdge = MW.Edge();
LastVertex = MW.Vertex();
}
BRepBuilderAPI_MakeFace类
生成一个面；有多种生成面的方法；
--通过一个封闭曲线生成面：
BRepBuilderAPI_MakeFace(curve);
--通过一个Wire生成面：
BrownFace = BRepBuilderAPI_MakeFace(YellowWire);
Bnd_Box2d类:
定义一个二维空间的边界盒,可以得出边界盒各个点的值，有时，在某个方向是无限大,这种情况下，称为在此方向上是开放的;
示例:
Bnd_Box2d aCBox;
Geom2dAdaptor_Curve GACC (C);
BndLib_Add2dCurve::Add (GACC,Precision::Approximation(),aCBox);
Bnd_Box类:
定义一个三维空间的边界盒,可以扩大或缩小边界盒,也可以合并两个轴对齐边界盒;
BRepPrimAPI_MakeBox类
用来生成一个立方体;
构造一个立方体可以是两个对角点,一个角点及三个方向长度,可以是非轴对称的:
TopoDS_Shape B2 = BRepPrimAPI_MakeBox (gp_Ax2(gp_Pnt(-200.,-80.,-70.), gp_Dir(1.,2.,1.)), 80.,90.,120.);
使用方法
TopoDS_Face& BottomFace() ;.可以得到立方体的底面;同样，用其它类似的方法可以获得顶面等；
方法TopoDS_Solid& Solid() ;可以将box转化为一个Solid;
方法TopoDS_Shell& Shell() ;可以将box转化为一个shell;
BRepPrimAPI_MakeCylinder类
用来生成一个园柱体或园柱体的一部分；
比如：
TopoDS_Shape C2 = BRepPrimAPI_MakeCylinder (gp_Ax2(gp_Pnt(200.,0.,200.), gp_Dir(0.,1.,0.)),40.,110.,210.*PI180);
BRepPrimAPI_MakeCone类
生成一个园锥或园锥的一部分；
BRepPrimAPI_MakeSphere类
生成球体或球体的一部分，可以是U方向切一部分或V方向切一部分；
BRepPrimAPI_MakeTorus类
生成环或环的一部分；
BRepPrimAPI_MakeWedge类
生成一个楔块或楔块的一部分；
BRepPrimAPI_MakePrism类
生成一个线性的swept,称为Prisms;它的基类是BRepPrimAPI_MakeSweep类；BRepPrimAPI_MakeSweep类的基类是
BRepBuilderAPI_MakeShape类
注意，原始基本图形不可以包含任何实体：
应用此类时：
--顶点“推移”成边：
TopoDS_Vertex V1 = BRepBuilderAPI_MakeVertex(gp_Pnt(-200.,-200.,0.));
Handle(AIS_Shape) ais1 = new AIS_Shape(V1);
TopoDS_Shape S1 = BRepPrimAPI_MakePrism(V1,gp_Vec(0.,0.,100.));
Handle(AIS_Shape) ais2 = new AIS_Shape(S1);
--边“推移”成面：.
TopoDS_Edge E = BRepBuilderAPI_MakeEdge(gp_Pnt(-150.,-150,0.), gp_Pnt(-50.,-50,0.));
Handle(AIS_Shape) ais3 = new AIS_Shape(E);
myAISContext->Display(ais3,Standard_False);
TopoDS_Shape S2 = BRepPrimAPI_MakePrism(E,gp_Vec(0.,0.,100.));
--Wires “推移”成Shells.
TopoDS_Edge E1 = BRepBuilderAPI_MakeEdge(gp_Pnt(0.,0.,0.), gp_Pnt(50.,0.,0.));
TopoDS_Edge E2 = BRepBuilderAPI_MakeEdge(gp_Pnt(50.,0.,0.), gp_Pnt(50.,50.,0.));
TopoDS_Edge E3 = BRepBuilderAPI_MakeEdge(gp_Pnt(50.,50.,0.), gp_Pnt(0.,0.,0.));
TopoDS_Wire W = BRepBuilderAPI_MakeWire(E1,E2,E3);
TopoDS_Shape S3 = BRepPrimAPI_MakePrism(W,gp_Vec(0.,0.,100.));
--Faces “推移”成Solids.
TopoDS_Face F = BRepBuilderAPI_MakeFace(gp_Pln(gp::XOY()),Wc);
Handle(AIS_Shape) ais7 = new AIS_Shape(F);
myAISContext->Display(ais7,Standard_False);
TopoDS_Shape S4 = BRepPrimAPI_MakePrism(F,gp_Vec(0.,0.,100.));
--Shells “推移”成复合实体
BRepPrimAPI_MakeRevol类
一个回转sweep体；
类继承关系和前面类似：BRepBuilderAPI_MakeShape--〉BRepPrimAPI_MakeSweep-->BRepPrimAPI_MakeRevol
，对于角度而言，范围是[0，2PI]，默认值是2PI，生成规则：
- Vertex -> Edge.
- Edge -> Face.
- Wire -> Shell.
- Face-> Solid.
- Shell-> CompSolid.
BRepOffsetAPI_MakePipe类
可以生成一个管道
类继承关系是：BRepBuilderAPI_MakeShape--〉BRepPrimAPI_MakeSweep-->BRepOffsetAPI_MakePipe
以下为生成一个管道的示例过程：
--利用生成一个WIRE，作为管道的路径:
Handle(Geom_BezierCurve) curve = new Geom_BezierCurve(CurvePoles);
TopoDS_Edge E = BRepBuilderAPI_MakeEdge(curve);
TopoDS_Wire W = BRepBuilderAPI_MakeWire(E);
--生成一个面，作为生成管道的截面：
gp_Circ c = gp_Circ(gp_Ax2(gp_Pnt(0.,0.,0.),gp_Dir(0.,1.,0.)),10.);
TopoDS_Edge Ec = BRepBuilderAPI_MakeEdge(c);
TopoDS_Wire Wc = BRepBuilderAPI_MakeWire(Ec);
TopoDS_Face F = BRepBuilderAPI_MakeFace(gp_Pln(gp::ZOX()),Wc);
--利用前两步生成的路径和截面来生成pipe:
TopoDS_Shape S = BRepOffsetAPI_MakePipe(W,F);
Handle(AIS_Shape) ais2 = new AIS_Shape(S);
BRepOffsetAPI_ThruSections类
此类继承自BRepBuilderAPI_MakeShape：创建一个loft,通过一组给定的sections，生成一个shell或一个solid;通常，section是wire;但是第一个和最后一个section可以是
vertices;
比如：
BRepOffsetAPI_ThruSections generator(Standard_False,Standard_True);
generator.AddWire(W1);
generator.AddWire(W2);
generator.AddWire(W3);
generator.AddWire(W4);
generator.Build();
TopoDS_Shape S1 = generator.Shape();
Handle(AIS_Shape) ais1 = new AIS_Shape(S1);
BRepBuilderAPI_MakePolygon类
创建一个polygonal wires，可以通过一组点或向量生成，也可以先生成一个空的对象，再添加点。
示例1：
BRepBuilderAPI_MakePolygon P;
P.Add(gp_Pnt(0.,0.,0.));
P.Add(gp_Pnt(200.,0.,0.));
P.Add(gp_Pnt(200.,200.,0.));
P.Add(gp_Pnt(0.,200.,0.));
P.Add(gp_Pnt(0.,0.,0.));
TopoDS_Wire W = P.Wire();
示例2：
TopoDS_Wire wprof = BRepBuilderAPI_MakePolygon(gp_Pnt(0.,0.,0.),gp_Pnt(-60.,-60.,-200.));
BRepOffsetAPI_MakeEvolved类
创建一个可展图形，它是通过一个planar spine (face or wire)和一个rofile (wire)来生成的，它是一个非循环的sweep (pipe),用profile沿着spline;自相交点将被移除；
比如：
--沿着一个spline，sweep一个profile;
Standard_EXPORT BRepOffsetAPI_MakeEvolved(const TopoDS_Face& Spine,const TopoDS_Wire& Profil,const GeomAbs_JoinType Join = GeomAbs_Arc,const Standard_Boolean
AxeProf = Standard_True,const Standard_Boolean Solid = Standard_False,const Standard_Boolean ProfOnSpine = Standard_False,const Standard_Real Tol = 0.0000001);
AxeProf参数如果为true,R是0,X,Y,Z;如果solid为真，结果为一个solid或复合的solids;
示例：
TopoDS_Shape
S = BRepOffsetAPI_MakeEvolved(W,wprof,GeomAbs_Arc,Standard_True,Standard_False,Standard_True,0.0001);
BRepBuilderAPI_ModifyShape类
当使用BRepTools来创建一个修改类，主要有以下派生类：
--BRepBuilderAPI_Copy:处理一个图形的拷贝；
--BRepBuilderAPI_Transform 和BRepBuilderAPI_GTransform：用来对一个图形应用几何变形；
--BRepBuilderAPI_NurbsConvert:用来将一个图形转化为NURBS几何体；
--BRepOffsetAPI_DraftAngle：创建一个tapered图形；
BRepOffsetAPI_DraftAngle类
创建一个tapered图形；一般过程是：
--初始化构造算法；
--输入要taper的特征面；
--实现算法；
--生成结果；
示例：
TopoDS_Shape S = BRepPrimAPI_MakeBox(200.,300.,150.);
BRepOffsetAPI_DraftAngle adraft(S);
TopExp_Explorer Ex;
for (Ex.Init(S,TopAbs_FACE); Ex.More(); Ex.Next()) {
TopoDS_Face F = TopoDS::Face(Ex.Current());
Handle(Geom_Plane) surf = Handle(Geom_Plane)::DownCast(BRep_Tool::Surface(F));
gp_Pln apln = surf->Pln();
gp_Dir dirF = apln.Axis().Direction();
if (dirF.IsNormal(gp_Dir(0.,0.,1.),Precision::Angular()))
adraft.Add(F, gp_Dir(0.,0.,1.), 15.*PI180, gp_Pln(gp::XOY()));
}
ais1->Set(adraft.Shape());
二：关于布尔等实体修改操作相关
此类的基类是BRepBuilderAPI_MakeShape类，它是一个抽象类；
可以应用的操作有：BOP_SECTION 、BOP_COMMON、BOP_FUSE、BOP_CUT、BOP_CUT21
有时会产生错误，无法达到想要的结果，根据返回值，可以得到错误信息，含义是：
0：OK
1： 对象创建完成，但结果为空；
2：源图形为空；
3：参数类型检查错误；
4：不能为DSFiller分配内存；
5：此种类型参数的Builder无法工作；
6：不允许的操作；
7：不能为Builder分配内存；
>100 参见Builder错误信息；
相关的方法介绍：
--TopTools_ListOfShape& SectionEdges()方法：返回一组截面的边，它们在布尔操作过程中生成；
--Standard_Boolean HasDeleted()方法：如果至少一个图形对象被删除了，返回为真；
--Standard_Boolean HasGenerated()方法：如果至少生成了一个图形，返回为真；
--Standard_Boolean HasModified()方法：如果至少一个图形被修改了，返回为真；
--TopTools_ListOfShape& Generated(const TopoDS_Shape& S) 方法：返回生成以后的图形的集合；
--TopTools_ListOfShape& Modified2(const TopoDS_Shape& aS)方法：返回修改后的图形的集合；
--Standard_Boolean IsDeleted(const TopoDS_Shape& aS)方法：如果图形S已经被删除，返回为真，即结果图形中不包括图形S；
-BOP_Operation Operation()方法：返回布尔操作的类型；
包括有BRepAlgoAPI_Cut类， BRepAlgoAPI_Fuse类，BRepAlgoAPI_Common类：布尔交集；
计算两个图形或几何体的截面，几何对象可以是平面的表面，转化为face.
示例：
给定两个图形S1和S2，计算在S1和S2上的边，在新曲线上生成近似值，结果在第一部分上而不在第二部分上：
Standard_Boolean PerformNow = Standard_False;
BRepBoolAPI_Section S(S1,S2,PerformNow);
S.ComputePCurveOn1(Standard_True);
S.Approximation(Standard_True);
S.Build();
TopoDS_Shape R = S.Shape();
如果结果为空，调用NotDone()；
常见方法：
--BRepAlgoAPI_Section(const Handle(Geom_Surface)& Sf1,const Handle(Geom_Surface)& Sf2,const Standard_Boolean
PerformNow = Standard_True);
用来生成线：
--两个图形SH1和SH2；
--图形SH和平面P1；
--表面SF和图形SH；
--两个表面SF1和SF2；
参数PerformNow如果为真，将直接计算结果，如果为假，表示后面将通过Build（）这个函数来计算结果；
生成后的图形是由方法Shape（）得出的；
这些相交的边是独立的，不在一个链表上，也不在一个wire上，如果不存在一个相交边，返回结果为空；
示例：
--计算相交的基本边--利用这些基本边创建一个相交线--决定相交线在两个图形的哪个图形的参数空间；
TopoDS_Shape S1 = ... , S2 = ... ;
Standard_Boolean PerformNow = Standard_False;
BRepAlgoAPI_Section S ( S1, S2, PerformNow );
S.ComputePCurveOn1 (Standard_True);
S.Approximation (Standard_True);
S.Build();
TopoDS_Shape R = S.Shape();
基类是BRepBuilderAPI_MakeShape；
构造在一个shell的边的园角；常用方法有
--void Add(const TopoDS_Edge& E) = 0;在builder上添加一个轮廓线；
--void ResetContour(const Standard_Integer IC) = 0;重置索引为IC的轮廓线；
--Standard_Integer NbContours() const = 0;返回轮廓线的数目；
--Standard_Integer Contour(const TopoDS_Edge& E) const = 0;返回边E的轮廓线的索引，如果边E不在轮廓线内，返回为O；
--Standard_Integer NbEdges(const Standard_Integer I) const = 0;返回在轮廓线I中的边数；
--void Remove(const TopoDS_Edge& E) = 0;移除一个边；
--Standard_Real Length(const Standard_Integer IC) const = 0;得到某个轮廓线的长度；
--TopoDS_Vertex FirstVertex(const Standard_Integer IC) const = 0;返回某个轮廓线的第一个顶点；LastVertex方法返回最后一个顶点；
--Abscissa方法，返回某个顶点的横坐标；
--Standard_Boolean ClosedAndTangent(const Standard_Integer IC) const如果某个轮廓线是封闭切线，返回为真；
--Standard_Boolean Closed(const Standard_Integer IC) const = 0;如果某个轮廓线是封闭，返回为真；
--Reset() = 0;重置所有；
创建一个园角；
示例一：
对一个BOX园角：
BRepFilletAPI_MakeFillet fillet(Box);
for (TopExp_Explorer ex(Box,TopAbs_EDGE); ex.More(); ex.Next()) {
TopoDS_Edge Edge =TopoDS::Edge(ex.Current());
fillet.Add(20,Edge);
}
示例二：
两个BOX，合并后园角；
TopoDS_Shape fusedShape = BRepAlgoAPI_Fuse(S1,S2);
BRepFilletAPI_MakeFillet fill(fusedShape);
for (TopExp_Explorer ex1(fusedShape,TopAbs_EDGE); ex1.More(); ex1.Next()) {
TopoDS_Edge E =TopoDS::Edge(ex1.Current());
fill.Add(E);
}
for (Standard_Integer i = 1;i<=fill.NbContours();i++) {
Standard_Real longueur(fill.Length(i));
Standard_Real Rad(0.15*longueur);
fill.SetRadius(Rad,i, 1);
}
TopoDS_Shape blendedFusedSolids = fill.Shape();
Handle(AIS_Shape) aBlend = new AIS_Shape(blendedFusedSolids);
示例三：
只园角其中一条边：
BRepFilletAPI_MakeFillet Rake(theBox);
TopExp_Explorer ex(theBox,TopAbs_EDGE);
ex.Next();
ex.Next();
ex.Next();
ex.Next();
Rake.Add(8,50,TopoDS::Edge(ex.Current()));
Rake.Build();
if (Rake.IsDone() ){
TopoDS_Shape evolvedBox = Rake.Shape();
ais1->Set(evolvedBox);
}
示例四：
园角一个园柱：
BRepFilletAPI_MakeFillet fillet(theCylinder);
TColgp_Array1OfPnt2d TabPoint2(1,20);
for (Standard_Integer i=0; i<=19; i++) {
gp_Pnt2d Point2d(i*2*PI/19,60*cos(i*PI/19-PI/2)+10);
TabPoint2.SetValue(i+1,Point2d);
}
TopExp_Explorer exp2(theCylinder,TopAbs_EDGE);
fillet.Add(TabPoint2,TopoDS::Edge(exp2.Current()));
fillet.Build();
if (fillet.IsDone() ){
TopoDS_Shape LawEvolvedCylinder = fillet.Shape();
ais3->Set(LawEvolvedCylinder);
myAISContext->Redisplay(ais3,Standard_False);
myAISContext->SetCurrentObject(ais3,Standard_False);
}
创建一个倒角；
基类：BRepFilletAPI_LocalOperation；
可以设置相关参数，比如倒角两个距离，角度等参数；
示例：
BRepFilletAPI_MakeChamfer MC(theBox);
// add all the edges to chamfer
TopTools_IndexedDataMapOfShapeListOfShape M;
TopExp::MapShapesAndAncestors(theBox,TopAbs_EDGE,TopAbs_FACE,M);
for (Standard_Integer i = 1;i<=M.Extent();i++) {
TopoDS_Edge E = TopoDS::Edge(M.FindKey(i));
TopoDS_Face F = TopoDS::Face(M.FindFromIndex(i).First());
MC.Add(5,5,E,F);
}
生成一个表面的外壳，注意，一个图形的外壳，不是一个由表面和厚度定义的实体模型，如果想要创建这种壳，需要使用BRepOffsetAPI_MakeOffsetShape，一个外壳是由一系列相互通过普通的边连接起来的面；如果表面是C2连续的，外壳将只有一个面；如果表面不是C2连续的，将把一些面细分成所有的面都是C2连续的，结果是外壳包含所有这些面；通过一个非C2连续的表面来生成一个外壳，一般过程是：--构造一个外壳对象--实现算法--生成结果；
注意：表面分解的这些C2面并没有缝合在一起，需要使用BRepOffsetAPI_Sewing，如果想实现带厚度的外壳，需要使用BRepOffsetAPI_MakeOffsetShape类；
BRepBuilderAPI_Sewing类
将多个邻近图形“缝合”成为一个图形；同时有多个边的情况下无法缝合；
一般操作过程是：
--创建一个空对象；
缺省的公差是1.E-06；
面分析；
缝合操作；
根据需要作剪操作；
--定义公差；
--添加要缝合的对象；
--计算生成；
--输出结果图形；
--如果需要可以输出自由边；
--如果需要可以输出多个边；
--输出其它问题；
主要方法：
--构造函数：
option1 如果为假表示只控制；
option2：分析退化的图形；
option3：为自由边的剪操作；
option4：未复制处理；
BRepBuilderAPI_Sewing(const Standard_Real tolerance = 1.0e-06,const Standard_Boolean option1 = Standard_True,const Standard_Boolean option2 = Standard_True,const Standard_Boolean option3 = Standard_True,const Standard_Boolean option4 = Standard_False);
如果必要，可以初始化参数；
void Init(const Standard_Real tolerance = 1.0e-06,const Standard_Boolean option1 = Standard_True,const Standard_Boolean option2 = Standard_True,const Standard_Boolean option3 = Standard_True,const Standard_Boolean option4 = Standard_False) ;
--添加一个要缝合的图形的方法是；
void Add(const TopoDS_Shape& shape) ;
--生成图形方法是：
void Perform() ;
--得到缝合后的图形方法是：
TopoDS_Shape& SewedShape() const;
--得到自由边（只被一个面共享的边）的数量方法是：
Standard_Integer NbFreeEdges() const;
--得到一个自由边的方法是：
const TopoDS_Edge& FreeEdge(const Standard_Integer index) const;
--得到复合边（被两个及以上面共享的边）的数量：
Standard_Integer NbMultipleEdges() const;
--得到其中的一个复合边：
const TopoDS_Edge& MultipleEdge(const Standard_Integer index) const;
--得到邻近边的数量：
Standard_Integer NbContigousEdges() const;
--得到其中一个邻近边：
const TopoDS_Edge& ContigousEdge(const Standard_Integer index) const;
--得到有一个邻近边的边的集合（截面）；
const TopTools_ListOfShape& ContigousEdgeCouple(const Standard_Integer index) const;
--一个截面是否是有边界的（使用SectionToBoundary方法之前）：
Standard_Boolean IsSectionBound(const TopoDS_Edge& section) const;
--得到成为截面的原始边。记住，截面是由普通边所组成的，这个信息对于控制来说是很重要的，因为通过原始边可以找到被附加的截面的表面；
const TopoDS_Edge& SectionToBoundary(const TopoDS_Edge& section) const;
--得到每一个退化的图形：
const TopoDS_Shape& DegeneratedShape(const Standard_Integer index) const;
--此图形是否是退化的图形：
Standard_Boolean IsDegenerated(const TopoDS_Shape& shape) const;
--此图形是否已被修改过：
Standard_Boolean IsModified(const TopoDS_Shape& shape) const;
--得到一个修改后的图形：
const TopoDS_Shape& Modified(const TopoDS_Shape& shape) const;
--子图形是否被修改过：
Standard_Boolean IsModifiedSubShape(const TopoDS_Shape& shape) const;
--得到一个修改过的子图形：
TopoDS_Shape ModifiedSubShape(const TopoDS_Shape& shape) const;
--得到每一个被删除的面：
const TopoDS_Face& DeletedFace(const Standard_Integer index) const;
--void Dump() const;打印相关信息；
--得到一个修改后的图形：
TopoDS_Face WhichFace(const TopoDS_Edge& theEdg,const Standard_Integer index = 1) const;
示例：
BRepOffsetAPI_Sewing aMethod;
aMethod.Add(FirstShape);
aMethod.Add(SecondShape);
aMethod.Perform();
TopoDS_Shape sewedShape = aMethod.SewedShape();
Handle(AIS_Shape) result = new AIS_Shape(sewedShape);
BRep_Tool类
提供了处理BRep图形几何对象的一些方法；
如果S是一个Solid,Shell,或Compound.返回为真；
Standard_Boolean IsClosed(const TopoDS_Shape& S) ;
返回在位置L处的几何表面：
Handle_Geom_Surface& Surface(const TopoDS_Face& F,TopLoc_Location& L) ;
返回面的几何表面，如果有一个位置可以是一个拷贝；
Handle_Geom_Surface Surface(const TopoDS_Face& F) ;
返回面的多边三角形，如果没有三角形返回一个空句柄：
const Handle_Poly_Triangulation& Triangulation(const TopoDS_Face& F,TopLoc_Location& L) ;
返加面的公差值：
Standard_Real Tolerance(const TopoDS_Face& F) ;
返回面的自然约束标志：
Standard_Boolean NaturalRestriction(const TopoDS_Face& F) ;
如果E是一个3D曲线或表面上的一个曲线，返回为真；
Standard_Boolean IsGeometric(const TopoDS_Edge& E) ;
返回边的3D曲线，可以是NULL，返回L位置，及参数范围；
Handle_Geom_Curve& Curve(const TopoDS_Edge& E,TopLoc_Location& L,Standard_Real& First,Standard_Real& Last) ;
返回边的3D多边形，返回多边形的位置L；
Handle_Poly_Polygon3D& Polygon3D(const TopoDS_Edge& E,TopLoc_Location& L)
TopLoc_Location类
一个Location 是一个复合的平移；对象类型是TopLoc_Datum3D；
常见方法：
--TopLoc_Location();
构造一个空的局部坐标系统对象；注意，这种被构造的缺省的数据为空；、
--TopLoc_Location(const gp_Trsf& T);
通过T构造一个局部坐标系统；
--TopLoc_Location(const Handle(TopLoc_Datum3D)& D);
通过3D datum D来构造一个局部坐标系统，如果平移T不能表达一个局部坐标系统，会引发构造异常；
--Standard_Boolean IsIdentity() const;如果此位置等于一个单位化平移，返回为真；
-- void Identity() ;设置位置为单位化平移；
--Handle_TopLoc_Datum3D& FirstDatum() 得到位置的第一个基础数据；
-- const TopLoc_Location& NextLocation() const;
另外，具有加减乘除，是否相等方法；
示例：
炸开一个立方体的六个面：
for (TopExp_Explorer exp (aBox,TopAbs_FACE);exp.More();exp.Next()) {
TopoDS_Face aCurrentFace = TopoDS::Face(exp.Current());
//测试当前面的方向
TopAbs_Orientation orient = aCurrentFace.Orientation();
//重新生成几何平面
TopLoc_Location location;
Handle (Geom_Surface) aGeometricSurface = BRep_Tool::Surface(aCurrentFace,location);
Handle (Geom_Plane) aPlane = Handle (Geom_Plane)::DownCast(aGeometricSurface);
//Build an AIS_Shape with a new color
//创建一个新的AIS_Shape
Handle(AIS_Shape) theMovingFace = new AIS_Shape(aCurrentFace);
Quantity_NameOfColor aCurrentColor = (Quantity_NameOfColor)j;
myAISContext->SetColor(theMovingFace,aCurrentColor,Standard_False);
myAISContext->SetMaterial(theMovingFace,Graphic3d_NOM_PLASTIC,Standard_False);
//查找每个面的法向量
gp_Pln agpPlane = aPlane->Pln();
gp_Ax1 norm = agpPlane.Axis();
gp_Dir dir = norm.Direction();
gp_Vec move(dir);
TopLoc_Location aLocation;
Handle (AIS_ConnectedInteractive) theTransformedDisplay = new AIS_ConnectedInteractive();
theTransformedDisplay->Connect(theMovingFace, aLocation);
// = myAISContext->Location(theMovingFace);
Handle (Geom_Transformation) theMove = new Geom_Transformation(aLocation.Transformation());
for (Standard_Integer i=1;i<=30;i++) {
theMove->SetTranslation(move*i);
if (orient==TopAbs_FORWARD) myAISContext->SetLocation(theTransformedDisplay,TopLoc_Location(theMove->Trsf()));
else myAISContext->SetLocation(theTransformedDisplay,TopLoc_Location(theMove->Inverted()->Trsf()));
myAISContext->Redisplay(theTransformedDisplay,Standard_False);
}
j+=15;
}
BRepAlgo类
BRepAlgo提供了一些布尔操作的服务；
注意，在BrepAlgoAPI包中提供了新的布尔操作，代替了旧的布尔操作；
方法：
--static Standard_Boolean IsValid(const TopoDS_Shape& S) ;检测图形是否合法；
--Standard_EXPORT static Standard_Boolean IsValid(const TopTools_ListOfShape& theArgs,const TopoDS_Shape&
theResult,const Standard_Boolean closedSolid = Standard_False,const Standard_Boolean GeomCtrl = Standard_True) ;
检查在结果图形中所生成和修改后的面是否合法，参数theArgs可以为空，表示所有的面都被检查；如果closedSolid 为真，表示只有封闭的图形合法，如果参数GeomCtrl为假，几何体的顶点和边不检查，自相交的新的wire也不检查；
--Standard_Boolean IsTopologicallyValid(const TopoDS_Shape& S) ;
也是检查图形是否合法，和前一个不同的是，检查 no geometric contols (intersection of wires, pcurve validity) are
performed.
GProp_GProps类
计算图元的属性；
gp_Trsf类
定义一个矩阵变换的类
--可以定义平移、旋转、缩放的矩阵；
--可以对称于一个点，一条线，一个平面；
示例一：
对称于一个点：
gp_Trsf theTransformation;
gp_Pnt PntCenterOfTheTransformation(110,60,60);
theTransformation.SetMirror(PntCenterOfTheTransformation);
示例二：
绕一个轴旋转：
gp_Trsf theTransformation;
gp_Ax1 axe = gp_Ax1(gp_Pnt(200,60,60),gp_Dir(0.,1.,0.));
theTransformation.SetRotation(axe,30*PI/180);
示例三：
缩放：
gp_Trsf theTransformation;
gp_Pnt theCenterOfScale(200,60,60);
theTransformation.SetScale(theCenterOfScale,0.5);
示例四：
平移：
gp_Trsf theTransformation;
gp_Vec theVectorOfTranslation(-6,-6,6);
theTransformation.SetTranslation(theVectorOfTranslation);
示例五：
Displacement：
TopoDS_Shape S = BRepPrimAPI_MakeWedge(60.,100.,80.,20.);
gp_Trsf theTransformation;
gp_Ax3 ax3_1(gp_Pnt(0,0,0),gp_Dir(0,0,1));
gp_Ax3 ax3_2(gp_Pnt(60,60,60),gp_Dir(1,1,1));
theTransformation.SetDisplacement(ax3_1,ax3_2);
BRepBuilderAPI_Transform myBRepTransformation(S,theTransformation);
TopoDS_Shape TransformedShape = myBRepTransformation.Shape();
示例六：
变形
gp_GTrsf theTransformation;
gp_Mat rot(1, 0, 0, 0, 0.5, 0, 0, 0, 1.5);
theTransformation.SetVectorialPart(rot);
theTransformation.SetTranslationPart(gp_XYZ(5,5,5));
BRepBuilderAPI_GTransform myBRepTransformation(S,theTransformation);
TopoDS_Shape S2 = myBRepTransformation.Shape();
BuilderAPI_MakeEdge类
定义一生成一个边；此类有多个构造函数，现举其中一个介绍如下：
Standard_EXPORT BRepBuilderAPI_MakeEdge(const Handle(Geom2d_Curve)& L,const Handle(Geom_Surface)& S,const TopoDS_Vertex& V1,const TopoDS_Vertex& V2,const Standard_Real p1,const Standard_Real p2);
其参数含义是：
顶点V1和V2用来限制曲线（定义边的约束），值p1和p2为顶点的参数；
曲线可以定义成在一个表面的2D曲线，应用缺省的公差；
参数规则：
对于曲线来说：
--句柄不能为空；
--如果曲线是一个trimmed曲线，使用基础曲线；
对于顶点来说：
--可以为空，表示此参数为无限大；静态方法 Precision::Infinite()用来定义一个无限大的数；
--两个顶点如果位于同一位置，必须一样，当曲线是封闭时使用相同的顶点；
对于参数来说：
--参数为必须在曲线参数范围内，如果曲线是trimmed,使用基础曲线；如果边的条件不满足，返回BRepAPI_ParameterOutOfRange错误；
--参数值不能相等，如果条件不满足，边无法创建，返回BRepAPI_LineThroughIdenticPoints错误；
--参数值可以这样给出C->FirstParameter()
--如果参数值需要切换，比如第一个顶点的参数为P2，第二个顶点的参数为P1，边的方向可以“reversed”；
--对于一个周期曲线，值P1和P2可以通过加或减周期来得到；
--参数值可以无限大，在对应的方向上边是开放的。然而，对应的顶点必须是空图形，如果条件不满足，边无法创建，返回BRepAPI_PointWithInfiniteParameter错误；
--参数值可以被忽略，将通过曲线上的投影进行计算；
--可以给定空间三维点；
BRepFeat_MakePipe类
基类为：BRepFeat_Form；
通过基本图形生成一个Pipe;
BRepFeat_MakeLinearForm 类
基类为：BRepFeat_RibSlot
在一个平面表面上建一个肋或开凹槽；
BRepFeat_Gluer类
粘合两个实体为一个实体；
示例：
（1）：创建两个BOX，并找到要粘合的面；
（2）：创建要粘合的对象：
BRepFeat_Gluer glue2(S4,S3);
（3）：用两个面粘合对象；
glue2.Bind(F4,F3);
（4）：重新生成对象：
LocOpe_FindEdges CommonEdges(F4,F3);
for (CommonEdges.InitIterator(); CommonEdges.More(); CommonEdges.Next())
glue2.Bind(CommonEdges.EdgeFrom(),CommonEdges.EdgeTo());
TopoDS_Shape res2 = glue2.Shape();
myAISContext->Erase(ais3,Standard_False,Standard_False);
ais4->Set(res2);
myAISContext->Redisplay(ais4,Standard_False);
Graphic2d_Polyline类
创建一个多边形．
常见方法：
--Length()得到线的点数；
--void Values(const Standard_Integer aRank,Quantity_Length& X,Quantity_Length& Y) const;得到序号为aRank的点；
--void DrawElement(const Handle(Graphic2d_Drawer)& aDrawer,const Standard_Integer anIndex) ;绘制多边形的一条边；
--void DrawVertex(const Handle(Graphic2d_Drawer)& aDrawer,const Standard_Integer anIndex) ;绘制多边形的一个顶点；
--Standard_Boolean Pick(const Standard_ShortReal X,const Standard_ShortReal Y,const Standard_ShortReal aPrecision,const Handle(Graphic2d_Drawer)& aDrawer) ;得到此多边形是否被拾取，注意：PickIndex()方法得到的是最后拾取的点，如果拾取点在线的内部，返回０；
Graphic2d_Line类
是Polyline, Circle ... 等图元的基类；
常见方法：
--SetWidthIndex(const Standard_Integer anIndex) ;得到在width map中的宽度的索引；设定对应的线宽值；
--SetTypeIndex(const Standard_Integer anIndex) ;设置线型；
--SetInteriorColorIndex(const Standard_Integer anIndex) ;设置颜色；
--void SetDrawEdge(const Standard_Boolean aDraw) ;设置边是否绘出，注意，这种情况下，polygon的类型必须为：
Graphic2d_TOPF_FILLED 或者 Graphic2d_TOPF_PATTERNED；
--SetInteriorPattern(const Standard_Integer anIndex) ;定义封闭线的内部图案，polygon的填充类型必须是：Graphic2d_TOPF_PATTERNED；
--SetTypeOfPolygonFilling(const Graphic2d_TypeOfPolygonFilling aType) ;定义封闭线的图案，TypeOfPolygonFilling可选类型有：
- Graphic2d_TOPF_EMPTY - Graphic2d_TOPF_FILLED - Graphic2d_TOPF_PATTERNED ；
--Standard_Integer InteriorColorIndex() const;得到颜色索引；
--Standard_Integer InteriorPattern() const;得到所使用的图案索引；
--Graphic2d_TypeOfPolygonFilling TypeOfPolygonFilling() const;得到多边形填充模式；
Graphic2d_Primitive类
是Graphic2d_Line类的基类，
常见方法：
--得到及获取颜色索引；
--得到图元元素的数量和顶点的数量：
Standard_Integer NumOfElemIndices() const;
Standard_Integer NumOfVertIndices() const;
--Standard_Integer PickedIndex() const;得到最后拾取的图元元素的索引值；
--void Highlight(const Standard_Integer anIndex = 0) ;高亮显示图元或图元的一部分，当anIndex＝０表示所有的图元高亮显示，>0为当所要求的图元元素高亮显示时，<0为所要求的顶点高亮显示时；
--void Unhighlight() ;禁止图元高亮显示；
-- Standard_Boolean IsHighlighted() const;图元是否高亮显示；
--Handle_TColStd_HSequenceOfInteger HighlightIndices() const;得到图元高亮显示的索引序列；
--void SetDisplayMode(const Standard_Integer aMode) ;设置图元显示的模式；
--Standard_Integer DisplayMode() const;得到图元显示的模式；
--Standard_Boolean Graphic2d_GraphicObject::Pick(const Standard_Real X,const Standard_Real Y,const Standard_Real aPrecision,const Handle(Graphic2d_Drawer)& aDrawer) ;
用一个矩形框拾取图形对象，如果图形对象被拾取，返回为真，通过方法Graphic2d_View::Pick调用；
--Standard_Boolean Graphic2d_GraphicObject::PickByCircle(const Standard_Real X,const Standard_Real Y,const Standard_Real Radius,const Handle(Graphic2d_Drawer)& aDrawer) ;
用一个园来拾取图形对象，如果图形对象被拾取，返回为真，通过方法Graphic2d_View::PickByCircle调用；
--Standard_Boolean Graphic2d_GraphicObject::Pick(const Standard_Real Xmin,const Standard_Real Ymin,const Standard_Real Xmax,const Standard_Real Ymax,const Handle(Graphic2d_Drawer)& aDrawer,const Graphic2d_PickMode aPickMode) ;
以下情况下返回值为真：
包括在矩形内：included in rectangle (),
不在矩形内：excluded from rectangle (),
相交于矩形框：intersected by rectangle (),
通过 Xmin, Ymin, Xmax, Ymax定义矩形框。
--得到所有在图元内的markers的最小最大值，注意，如果me为空，或未显示，或没有markers返回为假，
Minx = Miny = RealFirst () ；Maxx = Maxy = RealLast ()
Standard_EXPORT Standard_Boolean Graphic2d_GraphicObject::MarkerMinMax(Quantity_Length& Minx,Quantity_Length& Maxx,Quantity_Length& Miny,Quantity_Length& Maxy) const;
--移除图元；Standard_EXPORT void Graphic2d_GraphicObject::RemovePrimitive(const Handle(Graphic2d_Primitive)& aPrimitive) ;
--绘制图元，以默认的图元属性绘制；void Graphic2d_TransientManager::Draw(const Handle(Graphic2d_Primitive)& aPrimitive) ;
AIS2D_InteractiveObject类
使用显示和选择服务，来可视化和选择机制，交互式对象常用来显示数据，曲线，图形，markers,尺寸标注等。
常用方法：
--获取及设置属性
Handle_Prs2d_Drawer Attributes() const;
void SetAttributes(const Handle(Prs2d_Drawer)& aDrawer) ;
--通过Aspect设置属性，到所有图元分配这个Aspect.
Standard_EXPORT void SetAspect(const Handle(Prs2d_AspectRoot)& anAspect) ;
--通过Aspect设置属性,到所有通过InteractiveContext被链接的图元对象；
Standard_EXPORT void SetAspect(const Handle(Prs2d_AspectRoot)& anAspect,const Handle(Graphic2d_Primitive)& aPrimitive) ;
--得到图元的Aspect;
Standard_EXPORT Handle_Prs2d_AspectRoot GetAspect(const Handle(Graphic2d_Primitive)& aPrimitive) const;
--如果图元用一个aspect链接的话返回为真；
Standard_EXPORT Standard_Boolean HasAspect(const Handle(Graphic2d_Primitive)& aPrimitive) const;
--指出交互对象是否有一个交互上下文设备；
Standard_EXPORT Standard_Boolean HasInteractiveContext() const;
--得到交互对象的上下文设备；
Standard_EXPORT Handle_AIS2D_InteractiveContext GetContext() const;
Graphic2d_GraphicObject类
是AIS2D_InteractiveObject类的基类；在一个view内创建一个图形对象，一个图形对象管理一系列图元；默认值为：空，可输出，可绘制，可拾取，不显示，不高亮，优先权为０；
主要方法：
设置视图，设置一个变形，设置获取图层，设置获取优先权，禁用/使用输出，是否可输出，禁用/使用Draw.是否可显示，Erase，高亮显示，颜色，拾取等；
Graphic2d_ImageFile类
定义一个图像，以图像的中心位置作为插入点，Ｘ，Ｙ定义在模型空间的位置，adx,ady 定义在设备空间的偏移量.ascale定义一个缩放系数；
Aspect_WidthMap类
定义一个WidthMap集合对象；
主要方法有，
--添加一个入口：
Standard_Integer AddEntry(const Aspect_WidthOfLine aStyle) ;
void AddEntry(const Aspect_WidthMapEntry& AnEntry) ;
Standard_Integer AddEntry(const Quantity_Length aStyle) ;
--根据索引得到一个入口：
Aspect_WidthMapEntry Entry(const Standard_Integer AnIndex) const;
示例：
--定义private :
Handle(Aspect_WidthMap) myWidthMap;
--遍历：
for(int i =1;i<=myWidthMap->Size();i++)
{
Aspect_WidthMapEntry aWidthMapEntry = myWidthMap->Entry(i);
}
--得到一个入口： Aspect_WidthMapEntry aWidthMapEntry = myWidthMap->Entry(CurrentSelectionIndex);
Aspect_TypeMap类
定义一个线型集合对象：
Aspect_MarkMap类
定义一个MarkMap集合对象；
Aspect_FontMap类
定义一个字体集合对象；
Aspect_ColorMap类
定义一个颜色集合对象；
GGraphic2d_SetOfCurves类
基类是：Graphic2d_Line；
定义一图元为由多个curves 的集合；主要方法有添加一个curves, 得到curves的数量，得到其中一个curves等；只绘制其中一个元素，是否为拾取状态；
示例：
Handle(Prs2d_AspectLine) aLineAspect = new Prs2d_AspectLine;
aLineAspect->SetTypeOfFill(Graphic2d_TOPF_EMPTY);
aLineAspect->SetTypeIndex(...);
aLineAspect->SetColorIndex(...);
aLineAspect->SetWidthIndex(...);
Handle(Graphic2d_SetOfCurves) segment;
segment = new Graphic2d_SetOfCurves(this);
segment->Add(myGeom2dCurve);
将此曲线集合应用所定义的线型线宽等；
SetAspect(aLineAspect, segment);
创建交互式对象相关的类介绍
AIS_Line
此类的继承关系是：
Standard_Transient->MMgt_TShared->PrsMgr_PresentableObject-->SelectMgr_SelectableObject-->AIS_InteractiveObject－>AIS_Line
Standard_Transient:抽象类，主要定义分配空间，得到类型，引用计数等；
MMgt_TShared：抽象类，主要用来管理对象的内存；
PrsMgr_PresentableObject类：表示一个可表达的二维或三维图形对象；主要方法有设置位置，更新，图形类型等；
此类的派生类类型有：
-AIS_InteractiveObject
-AIS_ConnectedInteractive
-AIS_MultipleConnectedInteractive
-AIS_Shape
SelectMgr_SelectableObject类：表示一个可选择的对象；
AIS_Line，AIS_Circle等类
定义一个直线，园等；主要方法有，返回对象的类型，设置线宽，线型，颜色等；
示例：
GC_MakeCircle C(gp_Pnt(-100.,-300.,0.),gp_Pnt(-50.,-200.,0.),gp_Pnt(-10.,-250.,0.));
Handle(AIS_Circle) anAISCirc = new AIS_Circle(C.Value());
myAISContext->Display(anAISCirc);
AIS_InteractiveContext类
交互式设备类，可以用它来管理交互式图形对象，可以在一个或多个视图中。如果图形对象已经装入交互式设备，可以直接调用交互式对象的方法。
使用设备时必须区分两种状态：
－没有打开本地设备。也称为不确定点；
－打开了一个或多个设备；
有的方法可以使用在打开的设备中，有的方法用在关闭的设备中，有的方法与设备状态无关；
--当想工作在一个入口类型上，应设置选项UseDisplayedObjects为假，可显示对象可以重新可视化交互对象；
--当使用缺省的选项来打开一个设备时，注意：
：可视化的交互对象在缺省选择模式下是活动的，必须分离那些不想使用的对象；
：交互式对象可以自动分解为子图形；
：“临时的”交互对象不会自动计入总数，，如果想使用它，必须手动装载它；
使用过程是：
－－用正确的选项打开设备；
－－装载／显示对象；
－－如果需要，激活标准模式；
－－创建一个过滤器，添加到设备中；
－－查找／选择／重置所需的入口；
－－根据索引关闭设备；
－－创建一个交互设备编辑器很有用，可以设置不同的设备用不用的选择／表达方式；
常见方法：
--如果没有设备打开，交互对象没有显示模式，缺省的显示模式是０，如果一个设备是打开的并且更新为假，对象不会更新显示。
void Display(const Handle(AIS_InteractiveObject)& anIobj,const Standard_Integer amode,const Standard_Integer
aSelectionMode,const Standard_Boolean updateviewer = Standard_True,const Standard_Boolean allowdecomposition =
Standard_True) ;
--使用给定的选择模式载入一个交互对象：
void Load(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Integer SelectionMode = -1,const Standard_Boolean
AllowDecomp = Standard_False) ;
--擦除一个对象：如果putinCollector为假，对象被擦除但不放入集合中；
void Erase(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Boolean updateviewer = Standard_True,const
Standard_Boolean PutInCollector = Standard_True) ;
--擦除视图集合中的每个对象；
void EraseAll(const Standard_Boolean PutInCollector = Standard_True,const Standard_Boolean updateviewer = Standard_True) ；
--从集合中显示所有对象；
void DisplayAll(const Standard_Boolean OnlyFromCollector = Standard_True,const Standard_Boolean updateviewer =
Standard_True) ;
--从集合中显示一个对象；
void DisplayFromCollector(const Handle(AIS_InteractiveObject)& anIObj,const Standard_Boolean updateviewer = Standard_True)
--擦除选择的对象；
void EraseSelected(const Standard_Boolean PutInCollector = Standard_True,const Standard_Boolean updateviewer =
Standard_True) ;
--改变临时对象的状态，
Standard_Boolean KeepTemporary(const Handle(AIS_InteractiveObject)& anIObj,const Standard_Integer InWhichLocal = -1) ;
--从所有的视图中移除交互对象；
void Clear(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Boolean updateviewer = Standard_True) ;
--从每个视图中移除对象；
void Remove(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Boolean updateviewer = Standard_True) ;
--从所有打开的设备中移除所有对象；
void RemoveAll(const Standard_Boolean updateviewer = Standard_True) ;
--通过鼠标动态检测，感知的图元被高亮显示。缺省的鼠标移过时的颜色为白色。
void Hilight(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Boolean updateviewer = Standard_True) ;
--改变视图中线的颜色；
void HilightWithColor(const Handle(AIS_InteractiveObject)& aniobj,const Quantity_NameOfColor aCol,const Standard_Boolean updateviewer = Standard_True) ;
--从入口对象中移除高亮；更新视图；
void Unhilight(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Boolean updateviewer = Standard_True) ;
--设置显示的优先权；
void SetDisplayPriority(const Handle(AIS_InteractiveObject)& anIobj,const Standard_Integer aPriority) ;
--设置所看到的交互对象的显示模式；
void SetDisplayMode(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Integer aMode,const Standard_Boolean
updateviewer = Standard_True) ;
--设置/移除交互对象的选择模式：
void SetSelectionMode(const Handle(AIS_InteractiveObject)& aniobj,const Standard_Integer aMode) ;
void UnsetSelectionMode(const Handle(AIS_InteractiveObject)& aniobj) ;
--设置感知的精度：
void SetSensitivity(const Standard_Real aPrecision) ;
--定义当前选择感知的像素：
void SetSensitivity(const Standard_Integer aPrecision = 4) ;
--设置/重置初始图形的位置；如果有一个位置返回为真；
void SetLocation(const Handle(AIS_InteractiveObject)& aniobj,const TopLoc_Location& aLocation) ;
void ResetLocation(const Handle(AIS_InteractiveObject)& aniobj) ;
Standard_Boolean HasLocation(const Handle(AIS_InteractiveObject)& aniobj) const;
得到实体对象的位置；
const TopLoc_Location& Location(const Handle(AIS_InteractiveObject)& aniobj) const;
--改变当前面的模式；缺省模式是Aspect_TOFM_TWO_SIDE。意味着属性在前面和后面都应用；
void SetCurrentFacingModel(const Handle(AIS_InteractiveObject)& aniobj,const Aspect_TypeOfFacingModel aModel =
Aspect_TOFM_BOTH_SIDE) ;
--设置／获得三角形的尺寸，缺省值是１００mm.
void SetTrihedronSize(const Standard_Real aSize,const Standard_Boolean updateviewer = Standard_True) ;
Standard_Real TrihedronSize() const;
--设置／获取平面的尺寸：
Standard_EXPORT void SetPlaneSize(const Standard_Real aSizeX,const Standard_Real aSizeY,const Standard_Boolean
updateviewer = Standard_True) ;
--得到实体对象的显示状态；
AIS_DisplayStatus DisplayStatus(const Handle(AIS_InteractiveObject)& anIobj) const;
--得到实体对象的显示模式的列表：
const TColStd_ListOfInteger& DisplayedModes(const Handle(AIS_InteractiveObject)& aniobj) const;
--关于绘制隐藏线相关的一些函数，通过名称就可以知道函数的意思；
EnableDrawHiddenLine（）；
DisableDrawHiddenLine（）；
Standard_Boolean DrawHiddenLine()；
--设置／得到ＵＶ等高参数；等高参数是否可用；
Standard_Integer IsoNumber(const AIS_TypeOfIso WhichIsos = AIS_TOI_Both) ;
--设置／添加／移除当前对象.....
InitCurrent() ;MoreCurrent();NextCurrent();
Standard_Boolean IsCurrent(const Handle(AIS_InteractiveObject)& aniobj) const;
Handle_AIS_InteractiveObject Current() const;
Handle_AIS_InteractiveObject FirstCurrentObject() ;
void HilightCurrents(const Standard_Boolean updateviewer = Standard_True) ;
void UnhilightCurrents(const Standard_Boolean updateviewer = Standard_True) ;
void ClearCurrents(const Standard_Boolean updateviewer = Standard_True) ;
