Page tree


PxrMeshLight allows you to create arbitrary shapes and use them as bonafide light sources. This improves performance over emissive geometry and provides great flexibility for creating things like neon lights, futuristic light panels, and deforming shapes that light a scene.

The parameters are simple and easy to tune and the light follows the shape's render visibility as opposed to selections on the light.

While you may use a meshlight as a deforming piece of geometry, deformation motion blur is not yet supported and could provide incorrect results.

Light filters do not currently work with mesh lights.

In creating a meshlight, you may see a material connected to it called PxrBlack. This material has no parameters and is designed to prevent the mesh from scattering light a second time from itself. This is done to provide something intuitive, not necessarily something physical.






The color of the emitted light.


Scales the contribution of this light linearly. The light intensity is computed using physical falloff.



Specifies the exposure of the area light as a power of 2. Increasing the exposure by 1 will double the energy emitted by the light source. A value of 0 produces an intensity of 1 at the source, -1 produces 0.5. R eal world lighting has high energies and typical exposures are low values while you may have to type a really large number for equivalent Intensity. This is also comfortable to artists familiar with photographic measurements.


Texture Color

An image to use as a light source using a pattern node, e.g. PxrTexture. Preferably a High Dynamic Range source. Notice this affects color and shadowing based on the contents of the HDRI used. If forced to use an 8-bit source such as a JPEG image, it should be linearized (transformed to linear color space) before use as a color. Since this is indeed a mesh, you must have defined UVs or appropriate projections to place your texture correctly.


Enable Temperature

Turns color temperature on or off.



Allow the user to choose the color temperature of the light in Kelvins. Unlike the basic light color, this allows the user to easily pick plausible light colors based on standard temperature measurements.This control will act like a filter or gel (a tinted transparent surface) in front of your light. If your light is white, you will get the chosen color temperature. If your light is colored, the color temperature will make it cooler (over 6500K) or warmer (below 6500K).


The effect will be less pronounced on fully saturated mono-chromatic lights. Defaults to 6500K, which should be very close to white on most monitors (D65 illuminant used by sRGB and Rec 709).





Specular Amount

Amount of specular light that is emitted. This is a non-physical control. You could use a light with  Specular Amount  0.0 to act purely as a source of diffuse light for your scene objects and avoid adding highlights. 


Diffuse Amount

Amount of diffuse light that is emitted. This is a non-physical control. You could use a light with  Diffuse Amount  0.0 to act purely as a source of highlights for your scene objects.





Area Normalize

When normalize is enabled, the amount of light contributed to the scene will not change as you scale the light source. This makes it easier to adjust highlight size without changing scene lighting.


Trace Light Paths

Enable light and photon tracing from this light. This value enforces a physically-based light and as a side-effect disables the above Shadows controls. Users may use this feature to selectively decide which lights emit photons when using the PxrVCM or PxrUnified Integrators.


Thin Shadow

Enable thin shadow and disable refraction caustics for this light. This parameter will ignored if Trace Light Paths is enabled. This is a non-physical control that creates "fake" colored shadows for transmissive objects without needing to generate photons for caustics.


Light Group

Specify the light group name used for light group LPEs. This is useful to generate per-light AOVs for later adjustment in compositing.


Importance Multiplier

Rather than setting explicit Light Samples, users can change the amount of samples the light will be assigned internally by changing this value. RenderMan creates a set of samples at render time for all lights in the scene and changing this value rebalances the samples across the lights. Note that increasing this value will cause more samples to be selected from this light while reducing it for others in the scene. Lower than the default will decrease the samples while providing more to others in the scene.