.NET APIを使用してAutoCAD用のプラグインを作成する（パート1-最初のステップ）

こんにちは、Habr！

AutoCADでの経験について話すことにしました。 多分これは誰かを助けるだろう-まあ、または少なくともそれは面白いように思えます。

public static string disclaimer = "          AutoCAD.   –        ."; 

背景

すべてが非常に簡単に始まりました。再びお金の不足を感じたので、私はそれをどこかで探し始める時だと決めました。 そのため、 Freelansimで数週間検索した後 、開発者の空きが発見され、AutoCADとやり取りするプログラムが作成されました。

私はすぐに言わなければなりません：私はその日までAutoCADと通信する機会がありませんでした。 しかし、広告には「仕事の経験は必要ありません」というフレーズが含まれていて、それが私の魂を希望で満たしました。 空席を投稿した人に連絡し、テストタスクを取得しました。

テストのために、図面にいくつかのオブジェクトを作成し、テキストを表示することが提案されました。 数日間、APIに関する情報を検索し、珍しいプログラムで友達を作ろうとしました。 最後に、図が描かれ、テキストが表示され、検証のためにテストタスクが送信されました。 そして数日後、私は突然受け入れられたことがわかりました！ 奇跡、そしてのみ。

次の段落で-私の印象、あざやぶつかり、考えやアドバイス（有害かもしれない）。 開発はAutoCAD 2010の下で行われ、適切なVisual Studio 2013 ExpressがIDEとして使用されました。 開発言語はC＃です。

1.必要なツールの準備

1.1。 実際にはAutoCAD

ここではすべてが明確です。 オートデスクの公式Webサイトからダウンロードして、30日間、素晴らしいツールをお楽しみください。 次に、購入価格を調べて、 自分を絞ってください 。 開発者には、オートデスク製品の開発ライセンスを取得できる特別なADNプログラムがあります。 サイトに記載されているサブスクリプションの基本バージョンのコストは、年間700ドルからです。

1.2。 ObjectARX SDK-AutoCADでの作業に必要なライブラリのセット

ライブラリの最後の3つまたは4つのバージョンは、登録後にここから無料でダウンロードできます。 以前のものを探す必要があります- ここで言う。 念のため、ここでリストを複製します。それほど長くはありません。


個人的に、私はかつてObjectARXの後方互換性の問題に非常に興味がありました。 かつて、顧客は「プログラムはどのバージョンのAutoCADで動作しますか？」と尋ねました。そして、答えを探すのにかなりの時間を費やさなければなりませんでした。 一般的に、答えは「 オートデスクは3年間下位互換性があります。」 相互に互換性のあるバージョンは、上記のネタバレで確認できます。

これまでのところ、私はプログラムを他のライブラリと再コンパイルするタスクに遭遇していません。 これは良いことだと思います。AutoCADの他のリリース用に別のバージョンの製品を作成する見込みはまったくありません。

1.3。 MS Visual Studio 2013 Express

素晴らしいIDE！ 彼女について言うことはもうありません。 多数のダウンロードリンクがあります 。たとえば、 こちらです。

もちろん、以前のバージョンを使用することもできます。 MS Visual Studio 2010でプロジェクトの作業を開始しましたが、その後、最新のリリースに切り替えることにしました。

1.4。 検索エンジン、忍耐、常識

プログラミングの経験はあまりありませんでした。私の目には.NETプラットフォームツールで十分な簡単なタスクを解決することに慣れていました。 そして、私のAutoCADプログラミングの最初の知り合いはそれほど単純ではありませんでした。 不快な驚きは、AutoCADを操作するためのクラス：

• クラス、プロパティ、またはメソッドの割り当てに関する使い慣れたツールチップはありません。
• 詳細なヘルプはありません。

その結果、Object ARXヘルプファイル（ C：\ ObjectARX 2010 \ docsという名前のフォルダーにインストールされています）および多数のフォーラム、ブログ、AutoCAD開発者コミュニティから情報を取得しました。 率直に言って、後者は最初のものよりも役立ちました。 :)

