ジャンプ先: 概要. 戻り値.
関連項目. フラグ. 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)] )