ジャンプ先: 概要. 戻り値.
関連項目. フラグ. Python 例.
sets( selectionList , [addElement=name], [afterFilters=boolean], [clear=name], [color=int], [copy=name], [edges=boolean], [editPoints=boolean], [empty=boolean], [facets=boolean], [flatten=name], [forceElement=name], [include=name], [intersection=name], [isIntersecting=name], [isMember=name], [layer=boolean], [name=string], [noSurfaceShader=boolean],
[noWarnings=boolean],
[nodesOnly=boolean], [remove=name], [renderable=boolean], [size=boolean], [split=name], [subtract=name], [text=string], [union=name], [vertices=boolean])
注意:
オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
sets は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。
このコマンドは、セットを作成したり、セットの状態を照会したり、あるいは
操作を実行してセットのメンバー関係を更新したりするために使用します。 セットは、オブジェクト、アトリビュート、またはオブジェクトの
コンポーネントの任意の集まりを論理的にグループ化したものです。セットは、ディペンデンシー ノードです。
セットのメンバー関係は、オブジェクトからセットへの コネクションによって定義されます。 セットは、Maya
全体で多くの方法で使用されます。オブジェクトに対するマテリアル プロパティやライトの関連付けを定義したり、
オブジェクトのブックマークや 名前付きコレクション、キャラクタ、デフォメーション操作によって
変形されるコンポーネントを定義したりする際にセットを使用します。
セットは、任意の数のパーティションにコネクトできます。パーティションは、
パーティション内の各セットに相互排他性を持たせるためのノードです。つまり、パーティション内のいずれかのセットに含まれているオブジェクトが、
同じパーティション内の別のセットのメンバーになることはできません。 いずれかのフラグが無い場合は、sets コマンドは
「set#"（# は整数）というデフォルト名でセットを作成します。コマンド ラインに項目が指定されていない場合は、
現在選択している項目がセットに追加されます。-em/empty フラグを使用すると、空のセットを作成し、
選択した項目をセットに追加しないようにすることができます。
メンバー関係について特定の制約を持つセットを作成できます。レンダリング可能なオブジェクト（NURBS ジオメトリや
ポリゴンメッシュのフェースなど）だけを セットのメンバーにできる「renderable」セットや、 頂点（または制御点）、エディト
ポイント、エッジ、または フェースといったタイプのコンポーネントだけを セットのメンバーにできるセットを作成できます。
このようなセットでは、有効なタイプのコンポーネントを持つオブジェクトを セットに追加する場合に、オブジェクトではなく
オブジェクトのコンポーネントがセットに追加されるので注意してください。 セットには、頂点セットを作成するときのみに使用する
関連カラーを含めることができます。カラーは、カラー プリファレンスに定義されている 8 つのユーザ定義カラーの中から 1
つを指定できます。このカラーを使用すると、たとえば特定のデフォメーションによって どの頂点が変形されているかを識別できます。 次の 3
つのいずれかのフラグを使用すると、 オブジェクト、コンポーネント、またはアトリビュートを
セットに追加できます。-add/addElement フラグは、相互排他性の制約に反しない限り、
セットにオブジェクトを追加します。追加できない項目がある場合、コマンドは失敗します。-in/include
フラグは、追加できる項目だけを追加し、 追加できない項目については警告メッセージを表示します。-fe/forceElement
フラグは、セットにすべての項目を追加しますが、 そのセットと同じパーテション内のその他のセットにある項目を削除します。
セットには複数の操作があり、sets
コマンドと共に実行できます。メンバーシップを照会したり、項目がセット内にあるかどうかのテストや、 2
つのセットが同じ項目を共有しているかどうかのテストを実行できます。また、操作の結果としてセットのメンバー リストを返す、
セットの論理和（Union）、論理積（Intersection）、論理差（Difference）を 実行することもできます。
| string |
作成操作（作成または編集されたセットの名前） |
| string[] |
照会操作（セット内の項目名） |
| boolean |
isIntersecting および isMember 操作 |
戻り値の型は照会モードでは照会フラグが基になります。
character, listSets, partition
addElement, afterFilters, clear, color, copy, edges, editPoints, empty,
facets, flatten, forceElement, include, intersection, isIntersecting, isMember, layer,
name, noSurfaceShader, noWarnings, nodesOnly, remove,
renderable, size, split, subtract, text,
union, vertices
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
name(n) |
string |
 |
