hyperGraph

移動先: 概要 戻り値 フラグ. MEL 例.

概要

hyperGraph [-addBookmark] [-addDependGraph name] [-addDependNode name] [-animateTransition boolean] [-attributeEditor string] [-bookmarkName] [-clear] [-collapseContainer] [-connectionDrawStyle string] [-control] [-defineTemplate string] [-deleteBookmark string] [-dependGraph] [-dependNode string] [-docTag string] [-down] [-downstream] [-dragAndDropBehaviorCommand string] [-dropNode string] [-dropTargetNode string] [-edgeDblClickCommand string] [-edgeDimmedDblClickCommand string] [-enableAutomaticLayout boolean] [-exists] [-expandContainer] [-feedbackGadget string] [-feedbackNode string] [-filter string] [-filterDetail string boolean] [-fitImageToHeight] [-fitImageToWidth] [-focusCommand string] [-fold] [-forceMainConnection string] [-forceRefresh] [-frame] [-frameBranch] [-frameGraph] [-frameHierarchy] [-freeform boolean] [-fromAttr string] [-getNodeList] [-getNodePosition string] [-graphLayoutStyle string] [-graphType string] [-highlightConnection string] [-iconSize string] [-image string] [-imageEnabled boolean] [-imageForContainer] [-imagePosition float float] [-imageScale float] [-isHotkeyTarget] [-layout] [-layoutSelected string] [-lockMainConnection] [-look float float] [-mainListConnection string] [-mergeConnections boolean] [-navigateHome] [-nextView] [-nodeDropCommand string] [-nodePressCommand string] [-nodeReleaseCommand string] [-opaqueContainers boolean] [-orientation string] [-panel string] [-parent string] [-popupMenuScript string] [-previousView] [-range float float] [-rebuild] [-removeNode string] [-rename] [-resetFreeform] [-restoreBookmark string] [-scrollUpDownNoZoom boolean] [-selectionConnection string] [-setNodePosition string float float] [-showConstraints boolean] [-showDeformers boolean] [-showExpressions boolean] [-showInvisible boolean] [-showRelationships boolean] [-showShapes boolean] [-showUnderworld boolean] [-stateString] [-transitionFrames int] [-unParent] [-unfold] [-unfoldAll] [-unlockMainConnection] [-updateMainConnection] [-updateNodeAdded boolean] [-updateSelection boolean] [-upstream] [-useFeedbackList] [-useTemplate string] [-viewOption string] [-visibility boolean] [-zoom float] [string]

hyperGraph は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

ハイパーグラフで、ユーザは Maya シーン グラフを表示したり編集したりすることができます。ハイパーグラフでは 2 つのタイプのグラフがサポートされます。 DAG（シーン階層グラフ）およびディペンデンシー グラフです。

ハイパーグラフ エディタのデフォルトのビューは、DAG ビューです。 まずノードを選択してから、グラフ オプションの 1 つを使ってディペンデンシー グラフに移動し、ノードの集まりのディペンデンシー グラフを表示できます。ブックマークをビューに設定して任意のビューを保存することができます。提供されているビューのオプションを使って前のビューを表示することもできます。

ハイパーグラフでは、DAG ビューの階層およびディペンデンシー グラフ ビューのコネクションを編集するための単純な編集メカニズムがサポートされます。 DAG ビューでは、ドラッグ＆ドロップを使ってグラフ内でノードを再度ペアレント化したり順序を変更することができます。ディペンデンシー グラフ ビューでは、コネクションを選択、削除したり、ノードまたは既存のコネクションをドラッグ＆ドロップして新しいコネクションを作成することができます。

ハイパーグラフでは、DAG ビューで 2 つのレイアウト モードがサポートされます。自動モードとフリーフォーム モードです。自動モードでは、レイアウトのプリファレンスに応じてグラフ ノードが自動的に配置されます。フリーフォーム モードでは、手動でノードを配置できます。ノード位置はシーンに保存されます。 バックグラウンド イメージは、フリーフォーム モードで DG または DAG の後ろに配置できます。 このイメージは、ユーザ定義のレイアウトでノードを配置する際のテンプレートとして使うことができます。

DAG ビューのノードは、展開したり折り畳んだりすることができます。このノードの状態はシーンに保存されています。階層を折り畳むと、グラフ描画のパフォーマンスが向上します。

ハイパーグラフでは、階層のリレーションに加えて、DAG でエクスプレッション、コンストレイン、またはデフォメーションのリレーションも表示できます。 提供されているオプションを使って、これらの有効、無効を切り替えることができます。シェイプ ノードや非表示のノードを表示するための追加のフィルタもあります。表示のディテールの程度は、グラフの表示速度に影響する可能性があります。

