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 は、取り消し可能、照会不可能、および編集不可能です。

戻り値

なし

関連

フラグ

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

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

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' )