创建基本形状

基本形状包括方盒，圆柱，圆锥/圆台，球，圆环。

方盒

AMCAX::MakeBox 类提供创建方盒的功能。

AMCAX::TopoShape box = AMCAX::MakeBox(AMCAX::Point3(-5.0, -5.0, 0.0), AMCAX::Point3(5.0, 5.0, 3.0));

AMCAX::MakeBox

创建立方体的类

定义 MakeBox.hpp:18

AMCAX::TopoShape

形状的基类，包含具有位置和方向信息的基础形状

定义 TopoShape.hpp:15

AMCAX::Point3

PointT< double, 3 > Point3

三维点

定义 PointT.hpp:459

圆柱

AMCAX::MakeCylinder 类提供创建圆柱的功能。

AMCAX::TopoShape cylinder = AMCAX::MakeCylinder(AMCAX::Frame3(AMCAX::Point3(0.0, 0.0, 0.0), AMCAX::Direction3(0.0, 0.0, 1.0)), 3.0, 5.0);

AMCAX::MakeCylinder

创建圆柱体的类

定义 MakeCylinder.hpp:16

AMCAX::Direction3

DirectionT< double, 3 > Direction3

三维方向

定义 DirectionT.hpp:587

AMCAX::Frame3

FrameT< double, 3 > Frame3

三维标架

定义 FrameT.hpp:885

圆锥/圆台

AMCAX::MakeCone 类提供创建圆锥/圆台的功能。

AMCAX::TopoShape cone = AMCAX::MakeCone(4.0, 0.0, 4.0);

AMCAX::MakeCone

创建圆锥体的类

定义 MakeCone.hpp:16

球

AMCAX::MakeSphere 类提供创建球的功能。

AMCAX::TopoShape sphere = AMCAX::MakeSphere(AMCAX::Point3(-3.0, 0.0, 0.0), 1.0);

AMCAX::MakeSphere

创建球体的类

定义 MakeSphere.hpp:16

圆环

AMCAX::MakeTorus 类提供创建圆环的功能。

AMCAX::TopoShape torus = AMCAX::MakeTorus(AMCAX::Frame3(AMCAX::Point3(0.0, 0.0, 2.0), AMCAX::Direction3(1.0, 0.0, 0.0)), 4.0, 2.0);

AMCAX::MakeTorus

创建圆环的类

定义 MakeTorus.hpp:19

布尔运算

布尔运算功能包括融合，求交，剪切，分割，计算截面线。

融合

AMCAX::BoolBRepFuse 类提供融合功能。

AMCAX::TopoShape shape1, shape2;
AMCAX::OCCTIO::OCCTTool::Read(shape1, "./data/part.brep");
AMCAX::OCCTIO::OCCTTool::Read(shape2, "./data/box.brep");
//Fuse
AMCAX::TopoShape fuse = AMCAX::BoolBRepFuse(shape1, shape2);

求交

AMCAX::BoolBRepCommon 类提供求交功能。

AMCAX::TopoShape shape1, shape2;
AMCAX::OCCTIO::OCCTTool::Read(shape1, "./data/part.brep");
AMCAX::OCCTIO::OCCTTool::Read(shape2, "./data/box.brep");
//Common
AMCAX::TopoShape common = AMCAX::BoolBRepCommon(shape1, shape2);

剪切

AMCAX::BoolBRepCut 类提供剪切功能。

AMCAX::TopoShape cone = AMCAX::MakeCone(4, 0, 4);
AMCAX::TopoShape sphere = AMCAX::MakeSphere(4.0);
//Cut
AMCAX::TopoShape cut = AMCAX::BoolBRepCut(sphere, cone);

分割

AMCAX::BoolBRepSplitter 类提供分割功能。

AMCAX::TopoShape shape1, shape2;
AMCAX::OCCTIO::OCCTTool::Read(shape1, "./data/part.brep");
AMCAX::OCCTIO::OCCTTool::Read(shape2, "./data/box.brep");
//Splitter
AMCAX::BoolBRepSplitter splitter;
auto tool_shape = std::list{ shape1 };
auto tool_argument = std::list{ shape2 };
splitter.SetTools(tool_shape);
splitter.SetArguments(tool_argument);
AMCAX::TopoShape split = splitter.Shape();

