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