transferAttributes

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

概要

transferAttributes( object object , [colorBorders=uint], [flipUVs=uint], [matchChoice=uint], [sampleSpace=uint], [searchMethod=uint], [searchScaleX=float], [searchScaleY=float], [searchScaleZ=float], [sourceColorSet=string], [sourceUvSet=string], [sourceUvSpace=string], [targetColorSet=string], [targetUvSet=string], [targetUvSpace=string], [transferColors=uint], [transferNormals=uint], [transferPositions=uint], [transferUVs=uint])

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

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

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
transferPositions(pos)	uint
ゼロ以外の値は、頂点の位置をサンプリングすることを示します。この場合、ターゲット サーフェスがソース サーフェスに「ラップ」されます。
transferNormals(nml)	uint
ゼロ以外の値は、頂点法線をサンプリングし、ターゲット サーフェス上のユーザ法線に書き込むことを示します。
transferUVs(uvs)	uint
UV セットの転送をコントロールします。0 の場合は、UV セットを転送しません。1 の場合は、(sourceUVSet と targetUVSet で指定した)単一の UV セットを転送します。2 の場合は、すべての UV セットを転送します。
sourceUvSet(suv)	string
ターゲットに転送するソース サーフェス上の単一の UV セットの名前を指定します。この値は、単一の UV セットを転送するように操作を設定している場合だけ使用します(transferUVs フラグを参照)。
targetUvSet(tuv)	string
サンプリングした UV データを受信するターゲット サーフェス上の単一の UV セットの名前を指定します。この値は、単一の UV セットを転送するように操作を設定している場合だけ使用します(transferUVs フラグを参照)。
transferColors(col)	uint
カラー セットの転送をコントロールします。0 の場合は、カラー セットを転送しません。1 の場合は、(sourceColorSet と targetColorSet で指定した)単一の カラー セットを転送します。2 の場合は、すべてのカラー セットを転送します。
sourceColorSet(scs)	string
ターゲットに転送するソース サーフェス上の単一のカラー セットの名前を指定します。この値は、単一のカラー セットを転送するように操作を設定している場合だけ使用します(transferColors フラグを参照)。
targetColorSet(tcs)	string
サンプリングしたカラー データを受信するターゲット サーフェス上の単一のカラー セットの名前を指定します。この値は、単一のカラー セットを転送するように操作を設定している場合だけ使用します(transferColors フラグを参照)。
searchScaleX(ssx)	float
データの転送前にターゲット モデルの X 軸に適用するオプション スケールを指定します。値が 1.0 (既定)の場合、スケーリングは行いません。値が -1.0 の場合、X 軸に沿ってミラーリングを行います。
searchScaleY(ssy)	float
データの転送前にターゲット モデルの Y 軸に適用するオプション スケールを指定します。値が 1.0 (既定)の場合、スケーリングは行いません。値が -1.0 の場合、Y 軸に沿ってミラーリングを行います。
searchScaleZ(ssz)	float
データの転送前にターゲット モデルの Z 軸に適用するオプション スケールを指定します。値が 1.0 (既定)の場合、スケーリングは行いません。値が -1.0 の場合、Z 軸に沿ってミラーリングを行います。
flipUVs(fuv)	uint
ターゲットに転送する前に、サンプリングした UV データを反転する方法をコントロールします。0 の場合、反転は行いません。1 の場合は、U 方向に UV データを反転します。2 の場合は、V 方向に UV データを反転します。3 の場合は、両方の方向に反転します。反転をミラーリングと組み合わせると、対称的な UV マッピングを作成できます(たとえば、UV マップの一方にキャラクタの左側、他方に右側をマッピングできます)。
colorBorders(clb)	uint
カラー データの転送時にカラー境界を保持するかどうかをコントロールします。ゼロ以外の場合、カラー境界はターゲット ジオメトリの最も近いエッジにマッピングされます。0 の場合、カラー境界はターゲット ジオメトリの頂点に滑らかにブレンドされます。
sampleSpace(spa)	uint
アトリビュートの転送を実行する空間を選択します。0 はワールド空間、1 はモデル空間、4 はコンポーネント ベース、5 はトポロジ ベースです。既定はワールド空間です。
searchMethod(sm)	uint
ポイントを相関させるときに使用する検索方法を指定します。0 は法線に沿った最近接、3 はポイントに最近接を意味します。既定はポイントに最近接です。
sourceUvSpace(sus)	string
転送空間として使用するソース サーフェス上の UV セットの名前を指定します。この値は、UV 空間でアトリビュートを転送するように操作を設定している場合だけ使用します。
targetUvSpace(tus)	string
転送空間として使用するターゲット サーフェス上の UV セットの名前を指定します。この値は、UV 空間でアトリビュートを転送するように操作を設定している場合だけ使用します。
matchChoice(mch)	uint
トポロジのコンポーネントを一致する際に使用すると、一致候補から最良の一致を選択します。転送操作に関わるメッシュに対称のトポロジがある場合は、複数のトポロジの一致がある場合があります。メッシュのシェイプを比較して一致候補にスコアが付けられ、ゼロから始まるインデックスが割り当てられます。通常、(既定の)ゼロを一致させることが最良ですが、Maya が誤って選択する場合を考慮して値を変更することで、その他の一致を確認することができます。

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

Python 例

import maya.cmds as cmds

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