sets

移動先: 概要 戻り値 関連項目 フラグ MEL の例

概要

sets [-addElement name] [-afterFilters boolean] [-clear name] [-color int] [-copy name] [-edges boolean] [-editPoints boolean] [-empty] [-facets boolean] [-flatten name] [-forceElement name] [-include name] [-intersection name] [-isIntersecting name] [-isMember name] [-layer boolean] [-name string] [-noSurfaceShader boolean] [-noWarnings] [-nodesOnly] [-remove name] [-renderable boolean] [-size] [-split name] [-subtract name] [-text string] [-union name] [-vertices boolean] selectionList

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

セットは、Maya 全体で多くの方法で使用されます。オブジェクトに対するマテリアル プロパティやライトの関連付けを定義したり、 オブジェクトのブックマークや 名前付きコレクション、キャラクタ、デフォメーション操作によって 変形されるコンポーネントを定義したりする際にセットを使用します。

セットは、任意の数のパーティションにコネクトできます。パーティションは、 パーティション内の各セットに相互排他性を持たせるためのノードです。つまり、パーティション内のいずれかのセットに含まれているオブジェクトが、 同じパーティション内の別のセットのメンバーになることはできません。

いずれかのフラグが無い場合は、sets コマンドは "set#"（# は整数）というデフォルト名でセットを作成します。コマンド ラインに項目が指定されていない場合は、 現在選択している項目がセットに追加されます。-em/empty フラグを使用すると、空のセットを作成し、 選択した項目をセットに追加しないようにすることができます。

メンバー関係について特定の制約を持つセットを作成できます。レンダリング可能なオブジェクト（NURBS ジオメトリや ポリゴンメッシュのフェースなど）だけを セットのメンバーにできる「renderable」セットや、 頂点（または制御点）、エディト ポイント、エッジ、または フェースといったタイプのコンポーネントだけを セットのメンバーにできるセットを作成できます。 このようなセットでは、有効なタイプのコンポーネントを持つオブジェクトを セットに追加する場合に、オブジェクトではなく オブジェクトのコンポーネントがセットに追加されるので注意してください。

セットには、頂点セットを作成するときのみに使用する 関連カラーを含めることができます。カラーは、カラー プリファレンスに定義されている 8 つのユーザ定義カラーの中から 1 つを指定できます。このカラーを使用すると、たとえば特定のデフォメーションによって どの頂点が変形されているかを識別できます。

次の 3 つのいずれかのフラグを使用すると、 オブジェクト、コンポーネント、またはアトリビュートを セットに追加できます。-add/addElement フラグは、相互排他性の制約に反しない限り、 セットにオブジェクトを追加します。追加できない項目がある場合、コマンドは失敗します。-in/include フラグは、追加できる項目だけを追加し、 追加できない項目については警告メッセージを表示します。-fe/forceElement フラグは、セットにすべての項目を追加しますが、 そのセットと同じパーテション内のその他のセットにある項目を削除します。

セットには複数の操作があり、sets コマンドと共に実行できます。メンバーシップを照会したり、項目がセット内にあるかどうかのテストや、 2 つのセットが同じ項目を共有しているかどうかのテストを実行できます。また、操作の結果としてセットのメンバー リストを返す、 セットの論理和（Union）、論理積（Intersection）、論理差（Difference）を 実行することもできます。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-name(-n)	string
新しいセットの名前として文字列を割り当てます。このフラグは、新しいセットを作成する操作のみに有効です。
-text(-t)	string
セットとともに格納する注釈文字列を定義します。
-empty(-em)
作成されるセットが空でなければならないことを示します。つまり、セットに追加するオブジェクトを識別する引数はいずれも無視されます。このフラグは、新しいセットを作成する操作のみに有効です。
-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)
size フラグはセットの長さを照会する場合に使用します。
-subtract(-sub)	name
2 つのセットを比較して、2 番目のセットにはない 1 番目のセットのメンバーを返します。
-union(-un)	name
リストされたセットすべてのリストを返します。
-intersection(-int)	name
リストのセットすべてのメンバーである項目のリストを返します。
-clear(-cl)	name
指定したセットからすべての項目を削除してセットを空にします。
-flatten(-fl)	name
指定したセットの構造を平らにします。つまり、指定したセットに含まれているすべてのセットをセットのメンバーで置き換えて、 セットにその他のセットではなくその他のセットのメンバーが含まれるようにします。
-nodesOnly(-no)
このフラグは、-q/query フラグと一緒に使用できますが、 照会可能な別のフラグと一緒に使用した場合は無視されます。このフラグは、セットのメンバー関係の照会結果を修正して、 ノードのアトリビュート（sphere1.tx など）またはコンポーネントがセットに含まれているときに ノードだけがリストされるようにします。 セットにノードのアトリビュートまたはコンポーネントが複数存在する場合、 各ノードは一度だけリストされます。
-isIntersecting(-ii)	name
リスト内の各セットが共通のメンバーを持っているかどうかをテストします。
-isMember(-im)	name
指定した項目すべてが指定したセットのメンバーであるかどうかをテストします。
-split(-sp)	name
項目リストを持つ新しいセットを作成し、 指定したセットから項目リスト内の各項目を削除します。
-noWarnings(-nw)
セットに無効な項目を追加しようとするときなどに、 警告メッセージを報告しないことを示します（UI で使用）。
-addElement(-add)	name
指定したセットに項目のリストを追加します。一部の項目が編集対象のセットと同じパーティション内の別のセットにあるために それらの項目をセットに追加できない場合、コマンドは失敗します。
-include(-in)	name
指定したセットに項目のリストを追加します。セットに追加できない項目がある場合は、警告が発せられます。 これは、-add/addElement 操作よりも厳密性に欠けます。
-remove(-rm)	name
指定したセットの項目リストを削除します。
-forceElement(-fe)	name
編集モードのみで使用してください。項目を強制的にセットに追加します。指定したセットと同じパーティション内の別のセットにその項目がある場合、 メンバー関係の観点からパーティション内の各セットの相互排他性を保つために、 その項目は別のセットから削除されます。
-afterFilters(-af)	boolean
デフォルト状態は false です。このフラグは編集モードのみに有効です。 このフラグは、スカルプト、ラティス、ブレンドシェイプなどのデフォーマが適用されるセットに対して使用します。デフォルトの編集モードでは、デフォーマが適用されるグループのメンバー関係が編集されます。 グループを編集するがデフォーマのメンバー関係を変更しない場合は、このフラグを true に設定します。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

MEL の例

// create some objects
sphere -n sphere1;
cone -n cone1;

// create a set with whatever is currently active
select sphere1;
string $newSet1 = `sets`;
select cone1;
string $newSet2 = `sets`;

// Query the members of a set
sets -q $newSet1;

// create a set which contains two sets
sets -n setOfSets $newSet1 $newSet2;

// To select a set, the -noExpand flag must be used. Otherwise
// the members of a set are selected instead.
select -noExpand $newSet1;
ls -selection;

// Select the members of a set
select $newSet1;
ls -selection;

// Create a vertex set named ballVertices. This will contain
// all the vertices of the sphere.
sets -n ballVertices -v 1 sphere1;
select ballVertices;

// Return the union of two sets
sets -un $newSet1 $newSet2;

// Test whether a list of sets have common members
sets -ii $newSet1 ball;

// Test whether the sphere is a member of the set
sets -im $newSet1 sphere1;

// Remove the sphere from a set
sets -rm $newSet1 sphere1;

// Test again whether the sphere is a member of the set
sets -im $newSet1 sphere1;