Zero-Touch ケーススタディ - グリッドノード

Visual Studio プロジェクトを開始できたので、セルの矩形グリッドを作成するカスタムノードのビルド方法について説明します。矩形グリッドは複数の標準ノードを使用して作成できますが、このカスタムノードは Zero-Touch ノードに簡単に含めることができる便利なツールです。通芯とは異なり、セルは、中心点を基点にスケールを変更したり、コーナーの頂点がクエリーされたり、面を構成することができます。

この例では、Zero-Touch ノードを作成する際に注意するべき機能と概念を紹介します。カスタムノードをビルドして Dynamo に追加した後は、「Zero-Touch の詳細を確認する」ページの、「既定の入力値」、「複数の値を返す」、「ドキュメント」、「オブジェクト」、「Dynamo のジオメトリタイプを使用する」、および「マイグレーション」セクションで詳細を確認してください。

カスタムの矩形グリッドノード

グリッドノードのビルドを開始するには、新しい Visual Studio クラスライブラリプロジェクトを作成します。プロジェクトの設定方法の詳細な説明については、「スタートアップ」ページを参照してください。

プロジェクトタイプとして Class Library を選択します
プロジェクトに CustomNodes という名前を付けます

ジオメトリを作成するため、適切な NuGet パッケージを参照する必要があります。NuGet パッケージマネージャから ZeroTouchLibrary パッケージをインストールします。このパッケージは、using Autodesk.DesignScript.Geometry; ステートメントに必要です。

ZeroTouchLibrary パッケージを参照します。
このノードを Dynamo Studio の現在のビルド(1.3)で使用します。これに一致するパッケージバージョンを選択します。
クラスファイルの名前を Grids.cs に変更しています。

次に、RectangularGrid メソッドを配置する名前空間とクラスを設定する必要があります。Dynamo では、メソッド名とクラス名に基づいてノードに名前が付けられます。これを Visual Studio にコピーする必要はまだありません。

using Autodesk.DesignScript.Geometry;
using System.Collections.Generic;

namespace CustomNodes
{
    public class Grids
    {
        public static List<Rectangle> RectangularGrid(int xCount, int yCount)
        {
        //The method for creating a rectangular grid will live in here
        }
    }
}

Autodesk.DesignScript.Geometry; で、ZeroTouchLibrary パッケージにある ProtoGeometry.dll を参照します。System.Collections.Generic はリストの作成に必要です。

これで、矩形を描画するためのメソッドを追加できます。クラスファイルを次のようにして、Visual Studio にコピーします。

using Autodesk.DesignScript.Geometry;
using System.Collections.Generic;

namespace CustomNodes
{
    public class Grids
    {
        public static List<Rectangle> RectangularGrid(int xCount, int yCount)
        {
            double x = 0;
            double y = 0;

            var pList = new List<Rectangle>();

            for (int i = 0; i < xCount; i++)
            {
                y++;
                x = 0;
                for (int j = 0; j < yCount; j++)
                {
                    x++;
                    Point pt = Point.ByCoordinates(x, y);
                    Vector vec = Vector.ZAxis();
                    Plane bP = Plane.ByOriginNormal(pt, vec);
                    Rectangle rect = Rectangle.ByWidthLength(bP, 1, 1);
                    pList.Add(rect);
                }
            }
            return pList;
        }
    }
}

プロジェクトが次のように表示されている場合は、先に進んで .dll をビルドしてみます。

Build > Build Solution を選択します。

プロジェクトの bin フォルダに .dll があるか確認します。正常にビルドされている場合は、Dynamo に .dll を追加できます。

Dynamo ライブラリ内のカスタム RectangularGrids ノード。
キャンバス上のカスタムノード。
Dynamo に .dll を追加するための[追加]ボタン。

カスタムノードの修正

上記の例では、RectangularGrids メソッド以外の定義があまりないかなり単純なノードを作成しました。しかし、入力ポートのツールチップを作成したり、標準の Dynamo ノードと同様にノードの概要を設定することができます。これらの機能をカスタムノードに追加すると、特にライブラリで検索する場合に、そのカスタムノードを簡単に使用できるようになります。

既定の入力値
xCount 入力のツールチップ

RectangularGrid ノードには、このような基本的な機能が必要です。次のコードでは、入力と出力ポートの説明、概要、および既定の入力値を追加します。

using Autodesk.DesignScript.Geometry;
using System.Collections.Generic;

namespace CustomNodes
{
    public class Grids
    {
        /// <summary>
        /// This method creates a rectangular grid from an X and Y count.
        /// </summary>
        /// <param name="xCount">Number of grid cells in the X direction</param>
        /// <param name="yCount">Number of grid cells in the Y direction</param>
        /// <returns>A list of rectangles</returns>
        /// <search>grid, rectangle</search>
        public static List<Rectangle> RectangularGrid(int xCount = 10, int yCount = 10)
        {
            double x = 0;
            double y = 0;

            var pList = new List<Rectangle>();

            for (int i = 0; i < xCount; i++)
            {
                y++;
                x = 0;
                for (int j = 0; j < yCount; j++)
                {
                    x++;
                    Point pt = Point.ByCoordinates(x, y);
                    Vector vec = Vector.ZAxis();
                    Plane bP = Plane.ByOriginNormal(pt, vec);
                    Rectangle rect = Rectangle.ByWidthLength(bP, 1, 1);
                    pList.Add(rect);
                    Point cPt = rect.Center();
                }
            }
            return pList;
        }
    }
}