fonttools 4.60.2__cp311-cp311-win32.whl

fontTools/ttLib/standardGlyphOrder.py

@@ -0,0 +1,271 @@
+#
+# 'post' table formats 1.0 and 2.0 rely on this list of "standard"
+# glyphs.
+#
+# My list is correct according to the Apple documentation for the 'post'  table:
+# https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6post.html
+# (However, it seems that TTFdump (from MS) and FontLab disagree, at
+# least with respect to the last glyph, which they list as 'dslash'
+# instead of 'dcroat'.)
+#
+
+standardGlyphOrder = [
+    ".notdef",  # 0
+    ".null",  # 1
+    "nonmarkingreturn",  # 2
+    "space",  # 3
+    "exclam",  # 4
+    "quotedbl",  # 5
+    "numbersign",  # 6
+    "dollar",  # 7
+    "percent",  # 8
+    "ampersand",  # 9
+    "quotesingle",  # 10
+    "parenleft",  # 11
+    "parenright",  # 12
+    "asterisk",  # 13
+    "plus",  # 14
+    "comma",  # 15
+    "hyphen",  # 16
+    "period",  # 17
+    "slash",  # 18
+    "zero",  # 19
+    "one",  # 20
+    "two",  # 21
+    "three",  # 22
+    "four",  # 23
+    "five",  # 24
+    "six",  # 25
+    "seven",  # 26
+    "eight",  # 27
+    "nine",  # 28
+    "colon",  # 29
+    "semicolon",  # 30
+    "less",  # 31
+    "equal",  # 32
+    "greater",  # 33
+    "question",  # 34
+    "at",  # 35
+    "A",  # 36
+    "B",  # 37
+    "C",  # 38
+    "D",  # 39
+    "E",  # 40
+    "F",  # 41
+    "G",  # 42
+    "H",  # 43
+    "I",  # 44
+    "J",  # 45
+    "K",  # 46
+    "L",  # 47
+    "M",  # 48
+    "N",  # 49
+    "O",  # 50
+    "P",  # 51
+    "Q",  # 52
+    "R",  # 53
+    "S",  # 54
+    "T",  # 55
+    "U",  # 56
+    "V",  # 57
+    "W",  # 58
+    "X",  # 59
+    "Y",  # 60
+    "Z",  # 61
+    "bracketleft",  # 62
+    "backslash",  # 63
+    "bracketright",  # 64
+    "asciicircum",  # 65
+    "underscore",  # 66
+    "grave",  # 67
+    "a",  # 68
+    "b",  # 69
+    "c",  # 70
+    "d",  # 71
+    "e",  # 72
+    "f",  # 73
+    "g",  # 74
+    "h",  # 75
+    "i",  # 76
+    "j",  # 77
+    "k",  # 78
+    "l",  # 79
+    "m",  # 80
+    "n",  # 81
+    "o",  # 82
+    "p",  # 83
+    "q",  # 84
+    "r",  # 85
+    "s",  # 86
+    "t",  # 87
+    "u",  # 88
+    "v",  # 89
+    "w",  # 90
+    "x",  # 91
+    "y",  # 92
+    "z",  # 93
+    "braceleft",  # 94
+    "bar",  # 95
+    "braceright",  # 96
+    "asciitilde",  # 97
+    "Adieresis",  # 98
+    "Aring",  # 99
+    "Ccedilla",  # 100
+    "Eacute",  # 101
+    "Ntilde",  # 102
+    "Odieresis",  # 103
+    "Udieresis",  # 104
+    "aacute",  # 105
+    "agrave",  # 106
+    "acircumflex",  # 107
+    "adieresis",  # 108
+    "atilde",  # 109
+    "aring",  # 110
+    "ccedilla",  # 111
+    "eacute",  # 112
+    "egrave",  # 113
+    "ecircumflex",  # 114
+    "edieresis",  # 115
+    "iacute",  # 116
+    "igrave",  # 117
+    "icircumflex",  # 118
+    "idieresis",  # 119
+    "ntilde",  # 120
+    "oacute",  # 121
+    "ograve",  # 122
+    "ocircumflex",  # 123
+    "odieresis",  # 124
+    "otilde",  # 125
+    "uacute",  # 126
+    "ugrave",  # 127
+    "ucircumflex",  # 128
+    "udieresis",  # 129
+    "dagger",  # 130
+    "degree",  # 131
+    "cent",  # 132
+    "sterling",  # 133
+    "section",  # 134
+    "bullet",  # 135
+    "paragraph",  # 136
+    "germandbls",  # 137
+    "registered",  # 138
+    "copyright",  # 139
+    "trademark",  # 140
+    "acute",  # 141
+    "dieresis",  # 142
+    "notequal",  # 143
+    "AE",  # 144
+    "Oslash",  # 145
+    "infinity",  # 146
+    "plusminus",  # 147
+    "lessequal",  # 148
+    "greaterequal",  # 149
+    "yen",  # 150
+    "mu",  # 151
+    "partialdiff",  # 152
+    "summation",  # 153
+    "product",  # 154
+    "pi",  # 155
+    "integral",  # 156
+    "ordfeminine",  # 157
+    "ordmasculine",  # 158
+    "Omega",  # 159
+    "ae",  # 160
+    "oslash",  # 161
+    "questiondown",  # 162
+    "exclamdown",  # 163
+    "logicalnot",  # 164
+    "radical",  # 165
+    "florin",  # 166
+    "approxequal",  # 167
+    "Delta",  # 168
+    "guillemotleft",  # 169
+    "guillemotright",  # 170
+    "ellipsis",  # 171
+    "nonbreakingspace",  # 172
+    "Agrave",  # 173
+    "Atilde",  # 174
+    "Otilde",  # 175
+    "OE",  # 176
+    "oe",  # 177
+    "endash",  # 178
+    "emdash",  # 179
+    "quotedblleft",  # 180
+    "quotedblright",  # 181
+    "quoteleft",  # 182
+    "quoteright",  # 183
+    "divide",  # 184
+    "lozenge",  # 185
+    "ydieresis",  # 186
+    "Ydieresis",  # 187
+    "fraction",  # 188
+    "currency",  # 189
+    "guilsinglleft",  # 190
+    "guilsinglright",  # 191
+    "fi",  # 192
+    "fl",  # 193
+    "daggerdbl",  # 194
+    "periodcentered",  # 195
+    "quotesinglbase",  # 196
+    "quotedblbase",  # 197
+    "perthousand",  # 198
+    "Acircumflex",  # 199
+    "Ecircumflex",  # 200
+    "Aacute",  # 201
+    "Edieresis",  # 202
+    "Egrave",  # 203
+    "Iacute",  # 204
+    "Icircumflex",  # 205
+    "Idieresis",  # 206
+    "Igrave",  # 207
+    "Oacute",  # 208
+    "Ocircumflex",  # 209
+    "apple",  # 210
+    "Ograve",  # 211
+    "Uacute",  # 212
+    "Ucircumflex",  # 213
+    "Ugrave",  # 214
+    "dotlessi",  # 215
+    "circumflex",  # 216
+    "tilde",  # 217
+    "macron",  # 218
+    "breve",  # 219
+    "dotaccent",  # 220
+    "ring",  # 221
+    "cedilla",  # 222
+    "hungarumlaut",  # 223
+    "ogonek",  # 224
+    "caron",  # 225
+    "Lslash",  # 226
+    "lslash",  # 227
+    "Scaron",  # 228
+    "scaron",  # 229
+    "Zcaron",  # 230
+    "zcaron",  # 231
+    "brokenbar",  # 232
+    "Eth",  # 233
+    "eth",  # 234
+    "Yacute",  # 235
+    "yacute",  # 236
+    "Thorn",  # 237
+    "thorn",  # 238
+    "minus",  # 239
+    "multiply",  # 240
+    "onesuperior",  # 241
+    "twosuperior",  # 242
+    "threesuperior",  # 243
+    "onehalf",  # 244
+    "onequarter",  # 245
+    "threequarters",  # 246
+    "franc",  # 247
+    "Gbreve",  # 248
+    "gbreve",  # 249
+    "Idotaccent",  # 250
+    "Scedilla",  # 251
+    "scedilla",  # 252
+    "Cacute",  # 253
+    "cacute",  # 254
+    "Ccaron",  # 255
+    "ccaron",  # 256
+    "dcroat",  # 257
+]

