| On this page | |
| Since | 21.0 |
このノードは、リグコンポーネントを使用して、APEXキャラクタいわゆるAPEXリグをプロシージャルに拡張します。 リグコンポーネントは、Houdiniに同梱されている事前構築済みコンポーネント、または、異なるリグで再利用できるように独自に作成したコンポーネントのどちらでも構いません。
パラメータ ¶
Component Source
コンポーネントのソース。 以下のオプションが利用可能です:
-
コンポーネントライブラリ(事前構築済みコンポーネントと独自コンポーネントを含む)内で利用可能なリグコンポーネントのリストから選択します。
-
Use Second Input に設定すると、2番目の入力のリグコンポーネントスクリプトが使用されます。
-
Snippet に設定すると、 Snippet テキストブロックにAPEX Scriptコードを記述することで、独自のカスタムコンポーネントを作成することができます。
-
File に設定すると、 Component File の
.bgeoファイルで定義されたコンポーネントが使用されます。 -
Fuse Graph に設定すると、このノード上の既存のリグに2番目の入力のグラフをマージすることができます。
-
Deprecated に設定すると、 Component Source ドロップダウンの横に表示されるドロップダウンメニューの非推奨コンポーネントリストからコンポーネントを選択することができます。
Component Source Reload 
コンポーネントのライブラリをリロード/更新します。
Edit Source 
コンポーネントのソースコードを編集することができます。
をクリックすると、 Component Source が Snippet に設定され、コンポーネントのソースコードが取得され、それが Snippet パラメータにAPEX Scriptコードとして挿入されます。
また、 Save タブ内のいくつかのフィールドに値が設定されます。
これは、カスタムコンポーネントを作成するためのテンプレートとしてコンポーネントのコードを使用するのに役立ちます。
Component File
Component Source が File に設定されている場合、ここには、使用するリグコンポーネントのファイルパスを指定します。
Rig Source
CharacterStream入力内のリグに対して実行するオペレーション。
Add or Update
CharacterStream入力内の( Name で指定した)リグを追加/更新します。 リグが存在しない場合、可能であれば作成されます。
Add or Replace
CharacterStream入力内の( Name で指定した)リグを追加/置換します。
Name
CharacterStream入力内のリグの名前。
Build Rigscript
有効にすると、指定した名前のリグコンポーネントスクリプトがキャラクタフォルダ構造内に作成されます。 複数のAPEX Autorig Component SOPを直列接続すると、これは、そのノード順でリグスクリプトを構築していきます。
Guide Source
CharacterStream入力内のスケルトンに対して実行するオペレーション。
Add or Update
CharacterStream入力内で、指定したスケルトンを追加/更新します。 そのスケルトンが存在しなかった場合、可能であればそのスケルトンが作成されます。
Add or Replace
CharacterStream入力内で、指定したスケルトンを追加/置換します。
Name
CharacterStream入力内のスケルトンの名前。
Shape Source
CharacterStream入力のシェイプに対して実行するオペレーション。
Add or Update
CharacterStream入力内で、指定したシェイプを追加/更新します。 そのシェイプが存在しなかった場合、可能であればそのシェイプが作成されます。
Add or Replace
CharacterStream入力内で、指定したシェイプを追加/置換します。
Show
APEXネットワークビューに表示させるグラフを指定します。
Rig
キャラクタから抽出された結果のリググラフ。
Component Script
キャラクタを修正する現在のコンポーネントスクリプト。
Rig Script
Build Rigscript が有効になっている場合、ここには、複数のAPEX Autorig Component SOPを直列接続した際にそのノード順で構築されていくコンポーネントスクリプトを指定します。
Highlight Added Nodes
有効にすると、新しく追加されたノードが緑でハイライトされ、その他のノードがグレーアウトされます。 これによって、このリグコンポーネントによってグラフに加えられた変更内容が確認しやすくなります。
Highlight Reconnected Nodes
有効にすると、リググラフから接続が追加/修正/削除されたノードがハイライトされます。
Layout Graph
有効にすると、リググラフに自動レイアウトが適用されます。
Automatically Reset Test Animation 
有効にすると、パラメータを変更をした際に、ビューポートで実行中のアニメーションが自動でリセットされます。
無効の場合、アニメーションをリセットするにはボタンをクリックします。
Component ¶
このセクションには、現在のオペレーションまたはリグコンポーネントに固有のパラメータが含まれていて、 選択した Component Source オプションに応じて、そのパラメータインターフェースが変わります。
リグコンポーネントの場合、それらのパラメータは、コンポーネントスクリプトの入力から派生します。 このように、APEX Autorig Component SOPは、コンポーネントスクリプト入力を設定するためのインターフェースとして機能します。
View Log 
Opens the log viewer.
Reset Animation Parms 
コンポーネントスクリプトの入力として使用されているすべてのSpareパラメータを削除します。
Reload Setup Parms
このセクション内のパラメータを現在のコンポーネントのパラメータに更新します。 これは、入力コンポーネントスクリプトのパラメータが変わった場合に役立ちます。
Use Fusion Graph
有効にすると、2番目の入力のグラフ(Fuseグラフと呼びます)がこのノード上の既存リグにマージされます。
このパラメータは、 Component Source が Snippet または Fuse Graph に設定されている場合に利用可能です。
Component Source が Snippet に設定されている場合、Fuseグラフは現在のリググラフに自動でマージされません。
代わりに、Fuseグラフはtemplate_graphという名前の変数に設定されます。
このtemplate_graphを使用することで、Fuseグラフを現在のグラフに追加する方法を指定することができます。
例えば、Fuseグラフを単純にマージしたり、サブネットに追加したり、何回もループさせることができます。
Component Source が Snippet に設定されていて、且つ、 Use Fusion Graph が有効になっている場合、ヘッダの Template は Fuse Graph に設定されます。
Exclude Nodes
Use Fusion Graph が有効な場合、ここには、Fuseグラフを操作する前に安全に削除可能なグラフノードのグループを定義したAPEXパスパターンを設定します。 これは、フルリグがこのノードの2番目の入力に接続されているものの、実際のFuse操作に必要なノードが少ない場合に役立ちます。
Tip
不要なノードを除外することを推奨します。 これによって、Fuseグラフ操作の処理速度を大幅に向上させることができます。
これらのパラメータは、 Component Source が Fuse Graph に設定されている場合に利用可能です。 Fuseグラフ操作は、このノードの2番目の入力のグラフ(Fuseグラフと呼びます)を既存リグにマージすることができます。 Fuseグラフ操作の例は、グラフ機能のマージを参照してください。
Fuse Graph Tag
Fuseグラフからマージされたノードに追加するタグ。
Mirror
有効にすると、リグの両側でグラフ機能をミラーリングされます。
From
Mirror が有効な場合、ここには、ミラーリング元のキャラクタの側を指定します。
このパターンは、リググラフ内の
TransformObjectノード(このノードはスケルトンジョイントを意味しています)の名前を参照します。
To
Mirror が有効な場合、ここには、ミラーリング先のキャラクタの側を指定します。 このパターンは、リググラフ内のTransformObjectノード(このノードはスケルトンジョイントを意味しています)の名前を参照します。
Fuse Graph Body Side
Mirror が有効な場合、ここには、Fuseグラフ機能がセットアップされるキャラクタの側を指定します。
キャラクタの左側に対してFuseグラフを構築することが推奨されています。
そうすることで、
APEX Autorig Builder SOPと組み合わせて新しいコンポーネントをインタラクティブに使用したい場合に理想的な準備が整います。
Mapping
スケルトンジョイント間に作成するマッピングの数。
From
Fuseグラフ内で既存の機能を持ったTransformObjectノード。
To
その機能の適用先となるTransformObjectノード。 一致するTransformObjectノードが存在しなかった場合は、新しいTransformObjectノードが作成され、Fuseグラフ上のマッチしたジョイントの位置に配置されます。
このセクションは、 Component Source が Snippet に設定されている時に利用可能です。
Snippet
実行するAPEXスクリプトスニペット。
Inspect Line
有効にすると、 Snippet 内の指定した行番号のコードが赤で表示されます。これはデバッグで役に立ちます。
Show Traceback
有効にすると、フルのトレースバック付きですべてのエラーメッセージを表示します。
有効にすると、ヘッダとフッタがスニペットに追加されます。 ヘッダとフッタは、現在のスニペットの前後に挿入される事前定義済みコードスニペットであり、スニペットと併せて実行されます。 このヘッダとフッタは、ジオメトリ入力をグラフに変換してからそれを再びジオメトリに戻したり、キャラクタフォルダ構造からリググラフを取得するといったよく行なうオペレーションを標準化するのに役立ちます。
Template
現在のスニペットに使用するヘッダテンプレート。
Basic
空っぽのテンプレートを追加します。
Graph
(ヘッダ内で)グラフ入力のどれかにバインドされているジオメトリをグラフに変換し、(フッタ内で)そのグラフをジオメトリに書き戻します。
Component
(ヘッダ内で)パックキャラクタジオメトリからリググラフを取得し、(フッタ内で)そのグラフを用いてパックキャラクタジオメトリを更新します。
Custom
ユーザ側でヘッダとフッタを編集することができます。
Fuse Graph
template_graph変数を用意します。
この変数には、このノードの2番目の入力に接続されているFuseグラフが格納されています。
Add Version
有効にすると、Houdiniバージョンがヘッダーに追加され、使用するAPEX関数のバージョンが設定されます。 これによって、異なる引数を持つ新しいバージョンの関数が追加された場合でも下位互換を保つことができます。 詳細は、特別な関数を参照してください。
Show
有効にすると、ヘッダーとフッターが表示されます。
Edit
有効にすると、ヘッダーとフッターを手動で編集することができます。
Enable Partial Evaluation
有効にすると、以下のグラフの部分のみを実行することで、コンポーネントスクリプトグラフに対して部分的評価の最適化を行なうことができます:
-
変更のあった入力パラメータに依存している。
且つ
-
このノードから要求された出力に寄与している。
Color New Nodes
有効にすると、現在のコンポーネントスクリプトで追加されたノードを、指定したカラーにします。 このカラーは、出力グラフに追加されます。 簡単に各ノードをソースコンポーネントスクリプトに関連付けることができるのでデバッグ用途に使用すると良いでしょう。
Rig Script ¶
このタブは、 Build Rigscript が有効な場合に利用可能です。 このセクションでは、パラメータインターフェースで利用できるようにしたいリグスクリプト内のパラメータを指定することができます。
Promoted Parms
プロモートするリグスクリプトパラメータの数。
Parm
プロモートするコンポーネントパラメータ。
Alias
パラメータの新しい名前。
Save ¶
このタブは、 Component Source が Use Second Input 、 Snippet 、 Fuse Graph に設定されている場合に利用可能です。
Component Name
コンポーネントの名前。
例えば、ネームスペースフィールドにtest、名前フィールドにhello、バージョンを2.0に設定すると、そのコンポーネント名はtest::hello::2.0となります。
Tip
カスタムコンポーネントには、分類や並べ替えを容易にし、さらにHoudiniの事前構築済みコンポーネントとの名前衝突を防ぐために、ネームスペースを使用することを推奨します。
Component Label
コンポーネントの分かりやすいラベルです。 このラベルは、 Component Source のドロップダウンメニュー、Autorig BuilderビューアステートのコンポーネントカタログHUDで使用されます。
Component Icon
コンポーネントカタログHUDでアイコンに使用される.pngファイルのパス。
画像を指定しなかった場合は、デフォルトのアイコンが使用されます。
Component Categories
コンポーネントカタログHUDでフィルタとして使用できるカテゴリ名。 カテゴリ名は、コンポーネント上にタグとして追加されます。
Deprecated
有効にすると、コンポーネントが非推奨としてマークされます。 コンポーネントを保存した後、 Component Source が Deprecated に設定されている場合、そのコンポーネントは非推奨コンポーネントのドロップダウンメニューに表示されます。
Save as Config of
有効にすると、現在のコンポーネントを、指定した(参照)コンポーネントのバージョンとして保存します。 これは、Autorig Builderのコンポーネントカタログにエントリを追加します。 新しいコンポーネントに対して参照コンポーネントの実装を複製するのではなく、参照コンポーネントの実装を基に、新しいコンポーネント用に異なるデフォルトパラメータを設定して使用します。 例えば、“limb”が参照コンポーネントの場合、基本的にその“limb”と同じでありながらデフォルトパラメータが異なる“arm”コンポーネントを作成することができます。
Config Parms
Save as Config of が有効な場合、これらのパラメータは、新しいコンポーネントに上書きする参照コンポーネントのパラメータです。
*に設定すると、新しいコンポーネントは、参照コンポーネントのすべてのパラメータを上書きします。
Use with Rig Builder
有効にすると、保存されたコンポーネントは、コンポーネントカタログで利用可能になり、Autorig Builderビューアステートでインタラクティブにドラッグ&ドロップすることができます。
すべてのインタラクティブコンポーネントには、Autorig Builderビューアステートでのガイドに
メニューが追加されます。
このメニューでは、ユーザはビューポート内でコンポーネントパラメータをインタラクティブに変更することができます。
Component Output File
コンポーネントの保存先となるファイルパス。
Note
コンポーネントは、HOUDINI_PATH内のapexcomponentフォルダに保存しなければなりません。
Save to Disk
コンポーネントを Component Output File に保存します。
Note
コンポーネントスクリプトを$HIP/apexcomponent/または$HOME/apexcomponent/に保存すると、そのコンポーネントスクリプトが Component Source から自動で読み込まれます。
Rig Builder ¶
これらのパラメータは、APEX Autorig Builder SOPでコンポーネントをインタラクティブなツールとして利用できるようにします。
このセクションは、以下の条件が満たされている場合に利用可能です:
-
Component Source が Use Second Input 、 Snippet 、 Fuse Graph に設定されている。
且つ
-
Save タブで、 Use with Rig Builder が有効になっている。
詳細は、Autorig Builder用のコンポーネントの準備を参照してください。
Drag Drop Interaction
Autorig Builderのガイドの設定、および、コンポーネントカタログからのドラッグ&ドロップ操作の設定を定義します。
Deformer
このオプションは、スケルトンの特定のジョイントにはマッピングされず代わりにキャラクタ全体に適用されるデフォーマ(例えば、Delta Mushリグコンポーネント)に使用されます。
Skeleton
このオプションは、Autorig Builderでのドラッグ&ドロップ操作によって、スケルトンの一部(参照スケルトン)を既存のガイドジョイントにマッピングすることができます。 参照スケルトンジョイントが既存のジョイントにマッピングされていない場合、新しいジョイントが作成されます。 マッピングまたは新しく作成されたすべてのジョイントには、現在のセグメント名がタグとして付与されます。
Note
コンポーネントの適用先を示した“segments”パラメータを定義することを推奨します。 Autorig Builderは、“segments”というキーワードを認識し、ユーザがドラッグ&ドロップ操作によってコンポーネントをキャラクタの異なる部分に適用できるようにします。 詳細は、Autorig Builder用コンポーネントの準備を参照してください。
参照スケルトンのジョイントに保存されているすべてのタグとプロパティは、既存のガイドジョイントに転送されます。
新しいジョイントが作成される場合、参照スケルトンのジョイント名が使用されます。
ボディサイドインジケータ(例えば、L_*やR_*)は、Autorig Builderで使用されているボディサイドインジケータ(APEX Autorig Builder SOPの Left パラメータや Right パラメータ)に簡単に置き換えることができます。
Add2BoneIK
このオプションは、3本ジョイントセットアップで使用することができます。 これには、3本ジョイントの参照スケルトンが必要であり、ガイドの先端位置を変更することなくジョイントの位置合わせやルートの再配置を容易にするIKガイド配置オプションが追加されます。
Joint Chain
このオプションは、ジョイント数の柔軟な変更が必要なコンポーネント(例えば、背骨、FKチェーン、またはAutorig Builder内でジョイント数を変更できるようにしたいカスタムスプラインセットアップ)に使用することができます。 ドラッグ&ドロップ操作は、既存のリグ内のあらゆるジョイントチェーンに適用することができます。 新しいガイドジョイントが作成された場合、スプラインセットアップに基づいたIKコントロールを使用してガイドジョイントを配置することも可能であり、滑らかな曲線を描くジョイントチェーンを簡単に作成することができます。
Tag
このオプションは、Autorig Builder内のドラッグ&ドロップ操作によって、コンポーネントを既存のタグに適用することができます。 ドラッグすると、タグのビジュアライザが表示され、選択したタグに応じて適切なタグパラメータが入力されます。
Note
タグはAPEXパスパターンで入力します。
例えば、蜘蛛のすべての脚にIKコンポーネントを適用したい場合、その蜘蛛の脚に既にLeg_01、Leg_02などのタグが設定されていれば、
#Leg*というタグを使用することで、Leg_*のタグが付けられているすべてのジョイントにIKコンポーネントを適用することができます。
Generate from Component Parms
パラメータインターフェース内のコンポーネントの入力パラメータを、 Config Control Parms マルチパラメータに自動で設定します。
APEX Scriptを使用してコンポーネントを作成した場合、自動設定されるパラメータはBindInput()で定義されたパラメータとなります。
ボタンをクリックすると、それらのパラメータがパラメータエディタに表示されます(詳細は、グラフインターフェースの作成を参照してください)。
APEXグラフを使用してコンポーネントが定義されている場合、自動設定されるパラメータはグラフの入力パラメータとなります。
Config Control Parms
ガイド上のコンポーネントのメニューに追加されるパラメータ。
メニューは、Autorig Builderの各コンポーネントセグメントに表示され、ユーザがコンポーネントのパラメータをインタラクティブに設定することができます。
Note
Autorig Builderのメニューには、すべてのコンポーネントパラメータが必要というわけではありません。
ユーザが頻繁に変更するパラメータのみを追加することを推奨します。
これによって、インタラクティブツールがすっきりして使いやすくなります。
Parameter
コンポーネントの入力パラメータの名前。 APEX Scriptを使用してコンポーネントを作成した場合、コンポーネントの入力パラメータは次のように定義されます:
<parameter_name>: <parameter_type> = BindInput()
BindInput()関数の詳細は、グラフの入力と出力を指定する方法を参照してください。
Parameter の横にあるドロップダウンメニューでは、作成する メニューオプションのタイプを定義します。
メニュー内のオプションでは、コンポーネントパラメータをインタラクティブに設定することができます(これらのパラメータは、Parameters HUDでメニューを選択して、ビューポート上でGを押すことでも設定することができます)。
Slider
水平方向にドラッグしてパラメータ値を設定することができる浮動小数点スライダ。
Icon Menu
メニュー項目名( Menu Entries パラメータ)とそれに呼応するアイコン( Menu Entry Icons パラメータ)のリストが表示されるメニュー。
例えば、 Menu Entries をball cross duckyに設定し、 Menu Entry Icons をsphere_m crossplanes_wires rubberに設定すると、
コンポーネントのメニューに以下のオプションが表示されます。
アイコンをクリックしてドラッグすると、利用可能な項目のメニューが開きます:
Color
カラープリセットのメニュー。 例えば、APEX Scriptで以下のパラメータを定義した場合:
testcolor: Vector3 = BindInput((1, 0, 1))
コンポーネントのメニューに以下のオプションが表示されます:
カラーアイコンをクリックしてドラッグすると、利用可能なカラーのメニューが開きます。
Shape
事前定義済みリストから選択できるコントロールシェイプのメニュー。 ビューポート内でシェイプアイコンをクリックしてドラッグすると、利用可能なシェイプのメニューが開きます。
Joint Tag
コンポーネントが適用されるガイド上のタグを指定することができるボタン。
コンポーネントのメニューに以下のオプションが追加されます:
タグオプションの使用方法は、ギアメニューオプションを参照してください。
Rig Tag
コンポーネントが適用されるテストリグ上のタグを指定することができるボタン。
コンポーネントのメニューに以下のオプションが追加されます:
タグオプションの使用方法は、ギアメニューオプションを参照してください。
Parent
Child
コントロールの子を設定することができるボタン。
Toggle
コンポーネントパラメータのブール値を設定するクリック&ドラッグ式の水平トグルコントロール。
Name
コンポーネント用の文字列フィールド。
このオプションは、Parameters HUDにのみ表示されます(メニューを選択して、ビューポート上でGを押してください)。」このパラメータのデフォルト値を定義するには、APEX ScriptでBindInput()を使用するか、または、グラフ内で(例えば、
graph::SetDefaultParmsを使用して)デフォルトパラメータを設定してください。
例:
-
APEX Scriptで以下のパラメータを定義した場合:
testname: String = BindInput('C_main C_layout') -
Parameter を
testnameに設定します。 -
ドロップダウンメニューを Name に設定します。
testnameパラメータがParameters HUDに表示されます:
Int Menu
整数パラメータ値を設定するための数字アイコンを備えたRadialメニュー。
コンポーネントのメニューに以下のオプションが追加されます:
数字アイコンをクリックしてドラッグすると、利用可能な値のメニューが開きます。
Channel Widget Only
Parameters HUD(チャンネルウィジェットとも呼ばれます)にパラメータを追加します。 このオプションでは、Parameters HUDに正しいタイプが追加されるようにするために、そのパラメータのタイプを指定する必要があります。 例:
-
APEX Scriptで以下のパラメータを定義した場合:
test: Bool = BindInput(True) -
Parameter を
testに設定します。 -
ドロップダウンメニューを Channel Widget Only に設定します。
testパラメータは、Parameters HUDにチェックボックス(ブール値)として表示されますが、メニューには表示されません:
Note
どのパラメータ値タイプもParameters HUDに追加できるわけではありません。 有効なオプションは、Bool、Integer、Float、Vector3、Stringです。
このセクションは、 Drag Drop Interaction が Skeleton に設定されている場合にのみ利用可能です。 参照スケルトンとは、現在のコンポーネントに関連する一部の入力スケルトンのことです。 参照スケルトンを使用することで、ドラッグ&ドロップでスケルトンの一部を既存のガイドジョイントにマッピングすることができます。 参照スケルトンジョイントが既存のジョイントにマッピングされていない場合、新しいジョイントが作成されます。 マッピングまたは新しく作成されたすべてのジョイントには、現在のセグメント名がタグとして付与されます。
Skeleton Source
使用するスケルトンのソース。 デフォルトでは、指定された入力スケルトン( Guide Skeleton )が使用されます。 あるいは、2番目の入力で指定されたキャラクタフォルダ構造からスケルトンを取得することもできます。
Joint Group
コンポーネントのセグメントを定義するジョイント。 Skeleton Source にフルスケルトンを指定した場合、コンポーネントのセグメントを定義するのに必要なジョイントのみを選択してください。 例えば、“arm”に機能を追加するコンポーネントを構築する場合、このパラメータにはキャラクタの左側の“arm”ジョイントのみを含めてください。
Remove Side Indicator
スケルトンの側を定義するワイルドカードパターン(例えば、L_*)。
このボディサイドインジケータは、コンポーネントが保存される前に参照スケルトンのジョイント名から除去されます。
これによって、APEX Autorig Builder SOPのボディサイドインジケータ( Left パラメータや Right パラメータ)が異なっていても、Autorig Builderでコンポーネントを使用できるようになります。
有効にすると、ビューポート内でAutorig Builderのガイドの外観を確認することができます。
これは、 Config Control Parms で定義されたメニューのレイアウトを確認するのに役立ちます。
Mirror
有効にすると、参照スケルトンをミラーリングした場合の外観が表示されます。
Left
キャラクタのガイドジョイントの左側を示したワイルドカードパターン。
Right
キャラクタのガイドジョイントの右側を示したワイルドカードパターン。
入力 ¶
CharacterStream
キャラクタフォルダ構造内のAPEXキャラクタジオメトリ。
Component Script
コンポーネントに呼び出すためのAPEXグラフを含んだジオメトリ。
出力 ¶
CharacterStream
キャラクタフォルダ構造の修正されたAPEXキャラクタジオメトリ。
Component Script
パックキャラクタフォルダ構造のジオメトリ。
Examples ¶
NeckComponent Example for APEX Autorig Component geometry node
This example demonstrates how to use the neck rig component for the Otto test geometry.
RigCharacter Example for APEX Autorig Component geometry node
This example demonstrates how to use pre-built rig components to build up a rig for Electra.
RootComponent Example for APEX Autorig Component geometry node
This example demonstrates how to use the root rig component to add root controls for the Electra test geometry.
| See also |
APEX Configure Controls
