diff options
author | Jaakko Keränen <jaakko.keranen@iki.fi> | 2021-10-30 09:02:27 +0300 |
---|---|---|
committer | Jaakko Keränen <jaakko.keranen@iki.fi> | 2021-10-30 09:02:27 +0300 |
commit | 031f8255e6709e4db798de6fbac31ef590ebf432 (patch) | |
tree | a9b3df7667c174f865e42c074353ff63ef54f09e /res | |
parent | e02664c61d27feae1d6dcdda4a3af54e873ee9bd (diff) |
Updated Help: TrueType collections
Diffstat (limited to 'res')
-rw-r--r-- | res/about/help.gmi | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/res/about/help.gmi b/res/about/help.gmi index 20c5d6c8..4af1581e 100644 --- a/res/about/help.gmi +++ b/res/about/help.gmi | |||
@@ -465,7 +465,16 @@ glyphscale = 0.85 | |||
465 | monospace = true | 465 | monospace = true |
466 | ``` | 466 | ``` |
467 | 467 | ||
468 | About compatibility: fonts are complex, and while the TrueType format is not the most advanced one, it still has features that are not supported in Lagrange. The technical reason is that glyphs are rasterized using stb_truetype, a rather simple TrueType font library. (It's nice and small, though.) For example, hinting is not supported. You may find that some fonts simply fail to load correctly, or look wrong in the app. | 468 | About compatibility: fonts are complex, and while the TrueType format is not the most advanced one, it still has features that are not supported in Lagrange. The technical reason is that glyphs are rasterized using stb_truetype, a rather simple TrueType font library. (It's nice and small, though.) You may find that some fonts simply fail to load correctly, or look wrong in the app. |
469 | |||
470 | * Hinting is not supported. | ||
471 | * Bitmap glyphs are not supported. | ||
472 | * Multi-color glyphs are not supported. | ||
473 | |||
474 | TrueType Collections (.ttc) can be used, with the restriction that each declared font uses a single index from the collection. The index must be appended to the file name: | ||
475 | ```.ttc example | ||
476 | regular = "NotoSansCJK-Regular.ttc:2" | ||
477 | ``` | ||
469 | 478 | ||
470 | ## 2.5 Page style | 479 | ## 2.5 Page style |
471 | 480 | ||
@@ -863,6 +872,11 @@ A single typeface can use up to five font files. | |||
863 | * `bold` (string): path of a font file for the bold weight. | 872 | * `bold` (string): path of a font file for the bold weight. |
864 | 873 | ||
865 | Only the regular style is required. Undefined styles fall back to the closest available style. The same file path can be used in multiple styles; only one copy of the file will be loaded to memory. | 874 | Only the regular style is required. Undefined styles fall back to the closest available style. The same file path can be used in multiple styles; only one copy of the file will be loaded to memory. |
875 | |||
876 | When the path refers to a TrueType Collection (.ttc), the font index to use must be appended to the file name: | ||
877 | ```.ttc example | ||
878 | regular = "NotoSansCJK-Regular.ttc:2" | ||
879 | ``` | ||
866 | 880 | ||
867 | # Open source licenses | 881 | # Open source licenses |
868 | 882 | ||