スタートアップ

開発に取り組む前に、新しいプロジェクトのための強固な基盤を築くことが重要です。Dynamo 開発者のコミュニティには複数のプロジェクトテンプレートがあり、ここから始めると便利ですが、プロジェクトをゼロから開始する方法を理解することはさらに重要です。プロジェクトをゼロから構築すると、開発プロセスをより深く理解できます。

Visual Studio プロジェクトを作成する

Visual Studio は、プロジェクトの作成、参照の追加、.dlls のビルド、デバッグを行うことができる強力な IDE です。新しいプロジェクトを作成する際に、Visual Studio ではプロジェクトを編成するための構造であるソリューションも作成します。複数のプロジェクトを、単一のソリューション内に配置し、まとめてビルドできます。ZeroTouch ノードを作成するには、C# クラスライブラリを記述して .dll をビルドする新しい Visual Studio プロジェクトを開始する必要があります。

Visual Studio の新しいプロジェクトのウィンドウ
まず、Visual Studio を開いて、File > New > Project で新しいプロジェクトを作成します。
Class Library プロジェクトテンプレートを選択します。
プロジェクトに名前を付けます(この例ではプロジェクトに MyCustomNode という名前を付けています)。
プロジェクトのファイルパスを設定します。この例では、既定の場所のままにします。
Ok を選択します。

Visual Studio では自動的に C# ファイルを作成して開きます。適切な名前を付け、ワークスペースを設定し、既定のコードを次の乗算方法で置き換える必要があります。

 namespace MyCustomNode
 {
     public class SampleFunctions
     {
         public static double MultiplyByTwo(double inputNumber)
         {
             return inputNumber * 2.0;
         }
     }
 }

[View]からソリューションエクスプローラウィンドウと出力ウィンドウを開きます。
右側のソリューションエクスプローラで、ファイル Class1.cs の名前を SampleFunctions.cs に変更します。
乗算関数として上記のコードを追加します。Dynamo での C# クラスの読み込み方法については、後で詳しく説明します。
ソリューションエクスプローラ: ここでプロジェクト内のすべてにアクセスできます。
出力ウィンドウ: ビルドが成功したかどうかを後で確認する場合に必要になります。

次の手順ではプロジェクトをビルドしますが、その前に設定をいくつか確認する必要があります。まず、プロジェクトのプロパティで、[Platform target]に Any CPU または x64 が選択され、Prefer 32-bit がオフになっていることを確認します。

Project > "ProjectName" Properties を選択して、プロジェクトのプロパティを開きます。
Build ページを選択します。
ドロップダウンメニューから Any CPU または x64 を選択します。
Prefer 32-bit がオフになっていることを確認します。

これで、.dll を作成するためにプロジェクトをビルドできるようになりました。これを行うには、[Build]メニューから[Build Solution]を選択するか、ショートカット CTRL+SHIFT+B を使用します。

Build > Build Solution を選択します。
出力ウィンドウを確認すると、プロジェクトが正常にビルドされたかどうかを判断できます。

プロジェクトが正常にビルドされた場合、プロジェクトの bin フォルダに MyCustomNode という名前の .dll が作成されます。この例では、プロジェクトのファイルパスを Visual Studio の既定である c:\users\username\documents\visual studio 2015\Projects のままにしました。プロジェクトのファイル構造を確認します。

bin フォルダには、Visual Studio でビルドされた .dll が含まれています。
Visual Studio プロジェクトファイル。
クラスファイル。
ソリューション構成を Debug に設定したため、.dll は bin\Debug に作成されます。

これで、Dynamo を開いて .dll を読み込むことができるようになりました。追加機能を使用して、プロジェクトの bin の場所にナビゲートし、.dll を選択して開きます。

.dll を読み込むため、[追加]ボタンを選択します。
プロジェクトの場所にナビゲートします。プロジェクトは、Visual Studio の既定のファイルパス C:\Users\username\Documents\Visual Studio 2015\Projects\MyCustomNode にあります。
読み込む MyCustomNode.dll を選択します。
[Open]をクリックして .dll をロードします。

ライブラリに MyCustomNode という名前のカテゴリが作成されている場合は、.dll が正常に読み込まれています。しかし、単一のノードを作成しようとしたところ、Dynamo で 2 つのノードが作成されました。次のセクションでは、このようになる理由と、Dynamo による .dll の読み込みについて説明します。

