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

概要

renderer([string], [addGlobalsNode=string], [addGlobalsTab=[string, string, string]], [batchRenderOptionsProcedure=string], [batchRenderOptionsStringProcedure=string], [batchRenderProcedure=string], [cancelBatchRenderProcedure=string], [changeIprRegionProcedure=string], [commandRenderProcedure=string], [exists=boolean], [globalsNodes=boolean], [globalsTabCreateProcNames=boolean], [globalsTabLabels=boolean], [globalsTabUpdateProcNames=boolean], [iprOptionsMenuLabel=string], [iprOptionsProcedure=string], [iprOptionsSubMenuProcedure=string], [iprRenderProcedure=string], [iprRenderSubMenuProcedure=string], [isRunningIprProcedure=string], [logoCallbackProcedure=string], [logoImageName=string], [materialViewRendererList=boolean], [materialViewRendererPause=boolean], [materialViewRendererSuspend=boolean], [namesOfAvailableRenderers=boolean], [pauseIprRenderProcedure=string], [polyPrelightProcedure=string], [refreshIprRenderProcedure=string], [renderDiagnosticsProcedure=string], [renderGlobalsProcedure=string], [renderMenuProcedure=string], [renderOptionsProcedure=string], [renderProcedure=string], [renderRegionProcedure=string], [renderSequenceProcedure=string], [rendererUIName=string], [renderingEditorsSubMenuProcedure=string], [showBatchRenderLogProcedure=string], [showBatchRenderProcedure=string], [showRenderLogProcedure=string], [startIprRenderProcedure=string], [stopIprRenderProcedure=string], [supportColorManagement=boolean], [textureBakingProcedure=string], [unregisterRenderer=boolean])

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

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

レンダーを登録するコマンドです。このコマンドを使用して、レンダラの UI 名とプロシージャ名を指定できます。また、登録したレンダラの UI 名とプロシージャ名を照会することもできます。

戻り値

なし

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

キーワード

renderer, registration

フラグ

