移動先: 概要 戻り値 関連項目 フラグ 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)] )