prepareRender

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

概要

prepareRender [-defaultTraversalSet string] [-deregister string] [-invokePostRender] [-invokePostRenderFrame] [-invokePostRenderLayer] [-invokePreRender] [-invokePreRenderFrame] [-invokePreRenderLayer] [-invokeSettingsUI] [-label string] [-listTraversalSets] [-postRender script] [-postRenderFrame script] [-postRenderLayer script] [-preRender script] [-preRenderFrame script] [-preRenderLayer script] [-restore] [-saveAssemblyConfig boolean] [-settingsUI script] [-setup] [-traversalSet string] [-traversalSetInit script]

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

このコマンドは、シーン アセンブリ ノードに対して特別なサポートを提供します。シーン アセンブリ ノードをレンダリングするために、レンダリング縦断はシーン内の各アセンブリ ノードのために適切なリプレゼンテーションをアクティブにすることができます。レンダリングが完了すると、このコマンドはそれに応じて各アセンブリ上でレンダリング前にアクティブだったリプレゼンテーションを復元することができます。レンダー縦断は縦断のセットにグループ化されています。レンダー縦断セットには、以下に示す 1 つまたは複数のレンダリングの手順に対するコールバック、またはレンダー縦断が、粒度レベルの低い順に含まれています。レンダー縦断コールバックは、MEL または Python の任意のスクリプトで、レンダリング目的で Maya シーンをトランスフォームすることができます。

preRender

縦断は、レンダリングの実行前に、レンダーごとに一度実行されます。

postRender

縦断は、すべてのレンダリングの実行後に、レンダーごとに一度実行されます。

preRenderLayer

縦断は、各レンダー レイヤのレンダリング前に実行されます。

postRenderLayer

縦断は、各レンダー レイヤのレンダリング後に実行されます。

preRenderFrame

縦断は、各フレームのレンダリング前に実行されます。

postRenderFrame

縦断は、各フレームのレンダリング後に実行されます。

レンダー時に、ソフトウェアのレンダリング コードは、既定の縦断セットのコールバックを呼び出します。prepareRenderスクリプト機能によって、複数のレンダリング準備スクリプトを開発することができます。これにはプラグインの使用も含まれ、単一の実装に制約されない拡張性を提供します。

特殊な縦断セットに「null」縦断セットがあります。これは最初の既定の縦断セットで、登録解除することはできません。実行する機能はなく、アセンブリ ノードのアクティブ リプレゼンテーション設定の保存や復元を行いません。アセンブリノードの WYSIWYG (What You See Is What You Get)レンダリングを提供し、レンダリング対象の別のリプレゼンテーションに切り替わりません。

レンダー縦断は、このコマンドの作成モードを使用して、Maya によって呼び出されます。これは Maya のレンダリング インフラストラクチャによって行われるもので、新しいレンダー ビューまたはバッチ レンダー コードを開発しない限り必要はありません。このコマンドのほとんどの用途は、単純に編集モードを使用してレンダー縦断をレンダー縦断セットに登録するか、または照会モードを使用してレンダー縦断セット内のレンダー縦断の名前を照会することです。

レンダー縦断とレンダー MEL スクリプト

状態の保存と復元

prepareRender コマンドは、シーン内のアセンブリ ノードのアクティブ リプレゼンテーションの保存と復元をサポートします。saveAssemblyConfig フラグは、レンダー縦断セットが、レンダリングの開始前にアセンブリ ノードのアクティブ リプレゼンテーションを保存し、レンダリングの終了後に復元することを必要とすることを示すために使用します。

レンダー縦断がアセンブリ ノードのアクティブ リプレゼンテーション変更以外の方法でシーンを変更する場合、シーンを以前の状態に復元するのは、そのレンダー縦断の責任です。この場合は通常 postRender、postRenderLayer、および postRenderFrame 縦断を使用します。

Maya は、バッチ レンダーの完了時に prepareRender -restore コマンドを呼び出しません。バッチ レンダリングはレンダリングが終了すると破棄されるシーンのコピーに対して実行されるためです。レンダー縦断のインプリメンタは、同じ最適化を実装するために、自分がバッチ モードで実行しているかどうかを確認する必要があります。

戻り値

なし

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

