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

概要

Mayatomr [-active] [-addHosts string] [-addIncludes string] [-addLinks string] [-binary] [-camera string] [-echo] [-exportFilter int] [-exportFilterString string] [-exportPathNames string] [-exportStartFile] [-file string] [-fragmentChildDag] [-fragmentExport] [-fragmentIncomingShdrs] [-fragmentMaterials] [-immediateModeRender boolean] [-init] [-layer string] [-license string] [-listHosts] [-listLinks] [-logFile] [-miStream] [-padframe uint] [-pauseTuning boolean] [-perframe uint] [-preview] [-previousView] [-project string] [-region] [-regionRect uint uint uint uint] [-removeHosts string] [-removeLinks string] [-render] [-renderNoSlaves] [-renderTarget string] [-renderThreads uint] [-renderVerbosity uint] [-tabstop uint] [-updateHosts] [-updateRayrc] [-verbosity uint] [-xResolution uint] [-yResolution uint]

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

この MEL コマンドを使えば、.mi ファイルの書き出し、プレビューとバッチ レンダリング、ネットワーク レンダリング、シェーダ管理など、mental ray for maya プラグインのほとんどの機能にアクセスできます。

戻り値

Any戻り値はフラグによって異なります。

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

関連

convertLightmap

フラグ

active, addHosts, addIncludes, addLinks, binary, camera, echo, exportFilter, exportFilterString, exportPathNames, exportStartFile, file, fragmentChildDag, fragmentExport, fragmentIncomingShdrs, fragmentMaterials, immediateModeRender, init, layer, license, listHosts, listLinks, logFile, miStream, padframe, pauseTuning, perframe, preview, previousView, project, region, regionRect, removeHosts, removeLinks, render, renderNoSlaves, renderTarget, renderThreads, renderVerbosity, tabstop, updateHosts, updateRayrc, verbosity, xResolution, yResolution
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
mental ray IPR フラグ
-immediateModeRender(-imr) boolean createquery
インタラクティブ レンダーのみ。mental ray 即時モード レンダーの開始／停止(IPR)。pt/pauseTuning、rg/region、rr/regionRect を後に付けることができます。照会フラグ q/query とともに指定すると、mental ray IPR が実行されている場合は true (真)、されていない場合は false を返します。mental ray IPR がオンの場合のみ、オプションのサブセットが有効になります。
-pauseTuning(-pt) boolean createquery
imr/immediateModeRender と一緒に使用します。mental ray IPR を一時停止/再開します。一時停止しても、アトリビュートを変更すると内部データベースは更新されます。
汎用フラグ
-active(-a) create
最終シーンを作成するために、アクティブなシーンの要素だけを移動します。これは、これらのオブジェクトが参照するすべてのシェーディング ノード、すべてのライトとレンダー カメラとともに、選択したジオメトリ含みます。これにより、必ずレンダリング可能なシーンが確実に生成されます。このモードは書き出しフィルタと結合することができます。
既定: シーン全体を移動
-addIncludes(-ai) string create
インタラクティブに指定した .mi ファイルを含めます。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。
内部使用限定。
-addLinks(-al) string create
インタラクティブに指定したシェーダ ライブラリをリンクします。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。
内部使用限定。
-fragmentChildDag(-fcd) create
フラグメント モードでは、現在の選択にあるトランスフォーム ノードの子の DAG グラフをすべて追加で移動します。
既定: 選択したオブジェクト/インスタンスだけを移動
-fragmentExport(-fe) create
フラグメント .mi ファイルの書き出しを有効にします。これにより、サポートしているあらゆるタイプの選択ノードが移動されます。さらにオプションを追加すれば、移動を拡張して関連するノードや接続されたノードも考慮に入れることができます。詳細は以下を参照してください。このモードにより、目的の情報だけを含む .mi ファイルを作成できます。これは通常はレンダーできない .mi ファイルになります。ジオメトリック オブジェクトの場合は、シェイプ ノードまたはその親トランスフォームが選択されているかどうかにかかわらず、必ずオブジェクトとそのインスタンスの両方が書き出しされることに注意してください。
既定: シーン全体を移動
-fragmentIncomingShdrs(-fis) create
フラグメント モードでは、現在の選択(ドライビング ノード)にあるノードに接続されたシェーディング ノードを追加で移動します。
既定: 接続を無視
-fragmentMaterials(-fem) create
フラグメント モードでは、現在の選択にあるシェイプ/トランスフォームのアタッチされたマテリアルを追加で移動します。
既定: アタッチされたマテリアルを無視
-init(-ini) create
起動ファイルのロードとカスタム リンクの再実行を含めて、統合レンダラで初期化ステップを再度実行し、コマンドを含めます。
内部使用限定。
-listLinks(-ll) create
現在リンクしているシェーダ ライブラリをリスト表示します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。
内部使用限定。
-project(-prj) string create
プラグインに使用されるプロジェクトのルート ディレクトリを設定します。これは、テクスチャのように、完全なファイル パスを使わずにプロジェクトのサブディレクトリ内のファイルを参照する場合だけでなく、既定の出力ディレクトリにも影響します。
既定: ファイル書き出し用は none、プレビュー用は既定のプロジェクト ディレクトリ
-removeLinks(-rl) string create
インタラクティブに指定したシェーダ ライブラリをリンク解除します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。
内部使用限定。
-renderVerbosity(-rv) uint create
mental ray メッセージの冗長レベルを設定します。値の範囲は 0～6 で、冗長レベルはそれぞれ none、fatal、error、warning、info、progress と details に設定されます。
既定: レンダー グローバル設定(warning レベル)
-updateRayrc(-ur) create
maya.rayrc ファイルをリロードし、mental ray を再初期化します。
内部使用限定。
-verbosity(-v) uint create
プラグイン メッセージの冗長レベルを設定します。値の範囲は 0～6 で、冗長レベルはそれぞれ none、fatal、error、warning、info、progress と details に設定されます。
既定: レンダー グローバル設定(warning レベル)
書き出しフラグ
-binary(-bin) create
バイナリ .mi フォーマット(オブジェクト定義にバイナリ ベクトルを書く)を書き出します。
既定: off (ascii フォーマットを書く)
-echo(-e) create
シーン データをビルドイン mental ray に送り、エコー コマンドを実行して、.mi ファイルにシーンを書き出します。
既定:オフ
-exportFilter(-xf) int create
これにより、書き出した .mi ファイルから、特定のタイプの mental ray エントリを除去することができます。この int 型引数はビット セットで、各ビットは単一のフィルタ エントリを表します。
以下は全リストです。
値 pos 値
FilterLink 0 1
FilterInclude 1 2
FilterVersion 2 4
FilterTextures 3 8
FilterObject 4 16
FilterGroup 5 32
FilterLight 6 64
FilterCamera 7 128
FilterMaterial 8 256
FilterOptions 9 512
FilterFunction 10 1024
FilterFuncDecl 11 2048
FilterPhenDecl 12 4096
FilterUserData 13 8192
FilterInstObject 14 16384
FilterInstGroup 15 32768
FilterInstLight 16 65536
FilterInstCamera 17 131072
FilterInstFunction 18 262144
FilterRender 19 524288
FilterCustomText 20 1048576
FilterCustomShader 21 2097152
FilterCustomPhen 22 4194304

