Merge pull request #2047 from corrigentia/patch-66

Tweak environment_and_post_processing

tutorials/3d/environment_and_post_processing.rst

@@ -59,7 +59,7 @@ Background
 ^^^^^^^^^^
 
 The Background section contains settings on how to fill the background (parts of
-the screen where objects where not drawn). In Godot 3.0, the background not only
+the screen where objects were not drawn). In Godot 3.0, the background not only
 serves the purpose of displaying an image or color, it can also change how objects
 are affected by ambient and reflected light.
 
@@ -68,9 +68,9 @@ are affected by ambient and reflected light.
 There are many ways to set the background:
 
 - **Clear Color** uses the default clear color defined by the project. The background will be a constant color.
-- **Custom Color** is like Clear Color but with a custom color value.
+- **Custom Color** is like Clear Color, but with a custom color value.
 - **Sky** lets you define a panorama sky (a 360 degree sphere texture) or a procedural sky (a simple sky featuring a gradient and an optional sun). Objects will reflect it and absorb ambient light from it.
-- **Color+Sky** lets you define a sky (as above) but uses a constant color value for drawing the background. The sky will only be used for reflection and ambient light.
+- **Color+Sky** lets you define a sky (as above), but uses a constant color value for drawing the background. The sky will only be used for reflection and ambient light.
 
 Ambient Light
 ^^^^^^^^^^^^^
@@ -88,19 +88,19 @@ enabled).
 
 When a *Sky* is set as background, it's possible to blend between ambient color
 and sky using the **Sky Contribution** setting (this value is 1.0 by default for
-convenience so only sky affects objects).
+convenience, so only the sky affects objects).
 
 Here is a comparison of how different ambient light affects a scene:
 
 .. image:: img/environment_ambient2.png
 
-Finally there is a **Energy** setting, which is a multiplier, useful when working with HDR.
+Finally there is an **Energy** setting, which is a multiplier, useful when working with HDR.
 
 In general, ambient light should only be used for simple scenes, large exteriors,
 or for performance reasons (ambient light is cheap), as it does not provide the
 best lighting quality. It's better to generate
 ambient light from ReflectionProbe or GIProbe, which will more faithfully simulate
-how indirect light propagates. Below is a comparison in quality between using a
+how indirect light propagates. Below is a comparison, in terms of quality, between using a
 flat ambient color and a GIProbe:
 
 .. image:: img/environment_ambient_comparison.png
@@ -143,7 +143,7 @@ Tone mapping options are:
 
 - **Mode:** Tone mapping mode, which can be Linear, Reindhart, Filmic, or Aces.
 - **Exposure:** Tone mapping exposure which simulates amount of light received over time.
-- **White:** Tone mapping white which simulates where in the scale is white located (by default 1.0).
+- **White:** Tone mapping white, which simulates where in the scale white is located (by default 1.0).
 
 Auto Exposure (HDR)
 ^^^^^^^^^^^^^^^^^^^
@@ -160,7 +160,7 @@ different amounts of light.
 The simplest way to use auto exposure is to make sure outdoor lights (or other
 strong lights) have energy beyond 1.0. This is done by tweaking their **Energy**
 multiplier (on the Light itself). To make it consistent, the **Sky** usually
-needs to use the energy multiplier too, to match the with the directional light.
+needs to use the energy multiplier too, to match with the directional light.
 Normally, values between 3.0 and 6.0 are enough to simulate indoor-outdoor conditions.
 
 By combining Auto Exposure with *Glow* post processing (more on that below),
@@ -170,7 +170,7 @@ creating the typical bloom effect in photography.
 .. image:: img/environment_hdr_bloom.png
 
 The user-controllable values in the Auto Exposure section come with sensible
-defaults, but you can still tweak then:
+defaults, but you can still tweak them:
 
 .. image:: img/environment_hdr.png
 
@@ -179,11 +179,11 @@ defaults, but you can still tweak then:
 - **Max Luma:** Maximum luminance that auto exposure will aim to adjust for.
 - **Speed:** Speed at which luminance corrects itself. The higher the value, the faster correction happens.
 
-Mid and post-processing effects
--------------------------------
+Mid- and post-processing effects
+--------------------------------
 
