polySplit

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

概要

polySplit([constructionHistory=boolean], [edgepoint=[int, float]], [facepoint=[int, float, float, float]], [insertpoint=[int, float, [, float, float, ]]], [name=string], [smoothingangle=angle], [subdivision=int])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

polySplit は、取り消し可能、照会可能、および編集可能です。

最初と最後の引数はエッジにする必要があります。中間ポイントは、前のポイントに隣接する共有フェースかエッジに存在します。

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
edgepoint(ep)	[int, float]
エッジにそって特定パーセンテージに新しい頂点を配置し、特定エッジを 2 つの新しいエッジに分割します。 注: Python でこのフラグを使用することはお勧めできません。代わりに、insertpoint フラグを参照してください。
facepoint(fp)	[int, float, float, float]
特定フェース内の特定座標に新しい頂点を挿入します。座標はローカル オブジェクト空間で指定します。 注: Python でこのフラグを使用することはお勧めできません。代わりに、insertpoint フラグを参照してください。
insertpoint(ip)	[int, float, [, float, float, ]]
このフラグにより、コール側はエッジやフェースに新しい頂点を挿入できるようになります。 エッジに新しい頂点を挿入するには、エッジのインデックスと、新しい頂点を挿入するエッジ沿いの位置のパーセンテージを渡します。エッジに頂点を挿入するために使用する場合、このフラグは 2 つの引数を取ります。 フェースに新しい頂点を挿入するには、フェースのインデックスと、ローカルなオブジェクト空間に挿入するための座標を定義する 3 つの値を渡します。フェースに頂点を挿入するために使用する場合、このフラグは 4 つの引数を取ります。 このフラグは、edgepoint フラグと facepoint フラグに替わるものです。
subdivision(s)	int
特定数のセクションに新しいエッジを細分割します。フリー ポイントを含むエッジは細分割されません。 C :既定は 1 (細分割なし)です。 Q: 照会すると int を返します。
smoothingangle(sma)	angle
この角度よりも小さい場合に、細分割したエッジはソフト エッジになります。 C: 既定は 0.0 です。
共通のフラグ
name(n)	string
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
constructionHistory(ch)	boolean
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。 注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。

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

Python 例

import maya.cmds as cmds

# Note that in Python, you must use the ip/insertpoint flag which determines
# whether you are splitting an edge or a face based on the number of
# arguments to the flag (2 for an edge, and 4 for a face)
cmds.polyCreateFacet( p=[(0, 2, 0), (0, -2, 0), (4, -2, 0), (4, 2, 0)] )
cmds.polySplit( ip=[(2, 0.1), (3, 0.5), (0, 2, -1, 0.0), (0, 0.9)] )