计算交线

AMCAX::BoolBRepSection 类提供计算交线功能，结果会保存为 TopoCompound。

AMCAX::TopoShape cone = AMCAX::MakeCone(4, 0, 4);
AMCAX::TopoShape sphere = AMCAX::MakeSphere(4.0);
AMCAX::TopoShape section = AMCAX::BoolBRepSection(cone, sphere);

像上述这样直接调用接口得到的结果，不会计算在形状中的参数曲线。若想计算参数曲线，需要先初始化，然后再计算交线。

AMCAX::TopoShape cone = AMCAX::MakeCone(4, 0, 4);
AMCAX::TopoShape sphere = AMCAX::MakeSphere(4.0);
 
AMCAX::BoolBRepSection section;
section.Init1(cone);
section.ComputePCurveOn1(true);
section.Init2(sphere);
section.ComputePCurveOn2(true);
section.Build();
AMCAX::TopoShape result = section.Shape();

扫掠操作

拉伸

AMCAX::MakePrism 类提供拉伸（扫掠）功能。

AMCAX::MakeGeom3Ellipse makeEllipse(AMCAX::Frame3(), 3.0, 1.0);
std::shared_ptr<AMCAX::Geom3Curve> curve = makeEllipse.Value();
AMCAX::TopoEdge e = AMCAX::MakeEdge(curve);
AMCAX::TopoWire w = AMCAX::MakeWire(e);
AMCAX::TopoFace f = AMCAX::MakeFace(w);
//Make an extrusion shape
AMCAX::TopoShape s = AMCAX::MakePrism(f, AMCAX::Vector3(0.0, 0.0, 1.0));

旋转

AMCAX::MakeRevol 类提供旋转（扫掠）功能。

std::vector<AMCAX::Point3> poles{ AMCAX::Point3(1.0, 0.0, 0.0), AMCAX::Point3(0.8, 0.0, 0.5), AMCAX::Point3(1.0, 0.0, 1.0) };
auto bz = std::make_shared<AMCAX::Geom3BezierCurve>(poles);
AMCAX::TopoEdge e = AMCAX::MakeEdge(bz);
//Make a revolved shape
AMCAX::TopoShape revolshape = AMCAX::MakeRevol(e, AMCAX::CartesianCoordinateSystem::OZ());

管道

通过指定脊线（线框-Wire）和轮廓（形状-Shape）来创建管道。可通过 AMCAX::MakePipe 或 AMCAX::MakePipeShell 实现。MakePipe 为简单的管道算法，仅适用单个截面（平面形状）和光滑轨道。MakePipeShell 为更完备的管道算法，支持多个截面（平面形状），支持轨道不光滑。但路径（不应当有自相交）必须和截面平面相交。需要注意的是：Add 只能是 TopoWire 或 TopoVertex。

//Makepipe
//Make a face
double radius = 0.1;
AMCAX::Frame3 aFrame(AMCAX::Point3(0., 0., 0.), AMCAX::Direction3(-8.57143, 0., 4.));
AMCAX::Circle3 aCircle = AMCAX::Circle3(aFrame, radius);
AMCAX::TopoEdge aEdge = AMCAX::MakeEdge(aCircle);
AMCAX::TopoWire aWire = AMCAX::MakeWire(aEdge);
AMCAX::TopoFace aFace = AMCAX::MakeFace(aWire);
//Make a curve
std::vector<AMCAX::Point3> pointSet;
pointSet.push_back(AMCAX::Point3(0., 0., 0.));
pointSet.push_back(AMCAX::Point3(-1., 0., 1.));
pointSet.push_back(AMCAX::Point3(0., 0., 2.));
pointSet.push_back(AMCAX::Point3(1., 0., 3.));
pointSet.push_back(AMCAX::Point3(0., 0., 4.));
std::shared_ptr<AMCAX::Geom3BSplineCurve> aBSplineCurve = AMCAX::NURBSAPIInterpolate::InterpolatePoints(pointSet,
    2, false, AMCAX::ApproxParameterizationType::Centripetal);
//Make a wire
AMCAX::TopoEdge aSpineEdge = AMCAX::MakeEdge(aBSplineCurve);
AMCAX::TopoWire aSpineWire = AMCAX::MakeWire(aSpineEdge);
//Make a pipe
AMCAX::TopoShape aPipe = AMCAX::MakePipe(aSpineWire, aFace);
 
