移動先: 概要 戻り値 関連項目 フラグ MEL の例
curveOnSurface [-append] [-degree float] [-knot float] [-periodic boolean] [-positionUV float float] [-replace]
string
curveOnSurface は「元に戻す」が可能、「照会」が不可能、「編集」が不可能です。
curveOnSurface コマンドを使用すると、CV(control vertice)のリストから新規のカーブ オンサーフェスが作成されます。新規作成されたカーブ オンサーフェスへのパス名を含む文字列が返されます。
「-r/replace」フラグを使用すると、既存のカーブを置き換えることができます。「-a/append」フラグを使用すると、ポイントを既存のカーブ オンサーフェスにアペンドできます。
カーブ アトリビュートの照会方法について説明した Curve コマンドも参照してください。
string | - 新しいカーブ オンサーフェスの名前 |
curve
append, degree, knot, periodic, positionUV, replace
ロング ネーム(ショート ネーム) |
引数型 |
プロパティ |
-degree(-d)
|
float
|
|
|
新規カーブの次数。デフォルトは 3 です。目に見えるカーブ スパンを作成するには、次数に 1 を足した数のカーブ ポイントが必要です。たとえば、3 次カーブには、4 個のポイントを配置する必要があります。
|
|
-replace(-r)
|
|
|
|
既存のカーブ全体を置き換えます。
このフラグを使用する場合、置き換えるカーブの名前をコマンドの最後に指定する必要があります(以下の例を参照)。
|
|
-append(-a)
|
|
|
|
既存のカーブの端にポイントをアペンドします。
このフラグを使用する場合、アペンドするカーブの名前をコマンドの最後に指定する必要があります (以下の例を参照)。
|
|
-positionUV(-uv)
|
float float
|
|
|
-knot(-k)
|
float
|
|
|
ノット ベクトルにあるノットの値。ノット値ごとに 1 フラグ。(numberOfPoints+次数-1)個のノットが必要で、ノット ベクトルは非減少型である必要があります。
|
|
-periodic(-per)
|
boolean
|
|
|
オンの場合、周期的なカーブを作成します。デフォルトはオフです。
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
: コマンドの照会モードで使用可能なフラグ
|
: 1 つのコマンドで複数回使用可能なフラグ
|
curveOnSurface -d 3 -uv 0 0 -uv 0.3 0.5 -uv 0.5 0.6 -uv 0.9 1.0 surface1;
// This command creates a curve-on-surface of degree three with
// four control vertices on surface1.
curveOnSurface -uv 0 0 -uv 0.3 0.5 -uv 0.5 0.6 -uv 0.7 0.8 -uv 1.0 1.0 -k 0 -k 0 -k 0 -k 1 -k 2 -k 2 -k 2 surface1;
// This command creates a curve-on-surface with five CVs
// and a knot vector, on surface1. Notice that there must be
// (number of CVs + degree - 1) knots and that the knot
// vector must be non-decreasing.
curveOnSurface -degree 3 -per on -uv 0 0 -uv 0.2 0.6 -uv 0.4 0.7 -uv 0.9 0.9 -uv 0.0 0.0 -uv 0.2 0.6 -uv 0.4 0.7 -k -2 -k -1 -k 0 -k 1 -k 2 -k 3 -k 4 -k 5 -k 6 surface1;
// This command creates a closed (or "periodic") curve-on-surface with
// four distinct CVs. You must specify a knot vector when the
// "-per" flag is on. Notice that the first "degree" points
// are the same as the last "degree" points (ie. the first three
// points are the same as the last three points). Notice also
// that the knot spacing between the first "degree" knots must
// be the same as the spacing between the last "degree" knots
// (ie. the space between the 1st and 2nd knots is the same as
// the space between the 7th and 8th knots, and the space between
// the 2nd and 3rd knots is the same as the space between the
// 8th and 9th knots). There must be space between the first
// "degree" knots, unlike the previous example, where the first
// "degree" knots are the same.
curveOnSurface -append -uv 1.0 1.0 surface1->curve1;
// This command appends a point to an existing curve-on-surface.
// Notice that the curve-on-surface is specified, not just the surface.
curveOnSurface -replace -d 1 -uv 1.0 1.0 -uv 2.0 2.0 surface1->curve1;
// This command replaces an existing curve, surface1->curve1, with a
// new curve of degree 1 having the given points. Do not use this
// flag on a curve that is a result of a construction history operation.