Creating Portal Lights

A Portal Light on its own will not contribute light to the scene. The Portal needs to be a child of a Dome Light to have any contribution. A Portal inherits parameters from the parent Dome and either multiplies or overrides those parameters if its own equivalent parameter is set.

A future version of Katana will allow the creation of PxrPortalLights as children of PxrDomeLights in a single GafferThree. But until then, using Portal Lights requires a multiple GafferThree set up.

In the first GafferThree, create your PxrDomeLight. Then create a second GafferThree with the location equal to the location of the PxrDomeLight. In this GafferThree, place all the Portal Lights that you want to have attached to the Dome.

Image Removed

You can create multiple Domes with any number of Portals by adding a separate GafferThree for each Dome's set of Portals.

Image Added

Light Filters and Portal Lights

Any light filter applied to a dome light will automatically be applied to that dome's portal lights.  Portal lights can also have their own light filters.