feaLib

fontTools.feaLib – a package for dealing with OpenType feature files.

ast

class fontTools.feaLib.ast.AlternateSubstStatement(location, prefix, glyph, suffix, replacement)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.Anchor(location, name, x, y, contourpoint, xDeviceTable, yDeviceTable)

asFea(indent='')

class fontTools.feaLib.ast.AnchorDefinition(location, name, x, y, contourpoint)

asFea(indent='')

class fontTools.feaLib.ast.AnonymousBlock(tag, content, location)

asFea(indent='')

class fontTools.feaLib.ast.AttachStatement(location, glyphs, contourPoints)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.BaseAxis(location, bases, scripts, vertical)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.Block(location)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.ChainContextPosStatement(location, prefix, glyphs, suffix, lookups)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.ChainContextSubstStatement(location, prefix, glyphs, suffix, lookups)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.Comment(location, text)

asFea(indent='')

class fontTools.feaLib.ast.CursivePosStatement(location, glyphclass, entryAnchor, exitAnchor)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.Element(location)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.Expression(location)

class fontTools.feaLib.ast.FeatureBlock(location, name, use_extension)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.FeatureFile

asFea(indent='')

class fontTools.feaLib.ast.FeatureNameStatement(location, nameID, platformID, platEncID, langID, string)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.FeatureNamesBlock(location)

asFea(indent='')

class fontTools.feaLib.ast.FeatureReferenceStatement(location, featureName)

Example: feature salt;

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.FontRevisionStatement(location, revision)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.GlyphClass(location, glyphs=None)

A glyph class, such as [acute cedilla grave].

add_cid_range(start, end, glyphs)

add_class(gc)

add_range(start, end, glyphs)

append(glyph)

asFea(indent='')

extend(glyphs)

glyphSet()

class fontTools.feaLib.ast.GlyphClassDefStatement(location, baseGlyphs, markGlyphs, ligatureGlyphs, componentGlyphs)

Example: GlyphClassDef @UPPERCASE, [B], [C], [D];

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.GlyphClassDefinition(location, name, glyphs)

Example: @UPPERCASE = [A-Z];

asFea(indent='')

glyphSet()

class fontTools.feaLib.ast.GlyphClassName(location, glyphclass)

A glyph class name, such as @FRENCH_MARKS.

asFea(indent='')

glyphSet()

class fontTools.feaLib.ast.GlyphName(location, glyph)

A single glyph name, such as cedilla.

asFea(indent='')

glyphSet()

class fontTools.feaLib.ast.HheaField(location, key, value)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.IgnorePosStatement(location, chainContexts)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.IgnoreSubstStatement(location, chainContexts)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LanguageStatement(location, language, include_default, required)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LanguageSystemStatement(location, script, language)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LigatureCaretByIndexStatement(location, glyphs, carets)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LigatureCaretByPosStatement(location, glyphs, carets)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LigatureSubstStatement(location, prefix, glyphs, suffix, replacement, forceChain)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LookupBlock(location, name, use_extension)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LookupFlagStatement(location, value, markAttachment, markFilteringSet)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.LookupReferenceStatement(location, lookup)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.MarkBasePosStatement(location, base, marks)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.MarkClass(name)

addDefinition(definition)

asFea(indent='')

glyphSet()

class fontTools.feaLib.ast.MarkClassDefinition(location, markClass, anchor, glyphs)

asFea(indent='')

glyphSet()

class fontTools.feaLib.ast.MarkClassName(location, markClass)

A mark class name, such as @FRENCH_MARKS defined with markClass.

asFea(indent='')

glyphSet()

class fontTools.feaLib.ast.MarkLigPosStatement(location, ligatures, marks)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.MarkMarkPosStatement(location, baseMarks, marks)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.MultipleSubstStatement(location, prefix, glyph, suffix, replacement)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.NameRecord(location, nameID, platformID, platEncID, langID, string)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.OS2Field(location, key, value)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.PairPosStatement(location, enumerated, glyphs1, valuerecord1, glyphs2, valuerecord2)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.ReverseChainSingleSubstStatement(location, old_prefix, old_suffix, glyphs, replacements)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.ScriptStatement(location, script)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.SinglePosStatement(location, pos, prefix, suffix, forceChain)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.SingleSubstStatement(location, glyphs, replace, prefix, suffix, forceChain)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.SizeParameters(location, DesignSize, SubfamilyID, RangeStart, RangeEnd)

