fonttools 4.55.8__tar.gz → 4.57.0__tar.gz

fonttools-4.57.0/Doc/source/ttLib/index.rst

@@ -0,0 +1,62 @@
+#################################################
+ttLib: Read and write OpenType and TrueType fonts
+#################################################
+
+.. contents:: On this page:
+    :local:
+
+.. rubric:: Overview:
+   :heading-level: 2
+
+Most users of the :mod:`fontTools` library will be using it to generate or manipulate
+OpenType and TrueType fonts. (FontTools initially only supported TrueType fonts,
+gaining OpenType support in version 2.0, and so uses the ``tt`` prefix to refer to
+both kinds of font. Because of this we will refer to both as "TrueType fonts"
+unless we need to make a distinction.)
+
+The main entry point for such operations is the :py:mod:`fontTools.ttLib.ttFont`
+module, but other modules also provide useful functionality for handling OpenType
+fonts:
+
+.. toctree::
+   :maxdepth: 1
+
+   ttFont
+
+:mod:`.ttLib` supports fonts with TrueType-flavored glyphs (i.e., with
+a ``glyf`` table), with PostScript-flavored glyphs (i.e., ``CFF`` or
+``CFF2`` tables), and with all of the glyph formats used for color fonts
+(``CBDT``, ``COLR``, ``sbix``, and ``SVG``). Static and variable fonts
+are both supported.
+
+
+Command-line utilities
+----------------------
+
+:mod:`.ttLib` includes two modules that provide command-line operations:
+     
+.. toctree::
+   :maxdepth: 1
+   
+   removeOverlaps
+   scaleUpem
+
+
+Supporting modules
+------------------
+
+It also contains helper modules that enable lower-level
+functionality. In most cases, users will not need to access these
+modules directly:
+
+.. toctree::
+   :maxdepth: 1
+   
+   ttCollection
+   ttGlyphSet
+   macUtils
+   reorderGlyphs
+   sfnt
+   standardGlyphOrder
+   tables
+   woff2

fonttools-4.57.0/Doc/source/ttLib/macUtils.rst

@@ -0,0 +1,7 @@
+##########################################
+macUtils: Access fonts in Mac file formats
+##########################################
+
+.. automodule:: fontTools.ttLib.macUtils
+   :members:
+   :undoc-members:

fonttools-4.57.0/Doc/source/ttLib/removeOverlaps.rst

@@ -0,0 +1,13 @@
+##############################################################
+removeOverlaps: Tools to remove overlapping contours in glyphs
+##############################################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+The :mod:`fontTools.ttLib.removeOverlaps` module is a helper for
+:mod:`fontTools.ttLib`.
+
+.. automodule:: fontTools.ttLib.removeOverlaps
+   :members:
+   :undoc-members:

fonttools-4.57.0/Doc/source/ttLib/reorderGlyphs.rst

@@ -0,0 +1,13 @@
+########################################################
+reorderGlyphs: Functions to reorder the glyphs in a font
+########################################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+The :mod:`fontTools.ttLib.reorderGlyphs` module is a helper for
+:mod:`fontTools.ttLib`.
+
+.. automodule:: fontTools.ttLib.reorderGlyphs
+   :members:
+   :undoc-members:

fonttools-4.57.0/Doc/source/ttLib/scaleUpem.rst

@@ -0,0 +1,13 @@
+###########################################################
+scaleUpem: Tools to change the units-per-Em value in a font
+###########################################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+The :mod:`fontTools.ttLib.scaleUpem` module is a helper for
+:mod:`fontTools.ttLib`.
+
+.. automodule:: fontTools.ttLib.scaleUpem
+   :members:
+   :undoc-members:

fonttools-4.57.0/Doc/source/ttLib/sfnt.rst

@@ -0,0 +1,7 @@
+#########################################
+sfnt: Read and write the SFNT file format
+#########################################
+
+.. automodule:: fontTools.ttLib.sfnt
+   :members:
+   :undoc-members:

{fonttools-4.55.8 → fonttools-4.57.0}/Doc/source/ttLib/standardGlyphOrder.rst

@@ -1,9 +1,8 @@
-##################
-standardGlyphOrder
-##################
+###########################################################
+standardGlyphOrder: Interface with the Standard Glyph Order
+###########################################################
 
 .. automodule:: fontTools.ttLib.standardGlyphOrder
-   :inherited-members:
    :members:
    :undoc-members:
 

{fonttools-4.55.8 → fonttools-4.57.0}/Doc/source/ttLib/tables/TupleVariation.rst

