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

Synopsis

editDisplayLayerGlobals [-baseId int] [-currentDisplayLayer select] [-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.

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 be used more than once in a command

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

MEL examples

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