ハイパーグラフの UI 機能の大部分は、ハイパーグラフ コマンドライン インタフェースを使ってアドレス可能です。使用可能なコマンド ライン オプションについては、次のセクションで説明しています。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-exists(-ex)
指定したオブジェクトが存在するかどうかによって、 true または false を返します。他のフラグは無視されます。
-defineTemplate(-dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに 追加するモードに、コマンドのモードを変更します。 templateName がカレントのテンプレートとして設定されていれば、 その後コマンドが実行されるたびに、この引数がデフォルトの引数として使用されます。
-useTemplate(-ut)	string
コマンドに、カレント以外のコマンド テンプレートの使用を強制します。
-panel(-pnl)	string
エディタが属しているパネルを指定します。デフォルトでは、エディタがスクリプト パネルの作成コールバックで作成された場合、エディタはそのパネルに属します。エディタがパネルに属していない場合、 エディタのあるウィンドウを削除するとエディタも削除されます。
-parent(-p)	string
このエディタの親のレイアウトを指定します。このフラグは、エディタが現在ペアレント化されていない場合のみに効果があります。
-unParent(-up)
エディタをそのレイアウトから削除するように指定します。 照会には使用できません。
-control(-ctl)
照会モード専用です。このエディタの最上位のコントロールを返します。 通常は、親を取得してポップアップ メニューをアタッチするために使用します。 注意: コントロールのないエディタが存在する場合があります。コントロールがない場合は、このフラグは NONE を返します。
-mainListConnection(-mlc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。
-forceMainConnection(-fmc)	string
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。これは -mainListConnection フラグの変形で、 コネクションがロックされている場合でも強制的に変更します。このフラグを使用して、-unlockMainConnection、-mainListConnection、-lockMainConnection フラグを直後に連続して使用する場合に、オーバーヘッドを減します。
-selectionConnection(-slc)	string
その独自のセレクション リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。このエディタから選択する場合、 selectionConnection オブジェクトの中から選択します。オブジェクトが変更されると、エディタが更新されて変更が反映されます。
-highlightConnection(-hlc)	string
そのハイライト リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。すべてのエディタにハイライト リストがあるわけではありません。ハイライト リストがあるエディタの場合、これは第二の選択項目を表示したリストになります。
-filter(-f)	string
このエディタに配置する項目フィルタ オブジェクトの名前を指定します。 エディタの主要リストに表示される情報をフィルタします。
-lockMainConnection(-lck)
mainConnection 内のオブジェクトのカレント リストをロックして、そのオブジェクトだけがエディタ内に表示されるようにします。 これ以降、元の mainConnection に変更を加えても無視されます。
-stateString(-sts)
照会モード専用のフラグです。エディタを編集して現在のエディタの状態と一致させる MEL コマンドを返します。返されたコマンド文字列は、指定した名前の代わりに文字列変数 $editorName を使用します。
-unlockMainConnection(-ulk)
mainConnection をロック解除して、オリジナルの mainConnection（まだ使用可能な場合）を効率的に復元し、ダイナミックな更新を行います。
-updateMainConnection(-upd)
ロックされた mainConnection をオリジナルの mainConnection から更新させますが、ロック状態は保持されます。
-docTag(-dtg)	string
Maya エディタにタグをアタッチします。
-addBookmark(-abk)
カレントのハイパーグラフ ビューのブックマークを作成します。
-addDependNode(-adn)	name
ディペンデンシー ノードをディペンデンシー グラフビューに追加します。
-addDependGraph(-adg)	name
指定したノードで始まるディペンデンシー グラフをビューに追加します。
-animateTransition(-atr)	boolean
アニメート トランジションをオフまたはオンにします。
-attributeEditor(-ae)	string
選択したノードでアトリビュート エディタ（Attribute Editor）を起動します。
-bookmarkName(-bn)
最も新しく作成されたブックマークの名前を返します。
-connectionDrawStyle(-cds)	string
ノード間のコネクションの描画方法を指定します。有効な値は「center」ノードの中心から別のノードの中心へコネクション ラインを引く）および「side」（ソース ノードの右側から、接続先ノードの左側へコネクション ラインを引く）です。デフォルトは「center」です。このフラグはハイパーシェード（Hypershade）グラフには適用されません。これには、常に「side」のコネクション描画スタイルが適用されます。
-clear(-clr)
カレントのハイパーグラフ ビューをクリアしてグラフ UI を削除します（-rebuild フラグも参照してください）。
-collapseContainer(-cc)
DG グラフで選択したコンテナを折り畳みます。
-deleteBookmark(-dbk)	string
対応するノード名のブックマークを削除します。
-dependGraph(-dg)
指定したノードから繰り返されるディペンデンシー グラフを表示します。
-dependNode(-dn)	string
ビューにディペンデンシー ノードを表示します。
-dropNode(-dr)	string
ドロップの処理時に呼び出すと、ドラッグ＆ドロップ コネクションのソース ノードの名前を返します。
-dropTargetNode(-drt)	string
ドロップの処理時に呼び出すと、ドラッグ＆ドロップ コネクションの接続先ノードの名前を返します。
-dragAndDropBehaviorCommand(-ddc)	string
ハイパーグラフ ノードにドラッグ＆ドロップした場合に呼び出される Mel プロシージャです。Proc シグネチャは procName（string $editor、string $sourceNode、string $destinationNode）です。
-edgeDblClickCommand(-edc)	string
エッジをダブル クリックすると呼び出される MEL プロシージャです。Proc シグネチャは procName（string $editor、string $edge）です。
-edgeDimmedDblClickCommand(-edd)	string
薄く表示されたエッジをダブル クリックすると呼び出される MEL プロシージャです。Proc シグネチャは procName（string $editor、string $edge）です。
-enableAutomaticLayout(-eal)	boolean
ドラッグ＆ドロップまたは dg メッセージでグラフにノードが追加または削除された場合に、グラフを再構築します。デフォルトは true です。
-expandContainer(-ec)
DG グラフで選択したコンテナを展開します。
-fromAttr(-fat)	string
ドロップの処理時に呼び出すと、ドラッグ＆ドロップ コネクションのソース アトリビュートの名前を返します。
-feedbackGadget(-fbg)	string
カレントのガジェットの名前を返します。
-fitImageToWidth(-fiw)
バックグラウンド イメージの位置とスケールを変更し、幅をカレントのエディタ ビュー に合わせます。
-fitImageToHeight(-fih)
バックグラウンド イメージの位置とスケールを変更し、高さをカレントのエディタ ビュー に合わせます。
-feedbackNode(-fbn)	string
カレントのフィードバックまたはハイライト ノードの名前を返します。
-focusCommand(-fc)	string
ハイパーグラフでマウスをクリックすると実行される MEL プロシージャです。主にウィンドウのフォーカスを設定するときに使用します。
-filterDetail(-fd)	string boolean
このフラグは現在サポートしていません。この代わりに、showConstraints、showExpressions、showDeformer、showInvisible、showShapes、および showUnderworld フラグを使用します。
-fold(-fo)
選択したオブジェクトを折り畳みます。
-forceRefresh(-frf)
ハイパーグラフで強制的にコンテンツをリフレッシュ（再描画）します。
-frame(-fr)
選択したオブジェクトをフレーム構成します。
-frameBranch(-frb)
選択したノードの下位にある大枝をフレーム構成します。
-frameGraph(-fg)
グラフ全体をフレーム構成します。
-frameHierarchy(-frh)
選択したノードを含む階層をフレーム構成します。
-graphLayoutStyle(-gls)	string
グラフ レイアウト スタイルを次の中から選択します。"circularLayout"|"hierarchicalLayout"|"orthogonalLayout"|"symmetricLayout"|"treeLayout"
-getNodeList(-gnl)
グラフのすべてのノード リストを示す文字配列を返します。
-getNodePosition(-gnp)	string
指定したノードの位置を (x,y) グラフで返します。 このフラグと引数は、-q フラグより前にコマンドに渡されなければなりません（例を参照）。 このフラグは照会モードでは値を受け入れます。
-graphType(-gt)	string
ビュー内にあるカレントのグラフのタイプ名を返します（DAG または DG のいずれか）。
-iconSize(-ics)	string
このハイパーグラフ エディタ用のアイコン サイズを設定または照会します。 現時点で許容されているアイコン サイズは、「small」、「medium」および「large」です。
-viewOption(-vo)	string
このハイパーグラフ エディタ用のビューのオプションを設定または照会します。 現在のところ使用できるビューは、「asIcons」および「asList」です。
-isHotkeyTarget(-iht)
内部使用のためのフラグです。
-image(-img)	string
プロジェクト イメージ ディレクトリからロードされるバックグラウンド イメージを指定します。
-imageEnabled(-ime)	boolean
ロードしたバックグラウンド イメージの表示を有効にします（フリーフォーム DAG ビューまたは DG ビュー）。
-imagePosition(-imp)	float float
バックグラウンド イメージの位置です。
-imageScale(-ims)	float
バックグラウンド イメージの均一なスケールです。
-imageForContainer(-ifc)
次のフラグがイメージ全体ではなく選択したコンテナで動作するように指定します。 -imageScale、-imagePosition、fitImageToWidth、-fitImageToHeight、-image
-layout(-lay)
グラフで自動レイアウトを実行します。
-layoutSelected(-lsl)	string
選択したオブジェクトで自動レイアウトを実行します。 "circularLayout"|"hierarchicalLayout"|"orthogonalLayout"|"symmetricLayout"|"treeLayout"
-look(-loo)	float float
グラフ ビューの座標を調べます。
-down(-do)
現在の選択を含むディペンデンシー グラフを下方に移動します。 上流接続と下流接続を示します。
-mergeConnections(-mc)	boolean
コネクションのグループを「太い」コネクションにマージします。
-navigateHome(-hom)
ホーム（DAG ノード）ビューに移動します。
-nodeDropCommand(-ndr)	string
ノードがハイパーグラフ ウィンドウでドロップされるときに呼び出されるコマンドを設定します。
-nodePressCommand(-np)	string
カーソルがハイパーグラフ ウィンドウのノード上にある場合に、マウス ボタンを押したときに呼び出されるコマンドを設定します。
-nodeReleaseCommand(-nr)	string
カーソルがハイパーグラフ ウィンドウのノード上にある場合に、マウス ボタンを離したときに呼び出されるコマンドを設定します。
-nextView(-nvw)
ビューが次の DAG ノード ビューに変わります。
-opaqueContainers(-opc)	boolean
展開したコンテナの背景の不透明度を設定します。
-orientation(-or)	string
次のいずれかのグラフの方向スタイルを選択します。「horiz」または「vert」です。
-previousView(-pvw)
ビューが前の DAG ノード ビューに変わります。
-popupMenuScript(-pms)	string
このハイパーグラフのコントロールがあるポップアップ メニューを登録するために呼び出すスクリプトを設定します。このスクリプトは、ポップアップ メニューの親になるコントロールを持つ、ハイパーグラフの名前を指定する文字列引数と一緒に呼び出されます。
-range(-rg)	float float
ノードの表示を範囲内のノードのみに限定します。 2 つの float 値が予想されます。1 つ目は範囲の下限しきい値、2 つ目は上限しきい値です。 値は、パーセンテージではなく、絶対時間値です。
-rebuild(-rb)
グラフを再構築します。
-rename(-rn)
選択したオブジェクトの上にテキスト フィールドをポップ アップし、名前を変更します。
-resetFreeform(-rf)
すべてのノードの自由形式の位置をリセットします。
-freeform(-fre)	boolean
フリーフォーム レイアウト モードを有効にします。
-restoreBookmark(-rbk)	string
ブックマークに対応するビューを復元します。
-removeNode(-rmn)	string
文字列で識別されたノードをグラフから削除します。
-scrollUpDownNoZoom(-snz)	boolean
フリー ズーム モードでないとき、Y のみに沿ったスクロールをする場合に指定します。 デフォルトでは、ハイパーグラフ エディタを使用して左右にパンできます。
-showConstraints(-shc)	boolean
コンストレインのリレーションを DAG ノードで表示します。
-showExpressions(-shx)	boolean
エクスプレッションのリレーションを DAG ノードで表示します。
-showDeformers(-shd)	boolean
デフォーマまたはジオメトリ フィルタのリレーションを DAG ノードで表示します。
-showInvisible(-shi)	boolean
非表示のノードを DAG ノードで表示します。
-showRelationships(-shr)	boolean
リレーションシップ（メッセージ）コネクションを表示します。
-showShapes(-shs)	boolean
シェイプ ノードを DAG ノードで表示します。
-showUnderworld(-shu)	boolean
下層グラフを DAG ノードで表示します。
-setNodePosition(-snp)	string float float
文字列で識別されたノードを、2 つの float で指定したウインドウの (x,y) 位置に設定します。そのノードがグラフ内にない場合は、グラフに追加されてから新しい位置に移動されます。
-transitionFrames(-tfr)	int
アニメート トランジション用のトランジション フレームの数を指定します。
-unfold(-uf)
選択したオブジェクトを展開します。
-unfoldAll(-ua)
選択したオブジェクトの下位にあるすべてを展開します。
-updateNodeAdded(-una)	boolean
新しいノードがデータベースに追加された場合にグラフを更新します。
-updateSelection(-us)	boolean
データベースの選択状態が変わった場合にグラフの選択状態を更新します。
-upstream(-ups)
選択したノードの上流のディペンデンシー グラフを表示します。
-downstream(-ds)
選択したノードの下流のディペンデンシー グラフを表示します。
-useFeedbackList(-ufl)
他のハイパーグラフ コマンドライン オプションを処理しているときに、フィードバックまたはハイライト リストをターゲット選択として使用します。
-visibility(-vis)	boolean
選択したノードの可視の状態を設定します。
-zoom(-zm)	float
アニメート トランジションのズーム係数を指定します。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

MEL 例

// The hyperGraph command is not one which would commonly be used
// by the user.
polySphere -r 1 -sx 20 -sy 20 -ax 0 1 0 -tx 2 -ch 1;

// Gets the position of the node in the graph.
HypergraphHierarchyWindow;
string $editor = "hyperGraphPanel1HyperGraphEd";
float $position[] = `hyperGraph -getNodePosition pSphere1 -q $editor`;