一、本節課程
Arx二次開發創建直線、圓、圓弧和修改對象屬性
二、本節要講解的知識點
1、如何應用C++ ARX二次開發創建直線。
2、如何應用C++ ARX二次開發創建圓。
3、如何應用C++ ARX二次開發創建圓弧。
4、如何修改對象的屬性。
5、騰訊課堂雲幽學院詳細的內容講解。
三、具體內容
1、創建一條直線，直線的起點是（0,0,0），直線的終點（100,100,0）。
2、表：表是數據庫的組成單位，一個數據庫至少含有一個表。
3、記錄：記錄是表的組成單位，一個表可能含有多個記錄，也可能不包含任何記錄。
4、用一個圖來描述AUTOCAD圖形數據庫的基本結構。
5、創建圖形對象的步驟：
（1）確定要創建對象的圖形數據庫：acdbHostApplicationServices->workingDatabase()
（2）獲得這個圖形數據庫的塊表：->getBlockTable(塊表指針,打開的方式)
（3）獲得一個存儲實體的塊表記錄，所有模型空間的實體都存儲在模型空間的特定記錄里面。
（4）創建實體類對象，將該對象附加到特定的塊表記錄中。
6、創建命令需要修改兩個地方：拷貝模板提供的代碼，將里面的命令修改成自己想要定義的命令名字（命令的全局名和本地名）。
實現命令的函數：static void YunyouMyGroupCreateLine ()，命令函數名字由三部分組成，包括前綴標識“Yunyou”，命令組的名字“MyGroup”、命令名字“CreateLine”。
7、創建直線的實現代碼如下
| static AcDbObjectId YunyouMyGroupCreateLine () { //（1）確定要創建對象的圖形數據庫:acdbHostApplicationServices()->workingDatabase() //（2）獲得這個圖形數據庫的塊表:acdbHostApplicationServices()->workingDatabase()->getBlockTable(pBlockTable,AcDb::kForRead); //（3）獲得一個存儲實體的塊表記錄，所有模型空間的實體都存儲在模型空間的特定記錄里面：pBlockTable->getAt(ACDB_MODEL_SPACE,pBlockTableRecord,AcDb::kForWrite) //（4）創建實體類對象，將該對象附加到特定的塊表記錄中。 AcDbLine *pLine=new AcDbLine(ptStart,ptEnd); pBlockTableRecord->appendAcDbEntity(lineId,pLine); //關閉我們實體、塊表記錄、塊表。否則導致致命錯誤AUTOCAD的退出。 AcGePoint3d ptStart(0,0,0); AcGePoint3d ptEnd(100,100,0); AcDbLine *pLine=new AcDbLine(ptStart,ptEnd); AcDbBlockTable *pBlockTable=NULL; acdbHostApplicationServices()->workingDatabase()->getBlockTable(pBlockTable,AcDb::kForRead); AcDbBlockTableRecord *pBlockTableRecord; pBlockTable->getAt(ACDB_MODEL_SPACE,pBlockTableRecord,AcDb::kForWrite);//模型空間就是一個塊表記錄 AcDbObjectId lineId; pBlockTableRecord->appendAcDbEntity(lineId,pLine); pBlockTable->close(); pBlockTableRecord->close(); pLine->close(); return lineId; } |
8、對於高版本（AutoCAD2016及以上）來說，編譯后生成的ARX文件需要放置在AUTOCAD的安裝目錄或者其目錄下，在加載ARX時就不會有“安全性提示”。
9、加載ARX： 在命令行ARX 回車 Load, APPLOAD
10、調用命令：CreateLine,效果如下：
在模型空間創建了一條直線，直線的起點是（0,0,0）直線的終點是（100,100,0）。
11、修改對象屬性的思路：需要打開圖形數據庫的對象，AcDbObjectId
打開和關閉圖形數據庫的對象：
（1）acdbOpenAcDbEntity適用於打開繼承於AcDbEntity的數據庫常駐對象。
Acad::ErrorStatus acdbOpenAcDbEntity(
AcDbEntity*& pEnt,
AcDbObjectId id,
AcDb::OpenMode mode,
bool openErasedEntity = false
);
（2）acdbOpenAcDbObject適合於打開未繼承於AcDbEntity的數據庫常駐對象。
Acad::ErrorStatus acdbOpenAcDbObject(
AcDbObject*& pObj,
AcDbObjectId id,
AcDb::OpenMode mode,
bool openErasedObject = false
);
（3）acdbOpenObject不知道要打開的對象是否繼承於AcDbEntity時采用此方法。
ACDB_PORT Acad::ErrorStatus acdbOpenObject(
AcDbObject*& pObj,
AcDbObjectId id,
AcDb::OpenMode mode,
bool openErased = false,
const AcRxClass * pClass = nullptr
);
打開對象之后使用close()方法將其關閉。
12、ID(AcDbObjectId)、指針、句柄(handle)、和ads_name
（1）ID：AcDbObjectId，在一個AUTOCAD任務中，可能會加載有多個圖形數據庫，但是所有對象的ID在這次任務中都是獨一無二的，在不同任務中，同一圖形對象的ID可能不同。適合編程使用。
（2）句柄：handle,在一個DWG圖形文件里面是唯一的，但是不同的DWG文件句柄有可能重復。句柄隨DWG文件一起保存的，兩次任務中同一對象的句柄是相同的。
（3）ads_name :不穩定的，在AUTOCAD中的一個特定圖形中工作時可以使用，一旦退出AUTOCAD或者切換到另外一個圖形，就會消失。
13、轉化問題：
（1） ID-->對象指針：acdbOpenAcDbEntity、acdbOpenAcDbObject、acdbOpenObject
（2） 對象指針->ID：所有的對象都繼承於AcDbObject，包含了一個叫做objectId()的函數可以獲取到對象的指針。
（3） 句柄到ID:AcDbDataBase:getAcDbObjectId.
（4） ID到句柄：使用AcDbObjectId的handle函數。
（5） 指針到句柄：AcdbObject的getAcDbHandle函數
（6） ads_name到ID：使用全局函數acdbGetObjectId
（7） ID到ads_name:使用全局函數acdbGetAdsName。
四、總結
（1）圖形數據庫組成單位是表，表的組成單位是記錄，實體包含在塊表記錄里面，要創建實體的步驟是：需要確定圖形數據庫，打開塊表，獲取特定的塊表記錄（通常來說就是模型空間），創建實體，並將實體添加到塊表記錄里面。
（2）高版本的ARX模塊如果不在AUTOCAD“內部路徑”則會有安全性提示，建議開發階段將生成的文件放置於AUTOCAD安裝路徑的子目錄中，避免惱人提示。
（3）幾種標識： ID\句柄\ads_name\對象指針，特點以及如何使用、如何轉換。