curveIntersect

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

概要

curveIntersect( string string , [caching=boolean], [constructionHistory=boolean], [direction=[linear, linear, linear]], [directionX=linear], [directionY=linear], [directionZ=linear], [nodeState=int], [tolerance=linear], [useDirection=boolean])

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

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

このコマンドを使うと、指定の 2 本のカーブが交差している部分のパラメータ値、または交差の情報を表すディペンデンシー ノードを返します。特定方向のカーブの交差を照会する場合は、「-useDirection」フラグと「direction」フラグの両方を使用する必要があります。

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
共通のフラグ
caching(cch)	boolean
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
constructionHistory(ch)	boolean
コンストラクション ヒストリをオンまたはオフにします。
direction(d)	[linear, linear, linear]
交差の前に入力カーブが投影される方向です。このベクトルは、「useDirection」フラグが true の場合のみ使用されます。
directionX(dx)	linear
交差する前に入力カーブが投影される方向の X コンポーネントです。このベクトルは、「useDirection」フラグが true の場合のみ使用されます。
directionY(dy)	linear
交差する前に入力カーブが投影される方向の Y コンポーネントです。このベクトルは、「useDirection」フラグが true の場合のみ使用されます。
directionZ(dz)	linear
交差する前に入力カーブが投影される方向の Z コンポーネントです。このベクトルは、「useDirection」フラグが true の場合のみ使用されます。
nodeState(nds)	int
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
tolerance(tol)	linear
交差を算出する許容値です。たとえば、2 本のカーブのそれぞれの終端で接続する場合、その終端が返される交差の許容値内に収まっている必要があります。 既定: 0.001
useDirection(ud)	boolean
true の場合、Direction フラグを使用します。まず入力カーブを指定の方向に投影してから、交差させます。false の場合、このコマンドによって真の 3D 交差のみが検索されます。 既定: false

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

Python 例

import maya.cmds as cmds

cmds.curveIntersect( 'curve1', 'curve2' )
# Returns the parameter values that the curves intersect at.
# eg. if 6 parameter values are returned, the first 3 are
# on curve1 and the last 3 are on curve2.


cmds.curveIntersect( 'curve1', 'curve2', useDirection=True, direction=(0, 1, 0) )
# Returns the parameter values that the curves intersect at
# when projected along vector (0, 1, 0).  This is useful
# for example when you are viewing the two curves in an orthographic
# view and the curves appear to intersect, even though
# they do not intersect in 3D.

node = cmds.curveIntersect('curve1', 'curve2', ch= True)
p1 = cmds.getAttr(node + ".parameter1" )   # or use ".p1"
p2 = cmds.getAttr(node + ".parameter2" )   # or use ".p2"
# Returns a string which is the name of a new curveIntersect
# dependency node.
# The "getAttr" commands return the parameter values at
# which the curves intersect each other.