Go to: Synopsis. Return value. Keywords.
Related. Flags.
Python examples.
editRenderLayerGlobals([baseId=int], [currentRenderLayer=name],
[enableAutoAdjustments=boolean],
[mergeType=int], [useCurrent=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
editRenderLayerGlobals is undoable, queryable, and NOT
editable.
Edit the parameter values common to all render layers. Some of
these paremeters, eg. baseId and mergeType, are stored as
preferences and some, eg. currentRenderLayer, are stored in the
file.
boolean |
Command success |
string |
Current render layer name, when querying |
int |
Merge type, when querying |
int |
Base ID, when querying |
In query mode, return type is based on queried flag.
renderLayer, render, layer, globals, current, merge
createRenderLayer, editRenderLayerMembers
baseId, currentRenderLayer, enableAutoAdjustments, mergeType, useCurrent
Long name (short name) |
Argument types |
Properties |
currentRenderLayer(crl) |
name |
  |
|
Set current render layer. This will will update the
renderLayerManger and all DAG objects to identify them as members
of the render layer. This flag may also be used in conjunction with
"useCurrent" to automatically add new DAG objects to the active
layer. The "isCurrentRenderLayerChanging" condition can be used to
determine when the current layer is being changed and adjustments
are being applied to the scene. |
|
baseId(bi) |
int |
  |
|
Set base layer ID. This is the number at which new layers start
searching for a unique ID. |
|
useCurrent(uc) |
boolean |
  |
|
Set whether or not to enable usage of the current render layer
as the destination for all new nodes. |
|
enableAutoAdjustments(eaa) |
boolean |
  |
|
Set whether or not to enable automatic creation of adjustments
when certain attributes (ie. surface render stats, shading group
assignment, or render settings) are changed. |
|
mergeType(mt) |
int |
  |
|
Set file import merge type. Valid values are 0, none, 1, by
number, and 2, by name. |
|
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
cmds.editRenderLayerGlobals( currentRenderLayer='layer1' )
cmds.editRenderLayerGlobals( query=True, currentRenderLayer=True )
# Result: layer1
cmds.editRenderLayerGlobals( query=True, baseId=True )
# Result: 1
cmds.editRenderLayerGlobals( useCurrent=True )
# Enable automatic creation of adjustments
cmds.editRenderLayerGlobals( enableAutoAdjustments=True )