//MakePipeShell
AMCAX::MakePipeShell ps(aSpineWire);
ps.Add(aWire, false, false);
ps.Build();

放样操作

AMCAX::MakeLoft 类提供放样功能。添加若干 Wire，可以放样出 Shell 或 Solid。

//Make a polygon
AMCAX::Point3 aPoint1(1.0, 0.0, 0.0);
AMCAX::Point3 aPoint2(-0.5, std::sqrt(3.0) * 0.5, 0.0);
AMCAX::Point3 aPoint3(-0.5, -std::sqrt(3.0) * 0.5, 0.0);
AMCAX::MakePolygon aPolygon(aPoint1, aPoint2, aPoint3, true);
//Get the polygon wire
AMCAX::TopoWire bottomWire = aPolygon.Wire();
//Get the top wire 
AMCAX::Transformation3 aTransform;
aTransform.SetRotation(AMCAX::CartesianCoordinateSystem::OZ(), -AMCAX::Constants::pi / 6.0);
aTransform.SetTranslationPart(AMCAX::Vector3(0.0, 0.0, 3.0));
AMCAX::TopoWire topWire = AMCAX::TopoCast::Wire(AMCAX::TransformShape(bottomWire, aTransform));
//Make a lofting shape
AMCAX::MakeLoft aMakeLoft(true, true);
aMakeLoft.AddWire(bottomWire);
aMakeLoft.AddWire(topWire);
aMakeLoft.Build();
AMCAX::TopoShape loft = aMakeLoft.Shape();

边缘处理

圆角

圆角是取代锋利边缘的光滑面。 AMCAX::MakeFillet 类和 AMCAX::MakeFillet2d 类提供圆角的功能。

MakeFillet（圆角）

AMCAX::TopoShape box = AMCAX::MakeBox(AMCAX::Point3(-5.0, -5.0, -5.0), AMCAX::Point3(5.0, 5.0, 5.0));
//Get the edge in box
AMCAX::IndexSet<AMCAX::TopoShape> edges;
AMCAX::TopoExplorerTool::MapShapes(box, AMCAX::ShapeType::Edge, edges);
AMCAX::TopoShape e1 = edges[0];
//Make fillet
AMCAX::MakeFillet mf(box);
mf.Add(1.0, AMCAX::TopoCast::Edge(e1));
mf.Build();
AMCAX::TopoShape box_fillet = mf.Shape();

MakeFillet2d（平面圆角）

AMCAX::TopoShape box = AMCAX::MakeBox(AMCAX::Point3(-5.0, -5.0, -5.0), AMCAX::Point3(5.0, 5.0, 5.0));
//Get the face in box
AMCAX::IndexSet<AMCAX::TopoShape> faces;
AMCAX::TopoExplorerTool::MapShapes(box, AMCAX::ShapeType::Face, faces);
AMCAX::TopoShape f = faces[0];
AMCAX::TopoFace f1 = AMCAX::TopoCast::Face(f);
//Get the vertex in f1
AMCAX::IndexSet<AMCAX::TopoShape> vertex;
AMCAX::TopoExplorerTool::MapShapes(f1, AMCAX::ShapeType::Vertex, vertex);
AMCAX::TopoShape v1 = vertex[0];
//Make fillet2d
AMCAX::MakeFillet2d mf2d(AMCAX::TopoCast::Face(f1));
mf2d.AddFillet(AMCAX::TopoCast::Vertex(v1), 1.0);
mf2d.Build();
AMCAX::TopoShape box_fillet2d = mf2d.Shape();

倒角

AMCAX::MakeChamfer 类提供倒角功能。

AMCAX::TopoShape box = AMCAX::MakeBox(AMCAX::Point3(-5.0, -5.0, -5.0), AMCAX::Point3(5.0, 5.0, 5.0));
//Get the edge in box
AMCAX::IndexSet<AMCAX::TopoShape> edges;
AMCAX::TopoExplorerTool::MapShapes(box, AMCAX::ShapeType::Edge, edges);
AMCAX::TopoShape e1 = edges[0];
//Perform chamfer on a given shape
AMCAX::MakeChamfer mc(box);
mc.Add(1.0, AMCAX::TopoCast::Edge(e1));
mc.Build();
AMCAX::TopoShape box_chamfer = mc.Shape();