fontTools/ttLib/tables/B_A_S_E_.py

@@ -0,0 +1,14 @@
+from .otBase import BaseTTXConverter
+
+
+class table_B_A_S_E_(BaseTTXConverter):
+    """Baseline table
+
+    The ``BASE`` table contains information needed to align glyphs in
+    different scripts, from different fonts, or at different sizes
+    within the same line of text.
+
+    See also https://learn.microsoft.com/en-us/typography/opentype/spec/base
+    """
+
+    pass

fontTools/ttLib/tables/BitmapGlyphMetrics.py

@@ -0,0 +1,64 @@
+# Since bitmap glyph metrics are shared between EBLC and EBDT
+# this class gets its own python file.
+from fontTools.misc import sstruct
+from fontTools.misc.textTools import safeEval
+import logging
+
+
+log = logging.getLogger(__name__)
+
+bigGlyphMetricsFormat = """
+  > # big endian
+  height:       B
+  width:        B
+  horiBearingX: b
+  horiBearingY: b
+  horiAdvance:  B
+  vertBearingX: b
+  vertBearingY: b
+  vertAdvance:  B
+"""
+
+smallGlyphMetricsFormat = """
+  > # big endian
+  height:   B
+  width:    B
+  BearingX: b
+  BearingY: b
+  Advance:  B
+"""
+
+
+class BitmapGlyphMetrics(object):
+    def toXML(self, writer, ttFont):
+        writer.begintag(self.__class__.__name__)
+        writer.newline()
+        for metricName in sstruct.getformat(self.__class__.binaryFormat)[1]:
+            writer.simpletag(metricName, value=getattr(self, metricName))
+            writer.newline()
+        writer.endtag(self.__class__.__name__)
+        writer.newline()
+
+    def fromXML(self, name, attrs, content, ttFont):
+        metricNames = set(sstruct.getformat(self.__class__.binaryFormat)[1])
+        for element in content:
+            if not isinstance(element, tuple):
+                continue
+            name, attrs, content = element
+            # Make sure this is a metric that is needed by GlyphMetrics.
+            if name in metricNames:
+                vars(self)[name] = safeEval(attrs["value"])
+            else:
+                log.warning(
+                    "unknown name '%s' being ignored in %s.",
+                    name,
+                    self.__class__.__name__,
+                )
+
+
+class BigGlyphMetrics(BitmapGlyphMetrics):
+    binaryFormat = bigGlyphMetricsFormat
+
+
+class SmallGlyphMetrics(BitmapGlyphMetrics):
+    binaryFormat = smallGlyphMetricsFormat

