renderer

Go to: Synopsis. Return value. Keywords. Flags. MEL examples.

Synopsis

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

renderer is NOT undoable, queryable, and editable.

Return value

None

In query mode, return type is based on queried flag.

Keywords

Flags

Long name (short name)	Argument types	Properties
-rendererUIName(-ui)	string
Set or query the rendererUIName for the specified renderer. The rendererUIName is the name of the renderer as it would appear in menus.
-renderGlobalsProcedure(-rg)	string
This flag is obsolete. It will be removed in the next release.
-iprRenderProcedure(-ipr)	string
Set or query the IPR render command associated with the specified renderer.
-iprOptionsProcedure(-io)	string
Set or query the IPR render options procedure associated with the specified renderer.
-isRunningIprProcedure(-isr)	string
Set or query the isRunningIpr command associated with the specified renderer.
-startIprRenderProcedure(-sti)	string
Set or query the start IPR render procedure associated with the specified renderer.
-stopIprRenderProcedure(-spi)	string
Set or query the stop IPR render procedure associated with the specified renderer.
-refreshIprRenderProcedure(-rfi)	string
Set or query the refresh IPR render procedure associated with the specified renderer.
-pauseIprRenderProcedure(-psi)	string
Set or query the pause IPR render procedure associated with the specified renderer.
-changeIprRegionProcedure(-cir)	string
Set or query the change IPR region procedure associated with the specified renderer.
-iprOptionsMenuLabel(-ipm)	string
Set or query the label for the IPR update options menu which is under the render view's IPR menu.
-iprOptionsSubMenuProcedure(-ips)	string
Set or query the procedure for creating the sub menu for the IPR update options menu which is under the render view's IPR menu.
-iprRenderSubMenuProcedure(-irs)	string
Set or query the procedure for creating the sub menu for the IPR render menu which is under the render view's IPR menu.
-renderProcedure(-r)	string
Set or query the render command associated with the specified renderer.
-renderOptionsProcedure(-ro)	string
Set or query the render options procedure associated with the specified renderer.
-renderDiagnosticsProcedure(-rd)	string
Set or query the render diagnostics procedure associated with the specified renderer.
-commandRenderProcedure(-cr)	string
Set or query the command line rendering procedure associated with the specified renderer.
-batchRenderProcedure(-br)	string
Set or query the batch render procedure associated with the specified renderer.
-batchRenderOptionsProcedure(-bro)	string
Set or query the batch render options procedure associated with the specified renderer.
-batchRenderOptionsStringProcedure(-bso)	string
Set or query the argument string that will be used with the command line utility 'Render' when doing a batch render
-cancelBatchRenderProcedure(-cbr)	string
Set or query returns the cancel batch render procedure associated with the specified renderer.
-showBatchRenderProcedure(-sbr)	string
Set or query the show batch render procedure associated with the specified renderer.
-showRenderLogProcedure(-srl)	string
Set or query the log file render procedure associated with the specified renderer.
-showBatchRenderLogProcedure(-brl)	string
Set or query the log file batch procedure associated with the specified renderer.
-renderRegionProcedure(-rr)	string
Set or query the render region procedure associated with the specified renderer.
-textureBakingProcedure(-tb)	string
Set or query the texture baking procedure associated with the specified renderer.
-polyPrelightProcedure(-pp)	string
Set or query the polygon prelight procedure associated with the specified renderer.
-renderingEditorsSubMenuProcedure(-res)	string
Set or query the procedure reponsible for creating renderer specific editors submenu under the "Rendering Editors" menu for the specified renderer.
-renderMenuProcedure(-rm)	string
This flag is obsolete. It will be removed in the next release.
-logoImageName(-log)	string
Set or query the logo image name for the specified renderer. The logo is a image representing the renderer.
-logoCallbackProcedure(-lgc)	string
Set or query the procedure which is a callback associated to the logo for the specified renderer. For example, the logo and the callback can be used in the unified render globals window beside the "Render Using" optionMenu.
-namesOfAvailableRenderers(-ava)
Returns the names of renderers which are currently registered.
-unregisterRenderer(-unr)
Unregister the specified renderer.
-exists(-ex)
The flag returns true if the specified renderer is registered in the registry, and it returns false otherwise.
-addGlobalsTab(-agt)	string string string
Add a tab associated with the specified renderer for the unified render globals window.
-globalsTabLabels(-gtl)
This flag returns the labels of unified render globals window tabs which are associated with the specified renderer.
-globalsTabCreateProcNames(-gtc)
This flag returns the names of procedures which are used to create the unified render globals window tabs which are associated with the specified renderer.
-globalsTabUpdateProcNames(-gtu)
This flag returns the names of procedures which are used to update the unified render globals window tabs which are associated with the specified renderer.
-addGlobalsNode(-agn)	string
This flag allows the user to add a globals node the specified renderer uses.
-globalsNodes(-gn)
This flag returns the list of render globals nodes the specified renderer uses.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

// To register a renderer called "myRenderer":
//
renderer myRenderer;
// To edit a renderer called "myRenderer" with its rendererUIName
// being "My Renderer":
//
renderer -edit -rendererUIName "My Renderer" myRenderer;
// To register a renderer called "anotherRenderer" with all
// its parameters specified.
//
renderer -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       ""
        anotherRenderer;
// To add a render globals node the renderer uses:
//
renderer -edit -addGlobalsNode "defaultRenderGlobals" anotherRenderer;
// 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.
//
renderer
    -edit
    -addGlobalsTab  "Maya Software"
                    "createMayaSoftwareGlobalsTab"
                    "updateMayaSoftwareGlobalsTab"
    anotherRenderer;
// To get a list of unified render globals window tab labels associated
// with the specified renderer.
//
renderer -query -globalsTabLabels anotherRenderer;
// To get a list of names of mel procedures which are used to
// create the unified render globals window tabs associated with
// the specified renderer.
//
renderer -query -globalsTabCreateProcNames anotherRenderer;
// To get a list of names of mel procedures which are used to
// update the unified render globals window tabs associated with
// the specified renderer.
//
renderer -query -globalsTabUpdateProcNames anotherRenderer;
// To view a list of registered renderers.
//
renderer -query -namesOfAvailableRenderers;
// To check if anotherRenderer exists.
//
renderer -exists anotherRenderer;
// To view a list of render globals nodes used by the specified
// renderer:
//
renderer -query -globalsNodes anotherRenderer;