在线CAD(html预览cad插件)二次开发块表

前言

在DWG数据库中，所有图块都存放在块表McDbBlockTable()中，块表中每一条记录称为图块记录对象McDbBlockTableRecord()。图块记录中存放着所有实体数据，用户可以通过改变图块的属性设置来修改其对应着的实体数据。

块表操作

1. 获取当前控件的数据库块表

我们可以通过调用 mxcad 中的MxCpp.getCurrentMxCAD()得到当前的控件, 然后调用控件实例的getDatabase()方法得到数据库实例McDbDatabase()，在该数据库实例中调用getBlockTable()方法我们就能获取到块表McDbBlockTable() 。

[块表 McDbBlockTable()]

[图块记录对象 McDbLinetypeTableRecord()]

[数据库实例 McDbDatabase()]

查看详细属性和方法说明，参考代码如下：

import { MxCpp} from "mxcad"
   // 得到当前控件
   let mxcad = MxCpp.App.getCurrentMxCAD();
   // 获取块表
   let blockTable = mxcad.getDatabase().getBlockTable();

2. 插入图块

我们可以调用 mxcad 的实例对象中的insertBlock()方法引入插件图块文件得到引用的图块 ID ，最后通过McDbBlockReference()实例化一个 CAD 图块引用实体，设置该实体的blockTableRecordId属性值为引用的图块ID ，就能实现在图纸中插入目标块。

点击 [McObject.insertBlock()]、 [McDbBlockReference()]，查看详细属性和方法说明，参考代码如下：

import { MxCpp, McDbBlockReference, MxCADUiPrPoint } from "mxcad"
   async function MxTest\_InsertBlock(){
       // 目标块文件网络文件路径 且该文件为mxweb格式
       let blkFilePath = new URL("../src/assets/tree.mxweb", import.meta.url).href
       let mxcad = MxCpp.getCurrentMxCAD()
       let blkrecId = await mxcad.insertBlock(blkFilePath, "tree")
       if (!blkrecId.isValid()) return;
       let blkRef = new McDbBlockReference();
       blkRef.blockTableRecordId = blkrecId;
       // 设置块大小
       let box = blkRef.getBoundingBox();
       if (box.ret) {
         let dLen = box.maxPt.distanceTo(box.minPt);
         if (dLen > 0.00001) {
           blkRef.setScale(mxcad.getMxDrawObject().screenCoordLong2Doc(100) / dLen);
         }
       }
       // 设置块基点
       let getPoint = new MxCADUiPrPoint();
       getPoint.setMessage("\指定插入基点");
       getPoint.setUserDraw((v, worldDraw) => {
         blkRef.position = v;
         worldDraw\.drawMcDbEntity(blkRef);
       });
       let pt = await getPoint.go();
       if (!pt) return;
       blkRef.position = pt;
       mxcad.drawEntity(blkRef);
   }

示例效果如下图：

3. 遍历所有图块

我们可以通过调用块表McDbBlockTable()中的getAllRecordId()方法获取所有图块的id，再调用getMcDbBlockTableRecord()方法返回图块记录对象McDbBlockTableRecord()，得到所有图块记录对象数据，参考代码如下：

   import { MxCpp } from "mxcad"
   let mxcad = MxCpp.App.getCurrentMxCAD();
   let blockTable = mxcad.getDatabase().getBlockTable();
   let aryId = blockTable.getAllRecordId();
   aryId.forEach((id) => {
   let blkRec = id.getMcDbBlockTableRecord();
   if (blkRec === null) return;
       console.log(blkRec);
       console.log("blkRec.name:" + blkRec.name);
       console.log("blkRec.origin:" + blkRec.origin);
   });

4. 删除图块

我们得到图块记录对象McDbBlockTableRecord()后可调用该对象实例的erase()方法删除对象，参考代码如下：

import { MxCpp } from "mxcad"
   let blockTable = MxCpp.getCurrentMxCAD().getDatabase().getBlockTable()
   let blockId = blockTable.get("目标图块名")
   blockId.erase()
   // 更新显示
   mxcad.updateDisplay()

5. 查找图块

我们可以调用 McDbBlockTable块表中的has()方法判断当前数据库中，是否存在指定的块名，参考代码如下：

   import { MxCpp } from "mxcad";
   const mxcad = MxCpp.getCurrentMxCAD();
   const dataBase = mxcad.getDatabase();
   const blkTable = dataBase.getBlockTable();
   const res = blkTable.has("目标块名");
   if(res){
       console.log("存在目标块")
   }

6. 遍历图块下的所有实体

