RoboFab RKerning

Usage

f = CurrentFont()
print f.kerning
>>> < RKerning for Mailer-Regular >

# getting a value from the kerning dictionary
print f.kerning[('V', 'A')]
>>> -123

print f.kerning[('T', 'X')]
>>> None

print f.kerning.keys()
>>> [('X', 'emdash'), 
	('K', 'v'),
	('two', 'perthousand'),
	('guilsinglleft', 'a'),
	... etc.

Description

RKerning is a dictionary of kerning values. RFont makes a RKerning object when it is created and makes available as aFont.kerning attribute. The keys are tuples of the glyphs listed by their names: ('T', 'e'), ('V', 'A') etc. None is returned if the pair does not exist, rather than raising an IndexError. The parent of a kerning object is usually a Font.

Methods

• add(value): add value to all kerning pairs.
• asDict(): return the object as a plain dictionary.
• clear(): clear all the kerning (why would you want to do that?)
• combine(kerningDicts, overwriteExisting=True): combine two or more kerning dictionaries. Overwrite exsisting duplicate pairs if overwriteExisting=True
• eliminate(leftGlyphsToEliminate=None, rightGlyphsToEliminate=None, analyzeOnly=False): eliminate pairs containing a left glyph that is in the leftGlyphsToEliminate list or a right glyph that is in the rightGlyphsToELiminate list. sideGlyphsToEliminate can be a string: 'a' or list: ['a', 'b']. analyzeOnly will not remove pairs. it will return a count of all pairs that would be removed.
• explodeClasses(leftClassDict=None, rightClassDict=None, analyzeOnly=False): turn class kerns into real kerning pairs. classes should be defined in dicts: {'O':['C', 'G', 'Q'], 'H':['B', 'D', 'E', 'F', 'I']}. analyzeOnly will not remove pairs. it will return a count of all pairs that would be added
• get(aPair): get a value. return None if the pair does not exist.
• getAverage(): return average of all kerning pairs
• getExtremes(): return the lowest and highest kerning values.
• getLeft(glyphName): Return a list of kerns with glyphName as left character.
• getRight(glyphName): Return a list of kerns with glyphName as right character.
• has_key(pair): returns True if it has the pair.
• implodeClasses(leftClassDict=None, rightClassDict=None, analyzeOnly=False): condense the number of kerning pairs by applying classes. This will eliminate all pairs containg the classed glyphs leaving pairs that contain the key glyphs behind. analyzeOnly will not remove pairs. it will return a count of all pairs that would be removed.
• importAFM(path, clearExisting=True): Import kerning pairs from an AFM file. clearExisting=True will clear all exising kerning
• interpolate(sourceDictOne, sourceDictTwo, value, clearExisting=True): interpolate the kerning between sourceDictOne and sourceDictTwo. clearExisting will clear existing kerning first.
• items(): return a list of (pair, value) tuples.
• keys(): returns a lust of available pairs.
• minimize(minimum=10): eliminate pairs with value less than minimum
• occurrenceCount(glyphsToCount): return a dict with glyphs as keys and the number of occurances of that glyph in the kerning pairs as the value glyphsToCount can be a string: 'a' or list: ['a', 'b']
• remove(pair): remove a kerning pair
• round(multiple=10): round the kerning pair values to increments of multiple
• scale(value): scale all kernng pairs by value
• swapNames(swapTable): change glyph names in all kerning pairs based on swapTable:

  	swapTable = {'BeforeName':'AfterName', }

• update(kerningDict): replace kerning data with the data in the given kerningDict.
• values(): return a list of kerning values