summaryrefslogtreecommitdiff
path: root/res
diff options
context:
space:
mode:
authorJaakko Keränen <jaakko.keranen@iki.fi>2021-10-30 09:02:27 +0300
committerJaakko Keränen <jaakko.keranen@iki.fi>2021-10-30 09:02:27 +0300
commit031f8255e6709e4db798de6fbac31ef590ebf432 (patch)
treea9b3df7667c174f865e42c074353ff63ef54f09e /res
parente02664c61d27feae1d6dcdda4a3af54e873ee9bd (diff)
Updated Help: TrueType collections
Diffstat (limited to 'res')
-rw-r--r--res/about/help.gmi16
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
465monospace = true 465monospace = true
466``` 466```
467 467
468About 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. 468About 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
474TrueType 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
476regular = "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
865Only 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. 874Only 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
876When the path refers to a TrueType Collection (.ttc), the font index to use must be appended to the file name:
877```.ttc example
878regular = "NotoSansCJK-Regular.ttc:2"
879```
866 880
867# Open source licenses 881# Open source licenses
868 882