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

前言

在线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图纸，

然后我们用鼠标点击一个或者多个图形, 就可以选中它们，选中后执行以下代码:

const rowNum = Number(prompt("输入行数"))
const colNum = Number(prompt("输入列数"))
if (isNaN(rowNum) || isNaN(colNum)) return
alert("点击画布两点之间的距离作为偏移量")
let offset = await MxCADUtility.getCorner("输入偏移距离");
if (!offset) return
let dColOffset = offset.pt2.x - offset.pt1.x;
let dRowOffset = offset.pt2.y - offset.pt1.y;
// 得到选中的图形
let aryId = await MxCADUtility.userSelect("选择陈列对象");
// 得到这些图形的包围盒
let ext = MxCADUtility.getMcDbEntitysBoundingBox(aryId);
if (!ext) return;
let cenPt = new McGePoint3d();
if (dColOffset > 0)
cenPt.x = ext.minPt.x;
else
cenPt.x = ext.maxPt.x;
if (dRowOffset > 0)
cenPt.y = ext.minPt.y;
else
cenPt.y = ext.maxPt.y;
// 角度
let dAng = Number(prompt("输入角度"));
if (isNaN(dAng)) return
let matRot = new McGeMatrix3d().setToRotation(dAng * Math.PI / 180.0, McGeVector3d.kZAxis, cenPt);
// 循环渲染
let iMaxNum = 50000;
let iCount = 0;
for (let i = 0; i < rowNum; i++) {
// 行 平移矩阵
let yOffsetVec = new McGeVector3d(0.0, dRowOffset * i, 0.0);
let offsetMatY = new McGeMatrix3d().setToTranslation(yOffsetVec);
for (let j = 0; j < colNum; j++) {
if (i == 0 && j == 0)
continue;
// 列 平移矩阵
let xOffsetVec = new McGeVector3d(dColOffset * j, 0.0, 0.0);
let ofssetMatX = new McGeMatrix3d().setToTranslation(xOffsetVec);
let vecOffset = new McGePoint3d(cenPt.x, cenPt.y, cenPt.z);
// 应用对应矩阵
vecOffset.transformBy(offsetMatY);
vecOffset.transformBy(ofssetMatX);
vecOffset.transformBy(matRot);
// 最终的变换矩阵
let tmpMat = new McGeMatrix3d().setToTranslation(new McGeVector3d(vecOffset.x - cenPt.x, vecOffset.y - cenPt.y, vecOffset.z - cenPt.z));
for (let m = 0; m < aryId.length; m++) {
let tmp = aryId[m].clone() as McDbEntity
if (!tmp) {
continue;
// 将该变换矩阵应用在图形对象上
tmp.TransformBy(tmpMat);
MxCpp.GetCurrentMxCAD().DrawEntity(tmp);
iCount++;
if (iCount > iMaxNum) {
alert("超出最大阵列对象个数" + iMaxNum + "限制. \n");
return;

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

对于需要自己二次开发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