この記事の最後には、質問をしたり、運がよければ答えを得ることができるリソースのリストがあります。

2.ライブラリプロジェクトの作成

最初の手順は、 ここで非常に明確に説明されています 。 英語を話す人もここに来ることができます 。 確かに、最後のリンクの資料では、Visual Basicに重点が置かれています。さらに、AutoCADのプラグインを作成するためのプロジェクトテンプレートである「AutoCAD .NETウィザード」をインストールする必要があります。 知識のある人々は、このテンプレートは人生を大幅に簡素化すると言います。 私はそれを使用したことがないので、控えめに黙ってください。

メインステージを簡単に複製します。

2.1。 クラスライブラリプロジェクトを作成する

プラグインがAutoCADの古いバージョンを対象としている場合、使用するプロジェクトプロパティで.NETバージョンをすぐに設定することをお勧めします。 たとえば、AutoCAD 2010は.NET Framework 4を使用して作成されたプラグインを読み込むことができないため、使用するバージョンとして.NET Framework 3.5を指定します。

プロジェクトで使用されている.NET Frameworkのバージョンをダウングレードすると、エラーメッセージが表示される場合があります。 私の場合、Visual Studioは「Microsoft.CSharp」アセンブリがないと誓っています。参照から除外するだけです。

2.2。 必要なAutoCAD .NET APIライブラリへのリンクを追加します

この時点で、もう少し詳しく説明する価値があります。 AutoCAD .NET APIには、さまざまなネームスペースで区切られたかなり多数のクラスが含まれています。 同様に、これらの名前空間は、いくつかのコンテナ（つまり、DLLファイル）にまたがって配置されます。

これらのdllファイルは、 inc- <architecture_name>という名前のフォルダーにあります。 したがって、私の場合、 C：\ ObjectARX 2010 \ inc-win32フォルダーからライブラリへのリンクを追加します。


APIを初めて知ったのは、Web全体にgeneしみなく散らばっているサンプルの少なくとも1つをコンパイルしようとする熱心な試みでした。 そして、 λλの典型的なものは 、頑固にコンパイルすることを望まず、未知の名前空間とクラスを誓った。 悲しみとともに最初のプロジェクトを構築しようとして、ObjectARXに付属するほぼすべてのDLLファイルを含めました。 悪い方法は、あなたがする必要がないことです。


重要なポイント ：プロジェクトをビルドするときに、AutoCAD .NET APIライブラリをアセンブリディレクトリにコピーしないようにしてください。 これを行うには、追加された各リンクのプロパティでCopyLocalパラメーターを見つけてFalse設定します。

