Go to: Synopsis. Return value. Related. Flags. MEL examples.
lightListEditor [-add] [-allShadingGroups] [-mode string] [-multipleSelection] [-remove] [-singleSelection]
lightListEditor is undoable, queryable, and editable.
This command created a light list editor.
A light lister displays the lights that are illuminating the
selected objects. As the active list changes, the information
displayed in the light-lister changes.
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".
string | Name of the editor. |
In query mode, return type is based on queried flag.
ambientLight, directionalLight, exclusiveLightCheckBox, lightList, lightListPanel, lightlink, pointLight, spotLight, spotLightPreviewPort
add, allShadingGroups, mode, multipleSelection, remove, singleSelection
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.
|
// 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;