在线CAD（H5网页CAD SDK）实现阵列功能

MxDraw

前言

在线CAD SDK的集成过程中，甲方客户可能有阵列功能的需求，作为开发者如何利用WEB CAD SDK展现此功能效果呢？本章节我们重点讲述一下。

首先看一下在线CAD的DEMO：https://demo.mxdraw3d.com:3000/mxcad/，阵列功能如下图：

环境搭建

首先按照mxcad入门文档（https://mxcadx.gitee.io/mxcad_docs/zh/1.%E6%8C%87%E5%8D%97/1.%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8.html）创建环境，如下图：

基于mxcad库实现阵列功能

阵列功能是按一定规律对某个或多个图形组合进行复制偏移，生成出新的图形组合，在实现它之前我们要确保已经用mxcad库在页面中显示了一个cad图纸，然后我们用鼠标点击一个或者多个图形, 就可以选中它们，选中后执行以下代码:

1. const rowNum = Number(prompt("输入行数"))
   
2. 
   
3. const colNum = Number(prompt("输入列数"))
   
4. 
   
5. if (isNaN(rowNum) || isNaN(colNum)) return
   
6. 
   
7. 
   
8. 
   
9. alert("点击画布两点之间的距离作为偏移量")
   
10. 
    
11. let offset = await MxCADUtility.getCorner("输入偏移距离");
    
12. 
    
13. if (!offset) return
    
14. 
    
15. let dColOffset = offset.pt2.x - offset.pt1.x;
    
16. 
    
17. let dRowOffset = offset.pt2.y - offset.pt1.y;
    
18. 
    
19. 
    
20. 
    
21. // 得到选中的图形
    
22. 
    
23. let aryId = await MxCADUtility.userSelect("选择陈列对象");
    
24. 
    
25. // 得到这些图形的包围盒
    
26. 
    
27. let ext = MxCADUtility.getMcDbEntitysBoundingBox(aryId);
    
28. 
    
29. if (!ext) return;
    
30. 
    
31. 
    
32. 
    
33. let cenPt = new McGePoint3d();
    
34. 
    
35. 
    
36. 
    
37. if (dColOffset > 0)
    
38. 
    
39.     cenPt.x = ext.minPt.x;
    
40. 
    
41. else
    
42. 
    
43.     cenPt.x = ext.maxPt.x;
    
44. 
    
45. 
    
46. 
    
47. if (dRowOffset > 0)
    
48. 
    
49.     cenPt.y = ext.minPt.y;
    
50. 
    
51. else
    
52. 
    
53.     cenPt.y = ext.maxPt.y;
    
54. 
    
55. // 角度
    
56. 
    
57. let dAng = Number(prompt("输入角度"));
    
58. 
    
59. if (isNaN(dAng)) return
    
60. 
    
61. let matRot = new McGeMatrix3d().setToRotation(dAng * Math.PI / 180.0, McGeVector3d.kZAxis, cenPt);
    
62. 
    
63. 
    
64. 
    
65. // 循环渲染
    
66. 
    
67. let iMaxNum = 50000;
    
68. 
    
69. let iCount = 0;
    
70. 
    
71. for (let i = 0; i < rowNum; i++) {
    
72. 
    
73.     // 行 平移矩阵
    
74. 
    
75.     let yOffsetVec = new McGeVector3d(0.0, dRowOffset * i, 0.0);
    
76. 
    
77.     let offsetMatY = new McGeMatrix3d().setToTranslation(yOffsetVec);
    
78. 
    
79. 
    
80. 
    
81.     for (let j = 0; j < colNum; j++) {
    
82. 
    
83.         if (i == 0 && j == 0)
    
84. 
    
85.             continue;
    
86. 
    
87.         // 列 平移矩阵
    
88. 
    
89.         let xOffsetVec = new McGeVector3d(dColOffset * j, 0.0, 0.0);
    
90. 
    
91.         let ofssetMatX = new McGeMatrix3d().setToTranslation(xOffsetVec);
    
92. 
    
93. 
    
94. 
    
95.         let vecOffset = new McGePoint3d(cenPt.x, cenPt.y, cenPt.z);
    
96. 
    
97.         // 应用对应矩阵
    
98. 
    
99.         vecOffset.transformBy(offsetMatY);
    
100. 
     
101.         vecOffset.transformBy(ofssetMatX);
     
102. 
     
103.         vecOffset.transformBy(matRot);
     
104. 
     
105. 
     
106. 
     
107.         // 最终的变换矩阵
     
108. 
     
109.         let tmpMat = new McGeMatrix3d().setToTranslation(new McGeVector3d(vecOffset.x - cenPt.x, vecOffset.y - cenPt.y, vecOffset.z - cenPt.z));
     
110. 
     
111.         for (let m = 0; m < aryId.length; m++) {
     
112. 
     
113.             let tmp = aryId[m].clone() as McDbEntity
     
114. 
     
115.             if (!tmp) {
     
116. 
     
117.                 continue;
     
118. 
     
119.             }
     
120. 
     
121.             // 将该变换矩阵应用在图形对象上
     
122. 
     
123.             tmp.TransformBy(tmpMat);
     
124. 
     
125.             MxCpp.GetCurrentMxCAD().DrawEntity(tmp);
     
126. 
     
127.             iCount++;
     
128. 
     
129.             if (iCount > iMaxNum) {
     
130. 
     
131.                 alert("超出最大阵列对象个数" + iMaxNum + "限制. \n");
     
132. 
     
133.                 return;
     
134. 
     
135.             }
     
136. 
     
137.         }
     
138. 
     
139.     }
     
140. 
     
141. }

复制代码

代码中主要让用户输入一些行列数和偏移距离以及角度值, 然后得到选中图形, 得到其包围盒,并计算出变换矩阵, 复制这些对象然后绘制在画布，效果如下图:

对于需要自己二次开发cad相关功能, 可以参考:

mxcad入门: https://mxcadx.gitee.io/mxcad_docs/zh/

mxcad API文档 :https://mxcadx.gitee.io/mxcad_docs/api/README.html

DEMO源码：

https://gitee.com/mxcadx/mxdraw-article/tree/master/%E5%AE%9E%E7%8E%B0%E9%98%B5%E5%88%97%E5%8A%9F%E8%83%BD