addGlobalsNode, addGlobalsTab, batchRenderOptionsProcedure, batchRenderOptionsStringProcedure, batchRenderProcedure, cancelBatchRenderProcedure, changeIprRegionProcedure, commandRenderProcedure, exists, globalsNodes, globalsTabCreateProcNames, globalsTabLabels, globalsTabUpdateProcNames, iprOptionsMenuLabel, iprOptionsProcedure, iprOptionsSubMenuProcedure, iprRenderProcedure, iprRenderSubMenuProcedure, isRunningIprProcedure, logoCallbackProcedure, logoImageName, materialViewRendererList, materialViewRendererPause, materialViewRendererSuspend, namesOfAvailableRenderers, pauseIprRenderProcedure, polyPrelightProcedure, refreshIprRenderProcedure, renderDiagnosticsProcedure, renderGlobalsProcedure, renderMenuProcedure, renderOptionsProcedure, renderProcedure, renderRegionProcedure, renderSequenceProcedure, rendererUIName, renderingEditorsSubMenuProcedure, showBatchRenderLogProcedure, showBatchRenderProcedure, showRenderLogProcedure, startIprRenderProcedure, stopIprRenderProcedure, supportColorManagement, textureBakingProcedure, unregisterRenderer
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
addGlobalsNode(agn) string createqueryedit
指定したレンダラが使用するグローバル ノードを追加することができるようになります。
addGlobalsTab(agt) [string, string, string] createedit
指定したレンダラにコネクトされたタブを統一レンダー グローバル(Render Globals)ウィンドウに追加します。
batchRenderOptionsProcedure(bro) string createqueryedit
指定したレンダラにコネクトされたバッチ レンダー オプションのプロシージャを設定または照会します。
batchRenderOptionsStringProcedure(bso) string createqueryedit
バッチ レンダーを行う際に、コマンド ライン ユーティリティ「Render」と一緒に使用する引数文字列を設定または照会します。
batchRenderProcedure(br) string createqueryedit
指定したレンダラにコネクトされたバッチ レンダーのプロシージャを設定または照会します。
cancelBatchRenderProcedure(cbr) string createqueryedit
設定または照会すると、指定したレンダラにコネクトされた、バッチ レンダーの解除のプロシージャを返します。
changeIprRegionProcedure(cir) string createqueryedit
指定したレンダラにコネクトされた IPR 領域の変更プロシージャを設定または照会します。
commandRenderProcedure(cr) string createqueryedit
指定したレンダラにコネクトされたコマンド ライン レンダリングのプロシージャを設定または照会します。
exists(ex) boolean queryedit
指定したレンダラがレジストリに登録されている場合は true を、登録されていない場合は false を返します。
globalsNodes(gn) boolean createqueryedit
指定したレンダラが使用するレンダー グローバル(Render Globals)ノードのリストを返します。
globalsTabCreateProcNames(gtc) boolean createqueryedit
指定したレンダラにコネクトされた、統一レンダー グローバル(Render Globals)ウィンドウのタブの作成に使用するプロシージャの名前を返します。
globalsTabLabels(gtl) boolean createqueryedit
指定したレンダラにコネクトされた、統一レンダー グローバル(Render Globals)ウィンドウのタブのラベルを返します。
globalsTabUpdateProcNames(gtu) boolean createqueryedit
指定したレンダラにコネクトされた、統一レンダー グローバル(Render Globals)ウィンドウのタブの更新に使用するプロシージャの名前を返します。
iprOptionsMenuLabel(ipm) string createqueryedit
レンダー ビューの IPR メニュー下にある IPR の更新オプション メニューのラベルを設定または照会します。
iprOptionsProcedure(io) string createqueryedit
指定したレンダラにコネクトされた IPR レンダー オプションのプロシージャを設定または照会します。
iprOptionsSubMenuProcedure(ips) string createqueryedit
レンダー ビューの IPR メニュー下にある IPR の更新オプション メニューのサブメニューを作成するプロシージャを設定または照会します。
iprRenderProcedure(ipr) string createqueryedit
指定したレンダラにコネクトされた IPR レンダー コマンドを設定または照会します。
iprRenderSubMenuProcedure(irs) string createqueryedit
レンダー ビューの IPR メニュー下にある IPR レンダー メニューのサブメニューを作成するプロシージャを設定または照会します。
isRunningIprProcedure(isr) string createqueryedit
指定したレンダラにコネクトされた isRunningIpr コマンドを設定または照会します。
logoCallbackProcedure(lgc) string createqueryedit
指定したレンダラのロゴにコネクトされたコールバックになるプロシージャを設定または照会します。たとえばロゴとコールバックは、使用するレンダラ(Render Using)オプション メニューの隣にある統一レンダー グローバル(Render Globals)ウィンドウで使用することができます。
logoImageName(log) string createqueryedit
指定したレンダラのロゴのイメージ名を設定または照会します。ロゴはレンダラを表すイメージです。
materialViewRendererList(mvl) boolean queryedit
現在登録されているマテリアル ビュー レンダラの名前を返します。
materialViewRendererPause(mvp) boolean queryedit
マテリアル ビューアを一時停止するかどうかを指定します。マテリアル ビューアの更新をグローバルに停止する場合に便利です。マテリアル ビューアが一時停止されている間、マテリアル ビューのレンダラは中止されたままになります。
materialViewRendererSuspend(mvs) boolean queryedit
マテリアル ビューのレンダラを一時停止するか再開するかを指定します。別のレンダリング タスクが実行されている場合に、マテリアル ビューのレンダラを一時的に停止するのに役立ちます。
namesOfAvailableRenderers(ava) boolean queryedit
現在登録されているレンダラの名前を返します。
pauseIprRenderProcedure(psi) string createqueryedit
指定したレンダラにコネクトされた IPR レンダーのキャンセル プロシージャを設定または照会します。
polyPrelightProcedure(pp) string createqueryedit
指定したレンダラにコネクトされた、ポリゴンのプリライトのプロシージャを設定または照会します。
refreshIprRenderProcedure(rfi) string createqueryedit
指定したレンダラにコネクトされた IPR レンダーのリフレッシュ プロシージャを設定または照会します。
renderDiagnosticsProcedure(rd) string createqueryedit
指定したレンダラにコネクトされたレンダー診断のプロシージャを設定または照会します。
renderGlobalsProcedure(rg) string createqueryedit
このフラグは現在サポートされていません。次のリリースでは除去される予定です。
renderMenuProcedure(rm) string createqueryedit
このフラグは現在サポートされていません。次のリリースでは除去される予定です。
renderOptionsProcedure(ro) string createqueryedit
指定したレンダラにコネクトされたレンダー オプションのプロシージャを設定または照会します。
renderProcedure(r) string createqueryedit
指定したレンダラにコネクトされたレンダー コマンドを設定または照会します。
renderRegionProcedure(rr) string createqueryedit
指定したレンダラにコネクトされた、領域をレンダーのプロシージャを設定または照会します。
renderSequenceProcedure(rs) string createqueryedit
指定したレンダラにコネクトされたシーケンス レンダリング プロシージャを設定または照会します。
rendererUIName(ui) string createqueryedit
指定したレンダラの rendererUIName を設定または照会します。rendererUIName はメニューに表示されるレンダラの名前です。
renderingEditorsSubMenuProcedure(res) string createqueryedit
指定したレンダラの、レンダリング エディタ(Rendering Editors)メニュー下にある、レンダラ特有のエディタのサブメニューを作成するプロシージャを設定または照会します。
showBatchRenderLogProcedure(brl) string createqueryedit
指定したレンダラにコネクトされたログ ファイルのバッチ レンダーのプロシージャを設定または照会します。
showBatchRenderProcedure(sbr) string createqueryedit
指定したレンダラにコネクトされたバッチ レンダーの表示のプロシージャを設定または照会します。
showRenderLogProcedure(srl) string createqueryedit
指定したレンダラにコネクトされたログ ファイルのレンダーのプロシージャを設定または照会します。
startIprRenderProcedure(sti) string createqueryedit
指定したレンダラにコネクトされた IPR レンダーの開始プロシージャを設定または照会します。
stopIprRenderProcedure(spi) string createqueryedit
指定したレンダラにコネクトされた IPR レンダーの停止プロシージャを設定または照会します。
supportColorManagement(scm) boolean queryedit
レンダラでカラー管理がサポートされているかどうかを指定します。
textureBakingProcedure(tb) string createqueryedit
指定したレンダラにコネクトされた、テクスチャのベイク処理のプロシージャを設定または照会します。
unregisterRenderer(unr) boolean queryedit
指定したレンダラの登録を解除します。

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