asFea(indent='')

build(builder)

class fontTools.feaLib.ast.Statement(location)

class fontTools.feaLib.ast.SubtableStatement(location)

class fontTools.feaLib.ast.TableBlock(location, name)

asFea(indent='')

class fontTools.feaLib.ast.ValueRecord(location, vertical, xPlacement, yPlacement, xAdvance, yAdvance, xPlaDevice, yPlaDevice, xAdvDevice, yAdvDevice)

makeString(vertical=None)

class fontTools.feaLib.ast.ValueRecordDefinition(location, name, value)

asFea(indent='')

class fontTools.feaLib.ast.VheaField(location, key, value)

asFea(indent='')

build(builder)

fontTools.feaLib.ast.asFea(g)

fontTools.feaLib.ast.deviceToString(device)

fontTools.feaLib.ast.simplify_name_attributes(pid, eid, lid)

builder

class fontTools.feaLib.builder.AlternateSubstBuilder(font, location)

build()

equals(other)

getAlternateGlyphs()

class fontTools.feaLib.builder.Builder(font, featurefile)

add_alternate_subst(location, prefix, glyph, suffix, replacement)

add_attach_points(location, glyphs, contourPoints)

add_chain_context_pos(location, prefix, glyphs, suffix, lookups)

add_chain_context_subst(location, prefix, glyphs, suffix, lookups)

add_class_pair_pos(location, glyphclass1, value1, glyphclass2, value2)

add_cursive_pos(location, glyphclass, entryAnchor, exitAnchor)

add_featureName(location, tag)

add_feature_reference(location, featureName)

add_glyphClassDef(location, baseGlyphs, ligatureGlyphs, markGlyphs, componentGlyphs)

add_hhea_field(key, value)

add_language_system(location, script, language)

add_ligatureCaretByIndex_(location, glyphs, carets)

add_ligatureCaretByPos_(location, glyphs, carets)

add_ligature_subst(location, prefix, glyphs, suffix, replacement, forceChain)

add_lookup_call(lookup_name)

add_lookup_to_feature_(lookup, feature_name)

add_mark_base_pos(location, bases, marks)

add_mark_lig_pos(location, ligatures, components)

add_mark_mark_pos(location, baseMarks, marks)

add_marks_(location, lookupBuilder, marks)

Helper for add_mark_{base,liga,mark}_pos.

add_multiple_subst(location, prefix, glyph, suffix, replacements)

add_name_record(location, nameID, platformID, platEncID, langID, string)

add_os2_field(key, value)

add_reverse_chain_single_subst(location, old_prefix, old_suffix, mapping)

add_single_pos(location, prefix, suffix, pos, forceChain)

add_single_pos_chained_(location, prefix, suffix, pos)

add_single_subst(location, prefix, suffix, mapping, forceChain)

add_single_subst_chained_(location, prefix, suffix, mapping)

add_specific_pair_pos(location, glyph1, value1, glyph2, value2)

add_vhea_field(key, value)

build()

buildBASE()

buildBASEAxis(axis)

buildFeatureParams(tag)

buildGDEF()

buildGDEFGlyphClassDef_()

buildGDEFMarkAttachClassDef_()

buildGDEFMarkGlyphSetsDef_()

buildLookups_(tag)

build_OS_2()

build_codepages_(pages)

build_feature_aalt_()

build_head()

build_hhea()

build_name()

build_vhea()

end_feature()

end_lookup_block()

find_chainable_SinglePos_(lookups, glyphs, value)

Helper for add_single_pos_chained_()

find_chainable_SingleSubst_(chain, glyphs)

Helper for add_single_subst_chained_()

find_lookup_builders_(lookups)

