【初级教程十】除料

一、扫描除料
         概念：使用“扫描除料”命令，可以沿着您定义的路径 (B) 延伸横截面 (A)，以此构造除料。

         API：

1. SweptCutoutPtr Add(
   
2.     long NumCurves,// 指定在构建扫描凸出特征时使用的路径曲线对象的数量
   
3.     const _variant_t& TraceCurves,// 包含轮廓和/或边缘对象。数组的大小等于NumCurves的值
   
4.     const _variant_t& TraceCurveTypes,// 数组的大小等于NumCurves的值。常用(igProfileBasedCrossSection, igEdgeBasedCrossSection)的成员
   
5.     long NumSections,// 指定在构造扫描凸出特征时使用的截面对象的数量
   
6.     const _variant_t& CrossSections,// 包含截面轮廓和/或边缘对象。数组的大小等于NumSections的值
   
7.     const _variant_t& CrossSectionTypes,// 数组的大小等于NumSections的值
   
8.     const _variant_t& Origins,// 截面原点，若截面为圆，此处为零
   
9.     const _variant_t& SegmentMaps,
   
10.     enum FeaturePropertyConstants MaterialSide,
    
11.     enum FeaturePropertyConstants StartExtentType,
    
12.     double StartExtentDistance,
    
13.     IDispatch* StartSurfaceOrRefPlane,
    
14.     enum FeaturePropertyConstants EndExtentType,
    
15.     double EndExtentDistance,
    
16.     IDispatch* EndSurfaceOrRefPlane);

复制代码

         示例代码：

1. void AddSweptCutout()
   
