2つの値(aとb)を加算するロジックを作成します。

加算演算の入力のaとbを定義します。数値入力は辞書形式で格納する必要があるため、基本的に辞書が入力データのコンテナとなります。辞書にはキーと値のペアを格納し、この場合だとaとbがキーです。Attribute Adjust Dictionary SOPを使用して、入力パラメータの辞書を作成します:

1. Attribute Adjust Dictionary SOPの Set Values セクションで、 Number of Entries の横にあるをクリックし、2個のエントリを作成します。

2. 1つ目のエントリを以下のように設定します:

   • Key : a

   • Type : Float (float値を加算します)

   • Value : 値をaに割り当てます。

3. 2つ目のエントリを以下のように設定します:

   • Key : b

   • Type : Float

   • Value : 値をbに割り当てます。

デフォルトでは、 Attribute Name がparms、 Attribute Class が Detail に設定されているため、parmsという名前のDetailアトリビュートが作成されます。この新しいparmsアトリビュートは、Geometry Spreadsheetで確認することができます:

1. ペインの上部で、 New Tabアイコンをクリックして、 New Pane Tab Type ▸ Inspectors ▸ Geometry Spreadsheet を選択します。

2. 上部のツールバーから Detailを選択します。

これでグラフロジックとグラフ入力が定義されました。グラフを呼び出す(評価する)には、APEX Invoke Graph SOPを使用します。

1. 追加したノードを接続します:

   • APEX Invoke Graph SOPの1番目の入力はAPEXグラフを受け取ります。ネットワークエディタで、(APEXグラフを含んでいる)APEX Script SOPの2番目の出力をAPEX Invoke Graph SOPの1番目の入力に接続します。グラフロジックを手動で作成している場合、APEX Script SOPをAPEX Edit Graph SOPに置き換えます。

   • APEX Invoke Graph SOPの2番目の入力は、入力として使用したいデータを受け取ります。辞書形式の数値でも、通常のジオメトリでも構いません。Attribute Adjust Dictionary SOPをAPEX Invoke Graph SOPの2番目の入力に接続します。

   

2. APEX Invoke Graph SOPで、入力を指定します:

   • Input Bindings の横にあるをクリックして、入力を追加します。

   • デフォルトで、 Dictionary To Bind はオンで、parmsに設定されています。Attribute Adjust Dictionary SOPを使用してparmsという名前の入力を辞書として定義しているので、これは既に望ましい設定になっています。

3. APEX Invoke Graph SOPで、取得する出力を指定します:

   ここでは(ジオメトリではなく)数値を取得したいので、 Output Dictionary Bindings の横にあるをクリックして、取得したい出力を指定します。出力は辞書形式で格納されます。

   • Apex Outputs Group は、グラフ内の出力ノードの名前です。ここでは、outputです。

   • Output Attrib には、出力される辞書の名前(output_parms)を設定します。

   この新しいoutput_parms辞書に計算結果が格納されます。Geometry Spreadsheetの上部のツールバーから Detailを選択することで、これを確認することができます。output_parms辞書では、result(グラフのoutputノードのポート名)キーの値にa + bが設定されています。

   APEX Invoke Graph SOPはAPEXグラフのロジックを評価し、その結果を返します。Attribute Adjust Dictionary SOPでaやbの値を変更すると、そのAPEX Invoke Graph SOPで計算された出力の辞書が新しい合計値に更新されます。

グラフ入力は変わっていないため、Attribute Adjust Dictionary SOPでは何も変更する必要はありません。

グラフ出力に関しては、APEX Invoke Graph SOPは前と同じようにグラフのoutputノードから取得します。違いは、1つの結果( add_result の2つの入力の合計値)だけでなく、2つ目の結果( add_divide_result の除算結果)も取得することです。SOPで、両方の結果が1つの辞書に格納されます。

Geometry Spreadsheetで、グラフのoutputノードから取得された値を確認します:

1. ネットワークエディタでAPEX Invoke Graph SOPを選択します。

2. Geometry Spreadsheetで、上部のツールバーから Detailを選択します。

3. outputノードから、 add_result と add_divide_result の2つの値が取得されています。

前の例の加算と除算のグラフから開始し、もう1つ出力ノードを追加し、元の出力ノードと違う名前を付けます:

1. 以下のスニペットを、APEX Script SOPの Snippet パラメータに追加します:

   a = BindInput(Float())
   b = BindInput(Float())
   
   add_result = a + b
   
   add_divide_result = 1.0/add_result
   
   multiply_result = 2.0 * add_divide_result
   
   BindOutput(add_result, add_divide_result, __name='output')
   
   BindOutput(multiply_result, __name='output2')
   

   __nameは、ノードに名前を付けるのに使用する特殊関数の引数です。

