Method GetKerningAdjustmentFontUnits

Namespace

DocWright.Fonts

Assembly

DocWright.Fonts.dll

GetKerningAdjustmentFontUnits(ushort, ushort)

Gets the legacy kern table's adjustment for one glyph pair, in font units: the pair kerning the engine applies to text it shapes from the character map for a document outside compatibility mode 15, never the GPOS kern feature's value.

public int GetKerningAdjustmentFontUnits(ushort leftGlyphId, ushort rightGlyphId)

Parameters

leftGlyphId ushort

The left glyph id.

rightGlyphId ushort

The right glyph id.

Returns

int

The kerning adjustment in fUnits, or zero when absent.

Remarks

The value is the first glyph's X advance adjustment. Word kerns a run with w:kern in a document that declares compatibility mode 14 or earlier, or none, by the legacy table alone (WORDQUIRKS.md WQ-0049), so a face that kerns only in GPOS returns zero for every pair. In mode 15 Word kerns from the GPOS kern feature where the face has one; that value is reached by shaping with a ShapeRequest whose OpenTypeKerning is set, not by this method. Arabic and Hebrew runs shaped through the face's own OpenType tables take the GPOS pair adjustments as part of shaping; this method does not report those either.