LightLinkEdit

The LightLinkEdit node adjusts which objects are illuminated by a light. This node edits lightList attributes that were previously set by LightLink or LightLinkResolve nodes.

Note:  Light linking information is stored on the object scene graph locations themselves in the lightList attribute. This stores the enable state of a light for each location in the scene.

Connection Type

Connection Name

Function

Input

in

The object whose lightList attributes you want to modify.

 

Control (UI)

Default Value

Function

clearUnmatched

disabled

The clearUnmatched parameter determines whether or not existing light linking attributes for this light are removed from locations that do not match the on or off expressions.

effect

illumination

Determines whether the link is acting upon the light's illumination or shadow visibility of the specified objects:

illumination

shadow visibility

custom

Note:  Shadow visibility is only currently respected by Arnold renders.

light

N/A

Specifies the scene graph location for the light you want to apply the lighting quality of the effect parameter from.

For more information, refer to the Scene Graph Location Widget Type in the Common Parameter Widgets.

effect: custom

customAttrName

custom

Specifies a custom attribute name to set on the lightList for your object scene graph locations. The value of the custom parameter becomes the attribute name, which is set on the object scene graph location for each light.

When a LightLink node is used with a LightLinkEdit node, for instance, if the:

light parameter is set to /root/world/lgt/spotlight,

custom parameter is set to myAttr,

off CEL parameter is set to /root/world/geo/pony,

Then

/root/world/geo/pony has an attribute named lightList.root_world_lgt_spotlight.myAttr, the value of which is set to 0.

LightLinkEdit parameters continued

on

N/A

Links matching locations to the effect specified in the effect parameter.

The scene graph locations are specified using the Collection Expression Language (CEL). The on parameter options are available by clicking Add Statements.

For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation) or the CEL Statement Widget Type in Common Parameter Widgets.

off

N/A

Disables the effect specified in the effect parameter for the matching locations.

The scene graph locations are specified using the Collection Expression Language (CEL). The off parameter options are available by clicking Add Statements.

For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation) or the CEL Statement Widget Type in Common Parameter Widgets.