lightListEditor

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

Synopsis

lightListEditor [-add] [-allShadingGroups] [-mode string] [-multipleSelection] [-remove] [-singleSelection]

lightListEditor is undoable, queryable, and editable.

You can add relationships by selecting a light and the object and pressing "ADD". Or you can drag-and-drop the light from a UI like the outliner onto the light lister.

You can remove relationships by selecting the lights in the editor and pressing "REMOVE".

Return value

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

Related

Flags

Long name (short name)	Argument types	Properties
-add(-add)
If the editor is in light list mode, this will link the selected lights to the shading groups selected in the editor. If in shading group mode, will assign the currently selected renderable objects to the shading group selected in the editor.
-remove(-r)
If the editor is in light list mode, this will unlink the selected lights to the shading groups selected in the editor. If in shading group mode, will unassign the currently selected renderable objects from the shading group selected in the editor.
-mode(-m)	string
Specifies the operating mode for the editor. Valid values are: lightLists | shadingLists.
-singleSelection(-ss)
Specifies if the editor is listing only one item on the active list. Using this listing technique the frame will be opened automatically and single clicks of rows in the editor will result in membership changes.
-multipleSelection(-ms)
Specifies if the editor is listing all of the relevant things on the active list.
-allShadingGroups(-asg)
Specifies if the editor is listing all of the shading groups.

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

// Create a poly sphere and two pointLights
polySphere -r 3 -n pSphere1;
pointLight -pos 6 6 0 -rgb 1.0 1.0 0.0 -n yellowLight;
pointLight -pos -6 6 0 -rgb 1.0 0.0 0.0 -n redLight;

// Select the poly sphere
select pSphere1;

// Create a light list editor which displays the lights that illuminate poly sphere selected
window lightListWindow1;
frameLayout -h 500;
$llEditor = `lightListEditor -m lightLists -asg -ss`;
showWindow lightListWindow1;

// Click to select the initialShadingGroup in the light list editor

// Select the yellowLight
select yellowLightShape;

// Link the yellowLight to the initialShadingGroup
lightListEditor -e -add $llEditor;