Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# LightCreate

This node is used to create a scene graph containing a light. LightCreate does not load the light from any file or asset but instead builds an entirely novel light from the parameters you specify on this node. This node is not used generally, the GafferThree node is often used instead.

Note: LightCreate requires a light shader to function properly.

LightCreate and CameraCreate are identical, except for the type of scene graph locations they create, and the population of the lightList vs. cameraList.

Control (UI) | Default Value | Function
name | /root/world/lgt/light | Sets the scene graph location where the light is created. For example, the default value of /root/world/lgt/light creates a light at the location /root/world/lgt/light. The name parameter options are available in either the scene graph widget or dropdown menu to the right of the parameter. For more information, refer to the Create Scene Graph Location Widget Type in the Common Parameter Widgets.
projection | perspective | Sets the light projection mode: • perspective • othographic
fov | 70 | Controls the field of view angle in degrees.
near | 0.1 | Sets the near clipping plane distance.
far | 100000 | Sets the far clipping plane distance.
screenWindow
left | -1 | This set of four number parameters controls the screen window placement on the imaging plane. They are, in order, left, right, bottom and top bounds of the screen window.
right | 1
bottom | -1
top | 1
LightCreate parameters continued
centerOfInterest | 20 | Offsets the center of interest of the light.
orthographicWidth | 30 | Sets the orthographic projection width.
radius | 1 | Sets the light's radius.
initialState | on | Determines whether the newly-added light location is initially on or off.
previewColor
previewColor | 1, 1, 0 | Specifies the color of the light in the Viewer. This value does not affect the color value of the light when rendering, it's used for testing the placement of lights. For more information, refer to the Color Widget Type in the Common Parameter Widgets.
manipulators > Add
Add Entry | N/A | Adds entries to the manipulators list.
manipulators > manipulator
name | N/A | The name of the manipulator you've created.
preset | default | The preset manipulator type.
selected | Handles | When selected, how the manipulator displays: • Handles - the manipulator is shown with handles. • Outline - the manipulator is shown as an outline around the light. • None - the manipulator display doesn't change when selected.
visible | Outline | When visible, how the manipulator displays: • Handles - the manipulator is shown with handles. • Outline - the manipulator is shown as an outline around the light. • None - the manipulator display doesn't appear.
transform
transform | N/A | Transforms the light according to the SRT or matrix controls. For more information, refer to the Transform Controls Widget Type in the Common Parameter Widgets.
transform > Tools | N/A | Adjusts the light to match selected scene graph selection options in the dropdown menu. For more information, refer to the Transform Tools Widget Type in the Common Parameter Widgets.
LightCreate parameters continued
makeInteractive | Yes | When set to Yes, you can drag objects in the Viewer and Katana retains the information from the Viewer.