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

Synopsis

createRenderLayer [-empty] [-global] [-makeCurrent] [-name string] [-noRecurse] [-number int]

createRenderLayer is undoable, NOT queryable, and NOT editable.

Create a new render layer. The render layer number will be assigned based on the first unassigned number not less than the base index number found in the render layer global parameters. Normally all objects and their descendants will be added to the new render layer but if '-noRecurse' is specified then only the objects themselves will be added. Only transforms and geometry will be added to the new render layer.

Return value

stringName of render layer node that was created

Keywords

renderLayer, 2d3d, layer, color, playback, render

Related

editRenderLayerGlobals, editRenderLayerMembers

Flags

empty, global, makeCurrent, name, noRecurse, number
Long name (short name) Argument types Properties
-empty(-e) create
If set then create an empty render layer. The global flag or specified member list will take precidence over use of this flag.
-global(-g) create
If set then create a layer that contains all DAG objects in the scene. Any future objects created will also automatically become members of this layer. The global flag will take precidence over use of the empty flag or specified member list.
-makeCurrent(-mc) create
If set then make the new render layer the current one.
-name(-n) string create
Name of the new render layer being created.
-noRecurse(-nr) create
If set then only add specified objects to the render layer. Otherwise all descendants will also be added.
-number(-num) int create
Number for the new render layer being created.

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

// Add nut and nutShape to a new render layer
//
select nut;
createRenderLayer;
// Result: renderLayer1 //

// Add only bolt to a new render layer
//
createRenderLayer -noRecurse bolt;
// Result: renderLayer2 //

// Add washer to the new render layer 'assembly'.
//
createRenderLayer -noRecurse -name assembly washer;
// Result: assembly //

// Create a layer that will always contains everything
//
createRenderLayer -global;
// Result: renderLayer3 //