freetypy.Face

class freetypy.Face

A face object models a given typeface, in a given style.

Parameters:

file : path, or readable file-like object

The file containing the face data.

face_index : int, optional

The index of the face within the font. The first face has index 0.

Returns:

face : Face instance

Attributes

ascender The typographic ascender of the face, expressed in font units.
available_sizes An list of Bitmap_Size objects for all bitmap strikes in the face.
bbox The font bounding box.
charmap The current active CharMap for this face.
charmaps A list of CharMap objects in the face.
descender The typographic descender of the face, expressed in font units.
face_flags A set of FACE_FLAG flags that give important information about the face.
face_index The index of the face in the font file.
family_name The face’s family name.
filename ⨎ The argument used to initialize the font. Is usually a
glyph The face’s associated glyph slot.
has_horizontal True whenever a face object contains horizontal metrics.
has_kerning True whenever a face object contains kerning data.
has_vertical True whenever a face object contains real vertical metrics.
height This value is the vertical distance between two consecutive baselines, expressed in font units.
is_fixed_width True whenever a font face contains fixed-width (or ‘monospace’) glyphs.
is_scalable True whenever a face object contains a scalable font face.
is_sfnt True whenever font is based on the SFNT storage scheme.
max_advance_height The maximum advance height, in font units, for all glyphs in this face.
max_advance_width The maximum advance width, in font units, for all glyphs in this face.
num_faces The number of faces in the font file.
num_glyphs The number of glyphs in the face.
sfnt_names Get a SfntNames list of SfntName entries for the Face.
size The current active size for this face.
style_flags A set of STYLE_FLAG flags indicating the style of the face.
style_name The face’s style name.
tt_header The TrueType header (TT_Header) from the face.
tt_horiheader The TrueType horizontal header (TT_HoriHeader) from the face.
tt_os2 The OS/2 TrueType header (TT_OS2) from the face.
tt_pclt The PCLT header (TT_Pclt) from the face.
tt_postscript The Postscript header (TT_Postscript) from the face.
tt_vertheader The TrueType vertical header (TT_VertHeader) from the face.
underline_position The position, in font units, of the underline line for this face.
underline_thickness The thickness, in font units, of the underline for this face.
units_per_em The number of font units per EM square for this face.

Methods

attach ‘Attach’ data to a face object.
get_char_index Return the glyph index of a given character code.
get_char_index_unicode ⨎ Return the glyph index of a given Unicode character.
get_char_name ⨎ Returns the glyph name of the given unicode code point.
get_char_variant_index Return the glyph index of a given character code as modified by the variation selector.
get_chars Returns an iterator over all of the character codes in the current charmap.
get_fstype_flags Return the FSTYPE flags for a font, which indicate the licensing for embedding and subsetting a font.
get_glyph_name Retrieve the ASCII name of the given glyph in a face.
get_kerning Return the kerning vector between two glyphs of a same face.
get_name_index Return the glyph index of a given glyph name.
get_postscript_name Retrieve the ASCII PostScript name of a given face, if available.
get_track_kerning Return the track kerning for a given face object at a given size.
has_ps_glyph_names Return True if a given face provides reliable PostScript glyph names.
load_char Load a single glyph, according to its character code.
load_char_unicode ⨎ Load a single glyph, from a given unicode character.
load_glyph Load a single glyph.
request_size Resize the scale of the active Size object in a face.
select_charmap Select a given charmap by its encoding tag.
select_size Select a bitmap strike.
set_char_size Request a nominal font size (in points).
set_charmap Select a charmap for character code to glyph index mapping.
set_transform Set the transformation that is applied to glyph images.