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