fontTools/ttLib/tables/C_B_D_T_.py

@@ -0,0 +1,113 @@
+# Copyright 2013 Google, Inc. All Rights Reserved.
+#
+# Google Author(s): Matt Fontaine
+
+
+from fontTools.misc.textTools import bytesjoin
+from fontTools.misc import sstruct
+from . import E_B_D_T_
+from .BitmapGlyphMetrics import (
+    BigGlyphMetrics,
+    bigGlyphMetricsFormat,
+    SmallGlyphMetrics,
+    smallGlyphMetricsFormat,
+)
+from .E_B_D_T_ import (
+    BitmapGlyph,
+    BitmapPlusSmallMetricsMixin,
+    BitmapPlusBigMetricsMixin,
+)
+import struct
+
+
+class table_C_B_D_T_(E_B_D_T_.table_E_B_D_T_):
+    """Color Bitmap Data table
+
+    The ``CBDT`` table contains color bitmap data for glyphs. It must
+    be used in concert with the ``CBLC`` table.
+
+    It is backwards-compatible with the monochrome/grayscale ``EBDT`` table.
+
+    See also https://learn.microsoft.com/en-us/typography/opentype/spec/cbdt
+    """
+
+    # Change the data locator table being referenced.
+    locatorName = "CBLC"
+
+    # Modify the format class accessor for color bitmap use.
+    def getImageFormatClass(self, imageFormat):
+        try:
+            return E_B_D_T_.table_E_B_D_T_.getImageFormatClass(self, imageFormat)
+        except KeyError:
+            return cbdt_bitmap_classes[imageFormat]
+
+
+# Helper method for removing export features not supported by color bitmaps.
+# Write data in the parent class will default to raw if an option is unsupported.
+def _removeUnsupportedForColor(dataFunctions):
+    dataFunctions = dict(dataFunctions)
+    del dataFunctions["row"]
+    return dataFunctions
+
+
+class ColorBitmapGlyph(BitmapGlyph):
+    fileExtension = ".png"
+    xmlDataFunctions = _removeUnsupportedForColor(BitmapGlyph.xmlDataFunctions)
+
+
+class cbdt_bitmap_format_17(BitmapPlusSmallMetricsMixin, ColorBitmapGlyph):
+    def decompile(self):
+        self.metrics = SmallGlyphMetrics()
+        dummy, data = sstruct.unpack2(smallGlyphMetricsFormat, self.data, self.metrics)
+        (dataLen,) = struct.unpack(">L", data[:4])
+        data = data[4:]
+
+        # For the image data cut it to the size specified by dataLen.
+        assert dataLen <= len(data), "Data overun in format 17"
+        self.imageData = data[:dataLen]
+
+    def compile(self, ttFont):
+        dataList = []
+        dataList.append(sstruct.pack(smallGlyphMetricsFormat, self.metrics))
+        dataList.append(struct.pack(">L", len(self.imageData)))
+        dataList.append(self.imageData)
+        return bytesjoin(dataList)
+
+
+class cbdt_bitmap_format_18(BitmapPlusBigMetricsMixin, ColorBitmapGlyph):
+    def decompile(self):
+        self.metrics = BigGlyphMetrics()
+        dummy, data = sstruct.unpack2(bigGlyphMetricsFormat, self.data, self.metrics)
+        (dataLen,) = struct.unpack(">L", data[:4])
+        data = data[4:]
+
+        # For the image data cut it to the size specified by dataLen.
+        assert dataLen <= len(data), "Data overun in format 18"
+        self.imageData = data[:dataLen]
+
+    def compile(self, ttFont):
+        dataList = []
+        dataList.append(sstruct.pack(bigGlyphMetricsFormat, self.metrics))
+        dataList.append(struct.pack(">L", len(self.imageData)))
+        dataList.append(self.imageData)
+        return bytesjoin(dataList)
+
+
+class cbdt_bitmap_format_19(ColorBitmapGlyph):
+    def decompile(self):
+        (dataLen,) = struct.unpack(">L", self.data[:4])
+        data = self.data[4:]
+
+        assert dataLen <= len(data), "Data overun in format 19"
+        self.imageData = data[:dataLen]
+
+    def compile(self, ttFont):
+        return struct.pack(">L", len(self.imageData)) + self.imageData
+
+
+# Dict for CBDT extended formats.
+cbdt_bitmap_classes = {
+    17: cbdt_bitmap_format_17,
+    18: cbdt_bitmap_format_18,
+    19: cbdt_bitmap_format_19,
+}

