ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
select(
[objects...]
, [add=boolean], [addFirst=boolean], [all=boolean], [allDagObjects=boolean], [allDependencyNodes=boolean], [clear=boolean], [containerCentric=boolean], [deselect=boolean], [hierarchy=boolean], [noExpand=boolean], [replace=boolean], [symmetry=boolean], [symmetrySide=int], [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, containerCentric, deselect, hierarchy, noExpand, replace, symmetry, symmetrySide, toggle, visible
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
add(add)
|
boolean
|
|
|
アクティブ リストの既存の項目を除去することなく、指定した項目をアクティブ リストに追加することを示します。
|
|
addFirst(af)
|
boolean
|
|
|
アクティブ リストから既存の項目を除去することなく、指定した項目をアクティブ リストの先頭に追加することを示します。
|
|
all(all)
|
boolean
|
|
|
ルート レベルの削除可能なすべての DAG オブジェクトと、DAG ノード以外の削除可能なすべてのディペンデンシー ノードを選択することを示します。
|
|
allDagObjects(ado)
|
boolean
|
|
|
ルート レベルの削除可能なすべての DAG オブジェクトを選択することを示します。
|
|
allDependencyNodes(adn)
|
boolean
|
|
|
削除可能なすべての DAG オブジェクトを含め、削除可能なすべてのディペンデンシー ノードを選択することを示します。
|
|
clear(cl)
|
boolean
|
|
|
アクティブ リストをクリアします。これは、「select -d;」を実行するより効果的です。また、「select -d;」では、「-ne」を一緒に指定しなければアクティブ リストからセットは除去されません。
|
|
containerCentric(cc)
|
boolean
|
|
|
メイン ビューポート内の選択項目に適用するルールと同じ選択ルールが選択コマンドに適用されるように指定します。特に、指定したオブジェクトがブラックボックス コンテナのメンバーであり、ノードとしてパブリッシュされない場合、Maya ではこのようなオブジェクトは選択されません。代わりに、選択項目に対して有効な一番上にある親が選択されます。
|
|
deselect(d)
|
boolean
|
|
|
指定した項目がアクティブ リストにある場合、それらの項目をアクティブ リストから除去することを示します。
|
|
hierarchy(hi)
|
boolean
|
|
|
指定した DAG オブジェクトのすべての子、孫、曾孫なども選択することを示します。
|
|
noExpand(ne)
|
boolean
|
|
|
選択した項目の中にあるセットをメンバー リストに展開しないことを示します。これによって、セットのメンバー(既定動作)ではなくセットを選択できるようになります。
|
|
replace(r)
|
boolean
|
|
|
アクティブ リストの既存の項目を指定した項目で置き換えることを示します。
|
|
symmetry(sym)
|
boolean
|
|
|
現在の symmetricModelling コマンド設定を使用してコンポーネントを対称的に選択するように指定します。対称モデリングが有効になっていない場合、このフラグは影響しません。
|
|
symmetrySide(sys)
|
int
|
|
|
指定されたパラメータに従って、現在のシンメトリ オブジェクトに含まれるコンポーネントを選択するように指定します。パラメータの有効値は次のとおりです。
-1: 非対称領域でコンポーネントを選択します。
0: シンメトリの継ぎ目でコンポーネントを選択します。
1: サイド 1 でコンポーネントを選択します。
2: サイド 2 でコンポーネントを選択します。対称モデリングが有効になっていない場合、このフラグは影響しません。注: 現在はトポロジ シンメトリでのみ機能します。
|
|
toggle(tgl)
|
boolean
|
|
|
与えられたリストの項目のうち、アクティブ リストにある項目をアクティブ リストから除去し、アクティブ リストにない項目をアクティブ リストに追加することを示します。
|
|
visible(vis)
|
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:*' )