このリストの整数値で、パターンのビット位置が定義されます。MEL はビットのシフト操作はできませんが、代わりにコマンド: 最終的な整数値を計算するには、
pow 2 pos
を使用します。あらゆる組み合わせのフィルタ入力をサポートしていますが、最終的なフィルタ整数は個々の値の合計となります。例: 'link' と 'include' ステートメントを記述しない(除外する)ためには、
Mayatomr -mi -file fileName -exportFilter 3 を使用します。
便利な MEL 関数 miExportFilterValue(string $entries[])を使用すると、「link」、「include」など、与えられた説明的タイプ名に基づいて最終的な整数引数を計算することが可能です。サポートされているタイプ名のリストは、mentalrayUI.mel ファイルで確認できます。
既定: フラグなし
-exportFilterString(-xfs) string create
文字列引数を使用して書き出しフィルタを設定します。文字列のすべての文字は上記パターンの対応するビット位置をマークしています。
既定: フラグなし
-exportPathNames(-xp) string
ファイル リファレンスの書き出しオプションには、関連ライブラリ、インクルード mi ファイル、テクスチャ ファイル、ライト マップなどがあります。

すべてのファイル リファレンスを強制的に同じにするには、値
abs - absolute、rel - relative、non - nopath を使用します。
また、代わりに、文字列で個々のファイル リファレンスを指定することもできます。このとき、文字列の各文字は 1 つのファイル リファレンス エントリを表します。
ここで、0 - nochange、1 - absolute、2 - relative、3 - nopath、または 0 - nochange、a - absolute、r - relative、n - nopath を意味します。
ファイル リファレンス エントリは、次の順序で指定します。
関連ライブラリ、インクルード mi ファイル、テクスチャ ファイル、ライト マップ、ライト プロファイル、出力イメージ、シャドウ マップ、ファイナル ギャザー マップ、フォトン マップ、デマンド ロード オブジェクトの mi ファイル
既定: nochange
たとえば、「-xp aarrararra」では関連ライブラリ、インクルード ファイル、ライト プロファイル、シャドウ マップ、デマンド ロード オブジェクト mi ファイルについては絶対パスが、テクスチャ ファイル、ライト マップ、出力イメージ、ファイナル ギャザー マップ、フォトン マップについては相対パスが使用されます。個々のファイル リファレンス文字列が完全に指定されていない場合、最後のキャラクタが残りすべてのファイル リファレンスに対して指定されているものとみなされます。したがって、たとえば、「-xp aarra」と「-xp aarraaaaaa」と同じです。
-exportStartFile(-xsf) create
現在使用している起動ファイル maya.rayrc を含めて、.mi ファイルに書き出します。この場合は、シーン ファイル内から(カスタム テキストを介して)起動ファイルのステートメントを再度指定する必要がありません。
既定:オフ
-file(-f) string create
.mi export または .mi echo のファイル名とパスを設定します。
既定: タイトルなし
-miStream(-mi) create
シーンを .mi ファイルに書き出します。
既定:オフ
-padframe(-pad) uint create
フレーム番号のパディング(固定長のフィールド幅)を設定します。これはフレームごとに .mi ファイルにアニメーションを書き出す場合に、ファイル名の拡張子を生成するために使用します。
既定: 0、パディングなし
-perframe(-pf) uint create
フレームごとの .mi ファイルのアニメーションの書き出しを制御します。サポートされている値は、0 (アニメーション全体を含む 1 つの .mi ファイルで、差分変更を使用)と 0 より大きい値(フレームごとに 1 つの .mi ファイルを書き出し、差分変更を使用しない)では、次の異なる名前付けスキームを使用します: 1 (name.ext.#)、2 (name.#.ext)、3 (name.#)。
既定: 0
-tabstop(-tab) uint create
.mi ファイルで行をインデントするために使用するスペース文字数を設定します。
既定: 4
レンダリング フラグ
-addHosts(-ah) string create
ホスト リストに特定のマシン名を追加します(特定のホストをアタッチ)。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
-camera(-cam) string create
このカメラをプレビュー レンダリングのレンダー カメラとして使用します。カメラのシェイプ名が求められます。
既定: render globals カメラ
-layer(-l) string create
指定したレンダー レイヤをレンダーします。レンダー レイヤのレンダリング可能なアトリビュート値にかかわらず、このレンダー レイヤのみをレンダーします。レイヤ名は出力イメージ ファイル名にアペンドされます。指定したレンダー レイヤは、レンダリング前に現在のレンダー レイヤになり、レンダリング後も現在のレンダー レイヤのままです。
-license(-lic) string create
このフラグは現在サポートしていません。
-listHosts(-lh) create
ホスト リストにマシン名をリスト表示します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
-logFile(-log) create
現在のディレクトリにある 'mentalray.log' というファイルに、mental ray レンダー メッセージを書き込みます。このメッセージはさらに、出力ウィンドウまたは親シェル ウィンドウにも書き込まれます。
-preview(-pv) create
統合された mental ray でプレビュー レンダーを実行します。インタラクティブ レンダリングの場合のみ(バッチ レンダリングの場合はなし)(バッチ レンダリングでは使用しません) r/render と同時には指定できません。
既定:オフ
-previousView(-prv) create
同じコマンドラインで明らかなカメラ指定がなければ、プレビュー レンダリング用として以前実行したレンダー カメラを使用します。
既定: シーン内で最初に見つかったレンダリング可能なカメラ
-region(-rg) create
Maya レンダー ウィンドウの現在の長方形の範囲だけをプレビュー レンダーします。
既定: イメージ全体をレンダー
-regionRect(-rr) uint uint uint uint create
範囲が有効であれば、これによりプレビュー レンダーするカスタムの長方形の範囲が設定されます。4 つの整数値は、左、下、右、上の境界をこの順番で指定します。
既定: ウィンドウ範囲をレンダー
-removeHosts(-rh) string create
ホスト リストから特定のマシン名を除去します(特定のホストをデタッチ)。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
-render(-r) create
統合された mental ray を使用して、バッチ モードでレンダリングを実行します。バッチ レンダリングの場合のみ(インタラクティブ レンダリングでは使用しません) pv/preview と同時には指定できません。
-renderNoSlaves(-rns) create
これを指定すると、ほとんどすべてをマスタ マシン(Maya を実行しているマシン)上でレンダーできるため、スレーブ マシンの負荷を軽減することができます。
-renderTarget(-rtg) string create
指定したレンダー ターゲットをレンダーします。このフラグが設定されている場合、mental ray はシーンをレンダーしません。代わりに、ターゲット文字列で指定したノードの下流にある画像処理グラフをレンダーします。このフラグの目的は、合成や一般的な画像処理タスクに mental ray を利用することです。FLAGHEADER ネットワーク レンダリング フラグで、ほかのレンダリング フラグと一緒に使用。FLAG renderNoMaster rnm CREATE NO_QUERY NO_EDIT NO_MULTI COMMENT これを指定すると、ほとんどすべてをスレーブ マシン上でレンダーできるため、マスタ マシン(Maya を実行しているマシン)の負荷を軽減することができます。
-renderThreads(-rt) uint create
これにより、現在のレンダーの mental ray で使用するレンダー スレッドの数を減らすことができます。使用可能な値は 1～4 です。
既定: 4
-updateHosts(-uh) create
maya.rayhosts ファイルをリロードし、ホスト マシン(スレーブ マシン)のリストを適宜更新します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
-xResolution(-x) uint create
プレビュー レンダー用に、出力イメージの x 解像度を設定します。
既定: レンダー グローバル(Render Globals)のイメージの幅
-yResolution(-y) uint create
プレビュー レンダー用に、出力イメージの y 解像度を設定します。
既定: レンダー グローバル(Render Globals)のイメージの高さ
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// Render the lower left corner of the image to the render view with
// progress messages. persp camera is used to render the image.
Mayatomr -preview -v 5 -region -rr 0 0 300 300 -camera perspShape;

// Batch render occlusionLayer with occlusionCamera, with 1k square
// resolution.
Mayatomr -render -layer occlusionLayer -xResolution 1024 -yResolution 1024;

// Export the scene to test.mi file with tabstop value 8.
// Texture files exported with absolute path, and all other file entries
// are exported with no path.
Mayatomr -mi -tabstop 8 -xp "3313333333" -file "test.mi";