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

概要

insertKnotCurve [-addKnots boolean] [-caching boolean] [-constructionHistory boolean] [-curveOnSurface boolean] [-insertBetween boolean] [-name string] [-nodeState int] [-numberOfKnots int] [-object boolean] [-parameter float] [-replaceOriginal boolean] curve

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

insertKnotCurve コマンドでは、パラメータ値のリストが指定されている場合に、カーブにノットが挿入されます。パラメータ値 1 つに対して追加されるノットの数と、ノットが追加されるか補完されるかを指定することができます。 カーブの名前が返されます。 コンストラクション ヒストリがオンの場合、結果として得られるディペンデンシー ノード名も返されます。

ノットを挿入した位置にエディット ポイントが表示されます。また、ノットが挿入された領域では、カーブ内のスパンと CV の数が増えます。

まだエディット ポイントになっていないカーブ パラメータには、「次数」までノットを挿入することができます。例: 3 次のカーブに対しては、ノットを 3 つまで挿入できます。

カーブのローカル領域にさらに CV を追加する必要がある場合は、この操作を行います。 カーブにコーナーを作成する必要がある場合は、この操作(または「hardenPoint」)を使用します。

戻り値

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

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

フラグ

addKnots, caching, constructionHistory, curveOnSurface, insertBetween, name, nodeState, numberOfKnots, object, parameter, replaceOriginal
ロング ネーム(ショート ネーム) 引数型 プロパティ
-parameter(-p) float createqueryeditmultiuse
ノットが追加されるパラメータ値です。
デフォルト: 0
-numberOfKnots(-nk) int createqueryeditmultiuse
挿入されるノットの数。カーブのいずれかのポイントに、最大「次数」分のノットを挿入することができます。
デフォルト: 1
-addKnots(-add) boolean createqueryedit
ノットまたは補足を追加します。補足とは、指定したノット数に到達するようにノットを追加することです。
デフォルト: true
-insertBetween(-ib) boolean createqueryedit
true(真)に設定すると、複数のパラメータ値が指定され、ノットはパラメータ値そのものではなく、所定のパラメータ値の間に均等な間隔で挿入されます。
デフォルト: false
高度なフラグ
-caching(-cch) boolean createqueryedit
ノード キャッシング モードを修正します。詳細については、ノードの説明を参照してください。
: 上級ユーザ向けの機能です。
-nodeState(-nds) int createqueryedit
ノード状態を修正します。詳細については、ノードの説明を参照してください。
: 上級ユーザ向けの機能です。
一般的なフラグ
-name(-n) string create
作成されたオブジェクトに名前を付けます。
-constructionHistory(-ch) boolean create
コンストラクション ヒストリをオンまたはオフにします。
-object(-o) boolean create
結果のオブジェクト、またはディペンデンシー ノードのみを作成します。
-replaceOriginal(-rpo) boolean create
「同じ位置」に作成(つまり置き換え)します。
-curveOnSurface(-cos) boolean create
可能な場合は、2D カーブが作成されます。

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

MEL 例

insertKnotCurve -ch on -p 0.3 -nk 2 curve1;
insertKnotCurve -ch on -nk 2 curve1.u[0.3];
// Both commands will insert two knots into curve1 at parameter value 0.3.
// Because the -ch flag is used, a dependency node is created.

insertKnotCurve -ch on -add off -p 0.5 -nk 3 curve1;
// Inserts enough knots into curve1 at parameter value 0.5 to
// achieve a knot multiplicity of 3.  Because the -ch flag is used,
// a dependency node is created.

insertKnotCurve -ch on -p 0.3 -p 0.5 -p 0.8 curve1;
// Inserts a default of one knot at each parameter value: 0.3, 0.5 and 0.8.

insertKnotCurve -ch on -p 0.3 -p 0.5 -p 0.8 -nk 2 curve1;
// Inserts two knots at each parameter value: 0.3, 0.5 and 0.8.

insertKnotCurve -ch on -p 0.1 -p 0.3 -p 0.5 -p 0.8 -nk 1-nk 2 curve1;
// Invalid command.  The number of -nk flags doesn't match the number
// of -p flags.