lattice

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

概要

lattice( selectionList , [after=boolean], [afterReference=boolean], [before=boolean], [commonParent=boolean], [components=boolean], [deformerTools=boolean], [divisions=[uint, uint, uint]], [dualBase=boolean], [exclusive=string], [freezeMapping=boolean], [frontOfChain=boolean], [geometry=string], [geometryIndices=boolean], [ignoreSelected=boolean], [includeHiddenSelections=boolean], [latticeReset=boolean], [ldivisions=[uint, uint, uint]], [name=string], [objectCentered=boolean], [outsideFalloffDistance=float], [outsideLattice=uint], [parallel=boolean], [position=[linear, linear, linear]], [prune=boolean], [remove=boolean], [removeTweaks=boolean], [rotation=[angle, angle, angle]], [scale=[linear, linear, linear]], [selectedComponents=boolean], [split=boolean], [useComponentTags=boolean])

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

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

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
after(af)	boolean
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの後にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
afterReference(ar)	boolean
-afterReference フラグを使用して、-before と -after のどちらかが自動的に選択されるハイブリッド法でデフォーマの順序を指定します。変形されているジオメトリが参照される場合、新しいデフォーマを追加するときには -after モード が使用され、そうでないときには -before モードが使用されます。-afterReference を使ってデフォーマ チェーンを構築する場合の真の効果は、デフォーマ チェーンの内部シェイプ ノードがリファレンス ファイルの境界でしか表示されないため、デフォーマ ネットワークの負担が軽くなり、リファレンスの入れ替えをより柔軟にできる場合があることです。
before(bf)	boolean
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの前にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
commonParent(cp)	boolean
ベース ラティスと変形ラティスが共通のトランスフォームでグループ化されます。共通のトランスフォームのサイズを変更すると、変形に影響を与えずにラティスのサイズを変更できます。
components(cmp)	boolean
デフォーマで使用されているコンポーネントを返します。
deformerTools(dt)	boolean
デフォーマ ツール オブジェクト(ある場合)の名前を string string ... として返します。
divisions(dv)	[uint, uint, uint]
X、Y、Z のラティス スライス数が設定されます。既定は、2、5、2 です。照会すると float float float が返されます。分割数を変更したら、ラティス ポイントの微調整とアニメーションはすべて再実行する必要があります。
dualBase(db)	boolean
2 つのベース ラティスを受け入れる、特別な目的の ffd デフォーマ ノードが作成されます。既定はオフで、通常の ffd デフォーマ ノードが作成されます。内部使用のみです。
exclusive(ex)	string
デフォメーション セットを変形パーティションに置きます。
freezeMapping(fm)	boolean
ジオメトリ ポイントのベース位置が、このフラグを設定した時間に固定されます。マッピングが固定されている場合、ラティスを基準にジオメトリを移動しても、変形は再計算されません。
frontOfChain(foc)	boolean
このコマンドを使用して、新しいデフォーマ ノードが、シェイプのヒストリで既存のデフォーマとスキン ノードの前(上流、ただし既存の微調整ノードの前ではありません)に配置されるように指定します。デフォーマへの入力は、表示される下流のシェイプではなく上流のシェイプです。したがって、このフラグの動作は、新しいデフォーマが追加されたときに下流のデフォーマがリセット位置(hasNoEffect)にある場合に、最も直感的になります。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
geometry(g)	string
-rm フラグも指定していない限り、指定したオブジェクトは、このデフォーマ オブジェクトによって変形されるオブジェクトのリストに追加されます。照会すると string string string ...を返します。
geometryIndices(gi)	boolean
照会モードで -geometry フラグを補完します。各ジオメトリのマルチ インデックスを返します。
ignoreSelected(ignoreSelected)	boolean
現在のセレクション リスト上のオブジェクトを変形しないようにコマンドに指示します。
includeHiddenSelections(ihs)	boolean
セレクション リスト内の任意の表示および非表示オブジェクトにデフォーマを適用します。既定は false です。
latticeReset(lr)	boolean
ベース位置に一致するようにラティスがリセットされます。ラティスで実行される変形はすべて元に戻されます。ラティスでは、ラティスのリセット(ベース)位置で囲まれるポイントのみが変形されます。
ldivisions(ldv)	[uint, uint, uint]
X、Y、Z のローカル ラティス スライス数が設定されます。
name(n)	string
作成されるノードの名前を指定するために使用されます。
objectCentered(oc)	boolean
選択したオブジェクトまたはコンポーネントを中心にラティスがセンタリングされます。既定はオフで、ラティスは原点でセンタリングされます。
outsideFalloffDistance(ofd)	float
ベース ラティスの外側にあるポイントのトランスフォーム方法が 2 に設定されている場合に使用する減衰範囲を設定します。範囲の値は正の数で、減衰範囲をベース ラティス サイズの倍数として指定します。つまり、1.0 を指定すると、ベース ラティスの幅/高さ/深度までの範囲にあるポイントだけがトランスフォームされます。0.0 は outsideLattice の値を 0 にするのと同じです(ベース ラティスの外側のポイントはまったくトランスフォームされません)。大きい値は、outsideLattice の値を 1 (すべてのポイントがトランスフォームされます)にしたトランスフォーム結果と同じです。
outsideLattice(ol)	uint
ベース ラティスの外側にあるポイントのトランスフォーム方法を指定するモードを設定します。0 (既定)を指定すると、外側のポイントはトランスフォームされません。1 を指定するとすべての外側のポイントがトランスフォームされ、2 を指定すると「falloff distance」(ofd/outsideFalloffDistance フラグを参照)内にある外側のポイントだけがトランスフォームされます。照会すると、現在のラティス設定が返されます。
parallel(par)	boolean
オブジェクトのヒストリの既存のデフォーマに平行するチェーンの新規デフォーマを挿入します。blendShape を挿入して、平行の結果とブレンドします。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
position(pos)	[linear, linear, linear]
新しく作成したラティスの位置を指定するために使用されます。
prune(pr)	boolean
現在の設定のデフォーマによって変形されないポイントをデフォーマ セットから除去します。
remove(rm)	boolean
-g フラグの後ろにリストされているオブジェクトをこのデフォーマから除去するように指定します。
removeTweaks(rt)	boolean
ラティス ポイントの移動で実行されたラティス デフォメーションが除去されます。ラティス自体の平行移動、回転、スケールは除去されません。
rotation(ro)	[angle, angle, angle]
新しく作成したラティスの初期回転を指定するために使用されます。
scale(s)	[linear, linear, linear]
新しく作成したラティスの初期スケールを指定するために使用されます。
selectedComponents(cms)	boolean
現在選択されているデフォーマで使用されているコンポーネントを返します。これは、現在の選択項目とデフォーマの影響を受けるコンポーネントを交差させます。
split(sp)	boolean
デフォーマを既存のチェーンに挿入/アペンドする代わりに、ディペンデンシー グラフで新しいチェーンを分岐させます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
useComponentTags(uct)	boolean
このフラグを指定すると、componentTags を使用した設定が作成されます。つまり、groupId、groupParts、tweak、または objectSet ノードは作成されず、新しいデフォーマに接続されません。

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

Python 例

import maya.cmds as cmds

# to create a 4x5x4 lattice centered around the sphere
#
cmds.sphere();
cmds.lattice( dv=(4, 5, 4), oc=True )

# to edit the lattice divisions to be 6x6x6
#
cmds.lattice( 'ffd1', e=True, dv=(6, 6, 6) )

# move a point on the lattice
cmds.select('ffd1Lattice.pt[2][2][5]',r=True)
cmds.move(0,0,3,r=True)

# to reset the lattice
#
cmds.lattice( 'ffd1', e=True, lr=True )