ジャンプ先: 概要. 戻り値.
キーワード. 関連項目.
フラグ. 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'])