カスタムノードを作成する

Dynamo では、いくつかの方法でカスタムノードを作成することができます。最初からカスタムノードを作成することも、既存のグラフから作成することも、C# を使用して明示的に作成することもできます。このセクションでは、既存のグラフを使用して Dynamo UI 内にカスタムノードを作成する方法について説明します。ワークスペースを整理し、一連のノードをパッケージ化して別の場所で再利用する場合は、この方法が最適です。

演習: UV マッピング用のカスタムノード

パート I: グラフから開始する

次の図は、UV 座標を使用して、1 つのサーフェスから別のサーフェスに点をマッピングする場合の例を示しています。この概念を適用して、XY 平面上の曲線を参照する、複数の小さなパネルから構成されるサーフェスを作成してみましょう。ここでは、パネル化用の四角形のパネルを作成しますが、同じ概念を適用して、UV マッピングを使用する多様なパネルを作成することもできます。この演習を行うと、このグラフや Dynamo の別のワークフローで同様のプロセスを簡単に繰り返すことができるようになるため、カスタムノード開発のよい練習になります。

下のリンクをクリックして、サンプルファイルをダウンロードします。
すべてのサンプルファイルの一覧については、付録を参照してください。

最初に、カスタムノード内にネストするグラフを作成します。この例では、UV 座標を使用して、基準となるサーフェスから目的のサーフェスにポリゴンをマッピングするグラフを作成します。この UV マッピングプロセスは頻繁に使用するプロセスであるため、カスタムノードの演習素材として適しています。サーフェスと UV 空間の詳細については、「サーフェス」ページを参照してください。完全なグラフは、上記でダウンロードした .zip ファイルの UVmapping_Custom-Node.dyn になります。

Code Block: この行を使用して、-45 ～ 45 45..45..#10;の範囲の 10 個の数値を作成します。
Point.ByCoordinates: Code Block ノードの出力を x 入力と y 入力に接続し、[レーシング]を[外積]に設定します。これで、点のグリッドが作成されます。
Plane.ByOriginNormal: Point 出力を origin 入力に接続して、各点に平面を作成します。この操作では、既定の法線ベクトル(0,0,1)が使用されます。
Rectangle.ByWidthLength: 前の手順で作成した平面を plane 入力に接続し、値 10 の Code Block ノードを使用して幅と長さを指定します。

これで、長方形のグリッドが作成されます。UV 座標を使用して、これらの長方形を目的のサーフェスにマッピングします。

Polygon.Points: 前の手順の Rectangle.ByWidthLength 出力を polygon 入力に接続し、各長方形の頂点を抽出します。これらの点を、目的のサーフェスにマッピングします。
Rectangle.ByWidthLength: 値 100 で Code Block ノードを使用して、長方形の幅と長さを指定します。これが、基準サーフェスの境界線になります。
Surface.ByPatch: 前の手順の Rectangle.ByWidthLength 出力を closedCurve 入力に接続し、基準となるサーフェスを作成します。
Surface.UVParameterAtPoint: Polygon.Points ノードの Point 出力と Surface.ByPatch ノードの Surface 出力を接続して、各点で UV パラメータを返します。

これで、基準となるサーフェスと UV 座標のセットが作成されました。次に、目的のサーフェスを読み込み、2 つのサーフェス間で点をマッピングします。

File Path: 読み込むサーフェスのファイルパスを選択します。ファイルタイプは .sat にしてください。[参照...]ボタンをクリックして、上でダウンロードした .zip ファイルの UVmapping_srf.sat にナビゲートします。
Geometry.ImportFromSAT: ファイルパスを接続して、サーフェスを読み込みます。読み込んだサーフェスがジオメトリのプレビューに表示されます。
UV: UV パラメータ出力を UV.U ノードと UV.V ノードに接続します。
Surface.PointAtParameter: 読み込んだサーフェス、U 座標、V 座標を接続します。これで、目的のサーフェス上に 3D の点のグリッドが表示されます。

最後に、3D の点を使用して長方形のサーフェスパッチを作成します。

PolyCurve.ByPoints: サーフェス上の点群を接続し、その点群からポリカーブを作成します。
Boolean: Boolean ノードをワークスペースに追加して connectLastToFirst 入力に接続し、値を True に切り替えてポリカーブを閉じます。これで、サーフェスに長方形がマッピングされて表示されます。
Surface.ByPatch: ポリカーブを closedCurve 入力に接続し、サーフェスパッチを作成します。

パート II: グラフからカスタムノードへ

次に、ノードの入力と出力を考慮しながら、カスタムノード内にネストするノードを選択します。長方形以外の任意のポリゴンをマッピングできるように、カスタムノードの柔軟性を可能な限り高めてみましょう。

次のノード(Polygon.Points から始まる)を選択し、ワークスペースを右クリックして[カスタムノードを作成]を選択します。

[カスタムノードプロパティ]ダイアログボックスで、カスタムノードに名前、説明、カテゴリを割り当てます。

名前: MapPolygonsToSurface
説明: 基準点からターゲットサーフェスにポリゴンをマッピングします
アドオンカテゴリ: Geometry.Curve

カスタムノードにより、ワークスペースが見やすくなりました。入力と出力には、元のノードに基づいて名前が付いています。カスタムノードを編集して、これらの名前をもっとわかりやすい名前に変更しましょう。

編集するカスタムノードをダブルクリックします。ワークスペースの背景色が黄色で表示されます。これは、カスタムノードの内部を表しています。

各 Input ノードの入力名を baseSurface と targetSurface に変更します。
マッピングするポリゴン用に Output ノードを追加します。

カスタムノードを保存し、ホームワークスペースに戻ります。MapPolygonsToSurface ノードに変更内容が反映されます。

カスタムコメントを追加して、カスタムノードの内容をさらにわかりやすくすることもできます。コメントを入力すると、入力タイプと出力タイプの内容だけでなく、ノードの機能を説明することができます。カスタムノードの入力や出力にカーソルを置くと、コメントが表示されます。

編集するカスタムノードをダブルクリックします。背景が黄色のワークスペースがもう一度表示されます。

Input の Code Block ノードの編集を開始します。コメントを入力する場合は、最初に「//」を入力してから、コメントテキストを入力します。ノードの内容を説明するためのコメントを入力してください。ここでは、targetSurface ノードの説明を入力します。
特定の値に一致する入力タイプを設定して、inputSurface ノードの既定値を設定します。ここでは、既定値を元の Surface.ByPatch のセットに設定します。