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

概要

duplicateCurve [-caching boolean] [-constructionHistory boolean] [-local boolean] [-maxValue float] [-mergeItems boolean] [-minValue float] [-name string] [-nodeState int] [-range boolean] [-relative boolean]

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

サーフェス上のカーブを取り、3D カーブを返します。サーフェス上のカーブとは、アイソパラム コンポーネント、トリム エッジ、カーブ オンサーフェス オブジェクトのことです。

戻り値

string[]オブジェクト名とノード名

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

関連

curveOnSurface, intersect, projectCurve

フラグ

caching, constructionHistory, local, maxValue, mergeItems, minValue, name, nodeState, range, relative
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
共通のフラグ
-caching(-cch) boolean createqueryedit
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
-constructionHistory(-ch) boolean create
コンストラクション ヒストリをオンまたはオフにします。
-local(-l) boolean create
サーフェスのトランスフォームをコピーし、ローカル空間バージョンに接続します。
-maxValue(-max) float createqueryedit
カーブ セグメントに対する最大パラメータ値です。MinValue アトリビュートと等しいか、それよりも大きい必要があります。相対が true である場合、このアトリビュートは最大値の 1.0 になります。
既定: -1.0
-mergeItems(-mi) boolean create
可能な場合は、コンポーネントの結果をマージします。たとえば、a[1] および a[2] を返すのではなく、a[1:2] を返します。
-minValue(-min) float createqueryedit
カーブ セグメントに対する最小パラメータ値です。相対が true である場合、このアトリビュートは最小値の 0.0 になります。
既定: 1.0
-name(-n) string create
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
-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
-range(-rn) boolean create
カーブの範囲を入力カーブ全体に強制します。
-relative(-r) boolean createqueryedit
true の場合は、0.0 から 1.0 までの相対パラメータ範囲を使用します。そうでない場合は、パラメータ値は絶対値です。
既定: false
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

cone -ch on -o on -po 0 -ax 0 1 0 -r 3 -hr 4;
// Result: nurbsCone1 makeNurbCone1 //

// duplicate isoparm at v param 0.5 with history
duplicateCurve -ch true -o true nurbsCone1.v[0.5];

// duplicate isoparm at normalized u param 0.1, no history
duplicateCurve -ch false nurbsCone1.un[0.1];

nurbsPlane -ch on -o on -po 0 -ax 0 1 0 -w 10 -lr 1 ;
circle -ch on -o on -nr 0 1 0 -r 4 ;
projectCurve -ch 0 -rn false -un  false  -tol 0.01 "nurbsCircle1" "nurbsPlane1" ;
// duplicate curve on surface
duplicateCurve -ch true -o false nurbsPlaneShape1->projectionCurve1_1;

trim -ch on -o on -rpo on -lu 0.2 -lv 0.3 nurbsPlaneShape1 projectionCurve1_Shape1 ;
// duplicate trim edge
duplicateCurve -ch true -o false nurbsPlane1.edge[1][1][1];