2. APEXネットワークビューで、グラフとしてAPEX Scriptスニペットを表示します(赤のノードが新たに追加したノードです):

   

取得された結果を確認します:

1. ネットワークエディタでAPEX Invoke Graph SOPを選択します。

2. Geometry Spreadsheetで、上部のツールバーから Detailを選択します。

グラフ内に別の出力ノードがあっても、outputノードからの値のみが取得されます。ここでは部分評価が起きています。グラフロジックを介してoutputノードへのパスのみが実行されます。output2の値を計算するロジックは無視されます。

新しい出力ノードのoutput2からも値を取得するには:

1. APEX Invoke Graph SOPで、 Output Dictionary Bindings の横にあるをクリックし、取得する出力ノードをもう1つ追加します。

2. 新しい Output Dictionary Bindings エントリで:

   • Apex Outputs Group をoutput2に設定します。ドロップダウンボックスからoutput2を選択することができます。

   • Output Attrib には、出力される辞書の名前(output2_parms)を設定します。

3. 取得された値を確認します:

   1. ネットワークエディタでAPEX Invoke Graph SOPを選択します。

   2. Geometry Spreadsheetで、上部のツールバーから Detailを選択します。

   2個の出力ノードのoutputとoutput2からの値が計算され、取得され、それらの結果がoutput_parmsとoutput2_parmsという2つの辞書に格納されています。

1. 以下のスニペットを、APEX Script SOPの Snippet パラメータに追加します:

   a = BindInput(Float())
   b = BindInput(Float())
   
   result = a + b
   
   # add_resultはボックスのサイズに影響を与えます
   geo = apex.sop.box(scale=result)
   
   BindOutput(result, geo)
   

2. APEXネットワークビューで、グラフとしてAPEX Scriptスニペットを表示します。加算演算の合計値はボックスのサイズに影響します:

   

今回は、数値ではなくジオメトリを取得します。ボックスを表示するには、outputノードでボックスジオメトリを取得する必要があります:

1. APEX Invoke Graph SOPで、 Bind Output Geometry をオンにし、その値をoutput:geo (<name_of_output_node>:<geometry_on_output_node>)に設定します。

2. APEX Invoke Graph SOPのDisplayフラグをオンにし、ビューポートにボックスを表示します。

3. Attribute Adjust Dictionary SOPを選択し、パラメータエディタにグラフ入力パラメータのaとbを表示します。ただし、APEX Invoke Graph SOPのDisplayフラグはオンのままにします。Attribute Adjust Dictionary SOPでaとbの値を調整すると、ビューポートでボックスのサイズが変わります。

   

前の例からボックスジオメトリのグラフを追加します。

1. 以下のスニペットを、APEX Script SOPの Snippet パラメータに追加します:

   a = BindInput(Float())
   b = BindInput(Float())
   
   # add_resultはボックスのサイズに影響を与えます
   add_result = a + b
   box_geo = apex.sop.box(scale=add_result)
   
   # box_pointをボックス上のポイント0(コーナーの1つ)の
   # 位置(アトリビュート'P')に設定します
   box_point = box_geo.pointAttribValue(0, 'P', valuetype=Vector3)
   
   # multiply_resultは球のサイズに影響を与えます
   multiply_result = 0.5 * add_result
   
   # 球のトランスフォーム(t)はbox_pointに設定されているため
   # 球の中心はbox_pointになります
   sphere_geo = apex.sop.sphere(t=box_point, scale=multiply_result)
   
   # ボックスと球のジオメトリを結合します
   box_sphere_geo = apex.geo.mergePacked(box_geo, sphere_geo)
   
   BindOutput(add_result, box_geo, box_point, box_sphere_geo)
   

2. APEXネットワークビューで、グラフとしてAPEX Scriptスニペットを表示します(赤のノードが新たに追加したノードです)。球はボックスジオメトリ内の特定のコーナーに配置され、球とボックスは1ジオメトリとして結合さ、出力されます:

   

ボックスと球を一緒に表示するには、outputノードからボックスと球が結合されたジオメトリを取得する必要があります:

1. APEX Invoke Graph SOPで、 Bind Output Geometry をオンにし、その値をoutput:box_sphere_geo(<name_of_output_node>:<merged_geometry_on_output_node>)に設定します。

2. APEX Invoke Graph SOPのDisplayフラグをオンにし、ビューポートにボックスと球を表示します。

3. Attribute Adjust Dictionary SOPを選択し、パラメータエディタにグラフ入力パラメータのaとbを表示します。ただし、APEX Invoke Graph SOPのDisplayフラグはオンのままにします。Attribute Adjust Dictionary SOPでaとbの値を調整すると、ビューポートでボックスと球のサイズが変わります。