-A large amount of widely-used mid and post-processing effects are supported
-in Environment.
+A large amount of widely-used mid- and post-processing effects are supported
+in the Environment.
 
 Screen-Space Reflections (SSR)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -196,8 +196,8 @@ contact with each other (object over floor, over a table, floating on water, etc
 .. image:: img/environment_ssr.png
 
 The other advantage (even if only enabled to a minimum), is that it works in real-time
-(while the other types of reflections are pre-computed). This is great to
-make characters, cars, etc. reflect when moving around.
+(while the other types of reflections are pre-computed). This can be used to
+make characters, cars, etc. reflect on surrounding surfaces when moving around.
 
 A few user-controlled parameters are available to better tweak the technique:
 
@@ -216,15 +216,15 @@ As mentioned in the **Ambient** section, areas where light from light nodes
 does not reach (either because it's outside the radius or shadowed) are lit
 with ambient light. Godot can simulate this using GIProbe, ReflectionProbe,
 the Sky, or a constant ambient color. The problem, however, is that all the
-methods proposed before act more on a larger scale (large regions) than at the
+methods proposed previously act more on a larger scale (large regions) than at the
 smaller geometry level.
 
-Constant ambient color and Sky are uniform and the same everywhere while GI and
-Reflection probes have more local detail but not enough to simulate situations
+Constant ambient color and Sky are the same everywhere, while GI and
+Reflection probes have more local detail, but not enough to simulate situations
 where light is not able to fill inside hollow or concave features.
 
 This can be simulated with Screen Space Ambient Occlusion. As you can see in the
-image below, the goal of it is to make sure concave areas are darker, simulating
+image below, its purpose is to make sure concave areas are darker, simulating
 a narrower path for the light to enter:
 
 .. image:: img/environment_ssao.png
@@ -233,7 +233,7 @@ It is a common mistake to enable this effect, turn on a light, and not be able t
 appreciate it. This is because SSAO only acts on *ambient* light, not direct light.
 
 This is why, in the image above, the effect is less noticeable under the direct
-light (at the left). If you want to force SSAO to work with direct light too, use
+light (on the left). If you want to force SSAO to work with direct light too, use
 the **Light Affect** parameter (even though this is not correct, some artists like how it looks).
 
 SSAO looks best when combined with a real source of indirect light, like GIProbe:
@@ -247,9 +247,9 @@ Tweaking SSAO is possible with several parameters:
 - **Radius/Intensity:** To control the radius or intensity of the occlusion, these two parameters are available. Radius is in world (Metric) units.
 - **Radius2/Intensity2:** A Secondary radius/intensity can be used. Combining a large and a small radius AO generally works well.
 - **Bias:** This can be tweaked to solve self occlusion, though the default generally works well enough.
-- **Light Affect:** SSAO only affects ambient light but increasing this slider can make it also affect direct light. Some artists prefer this effect.
-- **Quality:** Depending on quality, SSAO will do more samplings over a sphere for every pixel. High quality only works well on modern GPUs.
-- **Blur:** Type of blur kernel used. The 1x1 kernel is a simple blur that preserves local detail better but is not as efficient (generally works better with high quality setting above), while 3x3 will soften the image better (with a bit of dithering-like effect) but does not preserve local detail as well.
+- **Light Affect:** SSAO only affects ambient light, but increasing this slider can make it also affect direct light. Some artists prefer this effect.
+- **Quality:** Depending on quality, SSAO will take more samples over a sphere for every pixel. High quality only works well on modern GPUs.
+- **Blur:** Type of blur kernel used. The 1x1 kernel is a simple blur that preserves local detail better, but is not as efficient (generally works better with the high quality setting above), while 3x3 will soften the image better (with a bit of dithering-like effect), but does not preserve local detail as well.
 - **Edge Sharpness**: This can be used to preserve the sharpness of edges (avoids areas without AO on creases).
 
 Depth of Field / Far Blur
@@ -293,7 +293,7 @@ of the image. This is simulated in Godot with the **Glow** effect.
 By default, even if the effect is enabled, it will be weak or invisible. One of
 two conditions need to happen for it to actually show:
 
-- 1) The light in a pixel surpasses the **HDR Threshold** (where 0 is all light surpasses it, and 1.0 is light over the tonemapper **White** value). Normally this value is expected to be at 1.0, but it can be lowered to allow more light to bleed. There is also an extra parameter, **HDR Scale** that allows scaling (making brighter or darker) the light surpassing the threshold.
+- 1) The light in a pixel surpasses the **HDR Threshold** (where 0 is all light surpasses it, and 1.0 is light over the tonemapper **White** value). Normally, this value is expected to be at 1.0, but it can be lowered to allow more light to bleed. There is also an extra parameter, **HDR Scale**, that allows scaling (making brighter or darker) the light surpassing the threshold.
 
 .. image:: img/environment_glow_threshold.png
 
@@ -306,17 +306,17 @@ Both will cause the light to start bleeding out of the brighter areas.
 Once glow is visible, it can be controlled with a few extra parameters:
 
 - **Intensity** is an overall scale for the effect, it can be made stronger or weaker (0.0 removes it).
-- **Strength** is how strong the gaussian filter kernel is processed. Greater values make the filter saturate and expand outwards. In general changing this is not needed, as the size can be more efficiently adjusted with the **Levels**.
+- **Strength** is how strong the gaussian filter kernel is processed. Greater values make the filter saturate and expand outwards. In general, changing this is not needed, as the size can be more efficiently adjusted with the **Levels**.
 
 The **Blend Mode** of the effect can also be changed:
 
-- **Additive** is the strongest one, as it just adds the glow effect over the image with no blending involved. In general, it's too strong to be used but can look good with low intensity Bloom (produces a dream-like effect).
+- **Additive** is the strongest one, as it just adds the glow effect over the image with no blending involved. In general, it's too strong to be used, but can look good with low intensity Bloom (produces a dream-like effect).
 - **Screen** is the default one. It ensures glow never brights more than itself and works great as an all around.
 - **Softlight** is the weakest one, producing only a subtle color disturbance around the objects. This mode works best on dark scenes.
 - **Replace** can be used to blur the whole screen or debug the effect. It just shows the glow effect without the image below.
 
 To change the glow effect size and shape, Godot provides **Levels**. Smaller
-levels are strong glows that appear around objects while large levels are hazy
+levels are strong glows that appear around objects, while large levels are hazy
 glows covering the whole screen:
 
 .. image:: img/environment_glow_layers.png