pymel.core.rendering.preferredRenderer¶

preferredRenderer(*args, **kwargs)¶

Command to set the preferred renderer. This command can be used to query the preferred renderer and to set the current renderer as the preferred one. It also allows users to specify a preferred fallback renderer. In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name		Argument Types	Properties
fallback / f		unicode
	Sets the preferred fallback renderer.
makeCurrent / mc		bool
	Sets the current renderer as the preferred one. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.preferredRenderer

Example:

::

import pymel.core as pm

# To set the preferred renderer to a renderer called “myRenderer”: # pm.preferredRenderer( ‘myRenderer’ )

# To query the preferred renderer # pm.preferredRenderer( query=True ) # Result: u’mayaSoftware’ #

# To set the current renderer as the preferred one # pm.preferredRenderer( makeCurrent=True )

# To set the preferred fallback renderer # pm.preferredRenderer( fallback=’myRenderer’ )