@@ -2,6 +2,8 @@
 OpenType variations helper module
 #################################
 
+.. currentmodule:: fontTools.ttLib.tables.TupleVariation
+
 .. rubric:: Overview:
    :heading-level: 2
 

fonttools-4.57.0/Doc/source/ttLib/ttCollection.rst

@@ -0,0 +1,15 @@
+################################################################
+ttCollection: Access fonts within a TrueType/OpenType Collection
+################################################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+The :mod:`fontTools.ttLib.ttCollection` module is a helper for
+:mod:`fontTools.ttLib`. It supports the reading of TrueType and
+OpenType `Collection <https://learn.microsoft.com/en-us/typography/opentype/spec/otff#font-collections>`_ files (\*.ttc, \*.otc) so that each member font in
+the collection is accessible as a :class:`.TTFont` instance.
+
+.. automodule:: fontTools.ttLib.ttCollection
+   :members:
+   :undoc-members:

fonttools-4.57.0/Doc/source/ttLib/ttFont.rst

@@ -0,0 +1,99 @@
+####################################
+ttFont: Read and write font contents
+####################################
+
+.. contents:: On this page:
+    :local:
+
+.. rubric:: Overview
+   :heading-level: 2
+
+:mod:`.ttLib.ttFont` is the primary fontTools interface for
+inspecting, constructing, or deconstructing TrueType and OpenType
+fonts.
+
+The :class:`fontTools.ttLib.ttFont.TTFont` class provides access to
+font-level data, including font metrics, substitution and positioning
+features, and metadata, through a set of :doc:`table converters
+</ttLib/tables>`. A :class:`.TTFont` may be instantiated from a single
+font file, or it may be a member of a
+:class:`.TTCollection`. :class:`.TTFont` objects can also be
+constructed from scratch. 
+
+
+glyphSets and ttGlyphs
+----------------------
+
+In addition to font-wide data, :mod:`.ttLib.ttFont` provides access to
+individual glyphs through a :class:`.TTFont` instance's
+``.glyphSet[]`` attribute. A ``.glyphSet`` is a dict-like object that is
+indexed by glyph names. Users can use the glyphSet to interact with
+each glyph's contours, components, points, and glyph metrics.
+
+Informally, some fontTools code or documentation will make reference to
+the individual glyphs in a ``.glyphSet`` as a "ttGlyph" or the
+like. This is convenient terminology, particularly for
+discussion. However, it is important to note that there is not a
+"ttGlyph" class. Instead, the ``.glyphSet`` attribute of a
+:class:`.TTFont` serves as an abstraction layer that provides a
+uniform interface to the glyphs, regardless of whether the
+:class:`.TTFont` instance in use comes from a font file with
+TrueType-flavored glyphs (and, therefore, has a `glyf` table
+containing glyph contours) or a font with PostScript-flavored outlines
+(and, therefore, with a ``CFF`` or ``CFF2`` table containing the glyph
+contours).
+
+Regardless of the flavor, each "ttGlyph" entry in the ``.glyphSet``
+includes the corresponding Bezier outlines and components from the
+``glyf`` or ``CFF``/``CFF2`` table and the glyph's metrics. Horizontal
+metrics are drawn from the font's ``hmtx`` table, and vertical metrics
+(if any) are drawn from the ``vmtx`` table. These attributes are:
+
+    width
+        The advance width of the glyph
+    
+    lsb
+        The left sidebearing of the glyph
+    
+    height
+        (For vertical-layout fonts) The advance height of the glyph
+    
+    tsb
+        (for vertical-layout fonts) The top sidebearing of the glyph
+
+Note that these attributes do not describe the bounding box of the
+glyph filled shape, because the filled area might include negative
+coordinate values or extend beyond the advance width due to overhang.
+
+The bounds of the glyph are accessible as ``xMin``, ``xMax``,
+``yMin``, and ``yMax`` attributes.
+
+For implementation details regarding the different flavors of
+"ttGlyph", see the :doc:`ttGlyphSet </ttLib/ttGlyphSet>`
+documentation.
+
+These glyph objects also implement the :doc:`Pen Protocol
+</pens/index>` by providing ``.draw()`` and ``.drawPoints()``
+methods. See the :doc:`pens </pens/index>` package documenation
+for more.
+
+
+Package contents
+----------------
+ 
+
+.. autoclass:: fontTools.ttLib.ttFont.TTFont
+   :members:
+   :undoc-members:
+
+
+      
+.. autoclass:: fontTools.ttLib.ttFont.GlyphOrder
+   :members:
+   :undoc-members:
+   :private-members:
+
+
+.. automodule:: fontTools.ttLib.ttFont
+   :members: getTableModule, registerCustomTableClass, unregisterCustomTableClass, getCustomTableClass, getClassTag, newTable, tagToIdentifier, identifierToTag, tagToXML, xmlToTag, sortedTagList, reorderFontTables
+   :exclude-members: TTFont, GlyphOrder

