Version: 2018.1
LOD and Realtime GI
Lightmapping: Getting started

Progressive Lightmapper

Progressive Lightmapper is a fast path-tracing-based lightmapper system that provides baked lightmaps and Light Probes with progressive updates in the Editor. It requires non-overlapping UVs with small area and angle errors, and sufficient padding between the charts.

Progressive Lightmapper takes a short preparation step to process geometry and instance updates, and generates the G-buffer and chart masks. It then produces the output immediately and progressively refines it over time for a much-improved interactive lighting workflow. Additionally, baking times are much more predictable because Progressive Lightmapper provides an estimated time while it bakes.

Progressive Lightmapper also bakes global illumination (GI) at the lightmap resolution for each texel individually, without upsampling schemes or relying on any irradiance caches or other global data structures. This makes it robust and allows you to bake selected portions of lightmaps, which makes it faster for you to test and iterate on your Scene.

For an in-depth video showing the interactive workflow, see Unity’s video walkthrough: In Development - Progressive Lightmapper (YouTube).

Settings

To open the settings, go to Window > Lighting > Settings.

Property: Function:
Lighting Mode Specifies which lighting mode Unity should use for all mixed lights in the Scene. Options are Baked Indirect, Distance Shadowmask, Shadowmask, and Subtractive.
Lightmapper Use this to specify which internal lighting calculation software to use to calculate lightmaps in the Scene. The options are Progressive and Enlighten. The default value is Progressive. If you want to use the Enlighten system, see documentation on Enlighten.
Prioritize View Enable this to make the Progressive Lightmapper apply changes to the texels that are currently visible in the Scene View, then apply changes to the out-of-view texels.
Direct Samples The number of samples (paths) shot from each texel. This setting controls the number of samples Progressive Lightmapper uses for direct lighting calculations. Increasing this value can improve the quality of lightmaps, but increases the baking time.
Indirect Samples The number of samples (paths) shot from each texel. This setting controls the number of samples Progressive Lightmapper uses for indirect lighting calculations. For some Scenes, especially outdoor Scenes, 100 samples should be enough. For indoor Scenes with emissive geometry, increase the value until you see the result you want.
Bounces Use this value to specify the number of indirect bounces to do when tracing paths. For most Scenes, two bounces is enough. For some indoor Scenes, more bounces might be necessary.
Filtering Configure the post-processing of lightmaps to limit noise. You can set it to None, Auto or Advanced. The Advanced option offers three additional parameters for manual configuration. In Auto mode, the default values from the Advanced mode are used. For every parameter, Gaussian or A-Trous filter can be used separately.
Auto Uses default values for post-processing lightmaps.
Advanced Offers three additional parameters for manual configuration. You can use the Gaussian or A-Trous filters separately for direct and indirect settings. Note that the Gaussian filter values define the radius, while the A-Trous filter value defines the “sigma”. Sigma is a parameter that determines the threshold at which the filter acts on differences in the image.
Direct Filter Select a filter to use for direct light in the lightmap.
Gaussian Select this to use a Gaussian filter for direct light in the lightmap.
Direct Radius The radius of the Gaussian filter in texels for direct light in the lightmap. A higher radius increases the blur strength.
A-Trous Select this to use an A-Trous filter for direct light in the lightmap.
Direct Sigma The sigma of the A-Trous filter in texels for direct light in the lightmap. A higher sigma increases the blur strength.
None Select this to use no filter for direct light in the lightmap.
Indirect Filter Select a filter to use for indirect light in the lightmap.
Gaussian Select this to use a Gaussian filter for indirect light in the lightmap.
Indirect Radius The radius of the Gaussian filter in texels for indirect light in the lightmap. A higher radius increases the blur strength.
A-Trous Select this to use an A-Trous filter for indirect light in the lightmap.
Indirect Sigma The sigma of the A-Trous filter in texels for indirect light in the lightmap. A higher sigma increases the blur strength.
Ambient Occlusion Filter Select a filter to use for Ambient Occlusion (see below) in the lightmap. Filter only available when you enable Ambient Occlusion.
Gaussian Select this to use a Gaussian filter for Ambient Occlusion in the lightmap.
Ambient Occlusion Radius The radius of the Gaussian filter in texels for Ambient Occlusion in the lightmap. A higher radius increases the blur strength.
A-Trous Select this to use an A-Trous filter for Ambient Occlusion in the lightmap.
Ambient Occlusion Sigma The sigma of the A-Trous filter in texels for Ambient Occlusion in the lightmap. A higher sigma increases the blur strength.
None Select this to use no filter for indirect light in the lightmap.
Lightmap Resolution Use this to specify the number of texels per unit to use for lightmaps. Increasing this value improves lightmap quality, but also increases bake times. Note that doubling this value causes the number of texels to quadruple (because the value refers to both the height and width of the lightmap). Check the Occupied texels count in the stats, documented below this table.
Lightmap Padding Use this to specify the separation (in texel units) between separate shapes in the baked lightmap. The default value is 2.
Lightmap Size The size (in pixels) of the full lightmap texture, which incorporates separate regions for the individual GameObject textures. The default value is 1024.
Compress Lightmaps A compressed lightmap requires less storage space, but the compression process can introduce unwanted visual effects into the texture. Tick this checkbox to compress lightmaps, or untick it to keep them uncompressed. The checkbox is ticked by default.
Ambient Occlusion Tick this checkbox to open a group of settings which allow you to control the relative brightness of surfaces in ambient occlusion. Higher values indicate a greater contrast between the occluded and fully lit areas. This only applies to the indirect lighting calculated by the GI system. This setting is enabled by default.
Max Distance Set a value to control how far the lighting system casts rays in order to determine whether or not to apply occlusion to an object. A larger value produces longer rays and contributes more shadows to the lightmap, while a smaller value produces shorter rays that contribute shadows only when objects are very close to one another. A value of 0 casts an infinitely long ray that has no maximum distance. The default value is 1.
Indirect Contribution Use the slider to scale the brightness of indirect light as seen in the final lightmap (that is, ambient light, or light bounced and emitted from objects) from a value between 0 and 10. The default value is 1. Values less than 1 reduce the intensity, while values greater than 1 increase it.
Direct Contribution Use the slider to scale the brightness of direct light from a value between 0 and 10. The default value is 0. The higher this value is, the greater the contrast applied to the direct lighting.
Directional Mode You can set the lightmap up to store information about the dominant incoming light at each point on the objects’ surfaces. See documentation on Directional Lightmapping for further details. The default mode is Directional.
Directional In Directional mode, Unity generates a second lightmap to store the dominant direction of incoming light. This allows diffuse normal mapped materials to work with the GI. Directional mode requires about twice as much storage space for the additional lightmap data. Directional lightmaps cannot be decoded on SM2.0 hardware or when using GLES2.0. They fall back to Non-Directional lightmaps.
Non-directional Non-directional mode switches Directional option off.
Indirect Intensity Use this slider to control the brightness of indirect light stored in realtime and baked lightmaps, from a value between 0 and 5. A value above 1 increases the intensity of indirect light while a value of less that 1 reduces indirect light intensity. The default value is 1.
Albedo Boost Use this slider to control the amount of light Unity bounces between surfaces, from a value between 1 and 10. To do this, Unity intensifies the albedo of materials in the Scene. Increasing this draws the albedo value towards white for indirect light computation. The default value of 1 is physically accurate.
Lightmap Parameters Unity uses a set of general parameters for the lightmapping in addition to properties of the Lighting window. A few defaults are available from the menu for this property but you can also create your own lightmap parameter file using the Create New option. See the Lightmap Parameters page for further details. The default value is Default-Medium.