2. {
   
3.     Application* application = TGAddinApp::GetTGApp()->GetApplication();
   
4.     TGPart::PartDocumentPtr pDoc = application->GetActiveDocument();
   
5.     // 新建草图
   
6.     TGPart::SketchPtr pSketch = pDoc->Sketches->Add();
   
7.     //参考平面
   
8.     TGPart::RefPlanePtr pRefplane = pDoc->GetRefPlanes()->Item(3);
   
9.     // 轮廓
   
10.     TGPart::ProfilePtr pProfile = pSketch->GetProfiles()->Add(pRefplane);
    
11.     TGFrameworkSupport::Lines2dPtr pLines2d = pProfile->GetLines2d();
    
12.     // 创建一个中线点为(0.05, 0.05), 长度为0.1，宽度为0.08的矩形
    
13.     double cenX = 0.0, cenY = 0.0, width = 0.08, len = 0.1;
    
14.     std::array<TGFrameworkSupport::Line2dPtr, 4> lines;
    
15.     lines[0] = pLines2d->AddBy2Points(cenX - len / 2, cenY - width / 2, cenX + len / 2, cenY - width / 2);// 底边
    
16.     lines[1] = pLines2d->AddBy2Points(cenX + len / 2, cenY - width / 2, cenX + len / 2, cenY + width / 2); // 右边
    
17.     lines[2] = pLines2d->AddBy2Points(cenX + len / 2, cenY + width / 2, cenX - len / 2, cenY + width / 2); // 上边
    
18.     lines[3] = pLines2d->AddBy2Points(cenX - len / 2, cenY + width / 2, cenX - len / 2, cenY - width / 2); // 左边
    
19. 
    
20.     TGFrameworkSupport::Relations2dPtr pRelations2d = pProfile->GetRelations2d();
    
21.     for (int i = 0; i < 4; i++)
    
22.     {
    
23.         TGFrameworkSupport::Line2dPtr pLine = lines[i];
    
24.         TGFrameworkSupport::Line2dPtr pNextLine = lines[(i + 1) % 4];
    
25.         pRelations2d->AddKeypoint(
    
26.             pLine,
    
27.             (int)TGConstants::KeypointIndexConstants::igLineEnd,
    
28.             pNextLine,
    
29.             (int)TGConstants::KeypointIndexConstants::igLineStart,
    
30.             true);
    
31.     }
    
32.     CComSafeArray<IDispatch*> aProfiles(1);
    
33.     aProfiles[0] = pProfile;
    
34.     // 基于矩形去进行拉伸,右侧拉伸、长度为0.05
    
35.     TGPart::ModelPtr model = pDoc->Models->AddFiniteExtrudedProtrusion(
    
36.         1,
    
37.         aProfiles.GetSafeArrayPtr(),
    
38.         TGPart::FeaturePropertyConstants::igRight,
    
39.         0.05);
    
40. 
    
41.     // 将矩形的草图作为路径曲线
    
42.     IDispatchPtr pTempTrace = static_cast<IDispatch*>(pProfile);
    
43.     _variant_t TraceCurves = CreateVariant<IDispatch>(pTempTrace, VT_DISPATCH);
    
44.     int TraceCurveType
    
45.         = TGConstants::FeaturePropertyConstants::igProfileBasedCrossSection;
    
46.     _variant_t TraceCurveTypes = CreateVariant<int>(&TraceCurveType, VT_INT);
    
47. 
    
48.     // 绘制截面轮廓
    
49.     pSketch = pDoc->Sketches->Add();
    
50.     ProfilePtr pProfileCross = pSketch->GetProfiles()->Add(pDoc->GetRefPlanes()->Item(2));
    
51.     pProfileCross->GetCircles2d()->AddByCenterRadius(0, 0.04, 0.01);
    
52.     pProfileCross->End(ProfileValidationType::igProfileClosed);
    
53. 
    
54.     // 截面
    
55.     IDispatchPtr pTempCross = static_cast<IDispatch*>(pProfileCross);
    
56.     _variant_t CrossSections = CreateVariant<IDispatch>(pTempCross, VT_DISPATCH);
    
57.     int CrossSectionType
    
58.         = TGConstants::FeaturePropertyConstants::igProfileBasedCrossSection;
    
59.     _variant_t CrossSectionTypes = CreateVariant<int>(&CrossSectionType, VT_INT);
    
60.     // 截面原点，若截面为圆，此处为零
    
61.     int t = 0;
    
62.     _variant_t Origins = CreateVariant<int>(&t, VT_INT);
    
63.     // 以圆为轮廓，矩形的草图为路径曲线进行扫掠去料
    
64.     pDoc->Models->Item(1)->GetSweptCutouts()->Add(
    
65.         1,
    
66.         TraceCurves,
    
67.         TraceCurveTypes,
    
68.         1,
    
69.         CrossSections,
    
70.         CrossSectionTypes,
    
71.         Origins,
    
72.         0,
    
73.         FeaturePropertyConstants::igLeft,
    
74.         FeaturePropertyConstants::igNone,
    
75.         0.0,
    
76.         NULL,
    
77.         FeaturePropertyConstants::igNone,
    
78.         0.0,
    
79.         NULL
    
80.     );
    
81. }

复制代码

         示例效果：


二、螺旋除料  
         使用螺旋除料可以沿着螺旋路径扫掠横截面，以此创建除料，主要用到的方法为HelixCutouts下的一组Add方法，下面以添加有限范围除料即AddFinite为例进行演示。其原型为

1. HelixCutoutPtr AddFinite(struct RefAxis* HelixAxis, enum FeaturePropertyConstants AxisStart,
   
2.     long NumCrossSections, SAFEARRAY** CrossSectionArray, enum FeaturePropertyConstants ProfileSide,
   
3.     double Height, double Pitch, double NumberOfTurns, enum FeaturePropertyConstants HelixDir,
   
4.     const _variant_t& TaperAngle = vtMissing, const _variant_t& TaperSide = vtMissing,
   
5.     const _variant_t& EndPitch = vtMissing, const _variant_t& PitchRatio = vtMissing,
   
6.     const _variant_t& TaperStartRadius = vtMissing, const _variant_t& TaperEndRadius = vtMissing);

复制代码

1. void DemoAddHelixCutouts()
   
