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

概要

polyAppendVertex [-append [ float float float ]] [-constructionHistory boolean] [-hole] [-name string] [-point float float float] [-texture int] [-vertex int]

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

選択したポリゴン オブジェクトに新しいフェースをアペンドします。法線の方向は、頂点の順序で決まります。頂点が反時計回りに回転する場合、フェース法線はユーザを向きます。穴は反対方向に記述する必要があります。
単一のオブジェクトを選択した場合のみに動作します。

戻り値

stringノード名

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

polyAppend, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplit, polySplitVertex, polySubdivideEdge, polySubdivideFacet, polyTriangulate

フラグ

append, constructionHistory, hole, name, point, texture, vertex
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-append(-a) [ float float float ] createmultiuse
選択したオブジェクトに頂点またはポイントをアペンドするか、または穴の始点をマークします。
このフラグを「hole」、「vertex」、「point」の各フラグの代わりに使用することもできます。append フラグに引数を渡さなかった場合、穴の始点がマークされます(Python では空のタプル () を使用します)。1 つの引数を渡した場合、vertex フラグと同様、この引数は選択したオブジェクトの頂点へのインデックスとみなされます。3 つの引数を渡した場合、point フラグと同様、この引数は挿入される新しいポイントの座標とみなされます。
-vertex(-v) int createmultiuse
選択したオブジェクトの指定した頂点を新しいフェースに追加します。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、単一の引数を渡します。
-point(-p) float float float createmultiuse
新しいフェースに新しいポイントを追加します。フリー ポイントの座標は、ローカル オブジェクトのリファレンスで指定されます。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、3 つの引数を渡します。
-texture(-tx) int createqueryedit
新しいフェースをマッピングする方法を指定します。
0: マッピングしない 1: 正規化する 2: ユニット化する
C: 既定は 0 (マッピングしない)です。
Q: 照会すると int を返します。
-hole(-h) createmultiuse
穴を追加します。続くポイントとエッジにより穴が定義されます。このフラグは、Python では使用しないでください。代わりに「append」フラグを使用して空のタプル () を渡し、穴の始点を指定することができます。
共通のフラグ
-name(-n) string create
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
-constructionHistory(-ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、 操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。

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

MEL 例

polyPlane -sx 3 -sy 3;
// add a new face
polyAppendVertex -v 6 -v 10 -p .167 .3 -.167 -p .167 .3 .167;
// add a new holed face
polyAppendVertex -v 9 -v 5 -p -.167 .3 .167 -p -.167 .3 -.167 -h -p -.167 .2 .1 -p -.167 .1 0 -p -.167 .2 -.1;
// connect the two new faces
polyAppendVertex -v 18 -v 17 -v 16 -v 19;
// add a new unconnected quad
polyAppendVertex -p -.5 .5 -.5 -p .5 .5 -.5 -p .5 .5 .5 -p -.5 .5 .5;