This is RenderMan 21 Documentation you are viewing. The Rmanwiki home page will redirect you to the current documentation.
Light Filters are used to manipulate lighting results. In the real world this is often achieved through the use of stencils and gels to change the color, quality, and amount of light in a shot. RenderMan's light filters are a powerful and flexible way to do the same (and even more) in lighting your scenes.
Creating Light Filters
To create a light filter in Maya, first select one or more RenderMan lights. Then right-click on the light filter button in the RenderMan shelf and choose a type of light filter. The light filter is created and wired into the selected light. As a convenience, the light filter is created at the same location as the selected light. Usually you will want to move the light filter somewhat forward from the light. The light filter is not parented under the light by default, but you may wish to do that if you want the light filter to always move around with its parent light.
For all the RenderMan light types, in the Attribute Editor, you'll see a section toward the bottom called "Light Filters". The shelf button automatically wires light filters in, but they can also be created and wired in by right-clicking on one of the controls in that section. More than one light filter can be wired in. Each time a filter is wired up, a new control will appear to allow for another.
Light Filter Types
For detailed information about parameters, follow the links for each light filter type.
Barn Door Light Filter
PxrBarnLightFilter allows you to create physically accurate window barns to simulate real set lighting with correct shadowing. Its other usages include controlling bounce lights in a large scene. In addition to the physical mode, it also provides an analytic mode.
Blocker Light Filter
PxrBlockerLightFilter uses a "rod" like object to block light. The blocker can be shaped into an irregular shape and is then placed next to the object where you want to block the light.
Rod Light Filter
PxrRodLightFilter is similar to the above PxrBlockerLightFilter but with more controls and flexibility.
Gobo Light Filter
PxrGoboLightFilter projects a painted texture in front of the light.
Cookie Light Filter
PxrCookieLightFilter is similar to the PxrGoboLightFilter but with more options and flexibility.
Intensity Light Filter
PxrIntMultLightFilter is a light filter that allows you to multiply the intensity/exposure of the light. This is very useful when you want to isolate a particular asset from the rest of the scene that has different intensity/exposure.
The position of the PxrIntMultLightFilter is not relevant. You'll want to use Maya's light linking to link this light filter to particular objects for which a particular lighting effect needs to be brighter or darker.
Ramp Light Filter
PxrRampLightFilter uses a ramp to control the light. This allows complex control of color, intensity, and more.