fontTools/ttLib/tables/C_B_L_C_.py

@@ -0,0 +1,19 @@
+# Copyright 2013 Google, Inc. All Rights Reserved.
+#
+# Google Author(s): Matt Fontaine
+
+from . import E_B_L_C_
+
+
+class table_C_B_L_C_(E_B_L_C_.table_E_B_L_C_):
+    """Color Bitmap Location table
+
+    The ``CBLC`` table contains the locations of color bitmaps for glyphs. It must
+    be used in concert with the ``CBDT`` table.
+
+    It is backwards-compatible with the monochrome/grayscale ``EBLC`` table.
+
+    See also https://learn.microsoft.com/en-us/typography/opentype/spec/cblc
+    """
+
+    dependencies = ["CBDT"]

fontTools/ttLib/tables/C_F_F_.py

@@ -0,0 +1,61 @@
+from io import BytesIO
+from fontTools import cffLib
+from . import DefaultTable
+
+
+class table_C_F_F_(DefaultTable.DefaultTable):
+    """Compact Font Format table (version 1)
+
+    The ``CFF`` table embeds a CFF-formatted font. The CFF font format
+    predates OpenType and could be used as a standalone font file, but the
+    ``CFF`` table is also used to package CFF fonts into an OpenType
+    container.
+
+    .. note::
+       ``CFF`` has been succeeded by ``CFF2``, which eliminates much of
+       the redundancy incurred by embedding CFF version 1 in an OpenType
+       font.
+
+    See also https://learn.microsoft.com/en-us/typography/opentype/spec/cff
+    """
+
+    def __init__(self, tag=None):
+        DefaultTable.DefaultTable.__init__(self, tag)
+        self.cff = cffLib.CFFFontSet()
+        self._gaveGlyphOrder = False
+
+    def decompile(self, data, otFont):
+        self.cff.decompile(BytesIO(data), otFont, isCFF2=False)
+        assert len(self.cff) == 1, "can't deal with multi-font CFF tables."
+
+    def compile(self, otFont):
+        f = BytesIO()
+        self.cff.compile(f, otFont, isCFF2=False)
+        return f.getvalue()
+
+    def haveGlyphNames(self):
+        if hasattr(self.cff[self.cff.fontNames[0]], "ROS"):
+            return False  # CID-keyed font
+        else:
+            return True
+
+    def getGlyphOrder(self):
+        if self._gaveGlyphOrder:
+            from fontTools import ttLib
+
+            raise ttLib.TTLibError("illegal use of getGlyphOrder()")
+        self._gaveGlyphOrder = True
+        return self.cff[self.cff.fontNames[0]].getGlyphOrder()
+
+    def setGlyphOrder(self, glyphOrder):
+        pass
+        # XXX
+        # self.cff[self.cff.fontNames[0]].setGlyphOrder(glyphOrder)
+
+    def toXML(self, writer, otFont):
+        self.cff.toXML(writer)
+
+    def fromXML(self, name, attrs, content, otFont):
+        if not hasattr(self, "cff"):
+            self.cff = cffLib.CFFFontSet()
+        self.cff.fromXML(name, attrs, content, otFont)

fontTools/ttLib/tables/C_F_F__2.py

@@ -0,0 +1,26 @@
+from io import BytesIO
+from fontTools.ttLib.tables.C_F_F_ import table_C_F_F_
+
+
+class table_C_F_F__2(table_C_F_F_):
+    """Compact Font Format version 2 table
+
+    The ``CFF2`` table contains glyph data for a CFF2-flavored OpenType
+    font.
+
+    .. note::
+       ``CFF2`` is the successor to ``CFF``, and eliminates much of
+       the redundancy incurred by embedding CFF version 1 in an OpenType
+       font.
+
+    See also https://learn.microsoft.com/en-us/typography/opentype/spec/cff2
+    """
+
+    def decompile(self, data, otFont):
+        self.cff.decompile(BytesIO(data), otFont, isCFF2=True)
+        assert len(self.cff) == 1, "can't deal with multi-font CFF tables."
+
+    def compile(self, otFont):
+        f = BytesIO()
+        self.cff.compile(f, otFont, isCFF2=True)
+        return f.getvalue()