Go to: Synopsis. Return value. Keywords.
Related. Flags.
Python examples.
createRenderLayer([empty=boolean], [g=boolean], [makeCurrent=boolean], [name=string], [noRecurse=boolean], [number=int])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
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.
| string |
Name of render layer node that was created |
renderLayer, 2d3d, layer, color, playback, render
editRenderLayerGlobals,
editRenderLayerMembers
empty, g, makeCurrent, name,
noRecurse, number
| Long name (short name) |
Argument types |
Properties |
noRecurse(nr) |
boolean |
 |
|
If set then only add specified objects to the render layer.
Otherwise all descendants will also be added. |
|
empty(e) |
boolean |
|
|
If set then create an empty render layer. The global flag or
specified member list will take precidence over use of this
flag. |
|
g(g) |
boolean |
|
|
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) |
boolean |
|
|
If set then make the new render layer the current one. |
|
name(n) |
string |
|
|
Name of the new render layer being created. |
|
number(num) |
int |
|
|
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 have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
# Add nut and nutShape to a new render layer
#
cmds.select( 'nut' )
cmds.createRenderLayer()
# Result: renderLayer1 #
# Add only bolt to a new render layer
#
cmds.createRenderLayer( 'bolt', noRecurse=True )
# Result: renderLayer2 #
# Add washer to the new render layer 'assembly'.
#
cmds.createRenderLayer( 'washer', noRecurse=True, name='assembly' )
# Result: assembly #
# Create a layer that will always contains everything
#
cmds.createRenderLayer( g=True )
# Result: renderLayer3 #