瀏覽代碼

Mention how to improve font rendering quality in 3D text

(cherry picked from commit 7e7182ba2bec78b323a2be596f0988c961db9011)
Hugo Locurcio 1 年之前
父節點
當前提交
f3c16ee187
共有 1 個文件被更改,包括 9 次插入1 次删除
  1. 9 1
      tutorials/3d/3d_text.rst

+ 9 - 1
tutorials/3d/3d_text.rst

@@ -45,7 +45,7 @@ Advantages
 - Label3D can use bitmap fonts and dynamic fonts (with and without
 - Label3D can use bitmap fonts and dynamic fonts (with and without
   :abbr:`MSDF (Multi-channel Signed Distance Font)` or mipmaps). This makes it
   :abbr:`MSDF (Multi-channel Signed Distance Font)` or mipmaps). This makes it
   more flexible on that aspect compared to TextMesh, especially for rendering
   more flexible on that aspect compared to TextMesh, especially for rendering
-  fonts with self-intersecting outlines.
+  fonts with self-intersecting outlines or colored fonts (emoji).
 
 
 .. seealso::
 .. seealso::
 
 
@@ -70,6 +70,10 @@ cast shadows, but some transparency sorting issues will remain.
 See :ref:`Transparency sorting <doc_3d_rendering_limitations_transparency_sorting>`
 See :ref:`Transparency sorting <doc_3d_rendering_limitations_transparency_sorting>`
 section in the 3D rendering limitations page for more information.
 section in the 3D rendering limitations page for more information.
 
 
+Text rendering quality can also suffer when the Label3D is viewed at a distance. To improve
+text rendering quality, :ref:`enable mipmaps on the font <doc_using_fonts_mipmaps>` or
+:ref:`switch the font to use MSDF rendering <doc_using_fonts_msdf>`.
+
 TextMesh
 TextMesh
 --------
 --------
 
 
@@ -111,6 +115,10 @@ There are some limitations to TextMesh:
   If you notice rendering issues on fonts downloaded from websites such as
   If you notice rendering issues on fonts downloaded from websites such as
   Google Fonts, try downloading the font from the font author's official
   Google Fonts, try downloading the font from the font author's official
   website instead.
   website instead.
+- Antialiasing the text rendering requires a full-scene antialiasing method to
+  be enabled such as MSAA, FXAA and temporal antialiasing (TAA). If no
+  antialiasing method is enabled, text will appear grainy, especially at a
+  distance. See :ref:`doc_3d_antialiasing` for more information.
 
 
 Projected Label node (or any other Control)
 Projected Label node (or any other Control)
 -------------------------------------------
 -------------------------------------------