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

Synopsis

editRenderLayerGlobals [-baseId int] [-currentRenderLayer name] [-enableAutoAdjustments boolean] [-mergeType int] [-useCurrent boolean]

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.

Return value

booleanCommand success
stringCurrent render layer name, when querying
intMerge type, when querying
intBase ID, when querying

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

Keywords

renderLayer, render, layer, globals, current, merge

Related

createRenderLayer, editRenderLayerMembers

Flags

baseId, currentRenderLayer, enableAutoAdjustments, mergeType, useCurrent
Long name (short name) Argument types Properties
-currentRenderLayer(-crl) name createquery
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 createquery
Set base layer ID. This is the number at which new layers start searching for a unique ID.
-useCurrent(-uc) boolean createquery
Set whether or not to enable usage of the current render layer as the destination for all new nodes.
-enableAutoAdjustments(-eaa) boolean createquery
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 createquery
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 be used more than once in a command.

MEL examples

editRenderLayerGlobals -currentRenderLayer layer1;
editRenderLayerGlobals -q -currentRenderLayer;
// Result: layer1
editRenderLayerGlobals -q -baseId;
// Result: 1
editRenderLayerGlobals -useCurrent on;
// Enable automatic creation of adjustments
editRenderLayerGlobals -enableAutoAdjustments on;