Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
editDisplayLayerGlobals([baseId=int], [currentDisplayLayer=name], [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.
| boolean | Command success |
| string | Current display layer name, when querying |
| int | Merge type, when querying |
| int | Base ID, when querying |
In query mode, return type is based on queried flag.
displayLayer, display, layer, globals, current, merge
createDisplayLayer, editDisplayLayerMembers, layerButton
baseId, currentDisplayLayer, mergeType, useCurrent
| Long name (short name) |
Argument types |
Properties |
baseId(bi)
|
int
|
 
|
|
Set base layer ID. This is the number at which new layers start searching
for a unique ID.
|
|
currentDisplayLayer(cdl)
|
name
|
|
|
Set current display layer; ie. the one that all new objects are added to.
|
|
mergeType(mt)
|
int
|
|
|
Set file import merge type. Valid values are 0, none, 1, by number, and
2, by name.
|
|
useCurrent(uc)
|
boolean
|
|
|
Set whether or not to enable usage of the current display layer as the
destination for all new nodes.
|
|
|
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.editDisplayLayerGlobals( cdl='displayLayer1' )
cmds.editDisplayLayerGlobals( query=True, cdl=True )
# Result: displayLayer1
cmds.editDisplayLayerGlobals( 'bi', query=True )
# Result: 10
cmds.editDisplayLayerGlobals( useCurrent='on' )