块表
在DWG数据库中,所有图块存放在块表 McDbBlockTable() 中,块表中每一条记录称为图块记录对象 McDbBlockTableRecord() 。图块记录中存放着所有实体数据,用户可以通过改变图块的属性设置来修改其对应着的实体数据。
我们可以通过调用 mxcad 中的 MxCpp.getCurrentMxCAD()
得到当前的控件, 然后调用控件实例的 getDatabase() 方法得到数据库实例 McDbDatabase() ,在该数据库实例中调用 getBlockTable() 方法我们就能获取到块表 McDbBlockTable() 。
点击 块表 McDbBlockTable()、图块记录对象 McDbLinetypeTableRecord()、数据库实例 McDbDatabase() 查看详细属性和方法说明。
import { MxCpp} from "mxcad"
let mxcad = MxCpp.App.getCurrentMxCAD();
// 获取块表
let blockTable = mxcad.getDatabase().getBlockTable();
插入图块
我们可以调用 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);
}
提示
insertBlock() 方法中的块文件路径必须为网络文件路径且该文件为mxweb格式。
添加图块
我们可以通过实例化一个图块记录对象 McDbBlockTableRecord() ,再调用 add() 方法添加到块表中。其中图块记录对象可通过调用 appendAcDbEntity() 方法向目标对象中添加实体,实现自定义块功能。
import { MxCpp, McDbBlockTableRecord, McDbBlockReference, McDbLine, McCmColor } from "mxcad"
let mxcad = MxCpp.getCurrentMxCAD();
let blkTable = mxcad.getDatabase().getBlockTable();
let blkRecId = blkTable.add(new McDbBlockTableRecord());
// 根据ObjectId再次得到刚刚添加的图块记录
let blkTableRecord:McDbBlockTableRecord = blkRecId.getMcDbBlockTableRecord()
// 添加两条线段再图块记录中 这里每条线段的具体属性比如开始点和结束点自行赋值
const line = new McDbLine(80, 80, 0, -80, -80, 0)
line.trueColor = new McCmColor(255, 0, 0)
const line1 = new McDbLine(-80, 80, 0, 80, -80, 0)
blkTableRecord.appendAcDbEntity(line);
blkTableRecord.appendAcDbEntity(line1);
// 设置图块的基点 一般是包围盒内的点, 可以任意指定
blkTableRecord.origin = new McGePoint3d(0,0,0);
// 实例化块参照 这里需要设置我们刚刚添加图块记录得到的ObjectId
let blkRef = new McDbBlockReference();
blkRef.blockTableRecordId = blkRecId;
// 最后设置位置 渲染图块
blkRef.position = new McGePoint3d(0,0,0);
mxcad.drawEntity(blkRef);
遍历所有图块
我们可以通过调用块表 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);
});
删除图块
我们得到图块记录对象 McDbBlockTableRecord() 后可调用该对象实例的 erase() 方法删除对象。
import { MxCpp } from "mxcad"
let blockTable = MxCpp.getCurrentMxCAD().getDatabase().getBlockTable()
let blockId = blockTable.get("目标图块名")
blockId.erase()
// 更新显示
mxcad.updateDisplay()
查找图块
我们可以调用 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("存在目标块")
}
遍历图块下所有实体
由于图块中的实体可能是另外的一个图块,因此,在遍历图块下所有实体时我们还需要遍历图块中的图块。下面以选择目标图块输出图块中所有实体的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);
}
})
}
选择实体做成块
我们可以通过 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();
});
}
把一个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);
}
块属性
在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;
})
遍历块中的属性文字
我们可以调用图块引用实体 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);
})