ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.
copyAttr([attribute=string], [containerParentChild=boolean], [inConnections=boolean], [keepSourceConnections=boolean], [outConnections=boolean], [renameTargetContainer=boolean], [values=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
copyAttr は、取り消し可能、照会可能、および編集可能です。
2 つのノードを指定し、名前とデータ タイプが一致するすべてのアトリビュートに対して、1 番目のノードから 2 番目のノードに接続および/または値を転送します。値を転送する場合は、直接転送されます。マッピングや修正は行われません。transferAttributes コマンドを使用して、メッシュ アトリビュートを転送およびリマップすることができます。処理するアトリビュートのリストを指定するには、アトリビュート フラグを使用します。アトリビュート フラグを使用しないと、すべてのアトリビュートが処理されます。ダイナミック アトリビュートでは、値および/または接続は、両方のノード上のアトリビュート名が一致する場合のみ転送されます。このコマンドは、メッシュ、サブディビジョン、および NURBS などのジオメトリ シェイプ ノードはサポートしていません。このコマンドは、ウェイト配列などのマルチ アトリビュート値の転送はサポートしていません。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
node, connection, container, copy
container, listAttr, transferAttributes
attribute, containerParentChild, inConnections, keepSourceConnections, outConnections, renameTargetContainer, values
ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
inConnections(ic)
|
boolean
|
|
|
outConnections(oc)
|
boolean
|
|
|
values(v)
|
boolean
|
|
|
attribute(at)
|
string
|
|
|
接続および/または値を転送するアトリビュート名です。アトリビュートを指定しないと、すべてのアトリビュートが転送されます。
|
|
keepSourceConnections(ksc)
|
boolean
|
|
|
outConnections フラグでのみ使用。1 番目のノード上の接続を維持したまま、さらに 2 番目のノードへの接続を作成します。outConnections を使用して keepSourceConnections を使用しないと、ソース ノード上の出力接続が解除されてターゲット ノードに作成されます。
|
|
renameTargetContainer(rtc)
|
boolean
|
|
|
あるコンテナから別のコンテナにコピーする場合にのみ使用します。このオプションは、ターゲット コンテナの名前をオリジナル コンテナの名前に変更し、オリジナル コンテナの名前をその前の名前 + 「Orig」に変更します。このオプションを使用して、オリジナル コンテナを参照して編集した変更内容を、メインのシーンから新しいコンテナに転送することができます。
|
|
containerParentChild(cpc)
|
boolean
|
|
|
あるコンテナから別のコンテナにコピーする場合にのみ使用します。このオプションは、オリジナル コンテナのパブリッシュされた親および/または子のリレーションシップを、パブリッシュされた名前が一致する場合にターゲット コンテナに転送します。
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# transfer input connections and values from locator1 to locator2
#
cmds.copyAttr('locator1','locator2',inConnections=True,values=True)
# transfer only the translateX and translateY values
#
cmds.copyAttr('locator1','locator2',values=True,attribute=['tx','translateY'])