Typeface

class Typeface

The Typeface class specifies the typeface and intrinsic style of a font.

This is used in the paint, along with optionally algorithmic settings like textSize, textSkewX, textScaleX, kFakeBoldText_Mask, to specify how text appears when drawn (and measured).

Typeface objects are immutable, and so they can be shared between threads.

Example:

typeface = skia.Typeface()
typeface = skia.Typeface('Arial')
typeface = skia.Typeface('Arial', skia.FontStyle.Bold())

Classes

SerializeBehavior

A typeface can serialize just a descriptor (names, etc.), or it can also

Methods

Equal

Returns true if the two typefaces reference the same underlying font, handling either being null (treating null as the default font)

MakeDefault

Returns the default normal typeface, which is never nullptr.

MakeDeserialize

Given the data previously written by serialize(), return a new instance of a typeface referring to the same font.

MakeEmpty

Returns a non-null typeface which contains no glyphs.

MakeFromData

Return a new typeface given a Data.

MakeFromFile

Return a new typeface given a file.

MakeFromName

Creates a new reference to the typeface that most closely matches the requested familyName and fontStyle.

__init__

Overloaded function.

copyTableData

Return an immutable copy of the requested font table, or nullptr if that table was not found.

countGlyphs

Return the number of glyphs in the typeface.

countTables

Return the number of tables in the font.

fontStyle

Returns the typeface's intrinsic style attributes.

getBounds

Return a rectangle (scaled to 1-pt) that represents the union of the bounds of all of the glyphs, but each one positioned at (0,).

getFamilyName

Return the family name for this typeface.

getFamilyNames

Returns a list of (family name, language) pairs specified by the font.

getKerningPairAdjustments

Given a run of glyphs, return the associated horizontal adjustments.

getPostScriptName

Return the PostScript name for this typeface.

getTableData

Returns the contents of a table.

getTableSize

Given a table tag, return the size of its contents, or 0 if not present.

getTableTags

Returns the list of table tags in the font.

getUnitsPerEm

Return the units-per-em value for this typeface, or zero if there is an error.

getVariationDesignParameters

Returns the design variation parameters.

getVariationDesignPosition

Returns the design variation coordinates.

isBold

Returns true if style() has the kBold bit set.

isFixedPitch

Returns true if the typeface claims to be fixed-pitch.

isItalic

Returns true if style() has the kItalic bit set.

makeClone

Return a new typeface based on this typeface but parameterized as specified in the FontArguments.

ref

Increment the reference count.

serialize

Returns a unique signature to a stream, sufficient to reconstruct a typeface referencing the same font when Deserialize is called.

unicharToGlyph

Return the glyphID that corresponds to the specified unicode code-point (in UTF32 encoding).

unicharsToGlyphs

Given an array of UTF32 character codes, return their corresponding glyph IDs.

unique

May return true if the caller is the only owner.

uniqueID

Return a 32bit value for this typeface, unique for the underlying font data.

unref

Decrement the reference count.

Attributes

kDoIncludeData

kDontIncludeData

kIncludeDataIfLocal

Methods

static Typeface.Equal(self: skia.Typeface, other: skia.Typeface) bool

Returns true if the two typefaces reference the same underlying font, handling either being null (treating null as the default font)

static Typeface.MakeDefault() skia.Typeface

Returns the default normal typeface, which is never nullptr.

static Typeface.MakeDeserialize(dats: skia.Data) skia.Typeface

Given the data previously written by serialize(), return a new instance of a typeface referring to the same font.

If that font is not available, return nullptr.

static Typeface.MakeEmpty() skia.Typeface

Returns a non-null typeface which contains no glyphs.

static Typeface.MakeFromData(data: skia.Data, index: int = 0) skia.Typeface

Return a new typeface given a Data.

If the data is null, or is not a valid font file, returns nullptr.

Use MakeDeserialize() for the result of serialize().

static Typeface.MakeFromFile(path: str, index: int = 0) skia.Typeface

Return a new typeface given a file.

If the file does not exist, or is not a valid font file, returns nullptr.

static Typeface.MakeFromName(familyName: object, fontStyle: skia.FontStyle = None) skia.Typeface

Creates a new reference to the typeface that most closely matches the requested familyName and fontStyle.

This method allows extended font face specifiers as in the FontStyle type. Will never return null.

Parameters:
  • familyName (str) – May be NULL. The name of the font family.

  • fontStyle (skia.FontStyle) – The style of the typeface.

Returns:

reference to the closest-matching typeface.

Typeface.__init__(*args, **kwargs)

Overloaded function.

  1. __init__(self: skia.Typeface) -> None

    Returns the default normal typeface.

  2. __init__(self: skia.Typeface, familyName: object, fontStyle: skia.FontStyle = None) -> None

    Creates a new reference to the typeface that most closely matches the requested familyName and fontStyle.

    This method allows extended font face specifiers as in the FontStyle type. Will never return null.

    param str familyName:

    May be NULL. The name of the font family.

    param skia.FontStyle fontStyle:

    The style of the typeface.

    return:

    reference to the closest-matching typeface.

Typeface.copyTableData(self: skia.Typeface, tag: int) skia.Data

Return an immutable copy of the requested font table, or nullptr if that table was not found.

This can sometimes be faster than calling getTableData() twice: once to find the length, and then again to copy the data.

Parameters:

