Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Light filters can be created in GafferThree. 

Shared Light Filters

Which mode your light filter is in depends on the state of the Shared Light Filter checkbox at the top of the macro. For shared light filters, the Light Filter Location parameter is the Scene Graph location of the light filter. The lightList is the list of lights that are affected by the light filter.  Shared light filters will create multiple new Scene Graph locations: the light filter will be created at the Light Filter Location, and light filter reference locations will be created under each light specified in the lightList parameter.

Image Removed

Parented Light Filters

Uncheck the Shared Light Filter checkbox to create a parented light filter. Set the Light Parent parameter to the Scene Graph location of the light to which you want to attach the filter. Then set the Name parameter to a unique name for your light filter. The light filter will be parented under the Light Parent.  

To share a light filter, select the light filter, then the lights you wish to share it and right-click, choose Share Light Filters from the menu as shown below. The resulting light filter is then shared and display below each light.

Image Added

Image Added

Parented Light Filters

Light filters created while a light is selected are automatically made children of the selected light.


Image Added

Image AddedImage Removed

Lock Size Cone Angle

Only lights with Cone Angle connected to Cookie and Barn filters have the option to match the light filter effect with the light's cone angle parameter.


Coordinate System

  • Coordinate
  • Light + Light Filter
  • Light Filter


Using Light Filters

All light filters have Viewer Modifiers that display the light filters in the Viewer. These Viewer Modifiers are helpful for approximating the shape and color of the light while setting up the light filters in the Viewer. For the Barn, Cookie, and Gobo light filters, you can use the Guide Size parameter in the viewer group at the bottom of the PrmanLightFilterCreate macro to adjust the length of the light filter projection guides.

The provided light filters also have Viewer Manipulators for interactively adjusting the light filter parameters in the Viewer.