2.3。 プラグインコードを書く

 using System.Windows.Forms; using Autodesk.AutoCAD.Runtime; namespace MyAutoCADDll { public class Commands : IExtensionApplication { //   (   ) public void Initialize() { MessageBox.Show("Hello!"); } // ,     public void Terminate() { MessageBox.Show("Goodbye!"); } //        AutoCAD  «TestCommand» [CommandMethod("TestCommand")] public void MyCommand() { MessageBox.Show("Habr!"); } } } 

すべてが非常に簡単です。 まず、必要な名前空間を指定します。 2つ必要です。

最初の名前空間（ System.Windows.Forms ）には、 MessageBoxを表示するMessageBoxクラスの説明が格納されます。 使用可能にするには、同じ名前の.NETアセンブリへのリンクを追加する必要があります。

2番目のネームスペース（ Autodesk.AutoCAD.Runtime ）は、 IExtensionApplicationインターフェイスとCommandMethod属性を定義します。 さらに、 IExtensionApplicationの説明はAcDBMgd.dllファイルにあり、 CommandMethod説明はAcMgd.dllファイルにあるため、これらの両方のライブラリへのリンクを追加する必要があります。

したがって、合計で3つのリンクを追加する必要があります。

---

UPD。 2018年4月9日。 lasteranからの重要な追加：新しいバージョン（おそらくAutoCAD 2013以降）では、 CommandMethodクラスはAcDBMgd.dllではなくAcCoreMgd.dllに含まれているため、このライブラリへのリンクも追加する必要があります。 新しいバージョンを使用するときは、このことに留意してください！

次に、 Commandsクラスを宣言します。 彼はプラグインの「出発点」になります。 このクラスはIExtensionApplicationインターフェイスから継承されているため、 InitializeおよびTerminateメソッドを実装できます。 それらの最初はプラグインがロードされると自動的に実行され、2番目はアンロードされると自動的に実行されます。


最後に、AutoCADコマンドを実装するMyCommand関数を宣言します。 彼女は入口で何も受け入れてはならず、出口で何も返してはいけません（この信念がどこから来たのかはわかりませんが、そうです）。 この関数内では、（当然ながら）必要なことを何でも行うことができ、AutoCAD .NET APIと標準の.NETクラスの両方で作業することができます。 たとえば、入力フィールドを使用して通常のWindowsフォームを作成し、 ShowModal()を使用して画面に表示し、ユーザーが入力したデータに基づいて、AutoCADで開いた図面を変更できます。

作成したメソッドをAutoCADコマンドに「変換」するには、 CommandMethod属性をCommandMethodます。 その後の括弧内には、作成されたコマンドの名前が示されており、AutoCAD環境で直接使用できます。

このプロジェクトを組み立てた後、プラグインを使用できるようにします。

2.4。 作成したプラグインをダウンロードする

AutoCADを起動し、「NETLOAD」コマンドを実行する必要があります。

---

次に、開いたウィンドウで、プラグインファイルへのパスを指定します。

---

その後、プラグインがAutoCADにロードされます。 最初のメッセージが表示されるはずです。

---

プラグインのロード中に重大なエラーが発生した場合、AutoCADコンソールに表示されます。



メッセージは通常理解可能である-ケースがあまり臨床的でない場合、それらは理解するのに役立つだろう。 :)


プラグインがロードされたので、テストコマンドを実行できます。

---

...そして結果を見る：



動作します。 これで、AutoCADを閉じることができます。

2.5。 デバッグプラグイン（必要な場合）

デバッグプラグインを起動する手順は 、 この Tepliukの 投稿で 詳しく説明されています。

ファイナル

さて-初めてで十分です。 約束されたリンクを提供することは残っています。 Namolemの投稿とn00buKの投稿には、すでに大量のソースが表示されています。 ここでそれらのいくつかを複製します。

1. http://adn-cis.org/forum/（rus）-Autodesk CIS Community Forum。 2013年から2014年に出会ったすべての中で最高のロシア語リソースの1つ。 私自身がアドバイスを求めてやって来ます。暑い時期であり、私を助ける機会がまだありません。 もちろん、私はあまり虐待しないようにしています。
2. http://forums.autodesk.com/t5/russkoe-soobshchestvo/bd-p/392（rus）-オートデスクの公式フォーラム-ロシアのコミュニティのセクション。 質問をすることができます。
3. http://forums.autodesk.com/t5/net/bd-p/152 （英語）-オートデスクの公式フォーラム-.NET APIのセクション。 質問することもできますが、無視することができます。
4. http://through-the-interface.typepad.com （英語）は、AutoCAD開発の主要なエキスパートの1人であるKean Walmsleyがホストするブログです。 最も貴重なリソース。 あなたはブログの所有者に何かを尋ねることができます-そして彼が気分にある場合は答えを得ることさえできます。 しかし、キーンはしばしば興味のない（そして単純な）質問を無視します-または公式フォーラムで解決策を探す質問者を提供します（図1を参照） 。
5. http://adndevblog.typepad.com （英語） -ADNの開発者の集合ブログ。 時々役立つ。
6. http://www.theswamp.org/index.php （英語）は、多くの例と解決策がある別のフォーラムです。

これで私の記事は終わりました。 それが適切であると認識されている場合-どういうわけか、私が遭遇したことについていくつかの簡単なメモを書きます：

• テープ（リボン）を使用します。
• レイヤーを操作します。
• 動的ブロックを操作します。
• ユーザー入力の実装。
• プラグインと外部アプリケーションとの相互作用。

ご清聴ありがとうございました！