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

概要

polyConnectComponents([caching=boolean], [constructionHistory=boolean], [name=string], [nodeState=int])

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

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

ポリゴン エッジを選択したコンポーネントに従って分割します。選択したコンポーネントは、連続する分割を定義する、接続された「パス」へと集められます。頂点、エッジ、フェースなどの混合コンポーネントは即座に使用できます。接続規則は以下の通りです。* エッジは、同じフェース上の別のエッジ、同じフェース上の頂点(そのエッジ上にない)、または同じフェース上で別のエッジに接続されたフェースに接続できます。* 頂点は、同じフェース上のエッジ(上記の通り)、同じフェース上の頂点(エッジを通じて 1 番目の頂点と結合していない)、または頂点を使用するフェースに隣接するフェース(頂点を使用するフェースを除く)に接続できます。* フェースは、頂点やエッジ(上記の通り)、または隣接するフェースと接続できます。

戻り値

stringノード名

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

関連

polyClipboard, polyCylindricalProjection, polyEditUV, polyForceUV, polyMapCut, polyMapDel, polyMapSew, polyMoveFacetUV, polyMoveUV, polyPlanarProjection, polyProjection, polySphericalProjection, polyUVSet, untangleUV

フラグ

caching, constructionHistory, name, nodeState
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
共通のフラグ
name(n) string create
作成されるノードに名前をつけます。
constructionHistory(ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。
caching(cch) boolean createedit
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
nodeState(nds) int createqueryedit
ノードの評価方法を定義します。
  • 0: Normal
  • 1: PassThrough
  • 2: Blocking
  • 3: 内部的に無効。有効にすると、Normal 状態に戻ります。
  • 4: 内部的に無効。有効にすると、PassThrough 状態に戻ります。
  • 5: 内部的に無効。有効にすると、Blocking 状態に戻ります。

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

Python 例

import maya.cmds as cmds

# make a sphere
cmds.polySphere( r=1, sx=20, sy=20, ax=(0,1,0), cuv=2, ch=1, name='sph' )
# split two faces by specifying 3 vertices
cmds.polyConnectComponents( 'sph.vtx[254]', 'sph.vtx[256]', 'sph.vtx[275]', ch=1 )
# split two faces by specifying 3 edges
cmds.polyConnectComponents( 'sph.e[278]', 'sph.e[637:638]', ch=1 )
# split three faces
cmds.polyConnectComponents( 'sph.f[66]', 'sph.f[215:217]', ch=1 )
# a complex split involving vertices, edges and faces, in a loop
cmds.polyConnectComponents( 'sph.f[270:271]', 'sph.vtx[273]', 'sph.e[232]', 'sph.e[252]',  'sph.e[592]', 'sph.f[210]', 'sph.vtx[229]', 'sph.e[249]', 'sph.e[269]', ch=1 )