Mayatomr

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

概要

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

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
mental ray IPR フラグ
immediateModeRender(imr)	boolean
インタラクティブ レンダーのみ。mental ray 即時モード レンダーの開始／停止(IPR)。pt/pauseTuning、rg/region、rr/regionRect を後に付けることができます。照会フラグ q/query とともに指定すると、mental ray IPR が実行されている場合は true (真)、されていない場合は false を返します。mental ray IPR がオンの場合のみ、オプションのサブセットが有効になります。
pauseTuning(pt)	boolean
imr/immediateModeRender と一緒に使用します。mental ray IPR を一時停止/再開します。一時停止しても、アトリビュートを変更すると内部データベースは更新されます。
汎用フラグ
active(a)	boolean
最終シーンを作成するために、アクティブなシーンの要素だけを移動します。これは、これらのオブジェクトが参照するすべてのシェーディング ノード、すべてのライトとレンダー カメラとともに、選択したジオメトリ含みます。これにより、必ずレンダリング可能なシーンが確実に生成されます。このモードは書き出しフィルタと結合することができます。 既定: シーン全体を移動
addIncludes(ai)	string
インタラクティブに指定した .mi ファイルを含めます。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。 内部使用限定。
addLinks(al)	string
インタラクティブに指定したシェーダ ライブラリをリンクします。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。 内部使用限定。
fragmentChildDag(fcd)	boolean
フラグメント モードでは、現在の選択にあるトランスフォーム ノードの子の DAG グラフをすべて追加で移動します。 既定: 選択したオブジェクト/インスタンスだけを移動
fragmentExport(fe)	boolean
フラグメント .mi ファイルの書き出しを有効にします。これにより、サポートしているあらゆるタイプの選択ノードが移動されます。さらにオプションを追加すれば、移動を拡張して関連するノードや接続されたノードも考慮に入れることができます。詳細は以下を参照してください。このモードにより、目的の情報だけを含む .mi ファイルを作成できます。これは通常はレンダーできない .mi ファイルになります。ジオメトリック オブジェクトの場合は、シェイプ ノードまたはその親トランスフォームが選択されているかどうかにかかわらず、必ずオブジェクトとそのインスタンスの両方が書き出しされることに注意してください。 既定: シーン全体を移動
fragmentIncomingShdrs(fis)	boolean
フラグメント モードでは、現在の選択(ドライビング ノード)にあるノードに接続されたシェーディング ノードを追加で移動します。 既定: 接続を無視
fragmentMaterials(fem)	boolean
フラグメント モードでは、現在の選択にあるシェイプ/トランスフォームのアタッチされたマテリアルを追加で移動します。 既定: アタッチされたマテリアルを無視
init(ini)	boolean
起動ファイルのロードとカスタム リンクの再実行を含めて、統合レンダラで初期化ステップを再度実行し、コマンドを含めます。 内部使用限定。
listLinks(ll)	boolean
現在リンクしているシェーダ ライブラリをリスト表示します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。 内部使用限定。
project(prj)	string
プラグインに使用されるプロジェクトのルート ディレクトリを設定します。これは、テクスチャのように、完全なファイル パスを使わずにプロジェクトのサブディレクトリ内のファイルを参照する場合だけでなく、既定の出力ディレクトリにも影響します。 既定: ファイル書き出し用は none、プレビュー用は既定のプロジェクト ディレクトリ
removeLinks(rl)	string
インタラクティブに指定したシェーダ ライブラリをリンク解除します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。 内部使用限定。
renderVerbosity(rv)	uint
mental ray メッセージの冗長レベルを設定します。値の範囲は 0～6 で、冗長レベルはそれぞれ none、fatal、error、warning、info、progress と details に設定されます。 既定: レンダー グローバル設定(warning レベル)
updateRayrc(ur)	boolean
maya.rayrc ファイルをリロードし、mental ray を再初期化します。 内部使用限定。
verbosity(v)	uint
プラグイン メッセージの冗長レベルを設定します。値の範囲は 0～6 で、冗長レベルはそれぞれ none、fatal、error、warning、info、progress と details に設定されます。 既定: レンダー グローバル設定(warning レベル)
書き出しフラグ
binary(bin)	boolean
バイナリ .mi フォーマット(オブジェクト定義にバイナリ ベクトルを書く)を書き出します。 既定: off (ascii フォーマットを書く)
echo(e)	boolean
シーン データをビルドイン mental ray に送り、エコー コマンドを実行して、.mi ファイルにシーンを書き出します。 既定:オフ
exportFilter(xf)	int
これにより、書き出した .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
文字列引数を使用して書き出しフィルタを設定します。文字列のすべての文字は上記パターンの対応するビット位置をマークしています。 既定: フラグなし
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)	boolean
現在使用している起動ファイル maya.rayrc を含めて、.mi ファイルに書き出します。この場合は、シーン ファイル内から(カスタム テキストを介して)起動ファイルのステートメントを再度指定する必要がありません。 既定:オフ
file(f)	string
.mi export または .mi echo のファイル名とパスを設定します。 既定: タイトルなし
miStream(mi)	boolean
シーンを .mi ファイルに書き出します。 既定:オフ
padframe(pad)	uint
フレーム番号のパディング(固定長のフィールド幅)を設定します。これはフレームごとに .mi ファイルにアニメーションを書き出す場合に、ファイル名の拡張子を生成するために使用します。 既定: 0、パディングなし
perframe(pf)	uint
フレームごとの .mi ファイルのアニメーションの書き出しを制御します。サポートされている値は、0 (アニメーション全体を含む 1 つの .mi ファイルで、差分変更を使用)と 0 より大きい値(フレームごとに 1 つの .mi ファイルを書き出し、差分変更を使用しない)では、次の異なる名前付けスキームを使用します: 1 (name.ext.#)、2 (name.#.ext)、3 (name.#)。 既定: 0
tabstop(tab)	uint
.mi ファイルで行をインデントするために使用するスペース文字数を設定します。 既定: 4
レンダリング フラグ
addHosts(ah)	string
ホスト リストに特定のマシン名を追加します(特定のホストをアタッチ)。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
camera(cam)	string
このカメラをプレビュー レンダリングのレンダー カメラとして使用します。カメラのシェイプ名が求められます。 既定: render globals カメラ
layer(l)	string
指定したレンダー レイヤをレンダーします。レンダー レイヤのレンダリング可能なアトリビュート値にかかわらず、このレンダー レイヤのみをレンダーします。レイヤ名は出力イメージ ファイル名にアペンドされます。指定したレンダー レイヤは、レンダリング前に現在のレンダー レイヤになり、レンダリング後も現在のレンダー レイヤのままです。
license(lic)	string
このフラグは現在サポートしていません。
listHosts(lh)	boolean
ホスト リストにマシン名をリスト表示します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
logFile(log)	boolean
現在のディレクトリにある 'mentalray.log' というファイルに、mental ray レンダー メッセージを書き込みます。このメッセージはさらに、出力ウィンドウまたは親シェル ウィンドウにも書き込まれます。
preview(pv)	boolean
統合された mental ray でプレビュー レンダーを実行します。インタラクティブ レンダリングの場合のみ(バッチ レンダリングの場合はなし)(バッチ レンダリングでは使用しません) r/render と同時には指定できません。 既定:オフ
previousView(prv)	boolean
同じコマンドラインで明らかなカメラ指定がなければ、プレビュー レンダリング用として以前実行したレンダー カメラを使用します。 既定: シーン内で最初に見つかったレンダリング可能なカメラ
region(rg)	boolean
Maya レンダー ウィンドウの現在の長方形の範囲だけをプレビュー レンダーします。 既定: イメージ全体をレンダー
regionRect(rr)	[uint, uint, uint, uint]
範囲が有効であれば、これによりプレビュー レンダーするカスタムの長方形の範囲が設定されます。4 つの整数値は、左、下、右、上の境界をこの順番で指定します。 既定: ウィンドウ範囲をレンダー
removeHosts(rh)	string
ホスト リストから特定のマシン名を除去します(特定のホストをデタッチ)。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
render(r)	boolean
統合された mental ray を使用して、バッチ モードでレンダリングを実行します。バッチ レンダリングの場合のみ(インタラクティブ レンダリングでは使用しません) pv/preview と同時には指定できません。
renderNoSlaves(rns)	boolean
これを指定すると、ほとんどすべてをマスタ マシン(Maya を実行しているマシン)上でレンダーできるため、スレーブ マシンの負荷を軽減することができます。
renderTarget(rtg)	string
指定したレンダー ターゲットをレンダーします。このフラグが設定されている場合、mental ray はシーンをレンダーしません。代わりに、ターゲット文字列で指定したノードの下流にある画像処理グラフをレンダーします。このフラグの目的は、合成や一般的な画像処理タスクに mental ray を利用することです。FLAGHEADER ネットワーク レンダリング フラグで、ほかのレンダリング フラグと一緒に使用。FLAG renderNoMaster rnm CREATE NO_QUERY NO_EDIT NO_MULTI COMMENT これを指定すると、ほとんどすべてをスレーブ マシン上でレンダーできるため、マスタ マシン(Maya を実行しているマシン)の負荷を軽減することができます。
renderThreads(rt)	uint
これにより、現在のレンダーの mental ray で使用するレンダー スレッドの数を減らすことができます。使用可能な値は 1～4 です。 既定: 4
updateHosts(uh)	boolean
maya.rayhosts ファイルをリロードし、ホスト マシン(スレーブ マシン)のリストを適宜更新します。mental ray を適切に初期化してから使用してください。たとえば、イメージのレンダー後。内部使用限定。
xResolution(x)	uint
プレビュー レンダー用に、出力イメージの x 解像度を設定します。 既定: レンダー グローバル(Render Globals)のイメージの幅
yResolution(y)	uint
プレビュー レンダー用に、出力イメージの y 解像度を設定します。 既定: レンダー グローバル(Render Globals)のイメージの高さ

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

Python 例

import maya.cmds as cmds

# Render the lower left corner of the image to the render view with
# progress messages. persp camera is used to render the image.
cmds.Mayatomr( preview=True, v=5, region=True, rr=(0, 0, 300, 300), camera='perspShape' )

# Batch render occlusionLayer with occlusionCamera, with 1k square
# resolution.
cmds.Mayatomr( render=True, 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.
cmds.Mayatomr( mi=True, tabstop=8, xp='3313333333', file='test.mi' )