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

Synopsis

render [-abortMissingTexture boolean] [-batch] [-keepPreImage boolean] [-layer string] [-nglowpass boolean] [-nshadows boolean] [-replace boolean] [-xresolution int] [-yresolution int] [camera]

render is NOT undoable, NOT queryable, and NOT editable.

The render command is used to start off a MayaSoftware rendering session of the currently active camera. If a rendering is already in progress, then this command stops the rendering. This command is not undoable.

Return value

stringThe name of the rendered image.

Flags

abortMissingTexture, batch, keepPreImage, layer, nglowpass, nshadows, replace, xresolution, yresolution
Long name (short name) Argument types Properties
-abortMissingTexture(-amt) boolean create
Abort renderer when encountered missing texture. Only available when -batch is set
-batch(-b) create
Run in batch mode. Compute the images for all renderable cameras. This is the mel equivalent of running maya in batch mode with the -render flag set. All other flags are ignored when -batch is used.
-keepPreImage(-kpi) boolean create
Keep the renderings prior to post-process around. Only available when -batch is set
-layer(-l) string create
Render the specified render layer. Only this render layer will be rendered, regardless of the renderable attribute value of the render layer. The layer name will be appended to the output image file name. The specified render layer becomes the current render layer before rendering, and remains as current render layer after the rendering.
-nglowpass(-ngl) boolean create
Overwrite glow pass capabilities (can turn off glow pass globally by setting this value to false)
-nshadows(-nsh) boolean create
Shadowing capabilities (can turn off shadow globally by setting this value to false)
-replace(-rep) boolean create
Replace the rendered image if it already exists. Only available when -batch is set
-xresolution(-x) int create
Overwrite x resolution
-yresolution(-y) int create
Overwrite y resolution

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

render;

string $cam[] = `camera`;
render -x 768 -y 576 $cam[0];

// Render render layer layer1.
render -layer layer1 camera1;