convertSolidTx command

概要

convertSolidTx [-alpha boolean] [-antiAlias boolean] [-backgroundColor int int int] [-backgroundMode string] [-camera name] [-componentRange boolean] [-doubleSided boolean] [-fileFormat string] [-fileImageName string] [-fillTextureSeams boolean] [-force boolean] [-fullUvRange] [-name string] [-pixelFormat string] [-resolutionX int] [-resolutionY int] [-reuseDepthMap boolean] [-samplePlane boolean] [-samplePlaneRange float float float float] [-shadows boolean] [-uvBBoxIntersect boolean] [-uvRange float float float float] [-uvSetName string] [node|attribute] [object...]

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

サーフェスのテクスチャをファイルテクスチャに変換するコマンド。最初の引数はレンダリングノードまたはアトリビュートです。ノードのみが指定された場合、outColor アトリビュートがサンプリングされます。ノードに outColor アトリビュートがない場合は、ノードの最初のアトリビュートが使用されます。ノードは、読み取りはできるが書き込みはできず、隠しノードではなく、接続可能で多色の縞模様ではないものです。ライティングをベイク処理する場合、シェーディンググループをテクスチャとして指定する必要があります。テクスチャやサーフェスを指定していない場合は、現在の選択範囲が使用されます。各オブジェクトのイメージファイルが生成され、プロジェクトのイメージセグメントに格納されます。ファイル名のフォーマットは、テクスチャ名とサーフェス名を次のように使用したものです。

{texture}-{surface}.{fileExtension} ただし、force がオフで、かつ名前の衝突がある場合、バージョン番号が調べられ、ファイル名が次のようにフォーマットされます。

{texture}-{surface}.{version}.{fileExtension} uv/uvsetName オプションを指定した場合、ファイル名には {surface} の代わりに {surface}-{uvname} が含まれます。

戻り値

string[]

ファイルテクスチャノード

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

フラグ

alpha, antiAlias, backgroundColor, backgroundMode, camera, componentRange, doubleSided, fileFormat, fileImageName, fillTextureSeams, force, fullUvRange, name, pixelFormat, resolutionX, resolutionY, reuseDepthMap, samplePlane, samplePlaneRange, shadows, uvBBoxIntersect, uvRange, uvSetName

ロングネーム(ショートネーム) 引数タイプ プロパティ

-antiAlias(-aa) boolean

作成されたイメージでアンチエイリアシングを行います。ソリッドテクスチャを変換すると、アンチエイリアシングなしに比べて、通常 4 倍の時間がかかります。既定ではこのフラグはオフです。

-alpha(-al) boolean

ライティングをベイク処理する際に透明度を計算するかどうかを指定します。変換では、シェーディングネットワークのカラーと透明度の両方がサンプリングされます。ファイルテクスチャのアルファチャネルは、透明度のサンプリング結果に合わせて設定されます。既定では透明度は計算されません。

-camera(-cam) name

ライティングのベイク処理で使用するカメラを指定します。カメラを指定していない場合は、アクティブなビューのカメラが使用されます。

-componentRange(-cr) boolean

1 つまたは複数のコンポーネントを使用するように選択し、このフラグを設定している場合、コンポーネントの uv 範囲を使用してテクスチャマップの解像度に合わせられます。既定ではこのフラグは false に設定されています。

-doubleSided(-ds) boolean

サンプルポイントがカメラと逆の位置にある場合、サンプラがサーフェス法線を反転するかどうかを指定します。注: 法線を反転すると、カメラによって結果が異なります（つまり、同じ場所でも法線を反転するカメラと反転しないカメラがあります）。doubleSided をシャドウと組み合わせて使用することはお勧めしません。既定ではこのフラグは false です。

-force(-f) boolean

出力イメージがすでに存在している場合は、上書きされます。既定ではこのフラグはオフです。

-fileFormat(-fil) string

出力に使用されるファイルフォーマット。指定しない場合は、IFF が既定設定です。その他の有効なフォーマットは、次のとおりです。

als:Alias PIX
cin:Cineon
eps:EPS
gif:GIF
iff:Maya IFF
jpg:JPEG
yuv:Quantel
rla:Wavefront RLA
sgi:SGI
si:SoftImage (.pic)
tga:Targa
tif:TIFF
bmp:Windows Bitmap

-fileImageName(-fin) string

ファイルテクスチャイメージの出力パスと名前を指定します。ファイル名にディレクトリセパレータが含まれない場合、イメージは現在のプロジェクトのソースイメージに書き込まれます。ファイルがすでに存在するとき、バージョン設定は行われません。

-fullUvRange(-fur)

サーフェスの UV 範囲全体を使用してサンプリングします。このフラグは、-uvr フラグと同時には使用できません。2D テクスチャ配置ノードが作成され、ファイルテクスチャに接続されます。配置の移動と有効範囲が、サーフェスの UV 範囲全体に従って設定されます。

