ジャンプ先: 概要. 戻り値. フラグ. Python 例.

概要

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

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

hyperGraph は、取り消し可能、照会可能、および編集可能です。

ハイパーグラフ(Hypergraph)の基本機能の概要を以下に示します。詳細は、ユーザ マニュアルを参照してください。

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

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

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

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

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

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

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

戻り値

stringパネルの名前

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

addBookmark, addDependGraph, addDependNode, animateTransition, attributeEditor, bookmarkName, clear, collapseContainer, connectionDrawStyle, control, defineTemplate, deleteBookmark, dependGraph, dependNode, docTag, down, downstream, dragAndDropBehaviorCommand, dropNode, dropTargetNode, edgeDblClickCommand, edgeDimmedDblClickCommand, enableAutomaticLayout, exists, expandContainer, feedbackGadget, feedbackNode, filter, filterDetail, fitImageToHeight, fitImageToWidth, focusCommand, fold, forceMainConnection, forceRefresh, frame, frameBranch, frameGraph, frameHierarchy, freeform, fromAttr, getNodeList, getNodePosition, graphLayoutStyle, graphType, highlightConnection, iconSize, image, imageEnabled, imageForContainer, imagePosition, imageScale, isHotkeyTarget, layout, layoutSelected, lockMainConnection, look, mainListConnection, mergeConnections, navigateHome, nextView, nodeDropCommand, nodePressCommand, nodeReleaseCommand, opaqueContainers, orientation, panel, parent, popupMenuScript, previousView, range, rebuild, removeNode, rename, resetFreeform, restoreBookmark, scrollUpDownNoZoom, selectionConnection, setNodePosition, showConnectionFromSelected, showConnectionToSelected, showConstraints, showDeformers, showExpressions, showInvisible, showRelationships, showShapes, showUnderworld, stateString, transitionFrames, unParent, unfold, unfoldAll, unlockMainConnection, updateMainConnection, updateNodeAdded, updateSelection, upstream, useFeedbackList, useTemplate, viewOption, visibility, zoom
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
exists(ex) boolean create
指定したオブジェクトが存在するかどうかによって、true または false を返します。他のフラグは無視されます。
defineTemplate(dt) string create
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
useTemplate(ut) string create
コマンドに、現在以外のコマンド テンプレートの使用を強制します。
panel(pnl) string createquery
エディタが属しているパネルを指定します。既定では、エディタがスクリプト パネルの作成コールバックで作成された場合、エディタはそのパネルに属します。エディタがパネルに属していない場合、エディタのあるウィンドウを削除するとエディタも削除されます。
parent(p) string createqueryedit
このエディタの親のレイアウトを指定します。このフラグは、エディタが現在ペアレント化されていない場合のみに効果があります。
unParent(up) boolean createedit
エディタをそのレイアウトから除去するように指定します。照会には使用できません。
control(ctl) boolean query
照会モード専用です。このエディタの最上位のコントロールを返します。通常は、親を取得してポップアップ メニューをアタッチするために使用します。注意: コントロールのないエディタが存在する場合があります。コントロールがない場合は、このフラグは NONE を返します。
mainListConnection(mlc) string createqueryedit
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。
forceMainConnection(fmc) string createqueryedit
エディタがコンテンツのソースとして使用する selectionConnection オブジェクトの名前を指定します。エディタは selectionConnection オブジェクトに含まれている項目のみを表示します。これは -mainListConnection フラグの変形で、接続がロックされている場合でも強制的に変更します。このフラグを使用して、-unlockMainConnection、-mainListConnection、-lockMainConnection フラグを直後に連続して使用する場合に、オーバーヘッドを減します。
selectionConnection(slc) string createqueryedit
その独自のセレクション リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。このエディタから選択する場合、selectionConnection オブジェクトの中から選択します。オブジェクトが変更されると、エディタが更新されて変更が反映されます。
highlightConnection(hlc) string createqueryedit
そのハイライト リストをエディタと同期化させる selectionConnection オブジェクトの名前を指定します。すべてのエディタにハイライト リストがあるわけではありません。ハイライト リストがあるエディタの場合、これは第二の選択項目を表示したリストになります。
filter(f) string createqueryedit
このエディタに配置する項目フィルタ オブジェクトの名前を指定します。エディタの主要リストに表示される情報をフィルタします。
lockMainConnection(lck) boolean createedit
mainConnection 内のオブジェクトの現在リストをロックして、そのオブジェクトだけがエディタ内に表示されるようにします。これ以降、元の mainConnection に変更を加えても無視されます。
stateString(sts) boolean query
照会モード専用のフラグです。エディタを編集して現在のエディタの状態と一致させる MEL コマンドを返します。返されたコマンド文字列は、指定した名前の代わりに文字列変数 $editorName を使用します。
unlockMainConnection(ulk) boolean createedit
mainConnection をロック解除して、オリジナルの mainConnection (まだ使用可能な場合)を効率的に復元し、ダイナミックな更新を行います。
updateMainConnection(upd) boolean createedit
ロックされた mainConnection をオリジナルの mainConnection から更新させますが、ロック状態は保持されます。
docTag(dtg) string createqueryedit
Maya エディタにタグをアタッチします。
addBookmark(abk) boolean createedit
現在のハイパーグラフ ビューのブックマークを作成します。
addDependNode(adn) name createedit
ディペンデンシー ノードをディペンデンシー グラフビューに追加します。
addDependGraph(adg) name createedit
指定したノードで始まるディペンデンシー グラフをビューに追加します。
animateTransition(atr) boolean createqueryedit
アニメート トランジションをオフまたはオンにします。
attributeEditor(ae) string createedit
選択したノードでアトリビュート エディタ(Attribute Editor)を起動します。
bookmarkName(bn) boolean query
最も新しく作成されたブックマークの名前を返します。
connectionDrawStyle(cds) string createedit
ノード間の接続の描画方法を指定します。有効な値は「center」(ノードの中心から別のノードの中心へ接続 ラインを引く)および「side」(ソース ノードの右側から、接続先ノードの左側へ接続 ラインを引く)です。既定は「center」です。このフラグはハイパーシェード(Hypershade)グラフには適用されません。これには、常に「side」の接続描画スタイルが適用されます。
clear(clr) boolean createedit
現在のハイパーグラフ ビューをクリアしてグラフ UI を削除します(-rebuild フラグも参照してください)。
collapseContainer(cc) boolean createedit
DG グラフで選択したコンテナを折り畳みます。
deleteBookmark(dbk) string createedit
対応するノード名のブックマークを削除します。
dependGraph(dg) boolean createedit
指定したノードから繰り返されるディペンデンシー グラフを表示します。
dependNode(dn) string createedit
ビューにディペンデンシー ノードを表示します。
dropNode(dr) string query
ドロップの処理時にコールすると、ドラッグ&ドロップ 接続のソース ノードの名前を返します。
dropTargetNode(drt) string query
ドロップの処理時にコールすると、ドラッグ&ドロップ 接続の接続先ノードの名前を返します。
dragAndDropBehaviorCommand(ddc) string createedit
ハイパーグラフ ノードにドラッグ&ドロップした場合にコールされる Mel プロシージャです。Proc シグネチャは procName (string $editor、string $sourceNode、string $destinationNode)です。
edgeDblClickCommand(edc) string createedit
エッジをダブル クリックするとコールされる MEL プロシージャです。Proc シグネチャは procName (string $editor、string $edge)です。
edgeDimmedDblClickCommand(edd) string createedit
薄く表示されたエッジをダブル クリックするとコールされる MEL プロシージャです。Proc シグネチャは procName (string $editor、string $edge)です。
enableAutomaticLayout(eal) boolean createedit
ドラッグ&ドロップまたは dg メッセージでグラフにノードが追加または除去された場合に、グラフを再構築します。既定は true です。
expandContainer(ec) boolean createedit
DG グラフで選択したコンテナを展開します。
fromAttr(fat) string query
ドロップの処理時にコールすると、ドラッグ&ドロップ 接続のソース アトリビュートの名前を返します。
feedbackGadget(fbg) string query
現在のガジェットの名前を返します。
fitImageToWidth(fiw) boolean create
バックグラウンド イメージの位置とスケールを変更し、幅を現在のエディタ ビュー に合わせます。
fitImageToHeight(fih) boolean create
バックグラウンド イメージの位置とスケールを変更し、高さを現在のエディタ ビュー に合わせます。
feedbackNode(fbn) string query
現在のフィードバックまたはハイライト ノードの名前を返します。
focusCommand(fc) string createedit
ハイパーグラフでマウスをクリックすると実行される MEL プロシージャです。主にウィンドウのフォーカスを設定するときに使用します。
filterDetail(fd) [string, boolean] createedit
このフラグは現在サポートしていません。この代わりに、showConstraints、showExpressions、showDeformer、showInvisible、showShapes、および showUnderworld フラグを使用します。
fold(fo) boolean createedit
選択したオブジェクトを折り畳みます。
forceRefresh(frf) boolean createedit
ハイパーグラフで強制的にコンテンツをリフレッシュ(再描画)します。
frame(fr) boolean createedit
選択したオブジェクトをフレーム構成します。
frameBranch(frb) boolean createedit
選択したノードの下位にある大枝をフレーム構成します。
frameGraph(fg) boolean createedit
グラフ全体をフレーム構成します。
frameHierarchy(frh) boolean createedit
選択したノードを含む階層をフレーム構成します。
graphLayoutStyle(gls) string createqueryedit
グラフ レイアウト スタイルを次の中から選択します。"circularLayout"|"hierarchicalLayout"|"orthogonalLayout"|"symmetricLayout"|"treeLayout"
getNodeList(gnl) boolean query
グラフのすべてのノード リストを示す文字配列を返します。
getNodePosition(gnp) string query
指定したノードの位置を(x,y)グラフで返します。このフラグと引数は、-q フラグより前にコマンドに渡されなければなりません(例を参照)。

