🔰 🏷️ 👩🏻‍🔧 C＃でAutocad用のプラグインを作成した最初の経験＃ 📛 🔱 👃🏿

背景

私は初心者開発者であり、「学校」レベルのC ++知識、C＃でのプログラミング経験がわずか（2年）、AutoCADでの経験がゼロです。

最近、彼らは境界計画を作成/変更し、対応するMS Word / XMLドキュメントを準備するように設計されたLISP auto-cadプログラムを変更するように頼みました。バグを修正し、新しい機能を追加します。

Lispでのプログラムの読みやすさ（少なくとも私にとっては）が望まれているので、私はこれをより理解しやすい言語で書き直すことにしました。

なぜならミリ秒単位で速度を上げる必要はありませんでした。C++をスキップし、C＃で解決しました

この記事を書いているのは：

1. Autocadについて学んだことを棚に頭の中に入れます。

2.私のように、ごくわずかなドキュメントを読む人を助けるため。

3.「あなたは間違っています。そうする方が簡単で良い」などのコメント情報を入手してください。

始めましょう。プラグインを作成します。

ClassLibraryテンプレートを使用してC＃プロジェクトを作成する

プログラムフォルダにある管理されたAutocad APIライブラリへのリンクを追加します。

私の場合、これは次のとおりです。

C：\ Program Files \ AutoCAD 2007 \ acdbmgd.dll

C：\ Program Files \ AutoCAD 2007 \ acmgd.dll

何かをするクラスを作成します。

using Autodesk.AutoCAD.Runtime; using Autodesk.AutoCAD.ApplicationServices; namespace AutocadPlugin { public class test : IExtensionApplication { [CommandMethod("hello")] public void Helloworld() { var editor = Application.DocumentManager.MdiActiveDocument.Editor; editor.WriteMessage("  Autocad "); } public void Initialize() { var editor = Application.DocumentManager.MdiActiveDocument.Editor; editor.WriteMessage(" .."+Environment.NewLine); } public void Terminate() { } } }

IExtensionApplicationからの継承はオプションであり、Autocadはライブラリ内のすべてのパブリッククラスを自動的に取得しますが、先ほど述べたように、より高速になります。さらに、Initialize / Terminateプラグインを制御できます。

コンパイルし、autocadを実行し、netloadコマンドでプラグインをロードします（マネージDLL選択ウィンドウが開きます）

これで、helloコマンドを入力すると、予想される応答が得られます。

Autocadアプリケーション構造：

画面に表示されるもの、 エンティティから継承されたグラフィックオブジェクト

目に見える情報オブジェクトに加えて、 レイヤー 、線種、 寸法スタイル 、 表スタイルなどの不可視の情報オブジェクトがあります。

これはすべて、 データベーステーブルレコード 、 TYPETableタイプリポジトリおよびTYPETableRecordタイプクラスに格納されます。

オブジェクト識別子

ObjectId 、EName（エンティティ名）とも呼ばれます。画像を開いたときに作成される番号。

使用法-1つのセッション中のデータベース内のオブジェクトの識別。オブジェクトは、そのObjectIdによってデータベースから要求されます

発見ごとに異なる場合があります。オブジェクトへのリンクを保存するために使用しないことをお勧めします
ハンドル -文書の異なる開口部の間で変化しない数;ファイルを保存するときにオブジェクト間の関係を維持するためにそれを使用すると便利です。

詳細：ハンドルはAutoCADセッション間で永続的であるため、後で図面の更新に使用する必要のある外部ファイルに図面情報をエクスポートする必要がある場合、オブジェクトにアクセスする最良の方法です。 データベース内のオブジェクトのObjectIdは、データベースがメモリにロードされている間のみ存在します。 データベースが閉じられると、オブジェクトに割り当てられたオブジェクトIDは存在しなくなり、次回データベースを開いたときに異なる可能性があります。

データベースを操作する

通常、データベースの操作はトランザクションを使用して行われます。オブジェクトがデータベースから要求され、変更され、コミットトランザクションが保存されます。

トランザクション中、3つのForRead、ForWrite、ForNotifyモードのいずれかでデータベースからオブジェクトが要求されます。

