surfaceSampler

移動先: 概要 戻り値 関連項目. フラグ. Python 例.

概要

surfaceSampler([camera=name], [fileFormat=string], [filename=string], [filterSize=float], [filterType=uint], [flipU=boolean], [flipV=boolean], [ignoreMirroredFaces=boolean], [ignoreTransforms=boolean], [mapHeight=uint], [mapMaterials=boolean], [mapOutput=string], [mapSpace=string], [mapWidth=uint], [maxSearchDistance=linear], [maximumValue=linear], [overscan=uint], [searchCage=string], [searchMethod=uint], [searchOffset=linear], [shadows=boolean], [source=string], [sourceUVSpace=string], [superSampling=uint], [target=string], [targetUVSpace=string], [useGeometryNormals=boolean], [uvSet=string])

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

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

戻り値

なし

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
source(s)	string
サンプリング ソースとして使用するサーフェスを指定します。
target(t)	string
出力情報をサンプリングするサーフェスを指定します。
uvSet(uv)	string
出力マップを作成する時に使用する UV セットの名前です。 このフラグを含む場合は、すべてのターゲットに 1 度は含める必要があります。
searchCage(sc)	string
ソース サーフェスを検索するときのガイドとして使用する、 検索エンベロープ サーフェスを指定します。 このフラグを含む場合は、すべてのターゲットに 1 度は含める必要があります。
searchOffset(so)	linear
ソース サーフェスを検索するときのスタート ポイントとして使用する、 固定オフセットをターゲット サーフェスから指定します。この値は、 所定のターゲットに検索ケージが指定されていない場合のみ使用します。 このフラグを含む場合は、すべてのターゲットに 1 度は含める必要があります。
maxSearchDistance(msd)	linear
ソース サーフェスを検索するターゲット サーフェスからの 最大距離を制御します。値「0」は、無制限を示します。 生成したマップにオブジェクトの反対側のアーティファクトが含まれる場合は、 この値をオブジェクトの半径とほぼ同じ距離に設定してください。 このフラグを含む場合は、すべてのターゲットに 1 度は含める必要があります。
mapOutput(mo)	string
作成する新しい出力マップを指定します。「normal」、「displacement」、「diffuseRGB」、「litAndShadedRGB」、「alpha」 のいずれかです。
mapWidth(mw)	uint
生成したマップのピクセル幅です。出力イメージ フォーマットによっては、等倍または 2 乗のピクセル幅が必要です。 これは出力マップを指定するたびに 1 度は含める必要があります。
mapHeight(mh)	uint
生成したマップのピクセル幅です。これは出力マップを指定するたびに 1 度は含める必要があります。
filename(fn)	string
マップを作成する時に使用するファイル名です。 これは出力マップを指定するたびに 1 度は含める必要があります。
fileFormat(ff)	string
「dds」などのファイル拡張子で表すイメージ フォーマットです。 これは出力マップを指定するたびに 1 度は含める必要があります。
mapSpace(sp)	string
マップを生成する空間です。有効なキーワードは「object」です。デフォルトは接線空間です。 これは出力マップを指定するたびに 1 度は含める必要があります。
maximumValue(max)	linear
マップに含むことができる最大値です。これによって、ディスプレイスメントなどの浮動小数点の値が 整数イメージ フォーマットに量子化される方法をコントロールすることができます。
mapMaterials(mm)	boolean
必要に応じて（法線マップなどの場合）、マップ アトリビュートをサンプリングするときに マテリアルを含めるかどうかを制御します。 これは出力マップを指定するたびに 1 度は含める必要があります。
shadows(sh)	boolean
必要に応じて（ライティングおよびシェーディングなどの場合）、計算に シャドウを含めるかどうかを制御します。現在はデプス マップ シャドウのみがサポートされています。
ignoreMirroredFaces(imf)	boolean
反転した（ミラーされた）フェースがマップの生成に寄与しなくなります。
searchMethod(sm)	uint
ターゲット サーフェスのサンプリング ポイントとソースのポイントを 一致させるために使用する検索手法を制御します。0 はエンベロープに最も近く、 1 はエンベロープの外側の交差よりも内側の交差を優先し、 2 はエンベロープの内側の交差のみ使用します。
ignoreTransforms(it)	boolean
トランスフォームを使用する（ワールド空間で検索を実行する）か、または使用しない （オブジェクト空間で検索を実行する）かを制御します。
sourceUVSpace(sus)	string
サーフェス間のデータ転送を UV 空間内で行うことを指定し、 転送空間として使用するソース サーフェス上の UV セットの名前を指定します。
targetUVSpace(tus)	string
サーフェス間のデータ転送を UV 空間内で行うことを指定し、 転送空間として使用するターゲット サーフェス上の UV セットの名前を指定します。
useGeometryNormals(ugn)	boolean
サーフェスの検索にジオメトリ法線とサーフェス法線のどちらを使用するかを制御します。 ジオメトリ法線を使用すると確実に滑らかなマッピングになりますが、ソース/ターゲット サーフェス間の 距離が開いている場合は、歪んだマッピングになる可能性があります。 サーフェス法線を使用すると、マッピングが重なったり途切れたりする可能性がありますが、 マッピングをサーフェス法線の方向に歪ませることができます。
camera(cam)	name
スペキュラ ハイライトまたは反射のような、カメラの特定のライティングの計算に使用する カメラを指定します。
superSampling(ss)	uint
各出力値向用に計算されたサンプリング ポイントの数を制御します。このアルゴリズムでは 各ポイントに 2 の n乗の 2乗のサンプルを使用します（値が 0 の場合は単一のサンプルを使用し、値が 3 の場合は各ポイントに 64 のサンプルという計算です）。
filterSize(fs)	float
フィルタ サイズ（ピクセルで表示）です。2.0 を超えるような大きな値ではより滑らかでソフトになり、 1.0 に近い値ではよりシャープになります。
filterType(ft)	uint
使用するフィルタ タイプです。0 は Gaussian フィルタ、1 は三角形のフィルタ、2 はボックス フィルタです。
overscan(os)	uint
UV 境界の周囲をレンダーするための追加のピクセル数です。 これは UV の継ぎ目のテクセル フィルタリング アーティファクトを 最低限に抑えるのに役立ちます。テクスチャに Mipmap を生成する場合は、filterSize を 1 より大きくして、 さらに値を大きくする必要があることがあります。
flipU(fu)	boolean
生成されたイメージの U 座標をフリップします。
flipV(fv)	boolean
生成されたイメージの V 座標をフリップします。

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

Python 例

import maya.cmds as cmds

# Generate an object space normal map of a cube onto a sphere called test.dds
cmds.surfaceSampler( mapOutput='normal', filename='C:/test', fileFormat='dds', source='pCube1', target='pSphere1', uv='map1' )