pymel.core.general.createDisplayLayer

createDisplayLayer(*args, **kwargs)

Create a new display layer. The display layer number will be assigned based on the first unassigned number not less than the base index number found in the display layer global parameters. Normally all objects and their descendants will be added to the new display layer but if the ‘-nr’ flag is specified then only the objects themselves will be added.

Modifications:

• returns a PyNode object

Flags:

• empty : e (bool) [create]

  If set then create an empty display layer. ie. Do not add the selected items to the new display layer.

• makeCurrent : mc (bool) [create]

  If set then make the new display layer the current one.

• name : n (unicode) [create]

  Name of the new display layer being created.

• noRecurse : nr (bool) [create]

  If set then only add selected objects to the display layer. Otherwise all descendants of the selected objects will also be added.

• number : num (int) [create]

  Number for the new display layer being created. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.createDisplayLayer