Add back information about per-vertex shading (#10281)

* Add back information about per-vertex shading

---------

Co-authored-by: Hugo Locurcio <[email protected]>

tutorials/3d/standard_material_3d.rst

@@ -244,34 +244,42 @@ Shading
 Shading mode
 ~~~~~~~~~~~~
 
-Godot has a more or less uniform cost per pixel thanks to the depth pre-pass.
-All lighting calculations are made by running the lighting shader on every
-pixel.
-
-As these calculations are costly, performance can be brought down considerably
-in some corner cases such as drawing several layers of transparency (which is
-common in particle systems). Switching to the **Unshaded** shading mode may help improve
-performance in these cases, especially when the camera is close to particles.
-
-Additionally, on low-end or mobile devices, switching to unshaded rendering
-can considerably increase rendering performance.
-
-.. image:: img/spatial_material26.png
-
-Keep in mind that when unshaded rendering is enabled, lights will not affect the
-material at all.
-
-.. UPDATE: Not implemented. When per-vertex shading is implemented, remove this
-.. note and remove this comment.
-
-.. note::
-
-    **Per-Vertex** shading is listed as an option in the shading mode property.
-    However, per-vertex shading is currently unimplemented and will act
-    identical to per-pixel shading.
-
-    Support for per-vertex shading is planned to be reimplemented in a future
-    Godot release.
+Materials support three shading modes: **Per-Pixel**, **Per-Vertex**, and
+**Unshaded**.
+
+.. figure:: img/standard_material_shading_modes.webp
+  :align: center
+  :alt: Three spheres showing the Per-Pixel, Per-Vertex, and Unshaded modes.
+
+The **Per-Pixel** shading mode calculates lighting for each pixel, and is a good
+fit for most use cases. However, in some cases you may want to increase
+performance by using another shading mode.
+
+The **Per-Vertex** shading mode, often called "vertex shading" or "vertex lighting",
+instead calculates lighting once for each vertex, and interpolates the result
+between each pixel.
+
+On low-end or mobile devices, using per-vertex lighting can considerably increase
+rendering performance. When rendering several layers of transparency,
+such as when using particle systems, using per-vertex shading can improve
+performance, especially when the camera is close to particles.
+
+You can also use per-vertex lighting to achieve a retro look.
+
+.. figure:: img/standard_material_shading_modes_textured.webp
+  :align: center
+  :alt: Two cubes with a brick texture, one shaded and one unshaded.
+  
+  Texture from `AmbientCG <https://ambientcg.com/view?id=Bricks051>`__
+
+The **Unshaded** shading mode does not calculate lighting at all. Instead, the
+**Albedo** color is output directly. Lights will not affect the material at all,
+and unshaded materials will tend to appear considerably brighter than shaded
+materials.
+
+Rendering unshaded is useful for some specific visual effects. If maximum
+performance is needed, it can also be used for particles, or low-end or
+mobile devices.
 
 Diffuse Mode
 ~~~~~~~~~~~~

tutorials/performance/gpu_optimization.rst

@@ -154,9 +154,7 @@ Pay attention to the additional vertex processing required when using:
 
 -  Skinning (skeletal animation)
 -  Morphs (shape keys)
-
-.. UPDATE: Not implemented in Godot 4.x yet. Uncomment when this is implemented.
-   -  Vertex-lit objects (common on mobile)
+-  Vertex-lit objects (common on mobile)
 
 Pixel/fragment shaders and fill rate
 ------------------------------------