ジャンプ先: 概要. 制限事項. 戻り値. 関連項目. フラグ. Python 例.
convertLightmap( string object [string
object ...] , [bakeSetDefault=string], [bakeSetOverride=string],
[camera=string], [exportPathNames=string],
[file=string], [help=boolean], [miStream=boolean], [notUndoable=boolean], [project=string], [separator=string], [shadows=boolean], [transferMapSpace=string],
[useLensBake=boolean],
[vertexMap=boolean])
注意:
オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
convertLightmap は 「元に戻す」が可能、「照会」が不可能、「編集」が不可能
です。
グローバル イルミネーションの計算は、高価で時間のかかるタスクであるため、リアルタイム レンダリングでは使用されません。
シーン内のライティングの状態が変化しなければ、事前にオブジェクト上の照明を計算してテクスチャ
マップや頂点カラーなどのしかるべきデータ構造に格納することができます。 そして、保存したデータをハードウェア レンダリングやゲーム
エンジンなどのリアルタイム アプリケーションに適用することができます。ライト マップ レンダリング機能を使えば、サーフェス
カラーやサーフェス ライティング（グローバル イルミネーションを含む）をオブジェクトごとのファイル
テクスチャと頂点ごとのカラー内にプリ レンダーすることができます。 さらに、このファイル テクスチャを正規のテクスチャ
マップとして使って、ソフトウェア レンダリングを高速化したり、事前計算したレンダリング エフェクトをハードウェア
レンダリングに適用したりすることができます。mental ray for Maya は、ベイク処理とプリライティングを実現するために
convertLightmap コマンドをサポートしています。指定したシェーディング
グループを指定したオブジェクト（のいくつかのコンポーネント）に割り当てる必要があります。 任意の数のシェーディング
グループとオブジェクトの組み合わせを指定することができます。 指定したオブジェクトは、1 つのシェイプ ノードの 1
つのインスタンスを固有的に識別する必要があります。
トランスフォーム名またはシェイプ名だけを指定した場合、このコマンドは最初の子供のシェイプまたはインスタンスの親を決定しようとします。
1 つのオブジェクトに複数のマテリアルが割り当てられるように（メッシュ
オブジェクト上のフェースごとの割り当て、複数のインスタンス化したシェイプ
ノード上のインスタンスごとの割り当て）ベイク処理する場合は、シェーディング グループごとに 1
つのオブジェクトの参照を提供する必要があります。 一方、1
つのマテリアルが複数のオブジェクトに適用されていた場合（マテリアルの共有）は、このシェーディング
グループをすべてのオブジェクトの数だけ指定する必要があります。コマンド
フラグに加えて、各オブジェクトのベイクセットを通してオブジェクトごとの設定が可能です。 オブジェクトにベイクセットがなく、-bo
フラグが指定されなかった場合は、ベイクセットのデフォルト設定が使用されます。 TextureBakeSet と
VertexBakeSet のノード リファレンスを参照してください。
ライト マップ レンダリングは、mental ray のレンダー グローバル（Render
Globals）に設定されているレンダー精度を使って実行されます。 特に、フォトン トレーシングとファイナル ギャザリングでは、ライト
マップの生成に必要なグローバル イルミネーションの計算を可能にする必要があります。
ただし、現在のバージョンでは以下のような制限事項が適用されます。
- モーション ブラーはライト マップに表示されない可能性があります
- ボリュームとフォグはライト マップでは認識されません
- アルファ チャンネルは常時、ファイル テクスチャにレンダーされます
| string[] |
このコマンドは、ベイク処理の組み合わせが指定されたのとまったく同じ長さの文字列値の配列を返します。返される文字列には、成功した場合のベイク処理されたオブジェクト名（テクスチャ
ファイルまたは頂点ベイク オブジェクトの名前）、または失敗した場合の文字列「error」が含まれます。 |
Mayatomr
bakeSetDefault, bakeSetOverride, camera, exportPathNames, file, help, miStream, notUndoable, project, separator,
shadows, transferMapSpace, useLensBake, vertexMap
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
help(h) |
boolean |
 |
