移動先: 概要 戻り値 関連項目 フラグ Python の例

概要

polyAppendVertex([append=[float, float, float]], [constructionHistory=boolean], [hole=boolean], [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) boolean createmultiuse
穴を追加します。続くポイントとエッジにより穴が定義されます。 このフラグは、Python では使用しないでください。代わりに「append」フラグを使用して空のタプル () を渡し、穴の始点を指定することができます。
一般的なフラグ
name(n) string create
作成されるノードに名前をつけます。
constructionHistory(ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、 操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、 このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python の例

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)] )