| On this page | |
| Since | 21.0 |
コントロールグループ内の親コントロールを基準に垂直または水平方向に積み重ねることができる構成サブコントロール(スライダ、トグル、メニュー、カラーピッカーなど)を作成します。 これらのサブコントロールは、現在のコントロールグループが主選択のコントロールだった場合に、ビューポート内でリグパラメータを調整するためのUI操作を可能にします。 また、AnimateステートのParameters HUDからもアクセス可能です。 利用可能な構成コントロールの種類は、APEX Autorig Component SOPを参照してください。
このノードの graph ポートはインプレースポートです。つまり、コピーを作成せずにグラフが更新されます。
入力 ¶
*graph:
ApexGraphHandle
Required
コントロールグループを含んだAPEXグラフ。
controlgroup:
ApexNodeID
構成コントロールの追加先となるコントロールグループサブネット。 無効な場合、構成コントロールはグラフのルートレベルに追加されます。
parent:
ApexNodeID
この構成コントロールが相対的に配置される親トランスフォームコントロール。
parentxform:
Matrix4
親のワールドトランスフォーム行列。 これは、コントロールがコントロールグループ内にない場合にワールド座標系に基づいたシェイプオフセットを計算するのに使用されます。
name:
String
構成コントロールの名前。 これは、パラメータの命名やノードの識別のベースとして使用されます。
defaultvaluedict:
Dict
コントロールのデフォルト値を含んだ辞書。 コントロールに適した型の'value'キーを含めてください。
controltype:
String
作成するUI操作コントロールの種類。 利用可能な構成コントロールの種類は、APEX Autorig Component SOPを参照してください。 有効な値は以下の通りです:
コントロールの種類 |
説明 |
|---|---|
|
視覚的フィードバックがある浮動小数点スライダ(デフォルト)。 |
|
ブール型トグルスイッチ。 |
|
IK/FKスタイルのトグルコントロール。 IKとFKの実際のブレンドは、たいていの場合だと別のスライダコントロールで制御されます。 |
|
カスタムアイコン付きの整数メニュー。 |
|
数値ラベル付き整数メニュー(0～12)。 |
|
カスタム入力値を持つ整数メニュー。 |
|
カラーピッカーメニュー。 |
|
シェイプピッカーメニュー。 |
|
文字列名入力。 これは非表示コントロールであり、Parameters HUDでのみ表示されます。 |
|
ボタンコントロール。 選択時にコールバックをトリガーするのに使用することができます。 |
|
様々な値の型に対応した汎用チャンネルコントロール。 この値は、Parameters HUD内でのみアクセス可能であり、ビューポート上ではUI操作することができません。 |
value_type:
String
構成コントロールのデータタイプ。
有効な値は、Bool、Float、Int、String、Vector3です。
デフォルトはFloatです。
size:
Float
コントロールシェイプオフセットのスケールに使用される基準高さ(単位はメートル)。 デフォルトは1.8です。
place_left:
Bool
Trueに設定すると、コントロールが親の左側に配置されます。 Falseに設定すると、右側に配置されます。 デフォルトはTrueです。
instance:
Int
垂直方向のスタックインデックス。 値が大きいほど、コントロールは親に対して下の方に配置されます。 デフォルトは0です。
horizontal_instance:
Int
水平方向のスタックインデックス。 値が大きいほど、コントロールは親から離れて配置されます。 デフォルトは0です。
animatable:
Bool
Trueに設定すると、コントロールはキーフレームアニメーションを受け付けます。 デフォルトはTrueです。
Note
文字列値を使用するコントロールはアニメーション不可です。
arrange_vertical:
Bool
Trueに設定すると、垂直配置シェイプオフセットが適用されます。 デフォルトはTrueです。
slider_min:
Float
スライダコントロールの最小値。 デフォルトは0.0です。
slider_max:
Float
スライダコントロールの最大値。 デフォルトは1.0です。
parm_name:
String
コントロールグループパラメータ名のオーバーライド。 空っぽの場合、コントロールタイプから自動的に導出されます。
color:
Vector3
コントロールシェイプの表示カラー。 デフォルトは白(1, 1, 1)です。
promoted_name:
String
パラメータをコントロールグループレベルまでプロモートさせた時に使用される名前。 空っぽの場合、フルコントロール名が使用されます。
出力 ¶
*graph:
ApexGraphHandle
修正されたAPEXグラフ。
control:
ApexNodeID
作成された
AbstractControlノード。
parmport:
ApexPortID
コントロールのパラメータ値に接続するための出力ポート。
| See also |
