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

1. ネットワークエディタ内のジオメトリレベルで、APEX Edit Graph SOPを作成します。

2. APEX Edit Graph SOPを選択したまま、APEX Network Viewを開きます。APEXネットワークビューでは、APEX Edit Graph SOPにグラフを直接書き込むことができます。

3. APEXネットワークビュー内で、簡単な数値演算を実行するグラフを作成します:

   • グラフ入力ノードとグラフ出力ノードを追加します:

     • 入力パラメータを受け取るノードを追加します。TABを押してTabメニューを開き、 Input を選択します。するとinputノードがグラフに追加されます。

     • Tabメニューで Output を選択してグラフ出力ノードを追加します。

   • 単純な加算演算を実行するAdd<Float>ノードを追加します。

   • それらのノードを以下のように接続します:

     addノードのbは可変長ポートなので、複数の接続が可能であり、b<x>という名前のサブポートが作成されます。

この時点では、グラフの入力は定義されておらず、グラフは評価も計算もされていないため、何の出力も結果もありません。 グラフは、ジオメトリとして表現されたロジックの一部(ピース)でしかありません。

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

ネットワークエディタ内のジオメトリレベルで、Attribute Adjust Dictionary SOPを追加して、aとbの値を設定します:

1. 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. Geometry Spreadsheetを開きたいペインの上部にある New Tabアイコンをクリックし、 New Pane Tab Type ▸ Inspectors ▸ Geometry Spreadsheet を選択します。

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

これでグラフロジックとグラフ入力が定義されました。 グラフを呼び出す(評価する)には、APEX Invoke Graph SOPを使用します。 ネットワークエディタ内のジオメトリレベルで、APEX Invoke Graph SOPを追加します。

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

   • APEX Invoke Graph SOPの1番目の入力はAPEXグラフを受け取ります。ネットワークエディタで、(APEXグラフを含んでいる)APEX Edit Graph SOPの出力をAPEX Invoke Graph SOPの1番目の入力に接続します。

   • 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で計算された出力の辞書が新しい合計値に更新されます。

前のグラフに、その結果の合計値を除算するノードを追加します。そして除算演算の結果を出力するようにします。

1. APEXネットワークビューで、Divide<Float>ノードを追加します。以下のようにノードを接続します(この例では赤のノードが新たに追加したノードです)。この例では、divideノードとoutputノードのサブポート名を変更しています。divideノードのbポートは可変長入力です。

   Note

   サブポート名はその名前の上でクリックすることで名前を変更することができます。

   

   これでoutputノードには2つの値が出来ました。

2. divideノードで値を設定します。

   • divideノードを選択し、Pを押してノードパラメータウィンドウを表示します。

   • divideは、aをbで除算します。ノードパラメータウィンドウで、aの値を1.0などに設定します。denominatorは前の加算演算からの値なので、そのままにします。

   Note

   接続からの値は、ノードパラメータウィンドウ内で設定された値を常に上書きします。 この例では、denominatorの値は、divideノードパラメータウィンドウで値を設定しても、add演算の結果で上書きされます。

グラフ入力は変わっていないため、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ノードから次の2つの値が取得されています:

   • add_result:グラフ入力のaとbの合計値

   • add_divide_result:<Divideノードのポートa> / <グラフ入力のaとbの合計値>

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

1. 2つ目の出力ノード(Subnet Outputs)を追加し、その名前をoutput2に変更します。

2. Multiply<Float>ノードを追加します。

3. 以下のようにノードを接続します(この例では赤のノードが新たに追加したノードです):

   

4. multiplyノードで値を設定します。

   • multiplyノードを選択し、Pを押してノードパラメータウィンドウを表示します。

   • ノードパラメータウィンドウで、aの値を2.0などに設定します。b0は前の除算演算からの値なので、そのままにします。

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

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

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

前の例と同じように、元のoutputノードから同じoutput_parms辞書が取得されています(取得される値はadd_resultとadd_divide_result)。 もう一方の出力ノードを指定しても、APEX Invoke Graph SOPはその指定した出力ノードの値だけが取得されます。

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

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

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

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

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

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

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

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

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