|
新しいセットの名前として文字列を割り当てます。このフラグは、新しいセットを作成する操作のみに有効です。 |
|
text(t) |
string |
  |
|
|
empty(em) |
boolean |
|
|
作成されるセットが空でなければならないことを示します。つまり、セットに追加するオブジェクトを識別する引数はいずれも無視されます。このフラグは、新しいセットを作成する操作のみに有効です。 |
|
color(co) |
int |
|
|
セットのハイライト カラーを定義します。値は [-1, 7] の範囲の値
（いずれかのユーザ定義カラー）である必要があります。-1 は、カラーが未定義で、影響がないことを示します。
頂点セットの頂点だけがこのカラーで表示されます。 |
|
layer(l) |
boolean |
|
|
|
vertices(v) |
boolean |
|
|
新しいセットに頂点だけを含めることができることを示します。 このフラグは、作成モードまたは照会モードのみに使用します。
デフォルト値は false です。 |
|
edges(eg) |
boolean |
|
|
新しいセットにエッジだけを含めることができることを示します。 このフラグは、作成モードまたは照会モードのみに使用します。
デフォルト値は false です。 |
|
facets(fc) |
boolean |
|
|
新しいセットにファセットだけを含めることができることを示します。 このフラグは、作成モードまたは照会モードのみに使用します。
デフォルト値は false です。 |
|
editPoints(ep) |
boolean |
|
|
新しいセットにエディットポイントだけを含めることができることを示します。
このフラグは、作成モードまたは照会モードのみに使用します。 デフォルト値は false です。 |
|
renderable(r) |
boolean |
|
|
このフラグは、特殊なタイプのセットを作成することを示します。このタイプのセット（objectSet とはまったく異なる
shadingEngine）には、 ライトやジオメトリなどのレンダリング可能なエレメントだけを含めることができるという、
メンバー関係に関する特定の制約があります。作成時に、これらのセットはシェーディング グループとして参照され、
「renderPartition」ノードに自動的にコネクトされます （セットのメンバーとパーティションのその他のセットとの
相互排他性を確保するため）。 このフラグは、作成モードまたは照会モードのみに使用します。 デフォルト値は false
で、通常のセットを作成することを意味します。 |
|
noSurfaceShader(nss) |
boolean |
|
|
セットがレンダリング可能な場合、 セットをデフォルトのサーフェス シェーダ
マテリアルにコネクトしません。レンダリング不可能なセットの場合は、フラグに意味または効果はありません。
このフラグは作成モードのみに使用します。 デフォルト値は false です。 |
|
copy(cp) |
name |
|
|
指定したセットのメンバーを新しいセットにコピーします。 このフラグは作成モードのみに使用します。 |
|
size(s) |
boolean |
|
|
size フラグはセットの長さを照会する場合に使用します。 |
|
subtract(sub) |
name |
|
|
2 つのセットを比較して、2 番目のセットにはない 1 番目のセットのメンバーを返します。 |
|
union(un) |
name |
|
|
|
intersection(int) |
name |
|
|
リストのセットすべてのメンバーである項目のリストを返します。 |
|
clear(cl) |
name |
|
|
指定したセットからすべての項目を削除してセットを空にします。 |
|
flatten(fl) |
name |
|
|
指定したセットの構造を平らにします。つまり、指定したセットに含まれているすべてのセットをセットのメンバーで置き換えて、
セットにその他のセットではなくその他のセットのメンバーが含まれるようにします。 |
|
nodesOnly(no) |
boolean |
|
|
このフラグは、-q/query フラグと一緒に使用できますが、
照会可能な別のフラグと一緒に使用した場合は無視されます。このフラグは、セットのメンバー関係の照会結果を修正して、
ノードのアトリビュート（sphere1.tx など）またはコンポーネントがセットに含まれているときに
ノードだけがリストされるようにします。 セットにノードのアトリビュートまたはコンポーネントが複数存在する場合、
各ノードは一度だけリストされます。 |
|
isIntersecting(ii) |
name |
|
|
リスト内の各セットが共通のメンバーを持っているかどうかをテストします。 |
|
isMember(im) |
name |
|
|
指定した項目すべてが指定したセットのメンバーであるかどうかをテストします。 |
|
split(sp) |
name |
|
|
項目リストを持つ新しいセットを作成し、 指定したセットから項目リスト内の各項目を削除します。 |
|
noWarnings(nw) |
boolean |
|
|
セットに無効な項目を追加しようとするときなどに、 警告メッセージを報告しないことを示します（UI で使用）。 |
|
addElement(add) |
name |
|
|
指定したセットに項目のリストを追加します。一部の項目が編集対象のセットと同じパーティション内の別のセットにあるために
それらの項目をセットに追加できない場合、コマンドは失敗します。 |
|
include(include) |
name |
|
|
指定したセットに項目のリストを追加します。セットに追加できない項目がある場合は、警告が発せられます。
これは、-add/addElement 操作よりも厳密性に欠けます。 |
|
remove(rm) |
name |
|
|
|
forceElement(fe) |
name |
|
|
編集モードのみで使用してください。項目を強制的にセットに追加します。指定したセットと同じパーティション内の別のセットにその項目がある場合、
メンバー関係の観点からパーティション内の各セットの相互排他性を保つために、 その項目は別のセットから削除されます。 |
|
afterFilters(af) |
boolean |
|
|
デフォルト状態は false です。このフラグは編集モードのみに有効です。
このフラグは、スカルプト、ラティス、ブレンドシェイプなどのデフォーマが適用されるセットに対して使用します。デフォルトの編集モードでは、デフォーマが適用されるグループのメンバー関係が編集されます。
グループを編集するがデフォーマのメンバー関係を変更しない場合は、このフラグを true に設定します。 |
|
| : コマンドの作成モードで使用可能なフラグ |
: コマンドの編集モードで使用可能なフラグ |
| : コマンドの照会モードで使用可能なフラグ |
 : タプルまたはリストとして渡された複数の引数を持てるフラグ |