Helper for building chain contextual substitutions

Given a list of lookup names, finds the LookupBuilder for each name. If an input name is None, it gets mapped to a None LookupBuilder.

getMarkAttachClass_(location, glyphs)

getMarkFilterSet_(location, glyphs)

get_chained_lookup_(location, builder_class)

get_default_language_systems_()

get_lookup_(location, builder_class)

get_user_name_id(table)

makeTable(tag)

setGlyphClass_(location, glyph, glyphClass)

set_base_axis(bases, scripts, vertical)

set_font_revision(location, revision)

set_language(location, language, include_default, required)

set_lookup_flag(location, value, markAttach, markFilter)

set_script(location, script)

set_size_parameters(location, DesignSize, SubfamilyID, RangeStart, RangeEnd)

start_feature(location, name)

start_lookup_block(location, name)

class fontTools.feaLib.builder.ChainContextPosBuilder(font, location)

build()

equals(other)

class fontTools.feaLib.builder.ChainContextSubstBuilder(font, location)

build()

equals(other)

getAlternateGlyphs()

class fontTools.feaLib.builder.ClassPairPosSubtableBuilder(builder, valueFormat1, valueFormat2)

addPair(gc1, value1, gc2, value2)

addSubtableBreak()

flush_()

subtables()

class fontTools.feaLib.builder.CursivePosBuilder(font, location)

add_attachment(location, glyphs, entryAnchor, exitAnchor)

build()

equals(other)

class fontTools.feaLib.builder.LigatureSubstBuilder(font, location)

build()

equals(other)

class fontTools.feaLib.builder.LookupBuilder(font, location, table, lookup_type)

buildLookup_(subtables)

buildMarkClasses_(marks)

{“cedilla”: (“BOTTOM”, ast.Anchor), …} –> {“BOTTOM”:0, “TOP”:1}

Helper for MarkBasePostBuilder, MarkLigPosBuilder, and MarkMarkPosBuilder. Seems to return the same numeric IDs for mark classes as the AFDKO makeotf tool.

equals(other)

getAlternateGlyphs()

Helper for building ‘aalt’ features.

inferGlyphClasses()

Infers glyph glasses for the GDEF table, such as {“cedilla”:3}.

setBacktrackCoverage_(prefix, subtable)

setInputCoverage_(glyphs, subtable)

setLookAheadCoverage_(suffix, subtable)

class fontTools.feaLib.builder.MarkBasePosBuilder(font, location)

build()

equals(other)

inferGlyphClasses()

class fontTools.feaLib.builder.MarkLigPosBuilder(font, location)

build()

equals(other)

inferGlyphClasses()

class fontTools.feaLib.builder.MarkMarkPosBuilder(font, location)

build()

equals(other)

inferGlyphClasses()

class fontTools.feaLib.builder.MultipleSubstBuilder(font, location)

build()

equals(other)

class fontTools.feaLib.builder.PairPosBuilder(font, location)

SUBTABLE_BREAK_ = 'SUBTABLE_BREAK'

addClassPair(location, glyphclass1, value1, glyphclass2, value2)

addGlyphPair(location, glyph1, value1, glyph2, value2)

add_subtable_break(location)

build()

equals(other)

class fontTools.feaLib.builder.ReverseChainSingleSubstBuilder(font, location)

build()

equals(other)

class fontTools.feaLib.builder.SinglePosBuilder(font, location)

add_pos(location, glyph, valueRecord)

build()

can_add(glyph, value)

equals(other)

class fontTools.feaLib.builder.SingleSubstBuilder(font, location)

build()

equals(other)

getAlternateGlyphs()

fontTools.feaLib.builder.addOpenTypeFeatures(font, featurefile)

fontTools.feaLib.builder.addOpenTypeFeaturesFromString(font, features, filename=None)

fontTools.feaLib.builder.makeOpenTypeAnchor(anchor)

ast.Anchor –> otTables.Anchor

fontTools.feaLib.builder.makeOpenTypeValueRecord(v, pairPosContext)

