ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.
polyAppend [-append [ float float float ]] [-constructionHistory boolean] [-edge int] [-hole] [-name string] [-point float float float] [-subdivision int] [-texture int]
polyAppend は、取り消し可能、照会可能、および編集可能です。
選択したポリゴン オブジェクトに新しいフェースをアペンドします。最初の引数は境界エッジにする必要があります。新しいフェースは自動的に閉じます。
単一のオブジェクトを選択した場合のみに動作します。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
polyAppendVertex, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplit, polySplitVertex, polySubdivideEdge, polySubdivideFacet, polyTriangulate
append, constructionHistory, edge, hole, name, point, subdivision, texture
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
-append(-a)
|
[ float float float ]
|
 
|
|
指定したポリゴン オブジェクトにアペンドします。append フラグを複数回使用して、追加する新しいフェースを構成するエッジ、ポイント、穴を指定する必要があります。エッジを指定するには、エッジのインデックスになる単一の引数を渡します。ポイントを指定するには、オブジェクトのローカル空間でのポイント座標である 3 つの引数を使用します。引数を指定しない場合、その後に続く値は穴を指定していることを示します。Python で引数を指定しない場合は、空のタプルを渡します。
|
|
-edge(-ed)
|
int
|
|
|
選択したオブジェクトの指定したエッジを、新しいフェースに追加します。このエッジは境界である必要があり、新しいフェースと隣接するフェースがこれを共有します。新しいフェースの向きは、指定したエッジの向きに従います。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、単一の引数を渡します。
|
|
-hole(-hl)
|
|
|
|
穴を追加します。続くポイントとエッジにより穴が定義されます。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、空のタプル () を渡します。
|
|
-point(-p)
|
float float float
|
|
|
新しいフェースに新しいポイントを追加します。フリー ポイントの座標は、ローカル オブジェクトのリファレンスで指定されます。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、3 つの引数を渡します。
|
|
-subdivision(-s)
|
int
|
 
|
|
サブディビジョンのレベルを指定します。新しいエッジを、指定したエッジ数へと自動的に細分割します。既存エッジは細分割できません。
C :既定は 1 (細分割なし)です。
Q: 照会すると int を返します。
|
|
-texture(-tx)
|
int
|
|
|
新しいフェースをマッピングする方法を指定します。
0: マッピングしない 1: 正規化する 2: ユニット化する
C: 既定は 0 (マッピングしない)です。
Q: 照会すると int を返します。
|
|
| 共通のフラグ |
-constructionHistory(-ch)
|
boolean
|
|
|
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。
|
|
-name(-n)
|
string
|
|
|
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
コマンド内でフラグを複数回使用できます。
|
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;