FaceSelection 値

値 > コレクション > コレクションのタイプ > FaceSelection 値

値とコレクション - クイックナビゲーション

FaceSelection は、シーンメッシュノードに対する面のセットを仮想配列で表します。

これにより、インデックスで面をアクセスしたり、面を反復したり、マップした関数を面に適用することができます。

「Editable_Mesh」も参照してください。

FaceSelection 配列はダイナミックであるため、その内容はメッシュノードの面あるいは選択された面が変更されると変化します。

FaceSelection 値はマップ可能です。

コンストラクタ:

<mesh>.selectedFaces

メッシュオブジェクトの現在選択されている面です。

<mesh>.Faces

メッシュオブジェクトのすべての面、読み込み専用です。

プロパティ

<faceselection>.count : Integer, read-only

FaceSelection 配列の面の数を返します。

<faceselection>.selSetNames : Array of names, read-only

FaceSelection が関連付けられているオブジェクトに対して、現在の面レベルの名前が付いた選択セットの名前の配列を返します。

次のプロパティは、単独の選択項目($foo.edges[n] の形式)で使われます。

<faceselection>.index : Integer, read-only

メッシュ内の選択された要素のインデックスを返します。

例

$foo.selectedFaces[2].index
-- returns the face index of the 2nd face in the current selection.

選択項目間を繰り返すと、ループ内で単一の項目を選択できます。

例

sf = for i in $foo.selectedFaces collect i.index
--sf contains selected faces as array

演算子

<mesh>.selectedFaces = (<array> | <bitarray>)

指定した面を選択します。

<faceselection>[<integer>]

インデックスで指定された面を単独の FaceSelection として検索します。インデックスは 1 から始まります。

<faceselection>[<integer>] = <point3>

インデックスで指定された面の頂点を point3 値で指定された頂点インデックスに設定します。

<faceselection>[(<integer_array> | <bitarray>)]

インデックスで指定された面を FaceSelection として検索します。インデックスは 1 から始まります。

<faceselection>[(<#name> | <string>)]

面レベルの名前が付いた選択セットを検索します。

<faceselection>[(<#name> | <string>)] = (<faceselection> | <integer_array> | <bitarray>)

選択セットの名前は、名前値または文字列値で指定できます。

面レベルの名前が付いた選択セットを指定された面に設定します。選択セットの名前は名前値または文字列値で指定でき、面は同じオブジェクトからの array、bitArray、または FaceSelection として指定できます。

メソッド

move <faceselection> <point3>

FaceSelection 内で面を移動します。

select <faceselection>

FaceSelection 内で面を選択します。

deselect <faceselection>

FaceSelection 内で面の選択を取り消します。

delete <faceselection>

FaceSelection 内で面を削除します。

append <faceselection> (<faceselection> | <integer>)

FaceSelection に面を追加します。

findItem <faceselection> (<faceselection[<integer>] | <integer>)

一致する項目がある場合は選択インデックス、ない場合は 0 (ゼロ)を返します。項目は、選択インデックスまたは単独の FaceSelection です。

例:

-- move faces in 'mouth' named selection set
move $foo.faces[#mouth] [0,0,10]
-- select faces in 'front faces' set
select $baz.faces["front faces"]
-- set 'baz' named selection set to given faces
$foo.faces[#baz] = #(1,3,4,5,10)
-- set 'cursel' set to current selection
$baz.faces[#cursel] = $baz.selectedFaces
-- all the names of the face-level named selection sets for object $foo
$foo.faces.selSetNames
-- print out all face-level named selection sets
for n in $.faces.selSetNames do print $.faces[n]