ノードとワイヤ
Last updated
Last updated
Dynamo のノードは、ビジュアル プログラムを形成するために接続するオブジェクトです。各ノードは、特定の操作を実行します。操作には、数値の保存といった単純なものもあれば、ジオメトリの作成やクエリーの実行といった複雑なものもあります。
Dynamo のほとんどのノードは、5 つのパーツで構成されています。入力ノードなどの例外はありますが、各ノードの構造は次のようになります。
名前 -
Category.Nameの命名規則に準拠したノードの名前。メイン - ノードの本体。ここを右クリックすると、ノード全体レベルのオプションが表示されます。
ポート(入力および出力) - ワイヤの出入り口。ノードに入力データを渡し、ノードのアクションの結果を出力します。
既定値 - 入力ポートを右クリックすると、一部のノードでは既定値が表示されます。既定値は、使用しても使用しなくてもかまいません。
レーシング アイコン - 一致するリスト入力に対して指定されているレーシング オプションを示します(後で詳しく説明します)。
ノードの入力と出力はポートと呼ばれ、ワイヤの出入り口として機能します。データは左側のポートを経由して入力され、操作が実行されるとノードの右側から出力されます。
ポートは、特定のタイプのデータを受け取るように設定されています。たとえば、 2.75 という数値を Point.ByCoordinates ノードのポートに接続すると、点が正常に作成されます。ただし、同じポートに対して 「Red」 を指定すると、エラーが発生します。
ヒント: ポートにカーソルを合わせると、そのポートの正しいデータ タイプを含むツールチップが表示されます。
ポートのラベル
ツールチップ
データ タイプ
既定値
Dynamo は、各ノードのステータスに基づいて異なるカラー スキームでノードをレンダリングすることにより、ビジュアル プログラムの実行状態を示します。状態の階層は、エラー > 警告 > 情報 > プレビューの順に表示されます。
名前やポートにカーソルを合わせるか右クリックすると、追加の情報やオプションが表示されます。
入力が十分 - 入力ポートに青色の垂直バーがあるノードは、適切に接続され、すべての入力が正常に接続されています。
入力が不十分 – 1 つ以上の入力ポートに赤色の垂直バーがあるノードでは、そのポートの入力を接続する必要があります。
関数 – 関数を出力し、出力ポート上に灰色の垂直バーがあるノードは関数ノードです。
選択済み - 現在選択されているノードは、縁が水色でハイライト表示されます。
フリーズ - 半透明の青色のノードは、フリーズされてノードの実行が停止しています。
警告 - ノードの下の黄色のステータス バーは警告状態を示します。そのノードで入力データが不足しているか、不正なデータ タイプが含まれている可能性があることを意味しています。
エラー - ノードの下の赤色のステータス バーは、ノードがエラー状態にあることを示します。
情報 - ノードの下の青色のステータス バーは情報状態を示し、ノードに関する有用な情報があることがわかります。この状態は、ノードによってサポートされる最大値に近づいた場合や、パフォーマンスに潜在的な影響を与える可能性のある方法でノードを使用している場合などに、トリガされることがあります。
ヒント: このツールチップ情報を使用して上流のノードを検査することにより、必要なデータ タイプまたはデータ構造にエラーがないか確認できます。
警告のツールチップ - 「Null」またはデータがない場合は、倍精度浮動小数点数つまり数値として認識されません。
Watch ノードを使用して入力データを検査します。
上流の Number ノードに数値ではなく「red」が指定されています。
場合によっては、ビジュアル プログラムで特定のノードが実行されないようにする必要があります。これを行うには、ノードの右クリック メニューから選択してノードを「フリーズ」します。
ノードをフリーズすると、その下流にあるノードもフリーズします。つまり、フリーズされたノードの出力に依存するすべてのノードもフリーズされます。
ワイヤは各ノードを接続してノード間の関係を作成し、ビジュアル プログラムのフローを確立します。ワイヤはその名前のとおり、特定のオブジェクトから次のオブジェクトにデータ パルスを送信するための電線と考えることができます。
ワイヤは、特定のノードの出力ポートを別のノードの入力ポートに接続します。この接続により、ビジュアル プログラムのデータ フローが確立します。
入力ポートは左側にあり、出力ポートはノードの右側にあります。そのため、通常、プログラム フローは左から右に移動します。
ポートを左クリックしてワイヤを作成し、続いて別のノードのポートを左クリックして接続を作成します。接続の作成中、ワイヤは破線で表示され、正常に接続されると実線に変わります。
データは常にこのワイヤを経由して出力から入力へと移動します。ただし、接続されているポートをクリックする順序によって、どちらの方向にもワイヤを作成できます。
多くの場合、ワイヤで表示されている接続を編集して、ビジュアル プログラムのプログラム フローを調整する必要が生じます。ワイヤを編集するには、既に接続されているノードの入力ポートを左クリックします。ワイヤを編集する場合の方法は 2 つあります。
入力ポートへの接続を変更するには、別の入力ポートを左クリックします。
ワイヤを削除するには、ワイヤを入力ポートから離してワークスペースを左クリックします。
複数のワイヤを再接続するには、Shift+ 左クリックを使用します。
ワイヤを複製するには、Ctrl+ 左クリックを使用します。
既定では、ワイヤは灰色のストロークでプレビュー表示されます。ノードを選択すると、接続されているワイヤがそのノードと同じ水色でハイライト表示されます。
ハイライト表示されたワイヤ
既定のワイヤ
既定でワイヤを非表示
グラフ内のワイヤを非表示にする場合は、[表示] > [コネクタ] > [コネクタを表示]のチェックを外します。
このように設定すると、選択したノードとその連結ワイヤのみが薄い水色でハイライト表示されます。
また、ノードの出力を右クリックして[ワイヤを非表示]を選択すると、選択したワイヤのみを非表示にすることができます。
プレビュー オフ - ノードの下の灰色のステータス バーと目のアイコン は、ノードのジオメトリ プレビューがオフになっていることを示します。
ビジュアル プログラムに警告やエラーが含まれている場合、その問題に関する追加情報が表示されます。また、黄色のノードでも、ノード名の上にツールチップが表示されます。警告 またはエラー ツールチップ アイコンにマウス カーソルを合わせて展開します。