2. {
   
3.     namespace pt = TGPart;
   
4.     namespace gm = TGGeometry;
   
5.     namespace as = TGAssembly;
   
6.     namespace fwp = TGFrameworkSupport;
   
7.     // 建一个圆柱体用于演示除料
   
8.     pt::PartDocumentPtr pPartDoc = SEAPP->GetActiveDocument();
   
9.     assert(pPartDoc);
   
10.     pt::ProfilePtr pProfile = pPartDoc->GetSketches()->AddByPlane(pPartDoc->GetRefPlanes()->Item(1l))->GetProfile();
    
11.     pProfile->GetCircles2d()->AddByCenterRadius(0, 0, 0.05);  // 中心位于原点，半径0.5
    
12.     ATL::CComSafeArray<IDispatch*> aProfiles(1);
    
13.     aProfiles.SetAt(0, pProfile);
    
14.     pt::ModelPtr pModel = pPartDoc->GetModels()->AddFiniteExtrudedProtrusion(aProfiles.GetCount(), aProfiles.GetSafeArrayPtr(), pt::igRight, 0.3);
    
15. 
    
16.     // XOZ平面构造螺旋轴和截面
    
17.     pt::ProfilePtr pHelixProfile = pPartDoc->GetSketches()->AddByPlane(pPartDoc->GetRefPlanes()->Item(3l))->GetProfile();
    
18.     fwp::Circle2dPtr pCir2d = pHelixProfile->GetCircles2d()->AddByCenterRadius(0.05, 0, 0.01);
    
19.     fwp::Line2dPtr pSeg = pHelixProfile->GetLines2d()->AddBy2Points(0, 0, 0, 0.3);
    
20.     pt::RefAxisPtr pRotateAxis = pHelixProfile->SetAxisOfRevolution(pSeg);
    
21. 
    
22.     // 进行螺旋除料
    
23.     ATL::CComSafeArray<IDispatch*> crossSectionArray(1);
    
24.     crossSectionArray.SetAt(0, pHelixProfile);
    
25.     pModel->GetHelixCutouts()->AddFinite(pRotateAxis,  // 螺旋轴
    
26.         pt::igStart,  // pt::igStart表示从轴定义的线段起点向终点向螺旋，pt::igEnd表示从轴定义的线段终点向起点螺旋
    
27.         1, crossSectionArray.GetSafeArrayPtr(), // 传入横截面
    
28.         pt::igRight,   // 为未来开放路径预留，暂时无用，pt::igRight和pt::igLeft为有效值
    
29.         0.3,  // 螺高，暂时无用
    
30.         0.1, // 螺距
    
31.         3, // 螺数
    
32.         pt::igLeft  // pt::igRight右旋，pt::igLeft左旋   
    
33.     );
    
34. }

复制代码

         上述代码演示了这个方法使用的一般过程，运行效果如下。

         可以看到一般情况下，我们只需传入旋转轴、螺旋截面、旋转方向、螺距、螺高、圈数等参数就可以创建一个螺旋除料特征，如果想使螺距、螺径变化，则还可以输入更多的参数。

三、法向除料  
         法向除料与法向拉伸类似，是通过拉伸位于零件面上的封闭曲线构造垂直于该面的除料。使用文本轮廓或其他草图元素在非平整面上构造特征时，此命令非常有用。创建一个法向除料特征，可使用NormalToFaceCutouts::Add方法，除返回值外，此方向原型与法向拉伸NormalToFaceProtrusions::Add一致。

1. NormalToFaceCutoutPtr Add(long NumberOfInputCurves, // 闭合轮廓的拓扑边集个数
   
2.     const _variant_t& InputCurvesSetArray, //闭合轮廓的拓扑边集
   
3.     enum FeaturePropertyConstants LongestCurveSide, // 拉伸方向(在除料时 pt::igLeft pt::igRight未发现区别)
   
4.     double offsetDistance, // 除料厚度
   
5.     enum FeaturePropertyConstants FaceContainment // pt::igFacesTouchingCurvesOnly 仅修改与曲线接触的面
   
6.     // pt::igAllFaces 修改曲线图内的所有面
   
7. )

复制代码

1. void DemoAddNormalCutouts()
   