由于图块中的实体可能是另外的一个图块，因此，在遍历图块下所有实体时我们还需要遍历图块中的图块。下面以选择目标图块输出图块中所有实体的id和对象类型为例，参考代码如下：

import { MxCADResbuf, MxCADUiPrEntity , McDbBlockReference, McDbBlockTableRecord} from "mxcad";
   // 遍历图块下所有实体
   async function Mx\_ForEachBlkEntity(){
       // 选择目标块
       let filter = new MxCADResbuf();
       filter.AddMcDbEntityTypes("INSERT");
       const getBlockEvent = new MxCADUiPrEntity()
       getBlockEvent.setMessage('选择目标块');
       getBlockEvent.setFilter(filter);
       const block\_id = await getBlockEvent.go();
       if (!block\_id.id) return;
       // 获取块实体
       const blkRef = block\_id.getMcDbEntity() as McDbBlockReference;
       // 获取块表记录对象
       let blkRec = blkRef.blockTableRecordId.getMcDbBlockTableRecord();
       // 遍历图块实体
       Mx\_ModyfBlockRecordEntity(blkRec)
   }
   function Mx\_ModyfBlockRecordEntity(blkRec: McDbBlockTableRecord) {
       // 获取图块中所有实体Id
       blkRec.getAllEntityId().forEach(id => {
           let ent = id.getMcDbEntity();
           // 若实体为图块，则递归遍历
           if (ent instanceof McDbBlockReference) {
               let blkref = ent as McDbBlockReference;
          Mx\_ModyfBlockRecordEntity(blkref.blockTableRecordId.getMcDbBlockTableRecord());
           }else{
              // 输出实体id、实体类名
               console.log(id.id,ent.objectName);
           }
       })
   }

7. 选择实体做成块

我们可以通过MxCADSelectionSet选择集获取目标实体，再新建McDbBlockTableRecord块表记录对象，将选择的实体对象通过appendAcDbEntity()方法写入记录对象中，最后设置图块的基点、位置等，参考代码如下：

import { MxCADSelectionSet, MxCpp, McDbBlockTableRecord, McGePoint3d } from "mxcad";
   // 选择实体做成块
   async function MxTest\_SelectEntitysToBlock() {
     // 选择要做成块的对象
     let ss = new MxCADSelectionSet();
     if(!await ss.userSelect("选择要做成块的对象:") ) return;
     if(ss.count() == 0) return;
     let mxcad = MxCpp.getCurrentMxCAD();
     // 获取数据库块表
     let blkTable =  mxcad.getDatabase().getBlockTable();
     // 创建新的块表记录对象
     let blkRecId = blkTable.add(new McDbBlockTableRecord());
     let blkTableRecord:McDbBlockTableRecord = blkRecId.getMcDbBlockTableRecord() as any;
     if(blkTableRecord == null) return;
     // 定义新建图块的包围盒最大点和最小点
     let pt1x:any,pt1y:any,pt2x:any,pt2y:any;
     // 遍历选择的实体获取新建图块的包围盒最大点和最小点
     ss.forEach((id)=>{
       let ent = id.getMcDbEntity();
       if(!ent) return;
       let cent = ent.clone() as McDbEntity;
       blkTableRecord.appendAcDbEntity(cent);
       let entBox = ent.getBoundingBox();
       if(entBox.ret){
         if(!pt1x){
           pt1x = entBox.minPt.x;
           pt1y = entBox.minPt.y;
           pt2x = entBox.maxPt.x;
           pt2y = entBox.maxPt.y;
         }
         else {
           if(pt1x > entBox.minPt.x) pt1x= entBox.minPt.x;
           if(pt1y > entBox.minPt.y) pt1y= entBox.minPt.y;
           if(pt2x < entBox.maxPt.x) pt2x= entBox.maxPt.x;
           if(pt2y < entBox.maxPt.y) pt2y= entBox.maxPt.y;
         }
       }
     })
     if(pt1x === undefined){
       return;
     }
     let insertPtx =  pt1x + (pt2x - pt1x) \* 0.5;
     let insertPty =  pt1y + (pt2y - pt1y) \* 0.5;
     // 设置图块的插入基点，在图形对象的中心位置。
     blkTableRecord.origin = new McGePoint3d(insertPtx,insertPty,0);
     // 设置图块位置
     let blkRef = new McDbBlockReference();
     blkRef.blockTableRecordId = blkRecId;
     blkRef.position = new McGePoint3d(insertPtx,insertPty,0);
     // 绘制图块
     mxcad.drawEntity(blkRef);
     // 删除原实体
     ss.forEach((id)=>{
       let ent = id.getMcDbEntity();
       if(!ent) return;
       ent.erase();
     });
   }

