cluster

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

概要

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

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

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

戻り値

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

関連項目

フラグ

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

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

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' )