形状变形

形状偏移

AMCAX::MakeOffset 类和 AMCAX::MakeOffsetShape 类提供对形状偏移的功能。

MakeOffset（2D形状的偏移）

输入wire进行offset，输入Face则对其边界进行offset，最后返回offset后的wire。

AMCAX::TopoShape box = AMCAX::MakeBox(AMCAX::Point3(-5.0, -5.0, -5.0), AMCAX::Point3(5.0, 5.0, 5.0));
//Get the face in box
AMCAX::IndexSet<AMCAX::TopoShape> faces;
AMCAX::TopoExplorerTool::MapShapes(box, AMCAX::ShapeType::Face, faces);
AMCAX::TopoShape f = faces[0];
//Get the wire of the f
AMCAX::IndexSet<AMCAX::TopoShape> wire;
AMCAX::TopoExplorerTool::MapShapes(f, AMCAX::ShapeType::Wire, wire);
AMCAX::TopoWire w = AMCAX::TopoCast::Wire(wire[0]);
 
//Make offset wire
double offset = 1.5;
AMCAX::JoinType theJoin = AMCAX::JoinType::Arc;
bool isOpenResult = false;
AMCAX::MakeOffset MakeOffset(w, theJoin, isOpenResult);
MakeOffset.Perform(offset);
AMCAX::TopoShape offset1 = MakeOffset.Shape();
 
//Make offset face
AMCAX::TopoFace f1 = AMCAX::TopoCast::Face(f);
AMCAX::MakeOffset MakeOffset2(f1, theJoin, isOpenResult);
MakeOffset2.Perform(offset);
AMCAX::TopoShape offset2 = MakeOffset2.Shape();

MakeOffsetShape（3D形状的偏移）

对输入的 face 进行 offset，如果输入是 shell，则对其整个 solid 进行 offset，最后返回 offset 后的 face 或 solid。偏移带来的缝隙可以选择使用延伸求交或圆角进行连接，而偏移带来的自交部分会被删除，另外还可通过 Modified 和 Generated 进行建模追踪。

AMCAX::TopoShape box = AMCAX::MakeBox(AMCAX::Point3(-5.0, -5.0, -5.0), AMCAX::Point3(5.0, 5.0, 5.0));
//Get the face in box
AMCAX::IndexSet<AMCAX::TopoShape> faces;
AMCAX::TopoExplorerTool::MapShapes(box, AMCAX::ShapeType::Face, faces);
AMCAX::TopoShape f = faces[0];
 
//Make offset face
AMCAX::MakeOffsetShape MakeOffsetShape;
double offsetvalue = 1.2;
MakeOffsetShape.PerformBySimple(f, offsetvalue);
MakeOffsetShape.Build();
AMCAX::TopoShape offsetshape1 = MakeOffsetShape.Shape();
AMCAX::OCCTIO::OCCTTool::Write(offsetshape1, "MakeOffsetShape-face.brep");
 
//Make offset face
AMCAX::MakeOffsetShape MakeOffsetShape2;
AMCAX::IndexSet<AMCAX::TopoShape> shell;
AMCAX::TopoExplorerTool::MapShapes(box, AMCAX::ShapeType::Shell, shell);
AMCAX::TopoShape s = shell[0];
MakeOffsetShape2.PerformBySimple(s, offsetvalue);
MakeOffsetShape2.Build();
AMCAX::TopoShape offsetshape2 = MakeOffsetShape2.Shape();

MakeOffsetWire

功能同样为偏移平面上的 wire，但支持拓扑结构的改变；支持在不连接的地方进行延伸求交过渡或构建圆弧过渡；支持通过 Generated 函数进行追踪。

