移動先: 概要 戻り値 関連項目. フラグ. Python 例.
select(
[objects...]
, [add=boolean], [addFirst=boolean], [all=boolean], [allDagObjects=boolean], [allDependencyNodes=boolean], [clear=boolean], [deselect=boolean], [hierarchy=boolean], [noExpand=boolean], [replace=boolean], [toggle=boolean], [visible=boolean])
注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
select は 「元に戻す」が可能、「照会」が不可能、「編集」が不可能 です。
このコマンドを使用して、オブジェクトをアクティブ リストに追加、またはリストからオブジェクトを削除します。
5 つのフラグ [-add, -af, -r, -d, -tgl] を指定していない場合、デフォルトではアクティブ リストのオブジェクトが指定したリストのオブジェクトに置き換えられます。
「select set1」と指定してセットを選択すると、セット自体ではなく、セットのすべてのメンバーが選択されます。
セットを選択するには、「-ne/noExpand」フラグを使用する必要があります。
ネームスペースを使用する場合、名前で選択を行うと混乱が生じることがあります。これを明確にするため、ネームスペースが修飾されていない場合は、ルート ネームスペース ":" のオブジェクトだけが検索されます。名前は実際には 2 つの部分からなっています。ネームスペースと、ネームスペース内で固有な名前そのものです。特定のネームスペースのオブジェクトを選択したい場合は、ネームスペースのセパレータ ":" を含める必要があります。
たとえば、'select -r "foo*"' と指定すると、
ルート ネームスペース内の "foo" プリフィックスを持つオブジェクトが検索されます。"foo" プリフィックスを持つネームスペース内のすべてのオブジェクトが検索されることはありません。ネームスペース(foo)内のすべてのオブジェクトを選択したい場合は、「select "foo:*"」を使用します。
注: アプリケーションの起動時に、存在している必要があるディペンデンシー ノードがシステムによっていくつか作成されます。これらのオブジェクトは削除できませんが、選択することはできます。引数なしで「ls」コマンドを使用すると、シーン内のすべてのオブジェクト(DAG ノードとディペンデンシー ノード)を取得できます。「-all」、「adn/allDependencyNodes」、または「-ado/allDagObjects」フラグを使用すると、削除可能なオブジェクトだけが選択されます。削除できないオブジェクトも、「select time1;」で名前を明示的に指定することによって選択できます。
なし
selectKey, selectMode, selectPref, selectPriority, selectType, selectedNodes
add, addFirst, all, allDagObjects, allDependencyNodes, clear, deselect, hierarchy, noExpand, replace, toggle, visible
ロング ネーム(ショート ネーム) |
引数型 |
プロパティ |
all(all)
|
boolean
|
|
|
ルート レベルの削除可能なすべての DAG オブジェクトと、DAG ノード以外の削除可能なすべてのディペンデンシー ノードを選択することを示します。
|
|
allDependencyNodes(adn)
|
boolean
|
|
|
削除可能なすべての DAG オブジェクトを含め、削除可能なすべてのディペンデンシー ノードを選択することを示します。
|
|
allDagObjects(ado)
|
boolean
|
|
|
ルート レベルの削除可能なすべての DAG オブジェクトを選択することを示します。
|
|
visible(vis)
|
boolean
|
|
|
指定した項目の内、可視の項目のみに影響することを示します。
|
|
hierarchy(hi)
|
boolean
|
|
|
指定した DAG オブジェクトのすべての子、孫、曾孫なども選択することを示します。
|
|
add(add)
|
boolean
|
|
|
アクティブ リストの既存の項目を削除することなく、指定した項目をアクティブ リストに追加することを示します。
|
|
addFirst(af)
|
boolean
|
|
|
アクティブ リストから既存の項目を削除することなく、指定した項目をアクティブ リストの先頭に追加することを示します。
|
|
replace(r)
|
boolean
|
|
|
アクティブ リストの既存の項目を指定した項目で置き換えることを示します。
|
|
deselect(d)
|
boolean
|
|
|
指定した項目がアクティブ リストにある場合、それらの項目をアクティブ リストから削除することを示します。
|
|
toggle(tgl)
|
boolean
|
|
|
与えられたリストの項目のうち、アクティブ リストにある項目をアクティブ リストから削除し、アクティブ リストにない項目をアクティブ リストに追加することを示します。
|
|
clear(cl)
|
boolean
|
|
|
アクティブ リストをクリアします。これは、「select -d;」を実行するより効果的です。また、「select -d;」では、「-ne」を一緒に指定しなければアクティブ リストからセットは削除されません。
|
|
noExpand(ne)
|
boolean
|
|
|
選択した項目の中にあるセットをメンバー リストに展開しないことを示します。
これによって、セットのメンバー(デフォルト動作)ではなくセットを選択できるようになります。
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
: コマンドの照会モードで使用可能なフラグ
|
: タプルまたはリストとして渡された複数の引数を持てるフラグ
|
import maya.cmds as cmds
# create some objects and add them to a set
cmds.sphere( n='sphere1' )
cmds.sphere( n='sphere2' )
cmds.sets( 'sphere1', 'sphere2', n='set1' )
# select all dag objects and all dependency nodes
cmds.select( all=True )
# clear the active list
cmds.select( clear=True )
# select sphere2 only if it is visible
cmds.select( 'sphere2', visible=True )
# select a couple of objects regardless of visibilty
cmds.select( 'sphere1', r=True )
cmds.select( 'sphere2', add=True )
# remove one of the spheres from the active list (using toggle)
cmds.select( 'sphere1', tgl=True )
# remove the other sphere from the active list
cmds.select( 'sphere2', d=True )
# the following selects all the members of set1
cmds.select( 'set1' )
# this selects set1 itself
cmds.select( 'set1', ne=True )
# Some examples selecting with namespaces:
# create a namespace and an object in the namespace
cmds.namespace( add='foo' )
cmds.namespace( set='foo' )
cmds.sphere( n='bar' )
# 'select bar' will not select "bar" unless bar is in the
# root namespace. You need to qualify the name with the
# namespace (shown below).
cmds.select( 'foo:bar' )
# select all the objects in a namespace
cmds.select( 'foo:*' )