最初の2つの目的は明らかであり、3番目は何らかの形でイベントのメカニズムに使用されます。

ForWriteモードでは、autocadはトランザクション内の変更を破棄できる追加のオブジェクトを作成します。

「ForRead」として開かれたオブジェクトを変更する場合、そのUpgradeOpen（）メソッドが呼び出されます。

既に変更モードで開いているオブジェクトでこのメソッドを呼び出すと、メソッドは例外をスローします。

ObjectIdによってPolylineオブジェクトを取得する例

 // UPDATE:     ,   .     ,     UpgradeOpen  , ..    public static Polyline GetPolylineByEname(ObjectId ename) { if (ename == ObjectId.Null) return null; Polyline polyline = null; var db = Application.DocumentManager.MdiActiveDocument.Database; using (var transaction = db.TransactionManager.StartTransaction()) { return transaction.GetObject(ename, OpenMode.ForRead) as Polyline; } }

トランザクションはネストでき、最上位のトランザクションがキャンセルされると、すべての子もキャンセルされます。

最初は、長い間、エラーの場所を特定できませんでした。画像の変更は保存されませんでした。結局のところ、私は上のトランザクションを閉じるのを忘れていました。

イラスト

 public void OwnerTransFunction() { var db = Application.DocumentManager.MdiActiveDocument.Database; using (var transaction = db.TransactionManager.StartTransaction()) { //   ChangePolylineInChildTransation() } } public void ChangePolyline() { var db = Application.DocumentManager.MdiActiveDocument.Database; using (var transaction = db.TransactionManager.StartTransaction()) { //   //   transaction.Commit(); //       ,       Commit'a    } }

更新：コメントで示唆されているように、トランザクションをキャンセルする必要がある場合を除いて、常にtransaction.Commit（）を呼び出すことをお勧めします。トランザクションがコミットされていない場合、transaction.Abort（）が自動的に呼び出され、追加のコストが発生します。

辞書

不要なファイルを作成しないように、辞書を使用してデータをDWGに保存しました

図面で2種類の辞書-NamedObjectDictionaryとExtensionDictionaryに 出会いました

辞書のデータはレコード（レコード）に格納され、レコードには型付きの値が格納されます。

テキストキーのデータをアドレス指定します。

NamedObjectDictionary-グローバルな描画辞書。ドキュメントの作成時に自動的に生成されます。

使用するメインオブジェクトへのリンクを保存するために使用しました。

ExtensionDictionary-各オブジェクトの辞書。手動で作成する必要があります。

entity.ExtensionDictionaryフィールドをObjectId.Nullと比較することにより、その存在を確認できます。

ExtensionDictionaryから文字列値を書き込んで取得する例

 public static void SetExtDictionaryValueString(ObjectId ename, string key, string value) { if (ename == ObjectId.Null) throw new ArgumentNullException("ename"); if (String.IsNullOrEmpty(key)) throw new ArgumentNullException("key"); var doc = Application.DocumentManager.MdiActiveDocument; using (var transaction = doc.Database.TransactionManager.StartTransaction()) { var entity = transaction.GetObject(ename, OpenMode.ForWrite); if (entity == null) throw new DataException("      ExtensionDictionary: entity  ObjectId=" + ename + "  "); //    extDictionary var extensionDictionaryId = entity.ExtensionDictionary; if (extensionDictionaryId == ObjectId.Null) { entity.CreateExtensionDictionary(); extensionDictionaryId = entity.ExtensionDictionary; } var extDictionary = (DBDictionary) transaction.GetObject(extensionDictionaryId, OpenMode.ForWrite); //     if (String.IsNullOrEmpty(value)) { if (extDictionary.Contains(key)) extDictionary.Remove(key); return; } var xrec = new Xrecord(); xrec.Data = new ResultBuffer(new TypedValue((int) DxfCode.ExtendedDataAsciiString, value)); extDictionary.SetAt(key, xrec); transaction.AddNewlyCreatedDBObject(xrec, true); Debug.WriteLine(entity.Handle+"['" + key + "'] = '" + value + "'"); transaction.Commit(); } } public static string GetExtDictionaryValueString(ObjectId ename, string key) { if (ename == ObjectId.Null) throw new ArgumentNullException("ename"); if (String.IsNullOrEmpty(key)) throw new ArgumentNullException("key"); var doc = Application.DocumentManager.MdiActiveDocument; using (var transaction = doc.Database.TransactionManager.StartTransaction()) { var entity = transaction.GetObject(ename, OpenMode.ForRead); if (entity == null) throw new DataException("      ExtensionDictionary:   ObjectId=" + ename + "  "); var extDictionaryId = entity.ExtensionDictionary; if (extDictionaryId == ObjectId.Null) throw new DataException("      ExtensionDictionary:   "); var extDic = (DBDictionary)transaction.GetObject(extDictionaryId, OpenMode.ForRead); if (!extDic.Contains(key)) return null; var myDataId = extDic.GetAt(key); var readBack = (Xrecord)transaction.GetObject(myDataId, OpenMode.ForRead); return (string)readBack.Data.AsArray()[0].Value; } }

グローバルディクショナリの操作はほとんど同じで、DBDictionaryオブジェクトのみが次のように取得されます。

 var dictionary = (DBDictionary) transaction.GetObject(db.NamedObjectsDictionaryId, OpenMode.ForWrite);

私は他に何に遭遇しました

1.プラグインの起動

プラグインの5秒間のチェックのためにnetloadを数十回入力した後、私はそれにうんざりし、手順を簡素化する方法を探し始めました。

検索中に、.NETプラグインの自動読み込みに関する記事に出会いました。要するに、レジストリにキーを追加する必要があります

 Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCAD\R17.0\ACAD-5001:419\Applications\GeocomplexPlugin] "LOADCTRLS"=dword:00000002 "MANAGED"=dword:00000001 "LOADER"="C:\\GeoComplexAutocadPlugin\\AutocadGeocomplexPlugin.dll"

説明：

R17.0-Autocad 2007

ロシア語版の場合は419

英語版の場合は409

GeocomplexPlugin-作成されたパーティション

LOADCTRLS = 2-起動時にAutoCADをロードします。特定のキーを使用してオンデマンドで起動できます。プラグインは、コマンドの1つが入力されるとロードされます。

ローダー-プラグインへのパス

2.デバッグ

~~なぜなら~~ ~~プラグインでは、VSで段階的なデバッグを開始することは不可能であるため、いくつかの段階でデバッグメッセージを表示する必要がありました。~~

~~この目的のAutoCADのエディターは使用するのが不便なので、標準のDebug.WriteMessage（）ツールを使用してメッセージを出力します~~

~~デバッグは、デバッグモードでコンパイルする場合にのみ表示されます。出力データは、DebugViewプログラムを実行して表示できます。~~

更新：段階的なデバッグの問題を解決しました：

この方法でこの問題を打ち負かしました：

autocad構成ファイルで、acad.exe.configはv4.0にランタイムをインストールしました。

  <configuration> <startup useLegacyV2RuntimeActivationPolicy="true"> <supportedRuntime version="v4.0"/> </startup> <runtime> <generatePublisherEvidence enabled="false"/> </runtime> </configuration>

プラグインランタイムを4.0クライアントプロファイルに変更しました

また、アセンブリ設定AssemblyInfo.csは属性AllowPartiallyTrustedCallersをコメントアウトしました

3.エディターでコマンドを送信する

一部のアクションは、Autocad .NET APIに実装されていないか、コマンドラインで実行する方がはるかに簡単です。

コマンドを実行する最も簡単な方法は、ZoomExtentsの例である関数を実行することです。

 var doc = Application.DocumentManager.MdiActiveDocument; doc.SendStringToExecute("_zoom _e ",false,false,true);

AutoCADでは、スペースはEnterに相当します。そのため、末尾のスペースなしでコマンドを送信すると、_eがeditor'eに入力され、さらに入力を待つことになります。

ただし、この方法は常に使用できるとは限りません。 SendStringToExecuteコマンドの原則は、コマンドによって呼び出された関数が完了した後にのみコマンドが送信されるということです。したがって、最初にこのコマンドを呼び出してから、たとえば、ユーザーが図内のオブジェクトを選択するように要求すると、2行が選択関数「_zoom」、「_ e」に送信され、誤ったオブジェクトとして認識されます。

すぐに実行されるアナログを探す必要があります。この場合：

 object acad = Application.AcadApplication; acad.GetType().InvokeMember("ZoomExtents", BindingFlags.DeclaredOnly | BindingFlags.Public | BindingFlags.Instance | BindingFlags.InvokeMethod, null, acad, null);

4.オブジェクトのユーザー選択

オブジェクトを選択するには、editor'a Get *関数を使用します

たとえば、複数のオブジェクトの選択-GetSelection、1つのGetEntityの選択...

 var editor = Application.DocumentManager.MdiActiveDocument.Editor; var promtResult = editor.GetEntity(" "); editor.WriteMessage(Environment.NewLine); if (promtResult.Status == PromptStatus.OK) { editor.WriteMessage("Selected Object's ID: " + promtResult.ObjectId+Enviropment.NewLine); }

ドキュメントフォルダーへのパスを取得する

インターネットで検索すると、完全なファイル名にアクセスする2つの方法が生成されました。

MdiActiveDocument.Database.Filename

MdiActiveDocument.Name

一見、それらは同じですが、

トピックについて-Database.Filenameプロパティの使用はお勧めしません。自動保存後、ファイル自体ではなく、自動保存コピーを示します-Document.Nameとは異なります

標準の.NETツールを使用して、フォルダーへのパスを取得しました。

Path.GetDirectoryName（Application.DocumentManager.MdiActiveDocument.Name）;

返された文字列が空の場合、ドキュメントは作成されますが保存されません

そして、さらに便利なコードスニペット：

ポリライン座標の変更（延長方法）

 //    ( ): public static void UpdatePoints(this Polyline polyline, List<Point2d> newPoints) { if (polyline == null) throw new ArgumentNullException("polyline"); if (newPoints.Count < 2) throw new ArgumentException("     "); using (var transaction = Application.DocumentManager.MdiActiveDocument.Database.TransactionManager.StartTransaction()) { //    ,      var pline = transaction.GetObject(polyline.ObjectId,OpenMode.ForWrite) as Polyline; if (pline == null) throw new DataException("!     "); var bulge = pline.GetBulgeAt(0); var start_width = pline.GetStartWidthAt(0); var end_width = pline.GetEndWidthAt(0); var prevPointsCount = pline.NumberOfVertices; //    //     ,    , .. Autocad      0  1  //    for (int i = prevPointsCount; i < prevPointsCount + newPoints.Count; i++) pline.AddVertexAt(i, newPoints[i - prevPointsCount], bulge, start_width, end_width); //    for (int i = prevPointsCount - 1; i >= 0; i--) pline.RemoveVertexAt(i); transaction.Commit(); } }

ポリラインの座標を取得する（拡張メソッド）：

 //    ( ): public static Point2d[] GetPoints(this Polyline polyline) { if (polyline == null) { Debug.WriteLine(" !      "); return null; } if (polyline.NumberOfVertices == 0) return null; var points = new List<Point2d>(); for (int i = 0; i < polyline.NumberOfVertices; i++) points.Add(polyline.GetPoint2dAt(i)); return points.ToArray(); }

便利なリンク

1. AutoCAD .NET開発者ガイド

英語のミニリファレンスは、VB.NET、C＃.NET、VBAのコードサンプルでAutocadデバイスの本質を説明しています

2. インターフェイスを介して

Kean Walmsleyのブログ、多くのHowto。 C＃、C＃+ COM、VB.NET、C ++の例があります。そこで検索することはできませんが、Googleからのリクエストの半分である「これを行う方法」は、このサイトにつながりました

3. caduser.ru、サブフォーラム「.NET」

トピックに精通しているロシア語を話す人々とのコミュニケーション。多くの場合、困難な場所を理解するのに役立ちました

C＃でAutocad用のプラグインを作成した最初の経験＃

背景