ast.ValueRecord –> (otBase.ValueRecord, int ValueFormat)

error

class fontTools.feaLib.parser.Parser(featurefile, glyphNames=(), **kwargs)

advance_lexer_(comments=False)

ast = <module 'fontTools.feaLib.ast' from '/build/fonttools-nUdeVi/fonttools-3.21.2/Doc/source/../../Lib/fontTools/feaLib/ast.py'>

expect_cid_()

expect_class_name_()

expect_decipoint_()

expect_float_()

expect_glyph_()

expect_keyword_(keyword)

expect_language_tag_()

expect_markClass_reference_()

expect_name_()

expect_number_()

expect_script_tag_()

expect_string_()

expect_symbol_(symbol)

expect_tag_()

extensions = {}

is_cur_keyword_(k)

is_next_value_()

make_cid_range_(location, start, limit)

(location, 999, 1001) –> [“cid00999”, “cid01000”, “cid01001”]

make_glyph_range_(location, start, limit)

(location, “a.sc”, “d.sc”) –> [“a.sc”, “b.sc”, “c.sc”, “d.sc”]

parse()

parse_FontRevision_()

parse_GlyphClassDef_()

Parses ‘GlyphClassDef @BASE, @LIGATURES, @MARKS, @COMPONENTS;’

parse_anchor_()

parse_anchor_marks_()

Parses a sequence of [<anchor> mark @MARKCLASS]*.

parse_anchordef_()

parse_anonymous_()

parse_attach_()

parse_base_script_list_(count)

parse_base_script_record_(count)

parse_base_tag_list_()

parse_block_(block, vertical, stylisticset=None, size_feature=False)

parse_chain_context_()

parse_class_name_()

parse_device_()

parse_enumerate_(vertical)

parse_featureNames_(tag)

parse_feature_block_()

parse_feature_reference_()

parse_glyph_pattern_(vertical)

parse_glyphclass_(accept_glyphname)

parse_glyphclass_definition_()

Parses glyph class definitions such as ‘@UPPERCASE = [A-Z];’

parse_ignore_()

parse_language_()

parse_languagesystem_()

parse_ligatureCaretByIndex_()

parse_ligatureCaretByPos_()

parse_lookup_(vertical)

parse_lookupflag_()

parse_markClass_()

parse_name_()

parse_nameid_()

parse_position_(enumerated, vertical)

parse_position_base_(enumerated, vertical)

parse_position_cursive_(enumerated, vertical)

parse_position_ligature_(enumerated, vertical)

parse_position_mark_(enumerated, vertical)

parse_script_()

parse_size_menuname_()

parse_size_parameters_()

parse_substitute_()

parse_subtable_()

parse_table_()

parse_table_BASE_(table)

parse_table_GDEF_(table)

parse_table_OS_2_(table)

parse_table_head_(table)

parse_table_hhea_(table)

parse_table_name_(table)

parse_table_vhea_(table)

parse_valuerecord_(vertical)

parse_valuerecord_definition_(vertical)

static reverse_string_(s)

‘abc’ –> ‘cba’

split_glyph_range_(name, location)

static unescape_byte_(match, encoding)

unescape_string_(string, encoding)

static unescape_unichr_(match)

class fontTools.feaLib.parser.SymbolTable

define(name, item)

enter_scope()

exit_scope()

resolve(name)

lexer

class fontTools.feaLib.lexer.IncludingLexer(featurefile)

static make_lexer_(file_or_path, location=None)

next()

scan_anonymous_block(tag)

class fontTools.feaLib.lexer.Lexer(text, filename)

ANONYMOUS_BLOCK = 'ANONYMOUS_BLOCK'

CHAR_DIGIT_ = '0123456789'

CHAR_HEXDIGIT_ = '0123456789ABCDEFabcdef'

CHAR_LETTER_ = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'

CHAR_NAME_CONTINUATION_ = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_.+*:^~!/-'

CHAR_NAME_START_ = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_+*:.^~!\\'

CHAR_NEWLINE_ = '\r\n'