2. {
   
3.     namespace pt = TGPart;
   
4.     namespace gm = TGGeometry;
   
5.     namespace as = TGAssembly;
   
6.     namespace fwp = TGFrameworkSupport;
   
7.     pt::PartDocumentPtr pPartDoc = SEAPP->GetActiveDocument();
   
8.     assert(pPartDoc);
   
9. 
   
10.     // 首先创建一个圆柱
    
11.     pt::RefPlanePtr pYOZPlane = pPartDoc->GetRefPlanes()->Item(2l);
    
12.     pt::ProfilePtr pProfile = pPartDoc->GetSketches()->AddByPlane(pYOZPlane)->GetProfile();
    
13.     pProfile->GetCircles2d()->AddByCenterRadius(0.0, 0.0, 0.2);
    
14.     ATL::CComSafeArray<IDispatch*> aProfiles(1);
    
15.     aProfiles.SetAt(0, pProfile);
    
16.     pt::ModelPtr pCylinderModel = pPartDoc->GetModels()->AddFiniteExtrudedProtrusion(1, aProfiles.GetSafeArrayPtr(),
    
17.         pt::igSymmetric, 0.6);
    
18. 
    
19.     // 在一个新的草图上创建一个圆
    
20.     pt::RefPlanePtr pXOYPlane = pPartDoc->GetRefPlanes()->Item(1l);
    
21.     pt::SketchPtr pSketch = pPartDoc->GetSketches()->AddByPlane(pXOYPlane);
    
22.     pt::ProfilePtr pProfileScd = pSketch->GetProfile();
    
23.     pProfileScd->GetCircles2d()->AddByCenterRadius(0.0, 0.0, 0.05);
    
24. 
    
25.     // 投影圆所在草图到圆柱面上
    
26.     gm::BodyPtr pBody = pCylinderModel->GetBody();
    
27.     gm::FacesPtr pFaces = pBody->GetFaces(gm::igQueryCylinder);
    
28.     assert(pFaces->GetCount() > 0);
    
29.     gm::FacePtr pFace = pFaces->Item(1l);
    
30.     long faceCnt = pFaces->GetCount();
    
31.     pt::ProjectCurvesPtr pProjCvs = pPartDoc->GetConstructions()->GetProjectCurves();
    
32.     pt::RefPlanePtr pDestPlane = pPartDoc->GetRefPlanes()->AddParallelByDistance(pXOYPlane, 0.2, pt::igNormalSide);
    
33.     pt::ProjectCurvePtr pProjCv = pProjCvs->Add(pSketch, pFace, pDestPlane, pt::igRight, pt::igProjectOptionProject);
    
34. 
    
35.     // 法向拉伸
    
36.     gm::EdgesPtr pProjEdges = pProjCv->GetEdges(gm::igQueryAll);
    
37.     long projEdgeCnt = pProjEdges->GetCount();
    
38.     ATL::CComSafeArray<IDispatch*> aEdges(projEdgeCnt);
    
39.     for (long i = 0; i < projEdgeCnt; i++)
    
40.     {
    
41.         aEdges.SetAt(i, pProjEdges->Item(i + 1));
    
42.     }
    
43.     _variant_t varEdges;
    
44.     varEdges.parray = aEdges.Detach();
    
45.     varEdges.vt = VT_ARRAY | VT_DISPATCH;
    
46.     pCylinderModel->GetNormalToFaceCutouts()->Add(projEdgeCnt,  // 传入的eges个数
    
47.         varEdges, // edges
    
48.         pt::igLeft, // pt::igLeft 向外拉伸(加料) pt::igRight 向内拉伸(除料)
    
49.         0.01,  // 除料厚度
    
50.         pt::igFacesTouchingCurvesOnly // pt::igFacesTouchingCurvesOnly 仅修改与曲线接触的面
    
51.         // pt::igAllFaces 修改曲线图内的所有面
    
52.     );
    
53. }

复制代码

         上述代码演示了使用此方向创建一个法向除料的一般过程，运行效果如下。