tag – The table tag whose contents are to be copied

Returns:

an immutable copy of the table’s data, or nullptr.

Typeface.countGlyphs(self: skia.Typeface) int

Return the number of glyphs in the typeface.

Typeface.countTables(self: skia.Typeface) int

Return the number of tables in the font.

Typeface.fontStyle(self: skia.Typeface) skia.FontStyle

Returns the typeface’s intrinsic style attributes.

Typeface.getBounds(self: skia.Typeface) skia.Rect

Return a rectangle (scaled to 1-pt) that represents the union of the bounds of all of the glyphs, but each one positioned at (0,).

This may be conservatively large, and will not take into account any hinting or other size-specific adjustments.

Typeface.getFamilyName(self: skia.Typeface) str

Return the family name for this typeface.

It will always be returned encoded as UTF8, but the language of the name is whatever the host platform chooses.

Typeface.getFamilyNames(self: skia.Typeface) list

Returns a list of (family name, language) pairs specified by the font.

Typeface.getKerningPairAdjustments(self: skia.Typeface, glyphs: List[int]) object

Given a run of glyphs, return the associated horizontal adjustments.

Adjustments are in “design units”, which are integers relative to the typeface’s units per em (see getUnitsPerEm).

Some typefaces are known to never support kerning. If the typeface does not support kerning, then this method will return None (no kerning) for all possible glyph runs.

Typeface.getPostScriptName(self: skia.Typeface) str

Return the PostScript name for this typeface. Value may change based on variation parameters. Returns false if no PostScript name is available.

Typeface.getTableData(self: skia.Typeface, tag: int) bytes

Returns the contents of a table.

Note that the contents of the table will be in their native endian order (which for most truetype tables is big endian). If the table tag is not found, or there is an error copying the data, then 0 is returned. If this happens, it is possible that some or all of the memory pointed to by data may have been written to, even though an error has occured.

Parameters:

tag (int) – The table tag whose contents are to be copied.

Returns:

table contents

Typeface.getTableSize(self: skia.Typeface, tag: int) int

Given a table tag, return the size of its contents, or 0 if not present.

Typeface.getTableTags(self: skia.Typeface) List[int]

Returns the list of table tags in the font.

Typeface.getUnitsPerEm(self: skia.Typeface) int

Return the units-per-em value for this typeface, or zero if there is an error.

Typeface.getVariationDesignParameters(self: skia.Typeface) List[skia.FontParameters.Variation.Axis]

Returns the design variation parameters.

Returns:

List of axes.

Return type:

List[skia.FontParameters.Variation.Axis]

Typeface.getVariationDesignPosition(self: skia.Typeface) skia.FontArguments.VariationPosition.Coordinates

Returns the design variation coordinates.

Parameters:

coordinateCount (int) – the maximum number of entries to get.

Returns:

list of coordinates

Return type:

List[skia.FontArguments.VariationPosition.Coordinate]

Typeface.isBold(self: skia.Typeface) bool

Returns true if style() has the kBold bit set.

Typeface.isFixedPitch(self: skia.Typeface) bool

Returns true if the typeface claims to be fixed-pitch.

Typeface.isItalic(self: skia.Typeface) bool

Returns true if style() has the kItalic bit set.

Typeface.makeClone(self: skia.Typeface, fontArguments: skia.FontArguments) skia.Typeface

Return a new typeface based on this typeface but parameterized as specified in the FontArguments.

If the FontArguments does not supply an argument for a parameter in the font then the value from this typeface will be used as the value for that argument. If the cloned typeface would be exaclty the same as this typeface then this typeface may be ref’ed and returned. May return nullptr on failure.

Typeface.ref(self: skia.RefCntBase) None

Increment the reference count.

Must be balanced by a call to unref().

Typeface.serialize(self: skia.Typeface, behavior: skia.Typeface.SerializeBehavior = <SerializeBehavior.kIncludeDataIfLocal: 2>) skia.Data

Returns a unique signature to a stream, sufficient to reconstruct a typeface referencing the same font when Deserialize is called.

Typeface.unicharToGlyph(self: skia.Typeface, unichar: int) int

Return the glyphID that corresponds to the specified unicode code-point (in UTF32 encoding).

If the unichar is not supported, returns 0.

This is a short-cut for calling unicharsToGlyphs().

Typeface.unicharsToGlyphs(self: skia.Typeface, chars: List[int]) List[int]

Given an array of UTF32 character codes, return their corresponding glyph IDs.

Parameters:

chars (List[int]) – the array of UTF32 chars.

Returns:

the corresponding glyph IDs for each character.

Typeface.unique(self: skia.RefCntBase) bool

May return true if the caller is the only owner.

Ensures that all previous owner’s actions are complete.

Typeface.uniqueID(self: skia.Typeface) int

Return a 32bit value for this typeface, unique for the underlying font data.

Will never return 0.

Typeface.unref(self: skia.RefCntBase) None

Decrement the reference count.

If the reference count is 1 before the decrement, then delete the object. Note that if this is the case, then the object needs to have been allocated via new, and not on the stack.

Attributes

Typeface.kDoIncludeData = <SerializeBehavior.kDoIncludeData: 0>
Typeface.kDontIncludeData = <SerializeBehavior.kDontIncludeData: 1>
Typeface.kIncludeDataIfLocal = <SerializeBehavior.kIncludeDataIfLocal: 2>