照会モードでは、このフラグは値を受け入れることができます。

graphType(gt) string query
ビュー内にある現在のグラフのタイプ名を返します(DAG または DG のいずれか)。
iconSize(ics) string createqueryedit
このハイパーグラフ エディタ用のアイコン サイズを設定または照会します。現時点で許容されているアイコン サイズは、「small」、「medium」および「large」です。
viewOption(vo) string createqueryedit
このハイパーグラフ エディタ用のビューのオプションを設定または照会します。現在のところ使用できるビューは、「asIcons」および「asList」です。
isHotkeyTarget(iht) boolean query
内部使用のためのフラグです。
image(img) string createqueryedit
プロジェクト イメージ ディレクトリからロードされるバックグラウンド イメージを指定します。
imageEnabled(ime) boolean createqueryedit
ロードしたバックグラウンド イメージの表示を有効にします(フリーフォーム DAG ビューまたは DG ビュー)。
imagePosition(imp) [float, float] createqueryedit
バックグラウンド イメージの位置です。
imageScale(ims) float createqueryedit
バックグラウンド イメージの均一なスケールです。
imageForContainer(ifc) boolean createqueryedit
次のフラグがイメージ全体ではなく選択したコンテナで動作するように指定します。-imageScale、-imagePosition、fitImageToWidth、-fitImageToHeight、-image
layout(lay) boolean createedit
グラフで自動レイアウトを実行します。
layoutSelected(lsl) string createedit
選択したオブジェクトで自動レイアウトを実行します。"circularLayout"|"hierarchicalLayout"|"orthogonalLayout"|"symmetricLayout"|"treeLayout"
look(loo) [float, float] createedit
グラフ ビューの座標を調べます。
down(do) boolean createedit
現在の選択を含むディペンデンシー グラフを下方に移動します。上流接続と下流接続を示します。
mergeConnections(mc) boolean createqueryedit
接続のグループを「太い」接続にマージします。
navigateHome(hom) boolean createedit
ホーム(DAG ノード)ビューに移動します。
nodeDropCommand(ndr) string createedit
ノードがハイパーグラフ ウィンドウでドロップされるときにコールされるコマンドを設定します。
nodePressCommand(np) string createedit
カーソルがハイパーグラフ ウィンドウのノード上にある場合に、マウス ボタンを押したときにコールされるコマンドを設定します。
nodeReleaseCommand(nr) string createedit
カーソルがハイパーグラフ ウィンドウのノード上にある場合に、マウス ボタンを離したときにコールされるコマンドを設定します。
nextView(nvw) boolean createedit
ビューが次の DAG ノード ビューに変わります。
opaqueContainers(opc) boolean queryedit
展開したコンテナのバックグラウンドの不透明度を設定します。
orientation(orientation) string createqueryedit
次のいずれかのグラフの方向スタイルを選択します。「horiz」または「vert」です。
previousView(pvw) boolean createedit
ビューが前の DAG ノード ビューに変わります。
popupMenuScript(pms) string createedit
このハイパーグラフのコントロールがあるポップアップ メニューを登録するためにコールするスクリプトを設定します。このスクリプトは、ポップアップ メニューの親になるコントロールを持つ、ハイパーグラフの名前を指定する文字列引数と一緒にコールされます。
range(rg) [float, float] createqueryedit
ノードの表示を範囲内のノードのみに限定します。2 つの float 値が予想されます。1 つ目は範囲の下限しきい値、2 つ目は上限しきい値です。値は、パーセンテージではなく、絶対時間値です。
rebuild(rb) boolean createedit
グラフを再構築します。
rename(rn) boolean createedit
選択したオブジェクトの上にテキスト フィールドをポップ アップし、名前を変更します。
resetFreeform(rf) boolean createedit
すべてのノードの自由形式の位置をリセットします。
freeform(fre) boolean createqueryedit
フリーフォーム レイアウト モードを有効にします。
restoreBookmark(rbk) string createedit
ブックマークに対応するビューを復元します。
removeNode(rmn) string createedit
文字列で識別されたノードをグラフから除去します。
scrollUpDownNoZoom(snz) boolean createedit
フリー ズーム モードでないとき、Y のみに沿ったスクロールをする場合に指定します。既定では、ハイパーグラフ エディタを使用して左右にパンできます。
showConstraints(shc) boolean createqueryedit
コンストレイントのリレーションを DAG ノードで表示します。
showExpressions(shx) boolean createqueryedit
エクスプレッションのリレーションを DAG ノードで表示します。
showDeformers(shd) boolean createqueryedit
デフォーマまたはジオメトリ フィルタのリレーションを DAG ノードで表示します。
showInvisible(shi) boolean createqueryedit
非表示のノードを DAG ノードで表示します。
showConnectionFromSelected(scf) boolean createqueryedit
選択したノードから離れた接続(コンストレイント、エクスプレッション、デフォーマ。例については showConstraints を参照)を表示します。これを showConnectionToSelected と組み合わせると、到着した接続と離れた接続の両方が表示されます。両方のフラグが false である場合、すべての接続が表示されます。
showConnectionToSelected(sct) boolean createqueryedit
選択したノードに到着した接続(コンストレイント、エクスプレッション、デフォーマ。例については showConstraints を参照)を表示します。これを showConnectionFromSelected と組み合わせると、到着した接続と離れた接続の両方が表示されます。両方のフラグが false である場合、すべての接続が表示されます。
showRelationships(shr) boolean createqueryedit
リレーションシップ(メッセージ)接続を表示します。
showShapes(shs) boolean createqueryedit
シェイプ ノードを DAG ノードで表示します。
showUnderworld(shu) boolean createqueryedit
下層グラフを DAG ノードで表示します。
setNodePosition(snp) [string, float, float] createedit
文字列で識別されたノードを、2 つの float で指定したウインドウの(x,y)位置に設定します。そのノードがグラフ内にない場合は、グラフに追加されてから新しい位置に移動されます。
transitionFrames(tfr) int createqueryedit
アニメート トランジション用のトランジション フレームの数を指定します。
unfold(uf) boolean createedit
選択したオブジェクトを展開します。
unfoldAll(ua) boolean createedit
選択したオブジェクトの下位にあるすべてを展開します。
updateNodeAdded(una) boolean createqueryedit
新しいノードがデータベースに追加された場合にグラフを更新します。
updateSelection(us) boolean createqueryedit
データベースの選択状態が変わった場合にグラフの選択状態を更新します。
upstream(ups) boolean createedit
選択したノードの上流のディペンデンシー グラフを表示します。
downstream(ds) boolean createedit
選択したノードの下流のディペンデンシー グラフを表示します。
useFeedbackList(ufl) boolean createqueryedit
他のハイパーグラフ コマンドライン オプションを処理しているときに、フィードバックまたはハイライト リストをターゲット選択として使用します。
visibility(vis) boolean createedit
選択したノードの可視の状態を設定します。
zoom(zm) float createedit
アニメート トランジションのズーム係数を指定します。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# The hyperGraph command is not one which would commonly be used
# by the user.
cmds.polySphere( r=1, sx=20, sy=20, ax=(0, 1, 0), tx=2, ch=1 )

# Gets the position of the node in the graph.
maya.mel.eval( "HypergraphHierarchyWindow" )
position = cmds.hyperGraph( 'hyperGraphPanel1HyperGraphEd', query=True, getNodePosition='pSphere1' )
print position