キーワード

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-defaultTraversalSet(-dt)	string
既定の縦断セットを設定または照会します。prepareRender コマンドは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セット上で操作を実行します。
-deregister(-d)	string
登録された縦断セットを登録解除します。登録解除された縦断セットが既定の縦断セットの場合、新しい既定の縦断セットは「null」縦断セットになります。
-saveAssemblyConfig(-sac)	boolean
シーン全体のアクティブ リプレゼンテーション設定を特定の縦断セットに対して保存するかどうかを設定または照会します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定になります。
-label(-lbl)	string
特定の縦断セットのラベルを設定または照会します。ラベルは UI 表示の目的で使用され、ローカライズできます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定になります。
-listTraversalSets(-lt)
サポートされているレンダー縦断セットを照会します。
-preRender(-prr)	script
特定の縦断セットに対する preRender レンダー縦断を設定または照会します。この縦断はレンダー前に実行されます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-postRender(-por)	script
特定の縦断セットに対する postRender レンダー縦断を設定または照会します。この縦断はレンダー後に実行されます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-preRenderLayer(-prl)	script
特定の縦断セットに対する preRenderLayer レンダー縦断を設定または照会します。この縦断はレンダー レイヤがレンダリグされる前に、レンダー内で実行されます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-postRenderLayer(-pol)	script
特定の縦断セットに対する postRenderLayer レンダー縦断を設定または照会します。この縦断はレンダー レイヤがレンダリグされた後に、レンダー内で実行されます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-preRenderFrame(-prf)	script
特定の縦断セットに対する preRenderFrame レンダー縦断を設定または照会します。この縦断は、レンダー レイヤを持つ単一フレームのレンダーの前に実行されます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-postRenderFrame(-pof)	script
特定の縦断セットに対する postRenderFrame レンダー縦断を設定または照会します。この縦断は、レンダー レイヤを持つ単一フレームのレンダーの後に実行されます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-invokePreRender(-irr)
特定の縦断セットに対する preRender レンダー縦断を呼び出します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-invokePostRender(-ior)
特定の縦断セットに対する postRender レンダー縦断を呼び出します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-invokePreRenderLayer(-irl)
特定の縦断セットに対する preRenderLayer レンダー縦断を呼び出します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-invokePostRenderLayer(-iol)
特定の縦断セットに対する postRenderLayer レンダー縦断を呼び出します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-invokePreRenderFrame(-irf)
特定の縦断セットに対する preRenderFrame レンダー縦断を呼び出します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-invokePostRenderFrame(-iof)
特定の縦断セットに対する postRenderFrame レンダー縦断を呼び出します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-setup(-stp)
縦断の saveAssemblyConfig フラグが true に設定されている場合、レンダー準備を設定します。これにはシーン全体のアセンブリ アクティブ リプレゼンテーション設定の保存が含まれます。以前に保存された設定は上書きされます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-restore(-rtr)
縦断の saveAssemblyConfig フラグが true に設定されている場合、レンダリングをクリーン アップします。これにはシーン全体のアセンブリ アクティブ リプレゼンテーション設定の復元が含まれます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-traversalSet(-ts)	string
指定した登録済み縦断セットのプロパティを設定または照会します。 照会モードでは、このフラグに値が必要になります。
-settingsUI(-sui)	script
特定の縦断セットに対する設定 UI コールバックを設定または照会します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-invokeSettingsUI(-isu)
特定の縦断セットに対する、設定 UI コールバックを呼び出してレイアウトに UI コントロールを設定します。現在の UI の親はフォーム レイアウトであり、コールバック は setParent コマンドを使用してクエリを実行できます。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。
-traversalSetInit(-tsi)	script
特定の走査セットに対する走査セット初期化コールバックを設定または照会します。縦断セットは、-traversalSet フラグを使用して縦断セットを明示的に指定しない限り、既定の縦断セットになります。このコールバックは、指定された走査セットが既定の走査セットになるたびに呼び出されます。

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

MEL 例

// Query what the default render traversal set is.
prepareRender -q -defaultTraversalSet
// Set the render traversal set to MyPrepareRender.
prepareRender -e -defaultTraversalSet MyPrepareRender
// Set the default render traversal set to require saving the assembly node
// configuration before render, and restore it once rendering completes.
prepareRender -e -saveAssemblyConfig
// Set the label of traversal set "MyPrepareRender" to be "Custom Render".
prepareRender -e -label "Custom Render" -traversalSet "MyPrepareRender"