ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

polyListComponentConversion [-border] [-fromEdge] [-fromFace] [-fromUV] [-fromVertex] [-fromVertexFace] [-internal] [-toEdge] [-toFace] [-toUV] [-toVertex] [-toVertexFace] [-vertexFaceAllEdges] selectionItem[]

polyListComponentConversion は、取り消し可能、照会不可能、および 編集不可能 です。

1 つまたは複数のタイプのポリゴン コンポーネントを別の 1 つまたは複数のタイプに変換し、変換のリストを返します。現在のデータベースは変更されません。

戻り値

selectionItem[]ポリゴン コンポーネントのリスト

関連

polyInstallAction, polySelectConstraint, polySelectConstraintMonitor

フラグ

border, fromEdge, fromFace, fromUV, fromVertex, fromVertexFace, internal, toEdge, toFace, toUV, toVertex, toVertexFace, vertexFaceAllEdges
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-fromVertex(-fv) create
-fromEdge(-fe) create
-fromUV(-fuv) create
-fromFace(-ff) create
-fromVertexFace(-fvf) create
変換前のコンポーネント タイプを指定します。指定しないと、ポリゴン オブジェクトを含むすべてとみなされます。
-toVertex(-tv) create
-toEdge(-te) create
-toUV(-tuv) create
-toFace(-tf) create
-toVertexFace(-tvf) create
変換後のコンポーネント タイプを指定します。指定しないとオブジェクトが仮定されます。
-internal(-in) create
変換後のコンポーネントにすべてのソース コンポーネントを含める必要があることを指定しますたとえば、指定した周囲の頂点すべてを変換後のフェースに含めます。指定しないと、変換後のコンポーネントは関連したコンポーネントになります。
-border(-bo) create
変換後のコンポーネントが、選択範囲の境界上に存在する必要があることを指定します。指定しないと、変換後のコンポーネントは関連したコンポーネントになります。
-vertexFaceAllEdges(-vfa) create
フェースの頂点からエッジに変換した場合、フェースの頂点に端があるエッジがすべて含まれるように指定します。このフラグがない場合、既定の動作ではフェースの頂点ごとに 1 つのエッジのみが含まれます。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// Convert the vertices to envolved poly face(s) and list results.
//
polyListComponentConversion -fv -tf -in plg.vtx[5:6] plg.vtx[9:10];
// Result: plg.f[4] //
// Convert anything to related poly face(s) and list results.
//
polyListComponentConversion -tf plg.vtx[0] plg.vtx[3] plg.vtx[8];
// Result: plg.f[0] plg.f[2] plg.f[3] plg.f[6] //
// Convert an object to faces and list results.
//
polyListComponentConversion    -tf plg;
// Result: plg.f[*] //
// Convert vertices to faces on selectionList and list results.
//
select -r plg.vtx[0] plg.vtx[3] plg.vtx[8];
polyListComponentConversion -fv -tf;
// Result: plg.f[0] plg.f[2] plg.f[3] plg.f[6] //
// Use several calls of the command to list edges in the order
// in which they appear in a face.
//
polyPlane -w 1 -h 1 -sx 1 -sy 1 -ax 0 1 0 -cuv 2 -ch 1;
// Will return the edges in numeric order:
polyListComponentConversion -ff -te pPlane1.f[0];
// Result: pPlane1.e[0:3] //
// Now convert to vertexFace and then to edge to get the edges in the order they
// appear within the face:
string $vfList[] = `polyListComponentConversion -ff -tvf pPlane1.f[0]`;
$vfList = `ls -flatten $vfList`;
// Result: pPlane1.vtxFace[0][0] pPlane1.vtxFace[1][0] pPlane1.vtxFace[3][0] pPlane1.vtxFace[2][0] //
for ($vf in $vfList)
{
string $edge[] = `polyListComponentConversion -fvf -te $vf`;
print ($edge);
}
// Prints out the edges in the order they show up in the face.
pPlane1.e[0]
pPlane1.e[2]
pPlane1.e[3]
pPlane1.e[1]
// Illustrate the vertexFaceAllEdges flag
//
polyPlane -w 1 -h 1 -sx 1 -sy 1 -ax 0 1 0 -cuv 2 -ch 1;
select -r pPlane1.vtxFace[0][0] ;
// Get the edge that originates at the selected face vertex
polyListComponentConversion -fvf -te;
// Result: pPlane1.e[0] //
// Get both edges that adjoin the selected face vertex
polyListComponentConversion -fvf -te -vfa;
// Result: pPlane1.e[0:1] //