fonttools-4.57.0/Doc/source/ttLib/ttGlyphSet.rst

@@ -0,0 +1,18 @@
+#################################################
+ttGlyphSet: GlyphSets returned by a TTFont object
+#################################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+The :mod:`fontTools.ttLib.ttGlyphSet` module is a helper for
+:mod:`fontTools.ttLib`.
+
+Most users will not need to access this module directly. Instead, the
+glyphs in a font are accessible as a ``.glyphSet`` dictionary in a
+:class:`TTFont` instance.
+
+.. automodule:: fontTools.ttLib.ttGlyphSet
+   :members:
+   :undoc-members:
+   :private-members:

fonttools-4.57.0/Doc/source/ttLib/woff2.rst

@@ -0,0 +1,11 @@
+################################################
+woff2: Read and write the WOFF2 font file format
+################################################
+
+Note also that :mod:`woff2` supports some :doc:`optional </optional>`
+external libraries.
+
+
+.. automodule:: fontTools.ttLib.woff2
+   :members:
+   :undoc-members:

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/__init__.py

@@ -3,6 +3,6 @@ from fontTools.misc.loggingTools import configLogger
 
 log = logging.getLogger(__name__)
 
-version = __version__ = "4.55.8"
+version = __version__ = "4.57.0"
 
 __all__ = ["version", "log", "configLogger"]

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/config/__init__.py

@@ -73,3 +73,18 @@ Config.register_option(
     parse=Option.parse_optional_bool,
     validate=Option.validate_optional_bool,
 )
+
+Config.register_option(
+    name="fontTools.ttLib:OPTIMIZE_FONT_SPEED",
+    help=dedent(
+        """\
+        Enable optimizations that prioritize speed over file size. This
+        mainly affects how glyf table and gvar / VARC tables are compiled.
+        The produced fonts will be larger, but rendering performance will
+        be improved with HarfBuzz and other text layout engines.
+        """
+    ),
+    default=False,
+    parse=Option.parse_optional_bool,
+    validate=Option.validate_optional_bool,
+)

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/feaLib/ast.py

@@ -1828,15 +1828,16 @@ class BaseAxis(Statement):
     """An axis definition, being either a ``VertAxis.BaseTagList/BaseScriptList``
     pair or a ``HorizAxis.BaseTagList/BaseScriptList`` pair."""
 
-    def __init__(self, bases, scripts, vertical, location=None):
+    def __init__(self, bases, scripts, vertical, minmax=None, location=None):
         Statement.__init__(self, location)
         self.bases = bases  #: A list of baseline tag names as strings
         self.scripts = scripts  #: A list of script record tuplets (script tag, default baseline tag, base coordinate)
         self.vertical = vertical  #: Boolean; VertAxis if True, HorizAxis if False
+        self.minmax = []  #: A set of minmax record
 
     def build(self, builder):
         """Calls the builder object's ``set_base_axis`` callback."""
-        builder.set_base_axis(self.bases, self.scripts, self.vertical)
+        builder.set_base_axis(self.bases, self.scripts, self.vertical, self.minmax)
 
     def asFea(self, indent=""):
         direction = "Vert" if self.vertical else "Horiz"
@@ -1844,9 +1845,13 @@ class BaseAxis(Statement):
             "{} {} {}".format(a[0], a[1], " ".join(map(str, a[2])))
             for a in self.scripts
         ]
+        minmaxes = [
+            "\n{}Axis.MinMax {} {} {}, {};".format(direction, a[0], a[1], a[2], a[3])
+            for a in self.minmax
+        ]
         return "{}Axis.BaseTagList {};\n{}{}Axis.BaseScriptList {};".format(
             direction, " ".join(self.bases), indent, direction, ", ".join(scripts)
-        )
+        ) + "\n".join(minmaxes)
 
 
 class OS2Field(Statement):

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/feaLib/builder.py

@@ -341,6 +341,7 @@ class Builder(object):
             table = self.font["head"] = newTable("head")
             table.decompile(b"\0" * 54, self.font)
             table.tableVersion = 1.0
+            table.magicNumber = 0x5F0F3CF5
             table.created = table.modified = 3406620153  # 2011-12-13 11:22:33
         table.fontRevision = self.fontRevision_
 
