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] [-showConnectionFromSelected boolean] [-showConnectionToSelected boolean] [-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 ノードで表示します。
-showConnectionFromSelected(-scf)	boolean
選択したノードから離れた接続(コンストレイント、エクスプレッション、デフォーマ。例については showConstraints を参照)を表示します。これを showConnectionToSelected と組み合わせると、到着した接続と離れた接続の両方が表示されます。両方のフラグが false である場合、すべての接続が表示されます。
-showConnectionToSelected(-sct)	boolean
選択したノードに到着した接続(コンストレイント、エクスプレッション、デフォーマ。例については showConstraints を参照)を表示します。これを showConnectionFromSelected と組み合わせると、到着した接続と離れた接続の両方が表示されます。両方のフラグが false である場合、すべての接続が表示されます。
-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
アニメート トランジションのズーム係数を指定します。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

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`;