Contact Support

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.