@@ -727,10 +728,16 @@ class Builder(object):
         result.table = base
         return result
 
+    def buildBASECoord(self, c):
+        coord = otTables.BaseCoord()
+        coord.Format = 1
+        coord.Coordinate = c
+        return coord
+
     def buildBASEAxis(self, axis):
         if not axis:
             return
-        bases, scripts = axis
+        bases, scripts, minmax = axis
         axis = otTables.Axis()
         axis.BaseTagList = otTables.BaseTagList()
         axis.BaseTagList.BaselineTag = bases
@@ -739,19 +746,35 @@ class Builder(object):
         axis.BaseScriptList.BaseScriptRecord = []
         axis.BaseScriptList.BaseScriptCount = len(scripts)
         for script in sorted(scripts):
+            minmax_for_script = [
+                record[1:] for record in minmax if record[0] == script[0]
+            ]
             record = otTables.BaseScriptRecord()
             record.BaseScriptTag = script[0]
             record.BaseScript = otTables.BaseScript()
-            record.BaseScript.BaseLangSysCount = 0
             record.BaseScript.BaseValues = otTables.BaseValues()
             record.BaseScript.BaseValues.DefaultIndex = bases.index(script[1])
             record.BaseScript.BaseValues.BaseCoord = []
             record.BaseScript.BaseValues.BaseCoordCount = len(script[2])
+            record.BaseScript.BaseLangSysRecord = []
+
             for c in script[2]:
-                coord = otTables.BaseCoord()
-                coord.Format = 1
-                coord.Coordinate = c
-                record.BaseScript.BaseValues.BaseCoord.append(coord)
+                record.BaseScript.BaseValues.BaseCoord.append(self.buildBASECoord(c))
+            for language, min_coord, max_coord in minmax_for_script:
+                minmax_record = otTables.MinMax()
+                minmax_record.MinCoord = self.buildBASECoord(min_coord)
+                minmax_record.MaxCoord = self.buildBASECoord(max_coord)
+                minmax_record.FeatMinMaxCount = 0
+                if language == "dflt":
+                    record.BaseScript.DefaultMinMax = minmax_record
+                else:
+                    lang_record = otTables.BaseLangSysRecord()
+                    lang_record.BaseLangSysTag = language
+                    lang_record.MinMax = minmax_record
+                    record.BaseScript.BaseLangSysRecord.append(lang_record)
+            record.BaseScript.BaseLangSysCount = len(
+                record.BaseScript.BaseLangSysRecord
+            )
             axis.BaseScriptList.BaseScriptRecord.append(record)
         return axis
 
@@ -1235,11 +1258,11 @@ class Builder(object):
     def add_cv_character(self, character, tag):
         self.cv_characters_[tag].append(character)
 
-    def set_base_axis(self, bases, scripts, vertical):
+    def set_base_axis(self, bases, scripts, vertical, minmax=[]):
         if vertical:
-            self.base_vert_axis_ = (bases, scripts)
+            self.base_vert_axis_ = (bases, scripts, minmax)
         else:
-            self.base_horiz_axis_ = (bases, scripts)
+            self.base_horiz_axis_ = (bases, scripts, minmax)
 
     def set_size_parameters(
         self, location, DesignSize, SubfamilyID, RangeStart, RangeEnd

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/feaLib/error.py

@@ -1,5 +1,5 @@
 class FeatureLibError(Exception):
-    def __init__(self, message, location):
+    def __init__(self, message, location=None):
         Exception.__init__(self, message)
         self.location = location
 

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/feaLib/parser.py

@@ -1286,6 +1286,19 @@ class Parser(object):
         n = match.group(0)[1:]
         return bytechr(int(n, 16)).decode(encoding)
 
+    def find_previous(self, statements, class_):
+        for previous in reversed(statements):
+            if isinstance(previous, self.ast.Comment):
+                continue
+            elif isinstance(previous, class_):
+                return previous
+            else:
+                # If we find something that doesn't match what we're looking
+                # for, and isn't a comment, fail
+                return None
+        # Out of statements to look at
+        return None
+
     def parse_table_BASE_(self, table):
         statements = table.statements
         while self.next_token_ != "}" or self.cur_comments_:
@@ -1306,6 +1319,19 @@ class Parser(object):
                         location=self.cur_token_location_,
                     )
                 )