Statistics

The panel below the Auto Generate and Generate Lighting options shows statistics about the lightmapping, including:

  • The number of lightmaps that Unity has created

  • Memory Usage: The amount of memory required for the current lightmapping.

  • Occupied Texels: The number of texels that are occupied in lightmap UV space.

  • Lightmaps in view: The number of lightmaps in the Scene view.

  • Lightmaps not in view: The number of lightmaps that are out of view.

    • Converged: All calculations for these lightmaps are complete.

    • Not Converged: Baking is still in progress for these lightmaps.

  • Bake Performance: The number of mrays per second. If this is low (that is, less than 2) you should adjust your settings or your hardware to process more light rays at a time.

In Auto mode, Unity automatically calculates the lightmaps and Light Probes. If you have Auto disabled, you need to press the Build button to start the bake.

During baking

Progressive Lightmapper provides options to monitor and stop the bake while it is in progress, if you need to.

ETA

The progress bar that appears while Unity is baking the lightmap provides an “estimated time of arrival” (displayed as ETA). This is the estimated time in seconds for the current bake to complete. This allows for much more predictable baking times, and allows you to quickly learn how much time baking takes with your current lighting settings.

Force Stop

During manual baking, press Force Stop at any time to halt the baking process. This allows you to stop the process as soon as you see results that look good.


Progressive Lightmapper added in 2018.1 NewIn20181

2018–03–28 Page amended with limited editorial review

LOD and Realtime GI
Lightmapping: Getting started