Simon Cozens c89c9487f1
[docs] encodings library (#1940)
Document the ``encodings.codecs`` part which might be useful to some people, and add a brief note about MacRoman.
2020-05-13 10:22:06 +01:00

22 lines
869 B
ReStructuredText

##################################################
encodings: Support for OpenType-specific encodings
##################################################
fontTools includes support for some character encodings found in legacy Mac
TrueType fonts. Many of these legacy encodings have found their way into the
standard Python ``encodings`` library, but others still remain unimplemented.
Importing ``fontTools.encodings.codecs`` will therefore add string ``encode``
and ``decode`` support for the following encodings:
* ``x_mac_japanese_ttx``
* ``x_mac_trad_chinese_ttx``
* ``x_mac_korean_ttx``
* ``x_mac_simp_chinese_ttx``
fontTools also includes a package (``fontTools.encodings.MacRoman``) which
contains a mapping of glyph IDs to glyph names in the MacRoman character set::
>>> from fontTools.encodings.MacRoman import MacRoman
>>> MacRoman[26]
'twosuperior'