@@ -290,14 +290,19 @@ Both of these fog types can have their curve tweaked, making their transition mo
290290
291291Two properties can be tweaked to make the fog effect more interesting:
292292
293- The first is **Sun Amount **, which makes use of the Sun Color property of the fog.
294- When looking towards a directional light (usually a sun), the color of the fog
295- will be changed, simulating the sunlight passing through the fog.
296-
297- The second is **Transmit Enabled ** which simulates more realistic light transmittance.
298- In practice, it makes light stand out more across the fog.
299-
300- .. image :: img/environment_fog_transmission.webp
293+ The first is **Sun Scatter **, which makes use of the DirectionalLight3D's color
294+ and energy in the current scene. When looking towards the directional light
295+ (usually a sun), the fog will be tinted according to the light's color to
296+ simulate the sunlight passing through the fog.
297+
298+ The second is **Aerial Perspective **, which tints the fog color according to the
299+ sky color to better blend the sky with the background. Higher values will result
300+ in more tinting, with ``1.0 `` fully replacing the regular fog color with aerial
301+ perspective. This can be used in large open world levels to provide a better
302+ sense of depth, or to avoid color discontinuities between the sky and fog colors.
303+
304+ If both **Sun Scatter ** and **Aerial Perspective ** are greater than ``0.0 ``, sun
305+ scattering is applied on top of aerial perspective.
301306
302307.. note ::
303308
0 commit comments