insertKnotSurface

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

概要

insertKnotSurface( surface , [addKnots=boolean], [caching=boolean], [constructionHistory=boolean], [direction=int], [insertBetween=boolean], [name=string], [nodeState=int], [numberOfKnots=int], [object=boolean], [parameter=float], [replaceOriginal=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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

「-nk」フラグを使用して、ノットの数を「1」、「なし」、または「すべて」に指定する必要があります。例:「なし」を指定すると、デフォルト（1）ノットが、指定したパラメータ値それぞれに追加されます。「-nk」値を 1 つ指定すると、パラメータ値それぞれに対して指定した数のノットが追加されます。 それ以外の場合、指定したパラメータ値それぞれに追加するノット数を定義するには、「-nk」フラグと「-p」フラグに同じ数値を指定する必要があります。

まだアイソパラムになっていないパラメータ値には、「次数」分までのノットを挿入することができます。例: 3 次のサーフェスに対しては、ノットを 3 つまで挿入できます。

サーフェスのローカル領域にさらに CV を追加する必要がある場合は、この操作を行います。 サーフェスにコーナーを作成する必要がある場合は、この操作を使用します。

注: 単一の insertKnotSurface コマンドで、一度に両方向へ挿入することはできません。これを実行するには、2 つのコマンドを別々に使用する必要があります。

戻り値

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

フラグ

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

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

cmds.insertKnotSurface( 'surface1', ch=True, p=0.3, d=0 )
cmds.insertKnotSurface( 'surface1.v[0.3]', ch=True )
# Inserts one knot (which is the default) into surface1 at
# parameter value v = 0.3.  When an isoparm is specified, the direction
# and parameter value is implied and the "p" and "d" flags can be omitted.

cmds.insertKnotSurface( 'surface1', ch=True, p=0.3, nk=2, d=0 )
# Inserts two knots into surface1 at parameter value v = 0.3.

cmds.insertKnotSurface( 'surface1', ch=True, p=0.3, p=0.5, p=0.8, nk=2, d=0 )
# Inserts two knots at each parameter value v = 0.3, 0.5 and 0.8.

cmds.insertKnotSurface( 'surface1', ch=True, p=0.5, add=False, nk=3, d=1 )
# Inserts enough knots into surface1 at parameter value u = 0.5 to
# achieve a knot multiplicity of 3.