CHAR_SYMBOL_ = ",;:-+'{}[]<>()="

CHAR_WHITESPACE_ = ' \t'

CID = 'CID'

COMMENT = 'COMMENT'

FILENAME = 'FILENAME'

FLOAT = 'FLOAT'

GLYPHCLASS = 'GLYPHCLASS'

MODE_FILENAME_ = 'FILENAME'

MODE_NORMAL_ = 'NORMAL'

NAME = 'NAME'

NEWLINE = 'NEWLINE'

NUMBER = 'NUMBER'

RE_GLYPHCLASS = re.compile('^[A-Za-z_0-9.]+$')

STRING = 'STRING'

SYMBOL = 'SYMBOL'

location_()

next()

next_()

scan_anonymous_block(tag)

scan_over_(valid)

scan_until_(stop_at)

parser

class fontTools.feaLib.parser.Parser(featurefile, glyphNames=(), **kwargs)

advance_lexer_(comments=False)

ast = <module 'fontTools.feaLib.ast' from '/build/fonttools-nUdeVi/fonttools-3.21.2/Doc/source/../../Lib/fontTools/feaLib/ast.py'>

expect_cid_()

expect_class_name_()

expect_decipoint_()

expect_float_()

expect_glyph_()

expect_keyword_(keyword)

expect_language_tag_()

expect_markClass_reference_()

expect_name_()

expect_number_()

expect_script_tag_()

expect_string_()

expect_symbol_(symbol)

expect_tag_()

extensions = {}

is_cur_keyword_(k)

is_next_value_()

make_cid_range_(location, start, limit)

(location, 999, 1001) –> [“cid00999”, “cid01000”, “cid01001”]

make_glyph_range_(location, start, limit)

(location, “a.sc”, “d.sc”) –> [“a.sc”, “b.sc”, “c.sc”, “d.sc”]

parse()

parse_FontRevision_()

parse_GlyphClassDef_()

Parses ‘GlyphClassDef @BASE, @LIGATURES, @MARKS, @COMPONENTS;’

parse_anchor_()

parse_anchor_marks_()

Parses a sequence of [<anchor> mark @MARKCLASS]*.

parse_anchordef_()

parse_anonymous_()

parse_attach_()

parse_base_script_list_(count)

parse_base_script_record_(count)

parse_base_tag_list_()

parse_block_(block, vertical, stylisticset=None, size_feature=False)

parse_chain_context_()

parse_class_name_()

parse_device_()

parse_enumerate_(vertical)

parse_featureNames_(tag)

parse_feature_block_()

parse_feature_reference_()

parse_glyph_pattern_(vertical)

parse_glyphclass_(accept_glyphname)

parse_glyphclass_definition_()

Parses glyph class definitions such as ‘@UPPERCASE = [A-Z];’

parse_ignore_()

parse_language_()

parse_languagesystem_()

parse_ligatureCaretByIndex_()

parse_ligatureCaretByPos_()

parse_lookup_(vertical)

parse_lookupflag_()

parse_markClass_()

parse_name_()

parse_nameid_()

parse_position_(enumerated, vertical)

parse_position_base_(enumerated, vertical)

parse_position_cursive_(enumerated, vertical)

parse_position_ligature_(enumerated, vertical)

parse_position_mark_(enumerated, vertical)

parse_script_()

parse_size_menuname_()

parse_size_parameters_()

parse_substitute_()

parse_subtable_()

parse_table_()

parse_table_BASE_(table)

parse_table_GDEF_(table)

parse_table_OS_2_(table)

parse_table_head_(table)

parse_table_hhea_(table)

parse_table_name_(table)

parse_table_vhea_(table)

parse_valuerecord_(vertical)

parse_valuerecord_definition_(vertical)

static reverse_string_(s)

‘abc’ –> ‘cba’

split_glyph_range_(name, location)

static unescape_byte_(match, encoding)

unescape_string_(string, encoding)

static unescape_unichr_(match)

class fontTools.feaLib.parser.SymbolTable

define(name, item)

enter_scope()

exit_scope()

resolve(name)