import maya.cmds as cmds
# create some objects
cmds.sphere( n="sphere1" )
cmds.cone( n="cone1" )
# create a set with whatever is currently active
cmds.select( 'sphere1' )
newSet1 = cmds.sets()
cmds.select( 'cone1' )
newSet2 = cmds.sets()
# Query the members of a set
cmds.sets( newSet1, q=True )
# create a set which contains two sets
cmds.sets( newSet1, newSet2, n="setOfSets" )
# To select a set, the -noExpand flag must be used. Otherwise
# the members of a set are selected instead.
cmds.select( newSet1, noExpand=True )
cmds.ls( selection=True )
# Select the members of a set
cmds.select( newSet1 )
cmds.ls( selection=True )
# Create a vertex set named ballVertices. This will contain
# all the vertices of the sphere.
cmds.sets( 'sphere1', n="ballVertices", v=1 )
cmds.select( 'ballVertices' )
# Return the union of two sets
cmds.sets( newSet2, un=newSet1 )
# Test whether a list of sets have common members
cmds.sets( 'ballVertices',ii=newSet1)
# Test whether the sphere is a member of the set
cmds.sets('sphere1',im=newSet1)
# Remove the sphere from a set
cmds.sets( 'sphere1', rm=newSet1 )
# Test again whether the sphere is a member of the set
cmds.sets( 'sphere1', im=newSet1 )