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

Synopsis

editDisplayLayerGlobals([baseId=int], [currentDisplayLayer=select], [mergeType=int], [useCurrent=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

editDisplayLayerGlobals is undoable, queryable, and NOT editable.

Edit the parameter values common to all display layers. Some of these paremeters, eg. baseId and mergeType, are stored as preferences and some, eg. currentDisplayLayer, are stored in the file.

Flags

baseId, currentDisplayLayer, mergeType, useCurrent
Long name (short name) [argument types] Properties
currentDisplayLayer(cdl) select createquery
Set current display layer; ie. the one that all new objects are added to.

In query mode, this flag needs a value.
baseId(bi) int createquery
Set base layer ID. This is the number at which new layers start searching for a unique ID.

In query mode, this flag needs a value.
useCurrent(uc) boolean createquery
Set whether or not to enable usage of the current display layer as the destination for all new nodes.

In query mode, this flag needs a value.
mergeType(mt) int createquery
Set file import merge type. Valid values are 0, none, 1, by number, and 2, by name.

In query mode, this flag needs a value.
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.

Return value


[bool] Command success

[string] Current display layer name, when querying

[int] Merge type, when querying

[int] Base ID, when querying

Keywords

displayLayer, display, layer, globals, current, merge

Related

createDisplayLayer, editDisplayLayerMembers, layerButton

Python examples

import maya.cmds as cmds

cmds.editDisplayLayerGlobals( cdl='displayLayer1' )
cmds.editDisplayLayerGlobals( query=True, cdl=True )
# Result: displayLayer1
cmds.editDisplayLayerGlobals( 'bi', query=True )
# Result: 10
cmds.editDisplayLayerGlobals( useCurrent='on' )