Dynamo ライブラリ内の MyCustomNode。ライブラリのカテゴリは、.dll の名前によって決まります。
キャンバス上の SampleFunctions.MultiplyByTwo。

Dynamo によるクラスとメソッドを読み込む仕組み

Dynamo は .dll をロードする際、すべてのパブリック静的メソッドをノードとして公開します。コンストラクタ、メソッド、およびプロパティは、それぞれ Create ノード、Action ノード、および Query ノードに変換されます。この乗算の例では、MultiplyByTwo() メソッドが Dynamo で Action ノードになります。これは、ノードの名前がそのメソッドとクラスに基づいて付けられているためです。

入力には、メソッドのパラメータ名に基づいて inputNumber という名前が付けられています。
出力に既定で double という名前が付けられているのは、これが返されるデータタイプであるためです。
ノードに SampleFunctions.MultiplyByTwo という名前が付けられているのは、クラス名とメソッド名であるためです。

上記の例では、さらに SampleFunctions という Create ノードが作成されました。これは、明示的にコンストラクタを指定しなかったために自動的に作成されたことが原因です。これを回避するには、SampleFunctions クラスに空のプライベートコンストラクタを作成します。

namespace MyCustomNode
{
    public class SampleFunctions
    {
        //The empty private constructor.
        //This will be not imported into Dynamo.
        private SampleFunctions() { }

        //The public multiplication method. 
        //This will be imported into Dynamo.
        public static double MultiplyByTwo(double inputNumber)
        {
            return inputNumber * 2.0;
        }
    }
}

Dynamo が Create ノードとしてメソッドを読み込みました。

Dynamo NuGet パッケージの参照設定を追加する

乗算ノードは非常に単純なため、Dynamo への参照設定は必要ありません。たとえば、ジオメトリを作成するために Dynamo の機能にアクセスする場合は、Dynamo NuGet パッケージを参照する必要があります。

ZeroTouchLibrary - Dynamo の Zero Touch ノードライブラリをビルドするためのパッケージであり、DynamoUnits.dll、ProtoGeometry.dll というライブラリが含まれています。
WpfUILibrary - WPF のカスタム UI を含む Dynamo のノードライブラリをビルドするためのパッケージであり、DynamoCoreWpf.dll、CoreNodeModels.dll、CoreNodeModelWpf.dll というライブラリが含まれています。
DynamoServices - Dynamo の DynamoServices ライブラリ。
Core - Dynamo の単位およびシステムのテストインフラストラクチャであり、DSIronPython.dll、DynamoApplications.dll、DynamoCore.dll、DynamoInstallDetective.dll、DynamoShapeManager.dll、DynamoUtilities.dll、ProtoCore.dll、VMDataBridge.dll というライブラリが含まれています。
Tests - Dynamo の単位およびシステムのテストインフラストラクチャであり、DynamoCoreTests.dll、SystemTestServices.dll、TestServices.dll というライブラリが含まれています。
DynamoCoreNodes - Dynamo のコアノードをビルドするためのパッケージであり、Analysis.dll、GeometryColor.dll、DSCoreNodes.dll というライブラリが含まれています。

Visual Studio プロジェクトでこれらのパッケージを参照するには、上記のリンクで NuGet からパッケージをダウンロードして .dll を手動で参照するか、Visual Studio の NuGet パッケージマネージャを使用します。まず、Visual Studio で NuGet を使用してインストールする方法について説明します。

Tools > NuGet Package Manager > Manage NuGet Packages for Solution... を選択して NuGet パッケージマネージャを開きます。

次の図が NuGet パッケージマネージャです。このウィンドウには、プロジェクトにインストールされているパッケージが表示され、ユーザは他のパッケージを参照できます。DynamoServices パッケージの新しいバージョンがリリースされた場合は、ここからパッケージを更新できます。前のバージョンに戻すこともできます。

[参照]を選択し、DynamoVisualProgramming を検索して Dynamo パッケージを表示します。
Dynamo パッケージです。いずれかを選択すると、そのパッケージの現在のバージョンと内容の説明が表示されます。
必要なパッケージのバージョンを選択し、[インストール]をクリックします。これにより、作業中の特定のプロジェクトにパッケージがインストールされます。Dynamo の最新の公式リリースであるバージョン 1.3 を使用しているため、対応するパッケージのバージョンを選択します。