//Make a outerWire
std::vector<AMCAX::Point3> points1;
points1.push_back(AMCAX::Point3(-1.0, -1.0, 0.0));
points1.push_back(AMCAX::Point3(1.0, -1.0, 0.0));
points1.push_back(AMCAX::Point3(1.0, 1.0, 0.0));
points1.push_back(AMCAX::Point3(-1.0, 1.0, 0.0));
AMCAX::MakePolygon mp1;
for (const auto& p : points1)
{
    mp1.Add(p);
}
mp1.Close();
const auto& outerWire = mp1.Wire();
//Make a innerWire
std::vector<AMCAX::Point3> points2;
points2.push_back(AMCAX::Point3(0.0, -0.5, 0.0));
points2.push_back(AMCAX::Point3(-0.5, 0.0, 0.0));
points2.push_back(AMCAX::Point3(0.0, 0.5, 0.0));
points2.push_back(AMCAX::Point3(0.5, 0.0, 0.0));
AMCAX::MakePolygon mp2;
for (const auto& p : points2)
{
    mp2.Add(p);
}
mp2.Close();
const auto& innerWire = mp2.Wire();
//Make a face
AMCAX::TopoBuilder b;
AMCAX::TopoFace f;
auto surf = std::make_shared<AMCAX::Geom3Plane>();
b.MakeFace(f, surf, AMCAX::Precision::Confusion());
b.Add(f, innerWire);
b.Add(f, outerWire);
//Make offset wire
double offset = 0.1;
{
    AMCAX::JoinType join = AMCAX::JoinType::Intersection;
    AMCAX::MakeOffsetWire mow(f, innerWire, join, offset);
    const auto& result = mow.Shape();
}
{
    AMCAX::JoinType join = AMCAX::JoinType::Intersection;
    AMCAX::MakeOffsetWire mow(f, innerWire, join, -offset);
    const auto& result = mow.Shape();
}
{
    AMCAX::JoinType join = AMCAX::JoinType::Arc;
    AMCAX::MakeOffsetWire mow(f, innerWire, join, offset);
    const auto& result = mow.Shape();
}
{
    AMCAX::JoinType join = AMCAX::JoinType::Arc;
    AMCAX::MakeOffsetWire mow(f, innerWire, join, -offset);
    const auto& result = mow.Shape();
}

拓扑结构改变举例：（蓝黑色为输入，蓝色为期待的结果，红色内部构建过程中产生出来的需要删除的部分）

形状加厚

AMCAX::MakeThickSolid 类提供形状加厚的功能。

 AMCAX::TopoShape box = AMCAX::MakeBox(AMCAX::Point3(-5.0, -5.0, -5.0), AMCAX::Point3(5.0, 5.0, 5.0));
 //Get the face in box
 AMCAX::IndexSet<AMCAX::TopoShape> faces;
 AMCAX::TopoExplorerTool::MapShapes(box, AMCAX::ShapeType::Face, faces);
 AMCAX::TopoShape f = faces[0];
//Make a thick solid
 double offsetvalue = 1.5;
 AMCAX::MakeThickSolid ts;
 ts.MakeThickBySimple(f, offsetvalue);
 ts.Build();
 AMCAX::TopoShape thicksolid = ts.Shape();

替换面

AMCAX::BoolBRepReplaceFace 类提供替换面的功能。即选择实体中的一个面，将其替换成另一个曲面。基本逻辑是将被替换的面周围的面进行延伸，与新的曲面进行相交并重构拓扑。但如果曲面不能覆盖被替换的面，替换会失败。

AMCAX::TopoShape cylinder = AMCAX::MakeCylinder(5, 10);
//Get the face in box
AMCAX::IndexSet<AMCAX::TopoShape> shapeFaces;
AMCAX::TopoExplorerTool::MapShapes(cylinder, AMCAX::ShapeType::Face, shapeFaces);
AMCAX::TopoFace upface = AMCAX::TopoCast::Face(shapeFaces[1]);
// Replace the feature faces in solid with surface
AMCAX::Plane plane(AMCAX::Point3(0., 0., 12.), AMCAX::Direction3(0.2, 0.2, 1.0));
std::shared_ptr<AMCAX::Geom3Plane> surf = std::make_shared<AMCAX::Geom3Plane>(plane);
AMCAX::BoolBRepReplaceFace rf;
rf.SetShape(cylinder);
rf.AddFaceToReplace(upface);
rf.SetReplaceSurface(surf);
rf.Build();
if (rf.IsDone())
{
    AMCAX::TopoShape result = rf.Shape();
}

部分图片来源： https://dev.opencascade.org/doc/overview/html/index.html ，版权归其所有。