示例效果如下：

8. 把一个DWG文件插入到当前文件

我们可以调用 mxcad 对象的insertBlock()方法把一个DWG文件，插入到图上，指定一个块名，放在块表记录中，下面以在文件中插入一个图章为例，点击[McObject.insertBlock()]查看详细属性和方法说明，参考代码如下：

import { MxCpp, McDbBlockReference, MxCADUiPrPoint } from "mxcad";
   // 插入图章
   async function MxTest\_InsertStamp() {
     // 设置块文件地址
     let baseUrl = "<http://localhost:3000/mxcad/>"
     if (baseUrl.substring(0, 16) == "<http://localhost>") {
       baseUrl = getHostUrl() + baseUrl.substring(16);
     }
     let blkFilePath = baseUrl + "stamp.mxweb";
     let mxcad = MxCpp.App.getCurrentMxCAD();
     // 插件图块文件
     let blkrecId = await mxcad.insertBlock(blkFilePath, "stamp");
     if (!blkrecId.isValid()) {
       // 未插入图块
       return;
     }
     // 创建一个新的图块引用实体
     let blkRef = new McDbBlockReference();
     // 设置图块引用实体的图块记录id为blkrecId
     blkRef.blockTableRecordId = blkrecId;
     // 适应图块大小
     let box = blkRef.getBoundingBox();
     if (box.ret) {
       let dLen = box.maxPt.distanceTo(box.minPt);
       if (dLen > 0.00001) {
         blkRef.setScale(mxcad.getMxDrawObject().screenCoordLong2Doc(100) / dLen);
       }
     }
     // 设置图块基点
     let getPoint = new MxCADUiPrPoint();
     getPoint.setMessage("\指定插入基点");
     // 动态绘制图块
     getPoint.setUserDraw((v, worldDraw) => {
       blkRef.position = v;
       worldDraw\.drawMcDbEntity(blkRef);
     });
     // 设置图块位置
     let pt = await getPoint.go();
     if (!pt) return;
     blkRef.position = pt;
     // 绘制图块实体
     mxcad.drawEntity(blkRef);
   }

示例效果如下：

9. 块属性

在AutoCAD中，块属性是将数据附着到块上的标签或标记。我们可以通过新创建一个块引用中的属性定义文字类McDbAttribute来为目标图块添加属性文字。下面以插入一个带有属性文字的图块为例。

点击[McDbAttribute]查看详细属性和方法说明，参考代码如下：

// 在块中插入属性文字 ent:块实体
   let blkRef: McDbBlockReference = ent;
   const blkrecId = blkRef.blockTableRecordId
   // 获取图块记录对象
   let blkRecord: any = blkrecId.getMcDbBlockTableRecord();
   // 获取图块记录中的所有实体对象ID
   let ids = blkRecord.getAllEntityId();
   // 遍历实体类型，添加属性文字
   ids.forEach((id: any, index: any) => {
     if (!id.isKindOf("McDbAttributeDefinition")) return;
     let attribDef = id.getMcDbEntity() as McDbAttributeDefinition;
     let tag = attribDef.tag;
     // 设置属性详情
     let attrib = new McDbAttribute();
     attrib.position = attribDef.position;
     attrib.alignmentPoint = attribDef.alignmentPoint;
     attrib.height = attribDef.height;
     attrib.trueColor = attribDef.trueColor;
     attrib.widthFactor = attribDef.widthFactor;
     attrib.textString = "test" + index;
     attrib.tag = tag;
     attrib.isInvisible = attribDef.isInvisible;
     attrib.transformBy(blkRef.blockTransform);
     attrib = blkRef.appendAttribute(attrib).getMcDbEntity() as McDbAttribute;
     attrib.textStyle = attribDef.textStyle;
     attrib.layer = attribDef.layer;
   })
  

示例效果如下：

10. 遍历块中的属性文字

我们可以调用图块引用实体 McDbBlockReference 对象中的 getAllAttribute() 方法获取图块中的所有属性文字。

点击[getAllAttribute()]查看详细属性和方法说明，参考代码如下：

import { McDbBlockReference, McDbAttribute } from "mxcad"
    // 遍历块中的属性文字 ent:块实体
    let blkRef: McDbBlockReference = ent;
    let aryId = blkRef.getAllAttribute();
    aryId.forEach((id) => {
      let attribt: McDbAttribute = id.getMcDbEntity() as any;
      console.log(attribt.textString);
      console.log(attribt.tag);
    })

在线示例

示例项目地址: [在线CAD梦想画图]https://demo.mxdraw3d.com:3000/mxcad/