Python 例

import maya.cmds as cmds

# To register a renderer called "myRenderer":
#
cmds.renderer( 'myRenderer' )

# To edit a renderer called "myRenderer" with its rendererUIName
# being "My Renderer":
#
cmds.renderer( 'myRenderer', edit=True, rendererUIName='My Renderer' )

# To register a renderer called "anotherRenderer" with all
# its parameters specified.
#
cmds.renderer( 'anotherRenderer', rendererUIName='Another Renderer', iprRenderProcedure='mayaSoftwareIprRender', -iprOptionsProcedure='', isRunningIprProcedure='mayaSoftwareIsRunningIpr', startIprRenderProcedure='mayaSoftwareStartIprRender', stopIprRenderProcedure='mayaSoftwareStopIprRender', refreshIprRenderProcedure='mayaSoftwareRefreshIprImage', pauseIprRenderProcedure='mayaSoftwarePauseIprRender', changeIprRegionProcedure='mayaSoftwareChangeIprRegion', iprOptionsMenuLabel='IPR Tuning Options', iprOptionsSubMenuProcedure='mayaSoftwareIprUpdateOptionsSubMenu', iprRenderSubMenuProcedure='mayaSoftwareIprUpdateRenderSubMenu', renderProcedure='mayaSoftwareRender', renderOptionsProcedure='RenderOptions', renderDiagnosticsProcedure='RenderDiagnostics', commandRenderProcedure='render -batch', batchRenderProcedure='BatchRender', batchRenderOptionsProcedure='BatchRenderOptions', batchRenderOptionsStringProcedure="mayaSoftwareBatchRenderOptionsString", cancelBatchRenderProcedure='CancelBatchRender', showBatchRenderProcedure='ShowBatchRender', showRenderLogProcedure='', showBatchRenderLogProcedure='', renderRegionProcedure='mayaRenderRegion', textureBakingProcedure='performConvertSolidTx', polyPrelightProcedure='performPrelight', renderingEditorsSubMenuProcedure='', logoImageName='', logoCallbackProcedure='' )

# To add a render globals node the renderer uses:
#
cmds.renderer( 'anotherRenderer', edit=True, addGlobalsNode='defaultRenderGlobals' )

# To add the tabs associated with the specified renderer
# for the unified render globals window, use the syntax
#
#      renderer -edit
#               -addGlobalsTab globalsTabLabel
#                              globalsTabCreateProcName
#                              globalsTabUpdateProcName
#               renderer;
#
# where "globalsTabLabel" is the label of the tab,
# "globalsTabCreatedProcName" is the name of the mel procedure
# which is used to create the content in the tab.
# and "globalsTabCreatedProcName" is the name of the mel procedure
# which is used to update the content in the tab.
#
# Note that if you want to add a number of tabs, you need to repeat
# this renderer command for each tab you wish to add, as shown below.
#
cmds.renderer( 'anotherRenderer', edit=True, addGlobalsTab=('Maya Software', 'createMayaSoftwareGlobalsTab', 'updateMayaSoftwareGlobalsTab') )


# To get a list of unified render globals window tab labels associated
# with the specified renderer.
#
cmds.renderer( 'anotherRenderer', query=True, globalsTabLabels=True )

# To get a list of names of mel procedures that are used to
# create the unified render globals window tabs associated with
# the specified renderer.
#
cmds.renderer( 'anotherRenderer', query=True, globalsTabCreateProcNames=True )

# To get a list of names of mel procedures that are used to
# update the unified render globals window tabs associated with
# the specified renderer.
#
cmds.renderer( 'anotherRenderer', query=True, globalsTabUpdateProcNames=True )

# To view a list of registered renderers.
#
cmds.renderer( query=True, namesOfAvailableRenderers=True )

# To check if anotherRenderer exists.
#
cmds.renderer( 'anotherRenderer', exists=True )

# To view a list of render globals nodes used by the specified
# renderer:
#
cmds.renderer( 'anotherRenderer', query=True, globalsNodes=True )