基本体构建

基本体包括平面矩形、立方体、圆柱体、圆锥体、圆台、球体、环面等。

TMSplineMakeRectangle（平面矩形）

AMCAX::Frame3 frame;
AMCAX::TMS::TMSplineMakeRectangle mkRect(frame, 3, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp1 = mkRect.BuildSpline();

TMSplineMakeCube（立方体）

AMCAX::Point3 min(0.00, 0.00, 0.00), max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(min, max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp2 = mkCube.BuildSpline();

TMSplineMakeCylinder（圆柱体）

AMCAX::Frame3 frame;
AMCAX::TMS::TMSplineMakeCylinder mkCylinder(frame, 1.0, 4.0, true, true, 8, 4);
AMCAX::TMS::TMSpline* tsp3 = mkCylinder.BuildSpline();

TMSplineMakeCone（圆锥体）

AMCAX::TMS::TMSplineMakeCone mkCone(1.0, 2.0, true, 8, 4);

AMCAX::TMS::TMSpline* tsp4 = mkCone.BuildSpline();

AMCAX::TMS::TMSplineMakeCone

T 网格样条接口中用于创建圆锥体的类

定义 TMSplineMakeCone.hpp:16

TMSplineMakeCone（圆台）

AMCAX::Frame3 frame;
AMCAX::TMS::TMSplineMakeCone mkCone2(frame, 2.0, 1.0, 2.0, true, true, 8, 4);
AMCAX::TMS::TMSpline* tsp5 = mkCone2.BuildSpline();

TMSplineMakeSphere（球体）

AMCAX::TMS::TMSplineMakeSphere mkSphere(10.0, 8, 8);

AMCAX::TMS::TMSpline* tsp6 = mkSphere.BuildSpline();

AMCAX::TMS::TMSplineMakeSphere

T 网格样条接口中用于创建球体的类

定义 TMSplineMakeSphere.hpp:16

TMSplineMakeTorus（环面）

AMCAX::TMS::TMSplineMakeTorus mkTorus(20.0, 10.0, 8, 16);

AMCAX::TMS::TMSpline* tsp7 = mkTorus.BuildSpline();

AMCAX::TMS::TMSplineMakeTorus

T 网格样条接口中用于创建圆环体的类

定义 TMSplineMakeTorus.hpp:15

基本编辑功能

基本编辑功能包括遍历、添加面、细化、删除、分离、缝合等。

遍历

AMCAX::TMS::TMSplineTool 类提供遍历功能，具体如下：
AMCAX::TMS::TMSplineTool::FaceVertexIndexs 获取 TMSpline 中某个面所有顶点的索引；
AMCAX::TMS::TMSplineTool::EdgeVertexIndexs 获取 TMSpline 中某条边顶点的索引；
AMCAX::TMS::TMSplineTool::FaceEdgeIndexs 获取 TMSpline 中某个面所有边的索引；
AMCAX::TMS::TMSplineTool::EdgeFaceIndexs 获取 TMSpline 中与输入边相邻的面的索引。

获取 TMSpline 中某个面所有顶点的索引

AMCAX::Point3 bb_min(0.00, 0.00, 0.00), bb_max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(bb_min, bb_max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp = mkCube.BuildSpline();
//Get the vertices of the face in TMSpline
int face = 0;
std::vector< int > index_v = AMCAX::TMS::TMSplineTool::FaceVertexIndexs(tsp, face);

获取 TMSpline 中某条边顶点的索引

AMCAX::Point3 bb_min(0.00, 0.00, 0.00), bb_max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(bb_min, bb_max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp = mkCube.BuildSpline();
//Get the vertices of the edge in TMSpline
int edge = 0;
int vfirst, vlast;
AMCAX::TMS::TMSplineTool::EdgeVertexIndexs(tsp, edge, vfirst, vlast);

获取 TMSpline 中某个面所有边的索引

AMCAX::Point3 bb_min(0.00, 0.00, 0.00), bb_max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(bb_min, bb_max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp = mkCube.BuildSpline();
//Get the edge of the face in TMSpline
int face = 0;
std::vector< int > index_e = AMCAX::TMS::TMSplineTool::FaceEdgeIndexs(tsp, face);

获取 TMSpline 中与输入边相邻的面的索引

AMCAX::Point3 bb_min(0.00, 0.00, 0.00), bb_max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(bb_min, bb_max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp = mkCube.BuildSpline();
//Get the faces adjacent to edge in TMSpline
int edge = 0;
std::vector< int >index_f = AMCAX::TMS::TMSplineTool::EdgeFaceIndexs(tsp, edge);

添加面

AMCAX::TMS::TMSplineAddFace 类提供添加功能。其中 AMCAX::TMS::TMSplineAddFace::AddSingleFace 为 TMSpline 添加由点集构成的单个面； AMCAX::TMS::TMSplineAddFace::AddFaceByEdge 为 TMSpline 添加由两条边构成的单个面。另外在添加前可以通过 AMCAX::TMS::TMSplineAddFace::CanAddSingleFace 或 AMCAX::TMS::TMSplineAddFace::CanAddFaceByEdge 来判断能否成功添加面。

为 TMSpline 添加由点集构成的单个面

AMCAX::Frame3 frame;
AMCAX::TMS::TMSplineMakeRectangle mkRect(frame, 10., 10., 2, 2);
AMCAX::TMS::TMSpline* tsp1 = mkRect.BuildSpline();
//Check it can add a single face constructed from points to a TMSpline
AMCAX::Point3 p1(12., 15., 15.);
AMCAX::Point3 p2(16., 13., 11.);
AMCAX::Point3 p3(20., 18., 13.);
std::vector< AMCAX::Point3 > vlist = { p1,p2,p3 };
AMCAX::TMS::TMSplineAddFace af1;
bool r1 = af1.CanAddSingleFace(tsp1, vlist);
std::cout << r1 << std::endl;
//Add a single face constructed from points to a TMSpline
af1.AddSingleFace(tsp1, vlist);

为 TMSpline 添加由两条边构成的单个面

建设中。

细化

AMCAX::TMS::TMSplineSplit 类提供细化功能。
建设中。

删除

AMCAX::TMS::TMSplineReduce 类提供删除功能。具体如下：
AMCAX::TMS::TMSplineReduce::RemoveVertices 用于删除 TMSpline 中的顶点（也会删除连接顶点的边）；
AMCAX::TMS::TMSplineReduce::RemoveEdges 用于删除 TMSpline 中的边；
AMCAX::TMS::TMSplineReduce::DeleteFaces 用于删除 TMSpline 中的面。
另外在删除前，可以通过 AMCAX::TMS::TMSplineReduce::CanRemoveVertices 、 AMCAX::TMS::TMSplineReduce::CanRemoveEdges 、 AMCAX::TMS::TMSplineReduce::CanDeleteFaces 来判断能否删除顶点/边/面。

删除 TMSpline 中的顶点

AMCAX::Point3 min(0.00, 0.00, 0.00), max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(min, max, 2, 2, 2);
AMCAX::TMS::TMSpline* tsp1 = mkCube.BuildSpline();
//Check it can remove vertices in a TMSpline
std::vector< int >vlist = { 0,1 };
AMCAX::TMS::TMSplineReduce rv;
std::cout << rv.CanRemoveVertices(tsp1, vlist) << std::endl;
//Remove vertices in a TMSpline
rv.RemoveVertices(tsp1, vlist);

删除 TMSpline 中的边

AMCAX::Point3 min(0.00, 0.00, 0.00), max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(min, max, 2, 2, 2);
AMCAX::TMS::TMSpline* tsp1 = mkCube.BuildSpline();
//Check it can remove edges in a TMSpline
const std::vector< int > elist = { 10,15 };
AMCAX::TMS::TMSplineReduce rv2;
std::cout << rv2.CanRemoveEdges(tsp1, elist) << std::endl;
//Remove edges in a TMSpline
rv2.RemoveEdges(tsp1, elist);

删除 TMSpline 中的面

AMCAX::Point3 min(0.00, 0.00, 0.00), max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(min, max, 2, 2, 2);
AMCAX::TMS::TMSpline* tsp1 = mkCube.BuildSpline();
//Check it can remove faces in a TMSpline
const std::vector< int > flist = { 2,6 };
AMCAX::TMS::TMSplineReduce rv3;
std::cout << rv3.CanDeleteFaces(tsp1, flist) << std::endl;
//Remove faces in a TMSpline
rv3.DeleteFaces(tsp1, flist);

分离和缝合

AMCAX::TMS::TMSplineSeparate 类提供分离功能； AMCAX::TMS::TMSplineWeld 类提供缝合功能。

AMCAX::Frame3 frame;
AMCAX::TMS::TMSplineMakeRectangle mkRect(frame, 3, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp1 = mkRect.BuildSpline();
//Separate
std::vector< int >elist = { 0 };
AMCAX::TMS::TMSplineSeparate se;
std::cout << se.SeparateEdges(tsp1, elist) << std::endl;
//Check edges in a TMSpline can be weld 
AMCAX::TMS::TMSplineWeld we;
std::cout << we.CanWeldEdges(tsp1, elist) << std::endl;
//Weld
we.WeldEdges(tsp1, elist);

拓扑建模功能

拓扑建模功能包括变换、拉伸、加厚、补洞等。

变换

AMCAX::TMS::TMSplineTransform 类提供变换功能。其中 AMCAX::TMS::TMSplineTransform::TransformTMSplineVertices 对 TMSpline 中的顶点列表进行变换； AMCAX::TMS::TMSplineTransform::TransformTMSplineEdges 对 TMSpline 中的边列表进行变换； AMCAX::TMS::TMSplineTransform::TransformTMSplineFaces 对 TMSpline 中的面列表进行变换。

AMCAX::Point3 min(0.00, 0.00, 0.00), max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(min, max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp = mkCube.BuildSpline();
//Set the transformation as the translation
AMCAX::Frame3 frame;
double h = 30;
AMCAX::Vector3 vh(frame.Direction().Coord() * h);
AMCAX::TMS::TMSplineTransform trsfV;
AMCAX::Transformation3 trsfMove;
trsfMove.SetTranslation(vh);
trsfV.SetTransformation(trsfMove);
 
//TransformTMSplineVertices
std::vector< int > vlist = { 0,1,2 };
trsfV.TransformTMSplineVertices(tsp, vlist);
 
//TransformTMSplineEdges
std::vector< int > elist = { 14,15,16 };
trsfV.TransformTMSplineEdges(tsp, elist);
 
//TransformTMSplineFaces
std::vector< int > flist = { 27,28,29 };
trsfV.TransformTMSplineFaces(tsp, flist);

拉伸

AMCAX::TMS::TMSplineExtrude 类提供拉伸功能。其中 AMCAX::TMS::TMSplineExtrude::ExtrudeEdges 用于拉伸边； AMCAX::TMS::TMSplineExtrude::ExtrudeFaces 用于拉伸面。

拉伸边

需要注意的是这里要进行拉伸的边需为边界边。

AMCAX::Frame3 frame;
AMCAX::TMS::TMSplineMakeRectangle mkRect(frame, 3, 3, 1, 1);
AMCAX::TMS::TMSpline* tsp = mkRect.BuildSpline();
//Check if the edge is boundary edge
std::vector<int> edgeid = { 0,1,2 };
std::vector<int> edge_id_new;
std::cout << AMCAX::TMS::TMSplineCheck::IsEdgeBoundary(tsp, edgeid[0]) << std::endl;
std::cout << AMCAX::TMS::TMSplineCheck::IsEdgeBoundary(tsp, edgeid[1]) << std::endl;
std::cout << AMCAX::TMS::TMSplineCheck::IsEdgeBoundary(tsp, edgeid[2]) << std::endl;
//Check if it can extrude input edges in TMSpline
AMCAX::TMS::TMSplineExtrude ex;
std::cout << ex.CanExtrudeEdges(tsp, edgeid) << std::endl;
//Extrude the edges in TMSpline
ex.ExtrudeEdges(tsp, edgeid, edge_id_new);

拉伸面

AMCAX::Point3 min(0.00, 0.00, 0.00), max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(min, max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp2 = mkCube.BuildSpline();
std::vector<int> faceid = { 0,2,5 };
std::vector<int> face_id_new;
//Check if it can extrude input faces in TMSpline
AMCAX::TMS::TMSplineExtrude ex;
std::cout << ex.CanExtrudeFaces(tsp2, faceid) << std::endl;
//Extrude the faces in TMSpline
ex.ExtrudeFaces(tsp2, faceid, face_id_new);

加厚

AMCAX::Frame3 frame;
AMCAX::TMS::TMSplineMakeRectangle mkRect(frame, 3, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp = mkRect.BuildSpline();
//Thicken a TMSpline
AMCAX::TMS::TMSplineThicken mkThick;
mkThick.ThickenTMSpline(tsp, 1);

补洞

AMCAX::TMS::TMSplineFillHole 类提供补洞功能。其中 AMCAX::TMS::TMSplineFillHole::FillAllHoles 用于补 TMSpline 中某一个洞，在补洞前，可以先通过 AMCAX::TMS::TMSplineFillHole::CanFillSingleHole 来判断能否补； AMCAX::TMS::TMSplineFillHole::FillAllHoles 用于补 TMSpline 中所有的洞。需要注意的是，对于一个开网格，补洞时会把边界也当成洞并且用一个多边形填充起来。

AMCAX::Point2 p0(1.0, 1.0), p1(10.0, 10.0);
AMCAX::TMS::TMSplineMakeRectangle mkRect(p0, p1, 3, 3);
AMCAX::TMS::TMSpline* tsp = mkRect.BuildSpline();
//Delete faces in a TMSpline
std::vector<int> face_id = { 4 };
std::vector<int> edge_id = { 6, 10, 13, 14 };
AMCAX::TMS::TMSplineReduce reduce;
reduce.DeleteFaces(tsp, face_id);
 
//Check there are hole with input edge in TMSpline
AMCAX::TMS::TMSplineFillHole fillhole;
std::cout << fillhole.CanFillSingleHole(tsp, 6) << std::endl;
//Fill hole whit input edge
fillhole.FillSingleHole(tsp, 6);
 
//Delete faces in a TMSpline
std::vector<int> face_id2 = { 0,6 };
AMCAX::TMS::TMSplineReduce reduce2;
reduce2.DeleteFaces(tsp, face_id2);
//Fill all holes in TMSpline
AMCAX::TMS::TMSplineFillHole fillhole2;
fillhole2.FillAllHoles(tsp);

网格化

AMCAX::TMS::TMSplineMeshing 类将 TMSpline 网格划分为三角形网格。

AMCAX::Point3 bb_min(0.00, 0.00, 0.00), bb_max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(bb_min, bb_max, 3, 3, 3);
//Meshing
AMCAX::TMS::TMSpline* tsp = mkCube.BuildSpline();
AMCAX::TMS::TMSplineMeshing tspMesh(tsp, 4);
tspMesh.UpdateDrawMesh();

导出 OBJ/STL 文件

AMCAX::TMS::TMSplineMeshingIO::ExportToOBJ 提供导出 OBJ 文件的功能； AMCAX::TMS::TMSplineMeshingIO::ExportToSTL 提供导出 OBJ 文件的功能。

AMCAX::Point3 min(0.00, 0.00, 0.00), max(12.00, 12.00, 12.00);
AMCAX::TMS::TMSplineMakeCube mkCube(min, max, 3, 3, 3);
AMCAX::TMS::TMSpline* tsp4 = mkCube.BuildSpline();
AMCAX::TMS::TMSplineMeshing tspMesh4(tsp4, 4);
tspMesh4.UpdateDrawMesh();
//Export
AMCAX::TMS::TMSplineMeshingIO meshIO4;
std::string fileNameOBJ4 = "cube.obj";
std::string fileNameOBJ5 = "cube.stl";
meshIO4.ExportToOBJ(fileNameOBJ4, tspMesh4.GetDrawMesh());
meshIO4.ExportToSTL(fileNameOBJ5, tspMesh4.GetDrawMesh());