移動先: 概要 戻り値 フラグ. MEL 例.

概要

detachSurface [-caching boolean] [-constructionHistory boolean] [-direction int] [-keep boolean] [-name string] [-nodeState int] [-object boolean] [-parameter float] [-replaceOriginal boolean] surface

detachSurface は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

パラメータ値と方向のリストに従って、サーフェスが断片にデタッチされます。「-k」フラグを使用すると、保存する断片と破棄する断片を指定できます。 戻り値は、新しくデタッチされたサーフェスの名前です。コンストラクション ヒストリがオンの場合は、作成されるディペンデンシー ノード名も返されます。

1 回の detachSurface 操作では、U か V のどちらか、または両方でデタッチできます。

このコマンドを使用すると、特定パラメータ値で閉じたサーフェスを開くことができます。このコマンドは、「-p」フラグを 1 つだけ指定して使用できます。

「-k」フラグを指定する場合は、「-k」フラグを 1 つかすべて指定するか、まったく指定しない必要があります。「-k」フラグをすべて指定する場合は、「-p」フラグより「-k」フラグを 1 つ多くする必要があります。

戻り値

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

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

caching, constructionHistory, direction, keep, name, nodeState, object, parameter, replaceOriginal
ロング ネーム(ショート ネーム) 引数型 プロパティ
-direction(-d) int createqueryedit
デタッチの方向。 0 - V 方向、 1 - U 方向。
デフォルト: 1
-parameter(-p) float createqueryeditmultiuse
デタッチのパラメータ。
デフォルト: 0
-keep(-k) boolean createqueryeditmultiuse
デタッチされた断片が保存されます。
デフォルト: true
高度なフラグ
-caching(-cch) boolean createqueryedit
ノード キャッシング モードを修正します。詳細については、ノードの説明を参照してください。
: 上級ユーザ向けの機能です。
-nodeState(-nds) int createqueryedit
ノード状態を修正します。詳細については、ノードの説明を参照してください。
: 上級ユーザ向けの機能です。
一般的なフラグ
-name(-n) string create
作成されたオブジェクトに名前を付けます。
-constructionHistory(-ch) boolean create
コンストラクション ヒストリをオンまたはオフにします。
-object(-o) boolean create
結果のオブジェクト、またはディペンデンシー ノードのみを作成します。
-replaceOriginal(-rpo) boolean create
「同じ位置」に作成(つまり置き換え)します。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL 例

detachSurface -ch on -d 1 -p 0.3 -rpo off surface1;
detachSurface -ch on surface1.u[0.3];
// Detaches surface1 into two pieces at u = 0.3.
// The results are two surface pieces, and a detachSurface dependency node.
// Since no "-keep" flag is used, all pieces are kept.

detachSurface -ch on -k on -k off -rpo off -p 0.34 -d 0 surface1;
detachSurface -ch on -k on -k off -rpo off surface1.v[0.34];
// Detaches surface1 at v = 0.34.  Because of the "-k" flags, two
// surfaces are created but the second surface is empty.  A
// detachSurface dependency node is also returned.

detachSurface -ch on -rpo on -p 0.2 -p 0.5 -d 1 surface1;
detachSurface -ch on -rpo on surface1.u[0.2] surface1.u[0.5];
// Detaches surface1 into three pieces.  Because of the "-rpo" flag,
// the first surface piece is used to replace the original surface1.
// The results are the three surfaces (including the original surface).
// Even though the "-ch" flag is on, a dependency node is not created
// if surface1 is not a result of construction history.  If surface1
// is the result of construction history, then a dependency node is
// created and its name is returned.

detachSurface -ch on -d 0 -p 0.3 -rpo off cylinder1;
// Detaches cylinder1, which is periodic in V, where the V parameter
// ranges between 0.0 and 8.0.  The parameter, 0.3, is used to move
// the start point of the cylinder, also known as the "seam".
// The resulting surface's V parameter range is 0.0 to 0.3.

detachSurface -ch on -d 0 -p 0.3 -p 0.7 -rpo off cylinder1;
// Detaches cylinder1, which is periodic in V, where the V parameter
// ranges between 0.0 and 8.0.  The 1st parameter, 0.3, is used to move
// the start point of the cylinder, also known as the "seam".
// The second parameter, 0.7, is used to detach the cylinder again.
// The result is only TWO surfaces; the first surface's V parameter ranges
// from 0.0 to 0.3. The second surface's V parameter ranges from 0.3 to 0.7.