diff options
| author | Werner Lemberg <wl@gnu.org> | 2021-08-08 00:22:34 +0200 |
|---|---|---|
| committer | Werner Lemberg <wl@gnu.org> | 2021-08-08 00:22:34 +0200 |
| commit | 2c853b38a717c615d3113a64033fc896e5888fa8 (patch) | |
| tree | 199ef6164bb3214d794b7f8dc8041803afccce77 | |
| parent | 18fc64e6a335e82eb3adb9a1a4a9ba43768cd134 (diff) | |
| download | freetype2-2c853b38a717c615d3113a64033fc896e5888fa8.tar.gz | |
include/freetype/freetype.h (FT_Encoding): Improve documentation.
Based on a suggestion by Antony Lee <anntzer.lee@gmail.com>.
| -rw-r--r-- | include/freetype/freetype.h | 15 |
1 files changed, 10 insertions, 5 deletions
diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h index 77fede35c..43eb90f22 100644 --- a/include/freetype/freetype.h +++ b/include/freetype/freetype.h @@ -730,11 +730,16 @@ FT_BEGIN_HEADER * Same as FT_ENCODING_JOHAB. Deprecated. * * @note: - * By default, FreeType enables a Unicode charmap and tags it with - * `FT_ENCODING_UNICODE` when it is either provided or can be generated - * from PostScript glyph name dictionaries in the font file. All other - * encodings are considered legacy and tagged only if explicitly defined - * in the font file. Otherwise, `FT_ENCODING_NONE` is used. + * When loading a font, FreeType makes a Unicode charmap active if + * possible (either if the font provides such a charmap, or if FreeType + * can synthesize one from PostScript glyph name dictionaries; in either + * case, the charmap is tagged with `FT_ENCODING_UNICODE`). If such a + * charmap is synthesized, it is placed at the first position of the + * charmap array. + * + * All other encodings are considered legacy and tagged only if + * explicitly defined in the font file. Otherwise, `FT_ENCODING_NONE` is + * used. * * `FT_ENCODING_NONE` is set by the BDF and PCF drivers if the charmap is * neither Unicode nor ISO-8859-1 (otherwise it is set to |