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

概要

polyMergeFacetCtx [-activeNodes] [-caching boolean] [-constructionHistory boolean] [-exists] [-firstFacet int] [-image1 string] [-image2 string] [-image3 string] [-immediate] [-mergeMode int] [-name string] [-nodeState int] [-previous] [-reset] [-secondFacet int] [-toolNode]

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

2 番目のフェースが 1 番目のフェースの穴になります。
新しく穴の開いたフェースは、モードによって、最初か最後、または選択したフェースの間に配置されます。

両方のフェースは、同じオブジェクトに属す必要があります。
ファセット フラグは必須です。

新しいコンテキストを作成し、ポリゴン オブジェクトでファセットをマージします。

戻り値

stringノード名

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

関連

polyCloseBorder, polyCollapseEdge, polyCollapseFacet, polyDelEdge, polyDelFacet, polyDelVertex, polyMergeEdge, polyMergeVertex, polyQuad, polyReduce, polySewEdge

フラグ

activeNodes, caching, constructionHistory, exists, firstFacet, image1, image2, image3, immediate, mergeMode, name, nodeState, previous, reset, secondFacet, toolNode
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-activeNodes(-anq) query
ツール内でアクティブなノードを返します。
-exists(-ex) create
指定したオブジェクトが存在するかどうかによって、true または false を返します。他のフラグは無視されます。
-image1(-i1) string createqueryedit
コンテキストに関連付けられているツールを表す 3 つの可能なアイコンの中の最初のアイコンです。
-image2(-i2) string createqueryedit
コンテキストに関連付けられているツールを表す 3 つの可能なアイコンの中の 2 番目のアイコンです。
-image3(-i3) string createqueryedit
コンテキストに関連付けられているツールを表す 3 つの可能なアイコンの中の 3 番目のアイコンです。
-immediate(-im) edit
ツールの既定ではなく、オブジェクト上で動作します。
-name(-n) string create
これがツール コマンドの場合、ツールに適切に名前を付けます。
-previous(-pv) edit
以前に格納した値にリセットします。
-reset(-rs) edit
既定値にリセットします。
-toolNode(-tnq) query
ツールの既定に使用されるノードを返します。
Common poly modifier operation flags
-caching(-cch) boolean createqueryedit
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
-constructionHistory(-ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。
-firstFacet(-ff) int createqueryedit
マージする 1 番目の(外部)フェースの数。
-mergeMode(-mm) int createqueryedit
フェースのマージ方法を指定します。0: 2 番目のフェースを 1 番目に移動します。1: 両方のフェースがその平均に移動します。2: 1 番目のフェースが 2 番目のフェースに移動します。3, 4, 5: フェースが投影されたときに中央に揃わないこと以外は上述と同様です。6: 移動しません。
C: 既定は none (6)です。
-nodeState(-nds) int createqueryedit

Maya のディペンデンシー ノードには 6 種類の設定可能な状態があります。通常(Normal)(0)、エフェクトなし(HasNoEffect)(1)、ブロッキング(Blocking)(2)ステータスは、グラフの評価方法を変更するために使用されます。

待機 - 通常(Waiting-Normal)(3)、待機 - エフェクトなし(Waiting-HasNoEffect)(4)、待機 - ブロッキング(Waiting-Blocking)(5)は、内部でのみ使用されます。これらは、インタラクション(例: 操作)の実行中にグラフのパーツを一時的に遮断します。操作が完了すると、ステータスは適切にリセットされます(例: 待機 - ブロッキング(Waiting-Blocking) は ブロッキング(Blocking) にリセットされます)。

通常(Normal)およびブロッキング(Blocking)のケースはすべてのノードに適用できますが、エフェクトなし(HasNoEffect)はノード特定です。多くのノードはこのオプションをサポートしていません。プラグインは状態を MPxNode::state アトリビュートに保存します。誰もがこのアトリビュートを設定したり確認したりすることができます。これらの 3 つの状態に関するその他の詳細は次の通りです。

状態 説明
通常(Normal) 通常のノードの状態です。これが既定の設定です。
エフェクトなし(HasNoEffect)

エフェクトなし(HasNoEffect)オプション(別名: 通過)は、同じデータ タイプの出力を生成する入力を操作している場合に使用されます。 ほぼすべてのデフォーマが、他のいくつかのノードと同様に、この状態をサポートします。前に説明したように、すべてのノードでサポートされるわけではありません。

ノードの計算メソッドでエフェクトなし(HasNoEffect)状態のサポートを実装し、適切な操作を実行することが一般的です。プラグインはエフェクトなし(HasNoEffect)もサポートします。

この状態を普通に実装するには、ノードにアルゴリズムを適用しないで、適合する出力に直接入力をコピーします。デフォーマの場合は、この状態を適用することにより、入力ジオメトリが出力でデフォーム解除されたままになります。

ブロッキング(Blocking)

これはディペンデンシー ノードのベース クラスで実装され、すべてのノードに適用されます。ブロッキング(Blocking)は評価フェーズ中に接続に適用されます。 ブロックされた接続に対する評価要求が失敗を返すと、目的プラグが現在の値を保持します。 ダーティな伝播はこの状態の間接的な影響を受けますが、ブロックされた接続がクリーンアップされることはありません。

ノードをブロッキング(Blocking)に設定すると、すべての送信接続が解除されたのと同じ動作になる可能性があります。 ブロックされたノードの評価を直接要求しない限り、その後に再評価されることはありません。ブロックされたノードは getAttr 要求に引き続き応答しますが、下流ノードの getAttr は、ブロックされたノードを再評価しないことに注意してください。

ブロッキング(Blocking)に対して階層のルート変換を設定しても、自動的にはこの階層の子変換に影響しません。これを実行するには、ブロッキング(Blocking)状態に対してすべての子ノードを明示的に設定する必要があります。

たとえば、すべての子トランスフォームをブロッキング(Blocking)に設定するには、次のスクリプトを使用します。

 import maya.cmds as cmds def blockTree(root): nodesToBlock = [] for node in {child:1 for child in cmds.listRelatives( root, path=True, allDescendents=True )}.keys(): nodesToBlock += cmds.listConnections(node, source=True, destination=True ) for node in {source:1 for source in nodesToBlock}.keys(): cmds.setAttr( '%s.nodeState' % node, 2 )

このスクリプトを適用してオブジェクトの描画を継続できますが、アニメートは行えません。


既定: kdnNormal
-secondFacet(-sf) int createqueryedit
マージする 2 番目の(穴)フェースの数。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

polyPlane -n plg -h 10 -w 10 -sx 5 -sy 5;
polyChipOff -dup 1 -ltz 1 -ls .5 .5 .5 plg.f[16] plg.f[18] plg.f[7];

// First
polyMergeFacet -mm 0 -ff 16 -sf 26 plg;
// A new face with face #16 as an outer loop and face #26 as a hole
// is replacing faces #16 and #26, and is located on face #16

// Between
polyMergeFacet -mm 1 -ff 7 -sf 25 plg;
// A new face with face #7 as an outer loop and face #25 as a hole
// is replacing faces #7 and #25, and is located in between.

// Last
polyMergeFacet -mm 2 -ff 18 -sf 25 plg;
// A new face with face #18 as an outer loop and face #25 as a hole
// is replacing faces #18 and #25, and is located on face #25

// Create a poly plane
polyPlane -w 10 -h 10 -sx 10 -sy 10 -n pPlane1;

// Create a new poly merge facet context, set the merge mode to merging the second face to the first face, then switch to it
polyMergeFacetCtx -mm 0 polyMergeFacetCtx1;
setToolTo polyMergeFacetCtx1;