---
title: "Lighting in Katana"
canonical: "https://rmanwiki-26.pixar.com/space/RFK26/20218718/Lighting%20in%20Katana"
format: markdown
---
### About Analytic Lights

One of the most valuable features of RenderMan for Katana (RfK) is the ability to create and manage Lights. The sections below provide a brief overview of how to take advantage of these capabilities.


### Using RenderMan LightPackages

![image](media://cc9fdebc-60ef-457d-be83-78e3946572ee)

  


RfK offers PRMan-specific light packages for creating each type of light in GafferThree. These light packages minimize the number of steps necessary to create a light. [Shortcuts](https://renderman.atlassian.net/wiki/spaces/RFK26/pages/20218654) let you add a light with only one keystroke. Each light package also includes a set of light-specific attributes, available in the Object tab of GafferThree, which lets you control certain attributes per-light without adding an additional PrmanObjectStatements node.   
  
The PxrMeshLight package includes the following attributes:

![image](media://8d33432c-2d62-4d16-8cd1-4df495864c7d)


The analytic light packages only include Camera Visibility, which is set 'Off' by default, because the renderer ignores the other visibility attributes for analytic lights.


### Creating Mesh Lights

There is a specific light package for creating mesh lights in GafferThree. To create a mesh light, select the desired geometry in the Scene Graph and add a "PxrMeshLight" in GafferThree. You can find a detailed explanation about mesh light setup in the link below:

- [Mesh Lights in RfK](https://renderman.atlassian.net/wiki/spaces/RFK26/pages/20218526)


### Using Light Filters

Light filters are a powerful way to control a light's appearance. With Katana 2.0 or 2.1, light filters can be added to a scene with a PrmanLightFilterCreate node. GafferThree support for light filters is available in Katana 2.2 and above. You can find a detailed explanation about light filter setup in the link below:

- [Light Filters in Katana](https://renderman.atlassian.net/wiki/spaces/RFK26/pages/20218662)


### Using Portal Lights

[PxrPortalLight](https://renderman.atlassian.net/wiki/spaces/REN26/pages/19661743) is an optimized environment light. Because Portals are lights, not light filters, they require a special workflow. GafferThree support for portal lights is coming in a future version of Katana. You can find a detailed explanation about portal light setup in the link below:

- [Portal Lights in Katana](https://renderman.atlassian.net/wiki/spaces/RFK26/pages/20218660)


### Light Sampling

Light Sampling capabilities are available through sample balancing in the integrator, typically with the **numLightSamples** option. Or using the Importance multiplier on the Light Parameter list to draw more samples from the sample pool.