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

Synopsis

preferredRenderer [-fallback string] [-makeCurrent] [string]

preferredRenderer is NOT undoable, queryable, and NOT editable.

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.

Return value

None

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

Keywords

renderer

Flags

fallback, makeCurrent
Long name (short name) Argument types Properties
-fallback(-f) string createquery
Sets the preferred fallback renderer.
-makeCurrent(-mc) create
Sets the current renderer as the preferred one.

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 set the preferred renderer to a renderer called "myRenderer":
//
preferredRenderer myRenderer;

// To query the preferred renderer
//
preferredRenderer -query;

// To set the current renderer as the preferred one
//
preferredRenderer -makeCurrent;

// To set the preferred fallback renderer
//
preferredRenderer -fallback myRenderer;