次のトピックでは Editable_Poly 基本オブジェクトに集約されるオブジェクトに適用される polyOp メソッドを一覧表示します。
すべての polyOp メソッドには、引数 <poly>
(操作するポリゴン)を指定します。基本オブジェクトが編集可能ポリゴンであるノードの値、または編集可能ポリゴンの基本オブジェクトを指定できます。
polyOp メソッドのサブオブジェクトの引数について:
ほとんどの polyOp メソッドには、引数として
これらの引数には、操作するサブ オブジェクトサブオブジェクト要素を指定します。
これらの引数には、次のパラメータを指定できます。
#all
- そのタイプのすべてのサブオブジェクト要素。
#selection
- そのタイプの現在選択されているサブオブジェクト。
#none
- そのタイプのサブオブジェクト要素を除外する。
サブオブジェクト要素のインデックスを表す整数の配列。
サブオブジェクト要素のインデックスを表す bitarray。
サブオブジェクト要素のインデックスを表す整数に変換できる値。
VertexSelection、EdgeSelection、または FaceSelection の値。値のタイプは、指定した サブオブジェクト タイプに一致していなければなりません。
編集可能ポリゴンには、「無効な」頂点、エッジ、および面が含まれることがあります。
無効なサブオブジェクト要素とは、ポリゴンからは削除されているが、対応するサブオブジェクト要素のリストから削除されていないもののことです。
これらのサブオブジェクト要素は、そのポリゴンに対して特定の操作を実行したときに無効とマークされます。ただし、サブオブジェクト要素のリストが集約される(無効なサブオブジェクト要素がすべて削除される)のは、通常はその操作が終了したときです。つまり、そのポリゴンには通常、無効なサブオブジェクト要素は存在しません。
サブオブジェクト要素を polyOp メソッドの 1 つを使用して無効としてマークした場合は、polyOp.collapseDeadStructs()
を呼び出してサブオブジェクト要素のリストを集約する必要があります。
サブオブジェクト要素のフラグを取得/設定するメソッド以外では通常、無効なサブオブジェクト要素は polyOp メソッドによって無視されます。メソッドが OK 以外の値を返し、指定されている引数が 1 つの サブオブジェクト要素インデックスだけで、かつその SO 要素が無効な場合は、通常、undefined
の値が返されます。