|
|
vertexMap(vm) |
boolean |
|
|
頂点内に照明をベイク処理します。指定されない場合は、ライト マップ内にベイク処理します。 |
|
useLensBake(ulb) |
boolean |
|
|
レンズ シェーダを使用してレンズをオブジェクトに対してシェイプする、特殊なテクスチャ
ベイク処理モードです。-vertexMap
フラグと一緒に使用すると無効です。単一の大きなオブジェクトをベイク処理するのに最適です。 |
|
camera(cam) |
string |
|
|
入射光の方向を計算するときに使用するカメラを指定します。 デフォルト: カレントのレンダー カメラ |
|
shadows(sh) |
boolean |
|
|
シャドウを考慮します。 mental ray のレンダー グローバルでシャドウが無効になっている場合は、mental ray
for maya がシャドウ マップを有効にして、シャドウ メソッド セグメントがオンになります。 |
|
notUndoable(nun) |
boolean |
|
|
このパラメータを指定した場合は、このコマンドを元に戻すことができません。 |
|
project(prj) |
string |
|
|
プロジェクト ディレクトリを設定します。 ライト マップにベイク処理すると、プロジェクトの「lightMap」サブ
ディレクトリにライト マップが生成されます。 「lightMap」ディレクトリが存在しない場合は、このコマンドがライト
マップの書き込みに失敗します。 デフォルト: カレント プロジェクトのルート ディレクトリ |
|
separator(sep) |
string |
|
|
このパラメータが指定されると、ベイク処理でこの文字列が、複雑な DAG オブジェクト（複数のシェイプを持つ DAG
インスタンスまたは階層的な DAG
エントリ）の固有なファイル名を生成するときに、インスタンス名とシェイプ名を分離するために使用されます。 デフォルト:
セパレータなし |
|
bakeSetOverride(bo) |
string |
|
|
このパラメータを指定した場合は、指定したベイクセットが各オブジェクトのベイクセットの代わりに使用されます。 |
|
miStream(mi) |
boolean |
|
|
このパラメータを指定した場合は、このコマンドは、ライト マップ レンダリングのほかに、mental ray
スタンドアローンで使用できる mental ray ファイルを生成します。-f/-file フラグを指定する必要があります。 |
|
file(f) |
string |
|
|
生成する mental ray ファイルの絶対ファイル名を指定します。 -mi/-miStream
フラグを指定した場合にだけ有効です。 |
|
exportPathNames(xp) |
string |
|
|
ファイル リファレンスのエクスポート オプションには、関連ライブラリ、インクルード mi ファイル、テクスチャ
ファイル、ライト マップなどがあります。
文字列で個々のファイル リファレンスを指定できます。文字列の各文字は、1 つのファイル リファレンス エントリを表し、
0 - nochange、1 - absolute、2 - relative、3 - nopath、または
0 - nochange、a - absolute、r - relative、n - nopath を意味します。
ファイル リファレンス エントリは、次の順序で指定します。
関連ライブラリ、インクルード mi ファイル、テクスチャ ファイル、ライト マップ、ライト プロファイル、出力イメージ、シャドウ
マップ、ファイナル ギャザー マップ、フォトン マップ、デマンド ロード オブジェクトの mi ファイル -mi/-miStream
フラグを指定した場合にだけ有効です。
デフォルト: nochange
たとえば、「-xp aarrararra」では、関連ライブラリ、インクルード ファイル、ライトのプロファイル、シャドウ
マップ、デマンド ロード オブジェクト mi ファイルには絶対パス、テクスチャ ファイル、ライト マップ、出力イメージ、ファイナル
ギャザー マップ、フォトン マップには相対パスが使用されます。 |
|
transferMapSpace(ts) |
string |
|
|
マップの転送操作にのみ使用します。 マップ空間を指定します。「world」または「object」になります。デフォルト:
world |
|
bakeSetDefault(bd) |
string |
|
|
シーン内で他のベイク セットに割り当てられていないすべてのオブジェクトを含めるためのベイク セットを指定します。 |
|
| : コマンドの作成モードで使用可能なフラグ |
 : コマンドの編集モードで使用可能なフラグ |
 : コマンドの照会モードで使用可能なフラグ |
 : タプルまたはリストとして渡された複数の引数を持てるフラグ |
import maya.cmds as cmds
cmds.convertLightmap( 'initialShadingGroup', 'pPlane1', 'initialShadingGroup', 'pSphere1' )
cmds.convertLightmap( 'initialShadingGroup', 'pPlane1', 'initialShadingGroup', 'pSphere1', vm=True, bo='vertexBakeSet1' )