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

概要

transferAttributes( object object , [after=boolean], [afterReference=boolean], [before=boolean], [colorBorders=uint], [components=boolean], [deformerTools=boolean], [exclusive=string], [flipUVs=uint], [frontOfChain=boolean], [geometry=string], [geometryIndices=boolean], [ignoreSelected=boolean], [includeHiddenSelections=boolean], [matchChoice=uint], [name=string], [parallel=boolean], [prune=boolean], [remove=boolean], [sampleSpace=uint], [searchMethod=uint], [searchScaleX=float], [searchScaleY=float], [searchScaleZ=float], [selectedComponents=boolean], [sourceColorSet=string], [sourceUvSet=string], [sourceUvSpace=string], [split=boolean], [targetColorSet=string], [targetUvSet=string], [targetUvSpace=string], [transferColors=uint], [transferNormals=uint], [transferPositions=uint], [transferUVs=uint], [useComponentTags=boolean])

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

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

ソース サーフェス(1 番目の引数)のアトリビュートをサンプリングし、これらをターゲット サーフェス(2 番目の引数)に転送します。

戻り値

stringノード名

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

フラグ

after, afterReference, before, colorBorders, components, deformerTools, exclusive, flipUVs, frontOfChain, geometry, geometryIndices, ignoreSelected, includeHiddenSelections, matchChoice, name, parallel, prune, remove, sampleSpace, searchMethod, searchScaleX, searchScaleY, searchScaleZ, selectedComponents, sourceColorSet, sourceUvSet, sourceUvSpace, split, targetColorSet, targetUvSet, targetUvSpace, transferColors, transferNormals, transferPositions, transferUVs, useComponentTags
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
after(af) boolean createedit
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの後にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
afterReference(ar) boolean createedit
-afterReference フラグを使用して、-before と -after のどちらかが自動的に選択されるハイブリッド法でデフォーマの順序を指定します。変形されているジオメトリが参照される場合、新しいデフォーマを追加するときには -after モード が使用され、そうでないときには -before モードが使用されます。-afterReference を使ってデフォーマ チェーンを構築する場合の真の効果は、デフォーマ チェーンの内部シェイプ ノードがリファレンス ファイルの境界でしか表示されないため、デフォーマ ネットワークの負担が軽くなり、リファレンスの入れ替えをより柔軟にできる場合があることです。
before(bf) boolean createedit
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの前にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
colorBorders(clb) uint createedit
カラー データの転送時にカラー境界を保持するかどうかをコントロールします。ゼロ以外の場合、カラー境界はターゲット ジオメトリの最も近いエッジにマッピングされます。0 の場合、カラー境界はターゲット ジオメトリの頂点に滑らかにブレンドされます。
components(cmp) boolean query
デフォーマで使用されているコンポーネントを返します。
deformerTools(dt) boolean query
デフォーマ ツール オブジェクト(ある場合)の名前を string string ... として返します。
exclusive(ex) string createquery
デフォメーション セットを変形パーティションに置きます。
flipUVs(fuv) uint createedit
ターゲットに転送する前に、サンプリングした UV データを反転する方法をコントロールします。0 の場合、反転は行いません。1 の場合は、U 方向に UV データを反転します。2 の場合は、V 方向に UV データを反転します。3 の場合は、両方の方向に反転します。反転をミラーリングと組み合わせると、対称的な UV マッピングを作成できます(たとえば、UV マップの一方にキャラクタの左側、他方に右側をマッピングできます)。
frontOfChain(foc) boolean createedit
このコマンドを使用して、新しいデフォーマ ノードが、シェイプのヒストリで既存のデフォーマとスキン ノードの前(上流、ただし既存の微調整ノードの前ではありません)に配置されるように指定します。デフォーマへの入力は、表示される下流のシェイプではなく上流のシェイプです。したがって、このフラグの動作は、新しいデフォーマが追加されたときに下流のデフォーマがリセット位置(hasNoEffect)にある場合に、最も直感的になります。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
geometry(g) string queryeditmultiuse
-rm フラグも指定していない限り、指定したオブジェクトは、このデフォーマ オブジェクトによって変形されるオブジェクトのリストに追加されます。照会すると string string string ...を返します。
geometryIndices(gi) boolean query
照会モードで -geometry フラグを補完します。各ジオメトリのマルチ インデックスを返します。
ignoreSelected(ignoreSelected) boolean create
現在のセレクション リスト上のオブジェクトを変形しないようにコマンドに指示します。
includeHiddenSelections(ihs) boolean create
セレクション リスト内の任意の表示および非表示オブジェクトにデフォーマを適用します。既定は false です。
matchChoice(mch) uint createedit
トポロジのコンポーネントを一致する際に使用すると、一致候補から最良の一致を選択します。転送操作に関わるメッシュに対称のトポロジがある場合は、複数のトポロジの一致がある場合があります。メッシュのシェイプを比較して一致候補にスコアが付けられ、ゼロから始まるインデックスが割り当てられます。通常、(既定の)ゼロを一致させることが最良ですが、Maya が誤って選択する場合を考慮して値を変更することで、その他の一致を確認することができます。
name(n) string create
作成されるノードの名前を指定するために使用されます。
parallel(par) boolean createedit
オブジェクトのヒストリの既存のデフォーマに平行するチェーンの新規デフォーマを挿入します。blendShape を挿入して、平行の結果とブレンドします。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
prune(pr) boolean edit
現在の設定のデフォーマによって変形されないポイントをデフォーマ セットから除去します。
remove(rm) boolean editmultiuse
-g フラグの後ろにリストされているオブジェクトをこのデフォーマから除去するように指定します。
sampleSpace(spa) uint createedit
アトリビュートの転送を実行する空間を選択します。0 はワールド空間、1 はモデル空間、4 はコンポーネント ベース、5 はトポロジ ベースです。既定はワールド空間です。
searchMethod(sm) uint createedit
ポイントを相関させるときに使用する検索方法を指定します。0 は法線に沿った最近接、3 はポイントに最近接を意味します。既定はポイントに最近接です。
searchScaleX(ssx) float createedit
データの転送前にターゲット モデルの X 軸に適用するオプション スケールを指定します。値が 1.0 (既定)の場合、スケーリングは行いません。値が -1.0 の場合、X 軸に沿ってミラーリングを行います。
searchScaleY(ssy) float createedit
データの転送前にターゲット モデルの Y 軸に適用するオプション スケールを指定します。値が 1.0 (既定)の場合、スケーリングは行いません。値が -1.0 の場合、Y 軸に沿ってミラーリングを行います。
searchScaleZ(ssz) float createedit
データの転送前にターゲット モデルの Z 軸に適用するオプション スケールを指定します。値が 1.0 (既定)の場合、スケーリングは行いません。値が -1.0 の場合、Z 軸に沿ってミラーリングを行います。
selectedComponents(cms) boolean query
現在選択されているデフォーマで使用されているコンポーネントを返します。これは、現在の選択項目とデフォーマの影響を受けるコンポーネントを交差させます。
sourceColorSet(scs) string create
ターゲットに転送するソース サーフェス上の単一のカラー セットの名前を指定します。この値は、単一のカラー セットを転送するように操作を設定している場合だけ使用します(transferColors フラグを参照)。
sourceUvSet(suv) string create
ターゲットに転送するソース サーフェス上の単一の UV セットの名前を指定します。この値は、単一の UV セットを転送するように操作を設定している場合だけ使用します(transferUVs フラグを参照)。
sourceUvSpace(sus) string create
転送空間として使用するソース サーフェス上の UV セットの名前を指定します。この値は、UV 空間でアトリビュートを転送するように操作を設定している場合だけ使用します。
split(sp) boolean createedit
デフォーマを既存のチェーンに挿入/アペンドする代わりに、ディペンデンシー グラフで新しいチェーンを分岐させます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
targetColorSet(tcs) string create
サンプリングしたカラー データを受信するターゲット サーフェス上の単一のカラー セットの名前を指定します。この値は、単一のカラー セットを転送するように操作を設定している場合だけ使用します(transferColors フラグを参照)。
targetUvSet(tuv) string create
サンプリングした UV データを受信するターゲット サーフェス上の単一の UV セットの名前を指定します。この値は、単一の UV セットを転送するように操作を設定している場合だけ使用します(transferUVs フラグを参照)。
targetUvSpace(tus) string create
転送空間として使用するターゲット サーフェス上の UV セットの名前を指定します。この値は、UV 空間でアトリビュートを転送するように操作を設定している場合だけ使用します。
transferColors(col) uint createedit
カラー セットの転送をコントロールします。0 の場合は、カラー セットを転送しません。1 の場合は、(sourceColorSet と targetColorSet で指定した)単一の カラー セットを転送します。2 の場合は、すべてのカラー セットを転送します。
transferNormals(nml) uint createedit
ゼロ以外の値は、頂点法線をサンプリングし、ターゲット サーフェス上のユーザ法線に書き込むことを示します。
transferPositions(pos) uint createedit
ゼロ以外の値は、頂点の位置をサンプリングすることを示します。この場合、ターゲット サーフェスがソース サーフェスに「ラップ」されます。
transferUVs(uvs) uint createedit
UV セットの転送をコントロールします。0 の場合は、UV セットを転送しません。1 の場合は、(sourceUVSet と targetUVSet で指定した)単一の UV セットを転送します。2 の場合は、すべての UV セットを転送します。
useComponentTags(uct) boolean create
このフラグを指定すると、componentTags を使用した設定が作成されます。つまり、groupId、groupParts、tweak、または objectSet ノードは作成されず、新しいデフォーマに接続されません。

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

Python 例

import maya.cmds as cmds

# Transfer all UV and color sets from pCube1 onto pSphere1
cmds.transferAttributes( 'pCube1', 'pSphere1', transferUVs=2, transferColors=2 )