Version: Unity 6.7 Alpha (6000.7)
LanguageEnglish
  • C#

SupportedRenderingFeatures.divideBakedOutputByPI

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public bool divideBakedOutputByPI;

Description

Determines whether baked lighting output is divided by PI, matching Unity's historical baked lighting convention.

When enabled, baked lightmaps and spherical harmonics lighting data store irradiance divided by PI, which matches Unity's historical baked lighting convention. This affects lightmap and light probe post processing, the ambient probe, and spherical harmonics produced by SphericalHarmonicsL2.AddAmbientLight and SphericalHarmonicsL2.AddDirectionalLight. IProbePostProcessor.ConvertToUnityFormat takes the convention as an explicit parameter instead. Because Unity also applies this setting to lighting data it generates at runtime, such as the ambient probe, the render pipeline must set this property in built players as well as in the Editor. Disable this if the render pipeline expects raw irradiance and applies the full Lambertian BRDF (albedo divided by PI) in shaders. Changing this value doesn't update any existing lighting data: bake lighting again to update baked lightmaps and probes, and regenerate the ambient probe, for example with DynamicGI.UpdateEnvironment. Enlighten realtime Global Illumination is not supported when this property is disabled.