Go to: Related nodes. Attributes.

This node defines light linking relationships between lights and objects. Connecting a light to the "light" child of the "link" compound will cause it to illuminate the object connected to the "object" child of the same index of the "link" compound. For example, if you connect a light to link[4].light and an object to link[4].object, then the light will illuminate the object. Similarly the "ignore" compound can be used to create ignore relationships between lights and objects. For example, if you connect a light to ignore[6].lightIgnored and an object to ignore[6].objectIgnored, then the object will ignore illumination from the light. Note that the entity used as a light may be a light shape, or a set containing light shapes, or a set containing transforms which are above light shapes in a hierarchy. An object may be an object shape (NURBS, polygon, particle...), a set containing object shapes, or a set containing transforms which are above object shapes in a hierarchy. Shading groups are an example of set containing object shapes. In all situations, a connection is made using the "message" attribute of the light or object.

This node is MP safe

Node nameParentsMFn typeCompatible function sets
lightLinkerdependNodekLightLinkkBase
kNamedObject
kDependencyNode
kLightLink

Related nodes

lightFog, envFog, lightList

Attributes (12)

ignore, light, lightIgnored, link, object, objectIgnored, shadowIgnore, shadowLight, shadowLightIgnored, shadowLink, shadowObject, shadowObjectIgnored

Long name (short name)TypeDefaultFlags
link (lnk) compoundn/aarrayoutputinputconnectablestorable
This attribute is used to make lights illuminate objects.
light (llnk) Messagen/aoutputinputconnectable
A light connected to this node illuminates an object connected to the "object" child of the same index of the "link" attribute.
object (olnk) Messagen/aoutputinputconnectable
An object connected to this node is illuminated by a light connected to the "light" child of the same index of the "link" attribute.
ignore (ign) compoundn/aarrayoutputinputconnectablestorable
This attribute is used to make lights not illuminate objects.
lightIgnored (lign) Messagen/aoutputinputconnectable
A light connected to this node is ignored by an object connected to the "object" child of the same index of the "ignore" attribute.
objectIgnored (oign) Messagen/aoutputinputconnectable
An object connected to this node ignores a light connected to the "light" child of the same index of the "ignore" attribute.
shadowLink (slnk) compoundn/aarrayoutputinputconnectablestorable
This attribute is used to make lights shadow objects.
shadowLight (sllk) Messagen/aoutputinputconnectable
A light connected to this node shadows an object connected to the "shadowObject" child of the same index of the "shadowLink" attribute.
shadowObject (solk) Messagen/aoutputinputconnectable
An object connected to this node is shadowed by a light connected to the "shadowLight" child of the same index of the "shadowLink" attribute.
shadowIgnore (sign) compoundn/aarrayoutputinputconnectablestorable
This attribute is used to prevent lights from shadowing objects.
shadowLightIgnored (slig) Messagen/aoutputinputconnectable
A light connected to this node ignores an object, connected to the "shadowObject" child of the same index of the "shadowIgnore" attribute, when calculating shadows.
shadowObjectIgnored (soig) Messagen/aoutputinputconnectable
An object connected to this node ignores a light, connected to the "shadowLight" child of the same index of the "shadowIgnore" attribute, when calculating shadows.