+            elif self.is_cur_keyword_("HorizAxis.MinMax"):
+                base_script_list = self.find_previous(statements, ast.BaseAxis)
+                if base_script_list is None:
+                    raise FeatureLibError(
+                        "MinMax must be preceded by BaseScriptList",
+                        self.cur_token_location_,
+                    )
+                if base_script_list.vertical:
+                    raise FeatureLibError(
+                        "HorizAxis.MinMax must be preceded by HorizAxis statements",
+                        self.cur_token_location_,
+                    )
+                base_script_list.minmax.append(self.parse_base_minmax_())
             elif self.is_cur_keyword_("VertAxis.BaseTagList"):
                 vert_bases = self.parse_base_tag_list_()
             elif self.is_cur_keyword_("VertAxis.BaseScriptList"):
@@ -1318,6 +1344,19 @@ class Parser(object):
                         location=self.cur_token_location_,
                     )
                 )
+            elif self.is_cur_keyword_("VertAxis.MinMax"):
+                base_script_list = self.find_previous(statements, ast.BaseAxis)
+                if base_script_list is None:
+                    raise FeatureLibError(
+                        "MinMax must be preceded by BaseScriptList",
+                        self.cur_token_location_,
+                    )
+                if not base_script_list.vertical:
+                    raise FeatureLibError(
+                        "VertAxis.MinMax must be preceded by VertAxis statements",
+                        self.cur_token_location_,
+                    )
+                base_script_list.minmax.append(self.parse_base_minmax_())
             elif self.cur_token_ == ";":
                 continue
 
@@ -1587,6 +1626,25 @@ class Parser(object):
         coords = [self.expect_number_() for i in range(count)]
         return script_tag, base_tag, coords
 
+    def parse_base_minmax_(self):
+        script_tag = self.expect_script_tag_()
+        language = self.expect_language_tag_()
+        min_coord = self.expect_number_()
+        self.advance_lexer_()
+        if not (self.cur_token_type_ is Lexer.SYMBOL and self.cur_token_ == ","):
+            raise FeatureLibError(
+                "Expected a comma between min and max coordinates",
+                self.cur_token_location_,
+            )
+        max_coord = self.expect_number_()
+        if self.next_token_ == ",":  # feature tag...
+            raise FeatureLibError(
+                "Feature tags are not yet supported in BASE table",
+                self.cur_token_location_,
+            )
+
+        return script_tag, language, min_coord, max_coord
+
     def parse_device_(self):
         result = None
         self.expect_symbol_("<")

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/misc/testTools.py

@@ -46,7 +46,8 @@ def parseXmlInto(font, parseInto, xmlSnippet):
     parsed_xml = [e for e in parseXML(xmlSnippet.strip()) if not isinstance(e, str)]
     for name, attrs, content in parsed_xml:
         parseInto.fromXML(name, attrs, content, font)
-    parseInto.populateDefaults()
+    if hasattr(parseInto, "populateDefaults"):
+        parseInto.populateDefaults()
     return parseInto
 
 
@@ -58,6 +59,9 @@ class FakeFont:
         self.tables = {}
         self.cfg = Config()
 
+    def __contains__(self, tag):
+        return tag in self.tables
+
     def __getitem__(self, tag):
         return self.tables[tag]
 

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/otlLib/optimize/gpos.py

@@ -53,12 +53,18 @@ def compact(font: TTFont, level: int) -> TTFont:
     #     are not grouped together first; instead each subtable is treated
     #     independently, so currently this step is:
     #     Split existing subtables into more smaller subtables
-    gpos = font["GPOS"]
+    gpos = font.get("GPOS")
+
+    # If the font does not contain a GPOS table, there is nothing to do.
+    if gpos is None:
+        return font
+
     for lookup in gpos.table.LookupList.Lookup:
         if lookup.LookupType == 2:
             compact_lookup(font, level, lookup)
         elif lookup.LookupType == 9 and lookup.SubTable[0].ExtensionLookupType == 2:
             compact_ext_lookup(font, level, lookup)
+
     return font
 
 

{fonttools-4.55.8 → fonttools-4.57.0}/Lib/fontTools/ttLib/__init__.py

@@ -1,5 +1,6 @@
 """fontTools.ttLib -- a package for dealing with TrueType fonts."""
 
+from fontTools.config import OPTIONS
 from fontTools.misc.loggingTools import deprecateFunction
 import logging
 
@@ -7,6 +8,9 @@ import logging
 log = logging.getLogger(__name__)
 
 
+OPTIMIZE_FONT_SPEED = OPTIONS["fontTools.ttLib:OPTIMIZE_FONT_SPEED"]
+
+
 class TTLibError(Exception):
     pass