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