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

概要

defaultNavigation([connectToExisting=boolean], [createNew=boolean], [defaultAttribute=boolean], [defaultTraversal=boolean], [defaultWorkingNode=boolean], [delete=boolean], [destination=name], [force=boolean], [ignore=boolean], [navigatorDecisionString=string], [quiet=boolean], [relatedNodes=boolean], [source=name], [unignore=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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

defaultNavigation コマンドは、ノード間のコネクションを作成または操作するとき、あるいはこのコネクションを介してノード間を移動するときの、デフォルトの動作を定義します。このコマンドは、主にアトリビュート エディタ(Attribute Editor)で使用されます。

戻り値

string または、文字配列

フラグ

connectToExisting, createNew, defaultAttribute, defaultTraversal, defaultWorkingNode, delete, destination, force, ignore, navigatorDecisionString, quiet, relatedNodes, source, unignore
ロング ネーム(ショート ネーム) 引数型 プロパティ
quiet(qt) boolean create
true に設定されていれば、どんな場合でも詳細は表示されません。デフォルトは false です。
force(f) boolean create
true に設定されていれば、すでに接続元がある接続先アトリビュートに接続元アトリビュートをコネクトしようと試みられるため、既存の接続元のコネクションが解除され、新しい接続元がコネクトされます。デフォルトは true です。
destination(d) name create
createNew または connectToExisting の既存の対象アトリビュートを指定します。
source(s) name create
connectToExisting の既存のソース アトリビュートを指定します。
createNew(cn) boolean create
新しいノードを作成し、destination フラグを使用して指定した node.attribute にコネクトます。
connectToExisting(ce) boolean create
接続先のアトリビュート(node.attribute または単なるノード)を既存の接続元にコネクトします。接続元が指定されていれば(node.attribute またはノードとして)、このコマンドは即座に処理されます。接続元が指定されていない場合、指定するよう求められます。接続元が指定したら、コネクトしてユーザが何を行いたいかについて、接続元のタイプと接続先のタイプに基づいて、最適な推測が行われます。このコマンドは、ノードやアトリビュートを最適な推測に基づいてコネクトします。対象は destination フラグ、ソースは source フラグを使用して指定します。
ignore(i) boolean create
destination フラグで指定した node.attribute に流れ込むコネクションを無視します。
unignore(u) boolean create
destination フラグで指定した node.attribute に流れ込むコネクションを無視しないようにします。
delete(delete) boolean create
destination フラグで指定した node.attribute に流れ込むコネクションを持つノードを削除します。
relatedNodes(ren) boolean create
コンセプトにおいて接続先で指定した node.attribute に関連するノードをリストします。関連するノードに直接または間接的に送信先にコネクトされたノードが含まれる場合もあります。 対象は、destination フラグを使用して指定します。 文字配列を返します。
defaultWorkingNode(dwn) boolean create
接続先ノードのアトリビュートに関連があれば、ユーザが最も必要とするノード名を返します。 対象は、destination フラグを使用して指定します。 文字列を返します。
defaultTraversal(dtv) boolean create
指定した接続先の node.attribute からの移動に最も重要なノード名を返します。 対象は、destination フラグを使用して指定します。 文字列を返します。
defaultAttribute(da) boolean create
接続元(アトリビュート)と接続先(ノード)フラグを指定し、connectNodeToNode を接続するアトリビュート名を返します。文字列を返します。
navigatorDecisionString( nds) string create
ここで、実行する動作を決定するために役立つ文字列をナビゲータに渡します。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# Create a poly plane
cmds.polyPlane(w=10, h=10, sx=10, sy=10, n='pPlane1')

# This will open the Create Render Node window from which you can select a node that you want to connect to the existing lambert1.color attribute
cmds.defaultNavigation(createNew=True, destination='lambert1.color')

# Select the Checker Node, you will find "checker1.outColor" is connected to "lambert1.color"

# Break the connection between "checker1.outColor" and "lambert1.color" you have just established
cmds.disconnectAttr('checker1.outColor', 'lambert1.color')

# Connect "checker1" to "lambert1". Only node is specified here, but the command will make a best guess.
# So "checker1.outColor" and "lambert1.color" are connected
cmds.defaultNavigation(connectToExisting=True, source='checker1', destination='lambert1')