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

Synopsis

editDisplayLayerGlobals [-baseId int] [-currentDisplayLayer name] [-mergeType int] [-useCurrent boolean]

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.

Return value

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

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

Keywords

displayLayer, display, layer, globals, current, merge

Related

createDisplayLayer, editDisplayLayerMembers, layerButton

Flags

baseId, currentDisplayLayer, mergeType, useCurrent
Long name (short name) Argument types Properties
-currentDisplayLayer(-cdl) name createquery
Set current display layer; ie. the one that all new objects are added to.
-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 display layer as the destination for all new nodes.
-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

editDisplayLayerGlobals -cdl displayLayer1;
editDisplayLayerGlobals -q -cdl;
// Result: displayLayer1
editDisplayLayerGlobals -q bi;
// Result: 10
editDisplayLayerGlobals -useCurrent on;