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

概要

polyAppend([append=[[, float, float, float, ]]], [constructionHistory=boolean], [edge=int], [hole=boolean], [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) boolean createmultiuse
穴を追加します。続くポイントとエッジにより穴が定義されます。このフラグは、Python では使用しないでください。代わりに append フラグを使用して、空のタプル () を渡します。
append(a) [[, float, float, float, ]] createmultiuse
指定したポリゴン オブジェクトにアペンドします。append フラグを複数回使用して、追加する新しいフェースを構成するエッジ、ポイント、穴を指定する必要があります。エッジを指定するには、エッジのインデックスになる単一の引数を渡します。ポイントを指定するには、オブジェクトのローカル空間でのポイント座標である 3 つの引数を使用します。引数を指定しない場合、その後に続く値は穴を指定していることを示します。Python で引数を指定しない場合は、空のタプルを渡します。
共通のフラグ
name(n) string create
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
constructionHistory(ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

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