From cdc3f1f3abd4f62384b547592babc2d47eaf082d Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Tue, 16 May 2023 10:27:17 +0200 Subject: [PATCH] Document font size caveats for pixel art fonts in Using fonts (#7355) Co-authored-by: Max Hilbrunner --- tutorials/ui/gui_using_fonts.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/tutorials/ui/gui_using_fonts.rst b/tutorials/ui/gui_using_fonts.rst index 6efce1e31..cb2373834 100644 --- a/tutorials/ui/gui_using_fonts.rst +++ b/tutorials/ui/gui_using_fonts.rst @@ -145,7 +145,9 @@ property that accepts a Font resource. Fonts that have a pixel art appearance should have bilinear filtering disabled by changing the **Rendering > Textures > Canvas Textures > Default Texture Filter** - project setting to **Nearest**. Otherwise, the font may appear to look blurry. + project setting to **Nearest**. The font size must also be an integer multiple of the + design size (which varies on a per-font basis), and the Control node using the font + must be scaled by an integer multiple as well. Otherwise, the font may look blurry. The texture filter mode can also be set on individual nodes that inherit from CanvasItem by setting :ref:`CanvasItem.texture_filter `.