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

概要

polyAppend [-append [ float float float ]] [-constructionHistory boolean] [-edge int] [-hole] [-name string] [-point float float float] [-subdivision int] [-texture int]

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

選択したポリゴン オブジェクトに新しいフェースをアペンドします。最初の引数は境界エッジにする必要があります。新しいフェースは自動的に閉じます。
単一のオブジェクトを選択した場合のみに動作します。

戻り値

stringノード名

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

関連

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

フラグ

append, constructionHistory, edge, hole, name, point, subdivision, texture
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-edge(-ed) int createmultiuse
選択したオブジェクトの指定したエッジを、新しいフェースに追加します。このエッジは境界である必要があり、新しいフェースと隣接するフェースがこれを共有します。新しいフェースの向きは、指定したエッジの向きに従います。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、単一の引数を渡します。
-point(-p) float float float createmultiuse
新しいフェースに新しいポイントを追加します。フリー ポイントの座標は、ローカル オブジェクトのリファレンスで指定されます。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、3 つの引数を渡します。
-texture(-tx) int createqueryedit
新しいフェースをマッピングする方法を指定します。
0: マッピングしない 1: 正規化する 2: ユニット化する
C: 既定は 0 (マッピングしない)です。
Q: 照会すると int を返します。
-subdivision(-s) int createqueryedit
サブディビジョンのレベルを指定します。新しいエッジを、指定したエッジ数へと自動的に細分割します。既存エッジは細分割できません。
C :既定は 1 (細分割なし)です。
Q: 照会すると int を返します。
-hole(-hl) createmultiuse
穴を追加します。続くポイントとエッジにより穴が定義されます。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、空のタプル () を渡します。
-append(-a) [ float float float ] createmultiuse
指定したポリゴン オブジェクトにアペンドします。append フラグを複数回使用して、追加する新しいフェースを構成するエッジ、ポイント、穴を指定する必要があります。エッジを指定するには、エッジのインデックスになる単一の引数を渡します。ポイントを指定するには、オブジェクトのローカル空間でのポイント座標である 3 つの引数を使用します。引数を指定しない場合、その後に続く値は穴を指定していることを示します。Python で引数を指定しない場合は、空のタプルを渡します。
共通のフラグ
-name(-n) string create
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
-constructionHistory(-ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。

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

MEL 例

polyCreateFacet -p 0 0 0 -p 10 0 0 -p 10 10 0 -p 0 10 0;

//add a new triangular facet described by the edge #0, and a free point
polyAppend -ed 0 -p 5 -5 0;

//add a new quadrangular facet with 2 triangular holes.
polyAppend -ed 1 -p 20 0 0 -p 20 10 0
    -hl -p 12 6 0 -p 14 5 0 -p 12 4 0
    -hl -p 16 5 0 -p 18 6 0 -p 18 4 0;