ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
polyAppendVertex([append=[[, float, float, float, ]]], [constructionHistory=boolean], [hole=boolean], [name=string], [point=[float, float, float]], [texture=int], [vertex=int])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
polyAppendVertex は、取り消し可能、照会可能、および 編集可能 です。
選択したポリゴン オブジェクトに新しいフェースをアペンドします。法線の方向は、頂点の順序で決まります。頂点が反時計回りに回転する場合、フェース法線はユーザを向きます。穴は反対方向に記述する必要があります。
単一のオブジェクトを選択した場合のみに動作します。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
polyAppend, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplit, polySplitVertex, polySubdivideEdge, polySubdivideFacet, polyTriangulate
append, constructionHistory, hole, name, point, texture, vertex
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
append(a)
|
[[, float, float, float, ]]
|
 
|
|
選択したオブジェクトに頂点またはポイントをアペンドするか、または穴の始点をマークします。
このフラグを「hole」、「vertex」、「point」の各フラグの代わりに使用することもできます。append フラグに引数を渡さなかった場合、穴の始点がマークされます(Python では空のタプル () を使用します)。1 つの引数を渡した場合、vertex フラグと同様、この引数は選択したオブジェクトの頂点へのインデックスとみなされます。3 つの引数を渡した場合、point フラグと同様、この引数は挿入される新しいポイントの座標とみなされます。
|
|
vertex(v)
|
int
|
|
|
選択したオブジェクトの指定した頂点を新しいフェースに追加します。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、単一の引数を渡します。
|
|
point(p)
|
[float, float, float]
|
|
|
新しいフェースに新しいポイントを追加します。フリー ポイントの座標は、ローカル オブジェクトのリファレンスで指定されます。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、3 つの引数を渡します。
|
|
texture(tx)
|
int
|
 
|
|
新しいフェースをマッピングする方法を指定します。
0: マッピングしない 1: 正規化する 2: ユニット化する
C: 既定は 0 (マッピングしない)です。
Q: 照会すると int を返します。
|
|
hole(h)
|
boolean
|
|
|
穴を追加します。続くポイントとエッジにより穴が定義されます。このフラグは、Python では使用しないでください。代わりに「append」フラグを使用して空のタプル () を渡し、穴の始点を指定することができます。
|
|
| 共通のフラグ |
name(n)
|
string
|
|
|
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
|
|
constructionHistory(ch)
|
boolean
|
|
|
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、
操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
cmds.polyPlane( sx=3, sy=3 )
# add a new face
cmds.polyAppendVertex( a=[6, 10, (.167, .3, -.167), (.167, .3, .167)] )
# add a new holed face
cmds.polyAppendVertex( a=[9, 5, (-.167, .3, .167), (-.167, .3, -.167), (), (-.167, .2, .1), (-.167, .1, 0), (-.167, .2, -.1)] )
# connect the two new faces
cmds.polyAppendVertex( a=[18, 17, 16, 19] )
# add a new unconnected quad
cmds.polyAppendVertex( a=[(-.5, .5, -.5), (.5, .5, -.5), (.5, .5, .5), (-.5, .5, .5)] )