Update 3D lights and shadows documentation for 4.0

godotengine · Feb 27, 2023 · bc3f3ac · bc3f3ac
1 parent c8d0af5
commit bc3f3ac
Show file tree

Hide file tree

Showing 29 changed files with 392 additions and 118 deletions.
diff --git a/tutorials/3d/3d_antialiasing.rst b/tutorials/3d/3d_antialiasing.rst
@@ -73,6 +73,8 @@ Note that alpha antialiasing is not used here:
 
 .. image:: img/antialiasing_msaa_8x.webp
 
+.. _doc_3d_antialiasing_taa:
+
 Temporal antialiasing (TAA)
 ---------------------------
 
@@ -103,6 +105,8 @@ Comparison between no antialiasing (left) and TAA (right):
 
 .. image:: img/antialiasing_taa.webp
 
+.. _doc_3d_antialiasing_fxaa:
+
 Fast approximate antialiasing (FXAA)
 ------------------------------------
 

diff --git a/tutorials/3d/img/lights_and_shadows_acne.webp b/tutorials/3d/img/lights_and_shadows_acne.webp
diff --git a/tutorials/3d/img/lights_and_shadows_blur.webp b/tutorials/3d/img/lights_and_shadows_blur.webp
diff --git a/tutorials/3d/img/lights_and_shadows_directional_mode.webp b/tutorials/3d/img/lights_and_shadows_directional_mode.webp
diff --git a/tutorials/3d/img/lights_and_shadows_directional_shadow_params.webp b/tutorials/3d/img/lights_and_shadows_directional_shadow_params.webp
diff --git a/tutorials/3d/img/lights_and_shadows_dual_parabolid_vs_cubemap.webp b/tutorials/3d/img/lights_and_shadows_dual_parabolid_vs_cubemap.webp
diff --git a/tutorials/3d/img/lights_and_shadows_filter_quality.webp b/tutorials/3d/img/lights_and_shadows_filter_quality.webp
diff --git a/tutorials/3d/img/lights_and_shadows_omni_projector.webp b/tutorials/3d/img/lights_and_shadows_omni_projector.webp
diff --git a/tutorials/3d/img/lights_and_shadows_omni_projector_example.webp b/tutorials/3d/img/lights_and_shadows_omni_projector_example.webp
diff --git a/tutorials/3d/img/lights_and_shadows_pcss.webp b/tutorials/3d/img/lights_and_shadows_pcss.webp
diff --git a/tutorials/3d/img/lights_and_shadows_peter_panning.webp b/tutorials/3d/img/lights_and_shadows_peter_panning.webp
diff --git a/tutorials/3d/img/lights_and_shadows_pssm_explained.webp b/tutorials/3d/img/lights_and_shadows_pssm_explained.webp
diff --git a/tutorials/3d/img/lights_and_shadows_shadow_quadrants.webp b/tutorials/3d/img/lights_and_shadows_shadow_quadrants.webp
diff --git a/tutorials/3d/img/lights_and_shadows_shadow_quadrants2.webp b/tutorials/3d/img/lights_and_shadows_shadow_quadrants2.webp
diff --git a/tutorials/3d/img/lights_and_shadows_spot_projector.webp b/tutorials/3d/img/lights_and_shadows_spot_projector.webp
diff --git a/tutorials/3d/img/lights_and_shadows_spot_projector_example.webp b/tutorials/3d/img/lights_and_shadows_spot_projector_example.webp
diff --git a/tutorials/3d/img/pssm_explained.png b/tutorials/3d/img/pssm_explained.png
diff --git a/tutorials/3d/img/shadow_atlas.png b/tutorials/3d/img/shadow_atlas.png
diff --git a/tutorials/3d/img/shadow_bias.png b/tutorials/3d/img/shadow_bias.png
diff --git a/tutorials/3d/img/shadow_blocky.png b/tutorials/3d/img/shadow_blocky.png
diff --git a/tutorials/3d/img/shadow_contact.png b/tutorials/3d/img/shadow_contact.png
diff --git a/tutorials/3d/img/shadow_omni_dp_cm.png b/tutorials/3d/img/shadow_omni_dp_cm.png
diff --git a/tutorials/3d/img/shadow_pcf1.png b/tutorials/3d/img/shadow_pcf1.png
diff --git a/tutorials/3d/img/shadow_pcf2.png b/tutorials/3d/img/shadow_pcf2.png
diff --git a/tutorials/3d/img/shadow_pssm.png b/tutorials/3d/img/shadow_pssm.png
diff --git a/tutorials/3d/img/shadow_quadrants.png b/tutorials/3d/img/shadow_quadrants.png
diff --git a/tutorials/3d/img/shadow_quadrants2.png b/tutorials/3d/img/shadow_quadrants2.png
diff --git a/tutorials/3d/introduction_to_3d.rst b/tutorials/3d/introduction_to_3d.rst
@@ -193,7 +193,7 @@ When created from the Project Manager, the 3D environment has a default sky.
 
 .. image:: img/tuto_3d8.png
 
-Given how physically based rendering works, it is advised to always try to
+Given how physically-based rendering works, it is advised to always try to
 work with a default environment in order to provide indirect and reflected
 light to your objects.
 
@@ -230,5 +230,10 @@ each viewport:
 Lights
 ------
 
-There is no limitation on the number of lights, nor of types of lights, in
-Godot. As many as desired can be added (as long as performance allows).
+The background environment emits some ambient light which appears on surfaces.
+Still, without any light sources placed in the scene, the scene will appear
+quite dark unless the background environment is very bright.
+
+Most outdoor scenes have a directional light (the sun or moon), while indoor
+scenes typically have several positional lights (lamps, torches, …).
+See :ref:`doc_lights_and_shadows` for more information on setting up lights in Godot.
diff --git a/tutorials/3d/lights_and_shadows.rst b/tutorials/3d/lights_and_shadows.rst