-name(-n) string

ファイルテクスチャノードの名前が設定されます。複数のオブジェクトを指定するときは、名前が衝突した場合の解決法を使用して有効な名前が決定されます。

-resolutionX(-rx) int

水平イメージ解像度を設定します。このフラグを指定しないと、解像度は 256 に設定されます。

-resolutionY(-ry) int

垂直イメージ解像度を設定します。このフラグを指定しないと、解像度は 256 に設定されます。

-shadows(-sh) boolean

ライティングをベイク処理する際にシャドウを計算するかどうかを指定します。ディスクベースのシャドウマップが使用されます。深度マップシャドウ付きのライトのみを有効にすると、シェーディングに役立ちます。既定ではシャドウは計算されません。

-samplePlane(-sp) boolean

バーチャルプレーンを使ってサンプリングするかどうかを指定します。このバーチャルプレーンでは、-samplePlaneRange フラグによって定義された長方形内にテクスチャ座標があります。-samplePlaneRange フラグが設定されない場合は、既定でバーチャルプレーンの(0,0)から(1,1)の正方形内にテクスチャ座標が設定されます。このオプションが設定されていると、すべての引数ベースのサーフェスは無視されます。

-samplePlaneRange(-spr) float float float float

-samplePlane オプションが設定されている場合に、サンプリングに使用するテクスチャ座標の UV 範囲を指定します。uMin、uMax、vMin、vMax に対応する 4 つの引数があります。既定でバーチャルプレーンは、uMin 0 から uMax 1 と vMin 0 から vMax 1 になります。

-uvBBoxIntersect(-ubi) boolean

このフラグは現在サポートしていません。

-backgroundMode(-bm) string

テクスチャのバックグラウンドを塗りつぶす方法を定義します。次の 3 つのモードが利用できます:
「shader」または1: 既定のシェーダカラーを使用します。
「color」または2:-backgroundColor フラグで指定したカラーを使用します。
「extend」または3:継ぎ目のエッジのカラーを外側に拡大します。
既定は「shader」です。

-backgroundColor(-bc) int int int

バックグラウンドカラーを特定の値に設定します。既定では、シェーダの既定のカラーを使ってバックグラウンドを塗り潰します。ピクセルフォーマットがチャネルあたり 8 ビットの場合、有効な値の範囲は 0～255 で、ピクセルフォーマットがチャネルあたり 16 ビットの場合、0～65535 です。このフラグは自動的に -backgroundMode を「color」に設定します。
既定は黒の 0 0 0.

-fillTextureSeams(-fts) boolean

ファイルテクスチャを作成するときに、テクスチャの継ぎ目を埋めるために外側のエッジを越えてポリゴンをオーバースキャンするかどうかを指定します。
既定は true です。

-reuseDepthMap(-rdm) boolean

作成されたすべての深度マップを再使用するかどうかを指定します。
既定は false です。

-uvSetName(-uv) string

ソリッド変換用のドライビングパラメータ設定として使用する必要がある UV 設定を指定します。

-uvRange(-uvr) float float float float

サンプルを計算する UV 範囲を指定します。uMin、uMax、vMin、vMax に対応する 4 つの引数があります。それぞれの値は、サーフェスの UV 空間に基づいて指定する必要があります。2D テクスチャ配置ノードが作成され、ファイルテクスチャに接続されます。配置のフレームの移動と有効範囲が指定した UV 範囲に従って設定されます。既定ではサーフェスの UV 範囲全体が使用されます。

-pixelFormat(-pf) string

イメージのピクセルフォーマットを指定します。すべてのファイルフォーマットですべてのピクセルフォーマットをサポートしていないことに注意してください。有効なオプション:
「8」: チャネルあたり 8 ビット、符号なし(0～255)
「16」: チャネルあたり 16 ビット、符号なし(0～65535)
既定は「8」です。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

file -f -new;
// Create a blinn shader with a marble texture.
shadingNode -asShader blinn;
sets -renderable true -noSurfaceShader true -empty -name "blinn1SG";
connectAttr -f blinn1.outColor blinn1SG.surfaceShader;
shadingNode -asTexture marble;
connectAttr -f marble1.outColor blinn1.color;
// Create two objects, and assign the blinn shader to them.
polySphere;
sets -e -forceElement blinn1SG;
polyPlane; move 2 0 0;
sets -e -forceElement blinn1SG;
// Create a low resolution texture for the sphere
convertSolidTx -rx 64 -ry 64 marble1 pSphere1;
// Create a transparency texture forthe plane.
convertSolidTx marble1.outAlpha pPlane1;
// Create a texture named myTexture.iff for the sphere.
convertSolidTx -bm "extend" -fileImageName "myTexture.iff" marble1 pSphere1;

コマンド (MEL)	Python バージョン
convertSolidTx	カテゴリ内: レンダリング