Version: 2023.2
LanguageEnglish
  • C#

RenderSettings.ambientProbe

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 static Rendering.SphericalHarmonicsL2 ambientProbe;

Description

An ambient probe that captures environment lighting.

Unity generates the ambient probe when you generate lighting for a scene. If you haven't yet generated lighting in a scene, Unity uses a default ambient probe that matches the default skybox instead. Unity uses the ambient probe to make sure environment lighting affects your scene and the GameObjects in it by default.

Unity does not use this probe to affect GameObjects that you manually associate with Light Probes and light maps in the Global Illumination system. This is because manually generated Light Probes and light maps include an environment contribution by default.

As a result, adjusting this automatically generated ambient probe does not affect Enlighten Realtime Global Illumination and Baked Global Illumination lighting results. If you want to affect Global Illumination values with this ambient probe, select an AmbientMode and make any manual adjustments needed to use that mode.

Additional resources: ambientMode, SphericalHarmonicsL2, The Lighting window.