cluster

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

概要

cluster( [objects] , [after=boolean], [afterReference=boolean], [before=boolean], [bindState=boolean], [components=boolean], [deformerTools=boolean], [envelope=float], [exclusive=string], [frontOfChain=boolean], [geometry=string], [geometryIndices=boolean], [ignoreSelected=boolean], [includeHiddenSelections=boolean], [name=string], [parallel=boolean], [prune=boolean], [relative=boolean], [remove=boolean], [resetGeometry=boolean], [selectedComponents=boolean], [split=boolean], [useComponentTags=boolean], [weightedNode=[string, string]])

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

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

クラスタ作成後、クラスタのウェイトは percent コマンドまたは set editor ウィンドウを使用して変更することができます。

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
after(af)	boolean
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの後にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
afterReference(ar)	boolean
-afterReference フラグを使用して、-before と -after のどちらかが自動的に選択されるハイブリッド法でデフォーマの順序を指定します。変形されているジオメトリが参照される場合、新しいデフォーマを追加するときには -after モード が使用され、そうでないときには -before モードが使用されます。-afterReference を使ってデフォーマ チェーンを構築する場合の真の効果は、デフォーマ チェーンの内部シェイプ ノードがリファレンス ファイルの境界でしか表示されないため、デフォーマ ネットワークの負担が軽くなり、リファレンスの入れ替えをより柔軟にできる場合があることです。
before(bf)	boolean
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの前にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
bindState(bs)	boolean
このフラグをオンにすると、クラスタ化したオブジェクトがクラスタ化時に空間上の位置を保持できるように補正が追加されます。これは、クラスタがクラスタ時間にトランスフォームする場合に、クラスタが作成される時間にジオメトリがジャンプしないようにするときに、必要な機能です。
components(cmp)	boolean
デフォーマで使用されているコンポーネントを返します。
deformerTools(dt)	boolean
デフォーマ ツール オブジェクト(ある場合)の名前を string string ... として返します。
envelope(en)	float
デフォーマのエンベロープ値を設定します。既定は 1.0 です。
exclusive(ex)	string
デフォメーション セットを変形パーティションに置きます。
frontOfChain(foc)	boolean
このコマンドを使用して、新しいデフォーマ ノードが、シェイプのヒストリで既存のデフォーマとスキン ノードの前(上流、ただし既存の微調整ノードの前ではありません)に配置されるように指定します。デフォーマへの入力は、表示される下流のシェイプではなく上流のシェイプです。したがって、このフラグの動作は、新しいデフォーマが追加されたときに下流のデフォーマがリセット位置(hasNoEffect)にある場合に、最も直感的になります。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
geometry(g)	string
-rm フラグも指定していない限り、指定したオブジェクトは、このデフォーマ オブジェクトによって変形されるオブジェクトのリストに追加されます。照会すると string string string ...を返します。
geometryIndices(gi)	boolean
照会モードで -geometry フラグを補完します。各ジオメトリのマルチ インデックスを返します。
ignoreSelected(ignoreSelected)	boolean
現在のセレクション リスト上のオブジェクトを変形しないようにコマンドに指示します。
includeHiddenSelections(ihs)	boolean
セレクション リスト内の任意の表示および非表示オブジェクトにデフォーマを適用します。既定は false です。
name(n)	string
作成されるノードの名前を指定するために使用されます。
parallel(par)	boolean
オブジェクトのヒストリの既存のデフォーマに平行するチェーンの新規デフォーマを挿入します。blendShape を挿入して、平行の結果とブレンドします。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
prune(pr)	boolean
現在の設定のデフォーマによって変形されないポイントをデフォーマ セットから除去します。
relative(rel)	boolean
デフォーマの相対モードを有効にします。相対モードでは、クラスタのすぐ上の変換のみがクラスタに使用されます。既定はオフです。
remove(rm)	boolean
-g フラグの後ろにリストされているオブジェクトをこのデフォーマから除去するように指定します。
resetGeometry(rg)	boolean
クラスタで変形されるオブジェクトの、ジオメトリ マトリックスをリセットします。このフラグを使用して、クラスタで変形されるオブジェクトをスケールする場合に発生する、不要なエフェクトを削除します。
selectedComponents(cms)	boolean
現在選択されているデフォーマで使用されているコンポーネントを返します。これは、現在の選択項目とデフォーマの影響を受けるコンポーネントを交差させます。
split(sp)	boolean
デフォーマを既存のチェーンに挿入/アペンドする代わりに、ディペンデンシー グラフで新しいチェーンを分岐させます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
useComponentTags(uct)	boolean
このフラグを指定すると、componentTags を使用した設定が作成されます。つまり、groupId、groupParts、tweak、または objectSet ノードは作成されず、新しいデフォーマに接続されません。
weightedNode(wn)	[string, string]
すべてのパーセントが適用されるクラスタの上にある DAG 内のトランスフォーム ノード。2 番目の DAGobject は、変換行列を評価する最初の DAGobject の派生要素を指定します。既定はクラスタ ハンドルです。

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

Python 例

import maya.cmds as cmds

# Create a cluster which uses the transformation of elbow1
#
cmds.joint(p=(2,0,0),name="elbow1")
cmds.joint(p=(4,0,0),name="wrist1")

cmds.sphere()
cmds.cluster( wn=('elbow1', 'elbow1') )

# Edit cluster1 to use the transformation of wrist1.
#
cmds.cluster( 'cluster1', e=True, bs=1, wn=('wrist1', 'wrist1') )

# Create a relative cluster with its own cluster handle. The
# cluster handle is drawn as the letter "C".
#
cmds.cluster( rel=True )

# Modify the membership of an existing cluster. First, find
# the name of the cluster's associated set, then use the sets
# command to edit the set membership (add a cube and remove a plane).
#
cmds.listConnections( 'cluster1', type="objectSet" )
# Result: cluster1Set
cmds.sets( 'pCube1', add='cluster1Set' )
cmds.sets( 'pPlane1', rm='cluster1Set' )