Update Using fonts documentation for 4.0.beta17

- Mention subpixel positioning should be disabled for fonts with a pixel art
  appearance.
- Update bitmap font import dock image and document image/character margin.
- Fixed character range example to match the font image (it previously
  had to be reduced by 1 due to an off-by-one error in the importer code).
This commit is contained in:
Hugo Locurcio
2023-02-08 02:01:32 +01:00
parent 8a19f44532
commit f8a612cd47
2 changed files with 17 additions and 0 deletions

View File

@@ -105,6 +105,14 @@ of *printable* (visible) ASCII characters.
Make sure the **Character Ranges** option doesn't exceed the number of
**Columns** × **Rows** defined. Otherwise, the font will fail to import.
If your font image contains margins not used for font glyphs (such as
attribution information), try adjusting **Image Margin**. This is a margin
applied only once around the whole image.
If your font image contains guides (in the form of lines between glyphs) or
if spacing between characters appears incorrect, try adjusting **Character
Margin**. This margin is applied for every imported glyph.
Loading a font file
-------------------
@@ -203,6 +211,15 @@ best quality, at the cost of longer rasterization times.
Changing antialiasing, hinting and subpixel positioning has the most visible
effect at smaller font sizes.
.. warning::
Fonts that have a pixel art appearance should have their subpixel positioning
mode set to **Disabled**. Otherwise, the font may appear to have uneven pixel
sizes.
This step is not required for bitmap fonts, as subpixel positioning is only
relevant for dynamic fonts (which are usually made of vector elements).
.. _doc_using_fonts_mipmaps:
Mipmaps

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 13 KiB