1. 2つの数値を加算するグラフから始めます。

   

2. ボックスジオメトリ(sop::boxノード)を追加します。Add演算のresultはボックスジオメトリのscaleに接続されているので、そのAdd演算の合計値がボックスのサイズに影響します。

   

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

1. APEX Invoke Graph SOPで、 Bind Output Geometry をオンにし、その値をoutput:geo(<出力ノードの名前>:<出力ノードのジオメトリ>)に設定します。

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

1. 前の例のボックスジオメトリのグラフから開始します。

2. 下図の赤いノードを追加します。このグラフロジックでは、球はボックスジオメトリ内の特定のコーナーに配置され、その球とボックスが1ジオメトリとしてマージされて出力されます。

   

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

1. APEX Invoke Graph SOPで、 Bind Output Geometry をオンにし、その値をoutput:box_sphere_geo(<出力ノードの名前>:<出力ノードの結合されたジオメトリ>)に設定します。

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

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

1. ネットワークエディタのジオメトリレベルで、APEX Edit Graph SOPを作成します。

2. APEX Edit Graph SOPを選択したまま、APEX Network Viewを開きます。APEXネットワークビューでは、APEX Edit Graph SOPにグラフを直接書き込むことができます。

3. APEXネットワークビュー内で、ジオメトリのコントールを追加するグラフを作成します:

   • グラフ入力ノードとグラフ出力ノードを追加します:

     • 入力パラメータを受け取るノードを追加します。TABを押してTabメニューを開き、 Input を選択します。するとinputノードがグラフに追加されます。

     • Tabメニューで Output を選択してグラフ出力ノードを追加します。

   • ジオメトリを動かすノードを追加します:

     ノード	説明
     torus	あれこれ動かすトーラスジオメトリ。
     TransformObject	階層トランスフォームの挙動の定義と管理をします。 Animateステートでトランスフォームを制御可能にするには、TransformObjectノード上の制御したい入力パラメータをinputノードに接続することで、その入力パラメータをプロモートさせる必要があります。 TransformObjectノード上のパラメータがプロモートされると、そのTransformObject要素がコントロールに変わり、ユーザがAnimateステートで操作できるようになります。 この例では、移動(t)と回転(r)のパラメータがプロモートされているので、ユーザは、Animateステートでコントールの移動コンポーネントと回転コンポーネントにアクセスすることができます。
     transform_geo	トーラスの位置を変更します。

     

ビューポートでは、グラフそのものがジオメトリとして表現されます:

グラフの 出力 を確認するには、Animateステートに入る必要があります。 Animateステートは、自動的にグラフを解釈して、その評価された出力を表示します。 また、Animateステートは、プロモートされたすべてのパラメータ(この例では移動と回転のパラメータ)のコントロールを作成し、それらのコントロールを操作できるようにします。

Animateステートに入るには:

1. 以下のようにノードネットワークを接続します。

   

   Pack Folder SOPは、リグをパックフォルダ構造にパックします。 Animateステートには、パックされたキャラクタ要素のみが表示されます。

2. Pack Folder SOPでは、入力がSOPに接続されると、自動的に Name パラメータに値が入力されます。入力の Type をrigに指定します。rigは、入力にリグロジックが含まれていることをAnimateステートに伝える特別な拡張子です。

3. APEX Scene Animate SOPを選択し、左側のツールバー上の Animateをクリック、または、ビューポート内でEnterを押します。

以下の動画は、Animateステートに入っています。 トーラスの中央にある白いドットがコントロールです。 移動と回転のパラメータがプロモートされているので、そのコントロールをクリックすると、その移動および回転のハンドルが表示されます。

Animateステートでコントロールを操作すると、プロモートされたパラメータが変更され、それらのパラメータがグラフロジックの入力として使用されます。 コントロールをドラッグする度に、更新されたパラメータでグラフが評価されます。

1. 前の例のトーラスのコントロールリグから開始します。

2. 子コントロールを追加します(この例では赤のノードが新たに追加したノードです):

   

   ノード	説明
   child	2つ目のTransformObjectノードをグラフに追加し、tとrのパラメータをプロモートします。これで、親コントロールと子コントロールの2つのコントロールができました。 parent入力やparentlocal入力に何か接続されているTransformObjectノードは、親子階層では子になります。 親子階層を作成するには、次のように接続します: 親TransformObjectのxform出力を子TransformObjectのparent入力に接続します。 親TransformObjectのlocalxform出力を子TransformObjectのparentlocal入力に接続します。
   child_starting_position	親コントロールと子コントロールが直接重なり合わないようにchild TransformObjectノードに対してオフセットを作成します。子コントロールのトランスフォームを変更するには: transform::Buildを選択してPを押してノードパラメータウィンドウを開きます。 移動パラメータtのXコンポーネントに1.0などの値を設定します。 child_starting_positionノードの出力をchildノードのrestlocal入力に接続します。 このrestlocalは、親コントロールを基準に子コントロールの開始位置を定義します。つまり、親コントロールに対するオフセットです。

コントロールの親子階層を確認するために、Animateステートに入ります:

1. ノードネットワークを上記のコントロールの例のように接続します。

2. APEX Scene Animate SOPを選択し、左側のツールバー上の Animateをクリック、または、ビューポート内でEnterを押します。

以下の動画は、Animateステートに入っています。左側の白いドットが親コントロールです。右側の白いドットが子コントロールです。

トーラスの位置は子コントロールによって駆動されているため、子コントロールにトーラスの中心が来ています。

1. 前の例からの親子リグから開始します。

2. 2つ目の子コントロールを追加します(赤のノードが新たに追加したノードです):

   

   ノード	説明
   child2	tとrのパラメータをプロモートして、2つ目の子コントロールを作成します。
   child2_start_position	新しい子コントロールのオフセットを作成します。 child2_start_positionを選択してPを押してノードパラメータウィンドウを開きます。 移動パラメータtのXコンポーネントに(前の例で作成した)1つ目の子コントロールとは異なる値を設定します。

   以下のAnimateステートを示した動画では、左側のコントロールが親、中央のコントロールが1つ目の子コントロール、右側のコントロールが2つ目の子コントロールです。どちらの子コントロールも親に従っています。

3. (下図の青のノードのように)transform::Buildノードを追加し、そのノード名をdriverに変更します。 driverノードの出力をchild2ノードのxform入力に接続して、child2ノードのコントロールをdriverノードに拘束します。 TransformObjectのxform入力はワールド空間トランスフォームであり、他のすべての入力を上書きします。 xformに何かを接続すると、拘束のように動作します。

   • driverノードを選択してPを押してノードパラメータウィンドウを開きます。

   • 移動パラメータtのXコンポーネントを設定します。

   

   Note

   TransformObjectノードが階層の子として接続されていて、何かがxformに接続されると、そのTransformObjectノードはその親に従わなくなり、xform入力の位置に拘束されるようになります。

以下の動画では、中央の子コントロールは拘束されておらず、親(左側のコントロール)に従っています。 一方、右側の子コントロールは親子階層にありますが、親に従っていません。 拘束の入力(xform)がその位置をxform位置に拘束しているからです。

移動、回転、スケールのいずれか1つのみを拘束し、その他のトランスフォームコンポーネントは維持したい場合は、1つのトランスフォームコンポーネントを拘束するを参照してください。

以下は、APEX Edit Graph SOPであるbone_deform_rig内のリグロジックです:

以下のテーブルには、SetPointTransformsノードとValueノードに関する詳細を載せています。

ノード	説明
SetPointTransformsノード	SetPointTransformsはスケルトンデフォーマです。 トランスフォームを受け取り、それをスケルトンのジョイントに適用します。 これは特殊なノードで、可変長入力であるtransformsからのサブポートの命名が重要になります。 サブポート名は、入力スケルトン(SetPointTransformsノードのgeo入力)のジョイント名にマッピングされます。 例えば、サブポートの1つがjoint_0という名前の場合、joint_0サブポートに渡されるトランスフォームに加えられた変更は、スケルトン上のjoint_0を更新します。 SetPointTransformsのサブポートの名前は、そのポート名をクリックすることで、スケルトンのジョイント名(Skeleton SOPからのジョイント名)と同じになるように変更することができます。
Valueノード	Value<Geometry>ノードは、静止スケルトンのコピーを作成し、このコピーをSetPointTransformsに接続します。 静止スケルトンのコピーを作成する必要がある理由は、SetPointTransformsノードは、接続されたジオメトリをその場で変更を行なうからです。 もし静止スケルトンをSetPointTransformsノードに接続してしまうと、そのSetPointTransformsノードはその静止スケルトンに対して変更を加えてしまいます。 その結果、静止スケルトンは静止スケルトンではなくなり、アニメーションスケルトンになります。 静止スケルトンは、ジオメトリ変形を実行するための参照として使用されます。 静止スケルトンとアニメーションスケルトンのトランスフォームの差を計算し、この差を使用して、ジオメトリの変形方法を決定します。 SetPointTransformsノードに接続する前に静止スケルトンのコピーを作成しなかった場合、SetPointTransformsノードはその静止スケルトンを更新してしまいます。 その結果、静止スケルトンとアニメーションスケルトンが同じになり、差分のないトランスフォームがジオメトリ変形に適用されることになります。 以下の例は、Valueノードを使用して最初にコピーを作成することなく、静止スケルトンを直接SetPointTransformsに接続した場合、何が起こるかを示したものです。 期待通りにボーンを変形させるには、Value<Geometry>ノードを使用して、静止スケルトンのコピーを作成する必要があります。 SetPointTransformsノードはコピーに対して更新を行ない、アニメーションスケルトンはSetPointTransformsノードからsop::bonedeformノードの3番目の入力(アニメーションスケルトン)であるgeoinput2に接続します。 元の静止スケルトンは、sop::bonedeformノードの2番目の入力(静止スケルトン)であるgeoinput1に接続します。

Pack Folder SOPを使用して、キャラクタ要素(チューブジオメトリ、スケルトン、リグ)をAnimateステートでアニメーション可能な“キャラクタ”にパックします。 Pack Folder SOP内でキャラクタ要素に名前を付ける方法については、キャラクタデータを組み立てるを参照してください。

ジオメトリを変形するには、Animateステートに入ります:

• ネットワークエディタでAPEX Scene Animate SOPを選択し、Displayフラグをオンにします。

• 左側のツールバー上の Animateをクリック、または、ビューポート内でEnterを押します。

特定の1つのトランスフォームコンポーネント(移動、回転、またはスケール)をドライバに拘束し、他のコンポーネントは変更しないようにするには、TransformObjectノードのxformmaskポートを使用します。

移動、回転、スケールの値にビットマスクをセットアップします。 ジョイントの回転をドライバの回転に拘束したい場合は、回転のValueノードを1に設定し、移動およびスケールのValueノードを0に設定します。

以下の例では、ピンクのノードを使用して、1つのトランスフォームコンポーネントをドライバに拘束する機能をセットアップしています。

driverTransformObjectノードの移動および回転の値はコントロールとしてプロモートされ、以下の機能を持ちます:

• driverの移動コントロールを変更しても、joint_1の移動はdriverに拘束されていないため、スケルトンのjoint_1は動きません。チューブジオメトリは変形しません。

• driverの回転コントロールを変更する場合、joint_1の回転はdriverの回転に拘束されているため、joint_1の回転はdriverと一緒に更新されます。チューブジオメトリは、joint_1回転に合わせて変形します。

以下の動画では、ドライバの 移動 を変更しても、チューブジオメトリは変形しません。ドライバの 回転 を変更すると、チューブが回転に合わせて変形します。