Constructs an unconfigured, empty font face specification. The appropriate setters should be used for configuring the font face. Alternatively, the font importer (@see {@link FontImporter}) provides the import of bitmap-font base configuration file (http://www.angelcode.com/products/bmfont/).
Valid context to create the object for.
Meaningful name for identification of this instances VAO and VBOs.
Map associating a glyph index to a glyph (sub image of a texture).
Set the font's ascent in texture space (px). The ascent is the distance from the baseline to the tops of the tallest glyphs (ascender) in pixel.
The distance from the baseline to the topmost ascender in pixel.
Set the font's ascent in texture space (px). The ascent is the distance from the baseline to the tops of the tallest glyphs (ascender) in pixel.
The distance from the baseline to the topmost ascender in pixel.
Set the font's base in texture space (px). The base is the distance from the baseline to the top in pixel.
The distance from the baseline to the top of the line in pixel.
Set the font's base in texture space (px). The base is the distance from the baseline to the top in pixel.
The distance from the baseline to the top of the line in pixel.
Set the font's descent in texture space (px). The descent is the distance from the baseline to the lowest descender in pixel. Please note that this value is usually negative (if the fonts lowest descender is below the baseline).
The distance from the baseline to the lowest descender in pixel.
Set the font's descent in texture space (px). The descent is the distance from the baseline to the lowest descender in pixel. Please note that this value is usually negative (if the fonts lowest descender is below the baseline).
The distance from the baseline to the lowest descender in pixel.
The padding applied to every glyph in px. This can only be set via setGlyphTexture.
The padding applied to every glyph in px. This can only be set via setGlyphTexture.
CSS style (top, right, bottom, left) padding applied to every glyph within the texture in px.
Set the font's leading/linegap in texture space (px). The leading is the distance from the lowest descender to the topmost ascender of a subsequent text line in pixel.
The gap between two subsequent lines of text in pixel.
Set the font's leading/linegap in texture space (px). The leading is the distance from the lowest descender to the topmost ascender of a subsequent text line in pixel.
The gap between two subsequent lines of text in pixel.
Set the baseline-to-baseline distance in texture space (px). Negative values will result in negative linegap. The line height is derived as follows: line_height = size + line_gap, or alternatively: line_height = size * line_space
The line height (baseline-to-baseline distance) in pixel.
Set the baseline-to-baseline distance in texture space (px). Negative values will result in negative linegap. The line height is derived as follows: line_height = size + line_gap, or alternatively: line_height = size * line_space
The line height (baseline-to-baseline distance) in pixel.
The relative baseline-to-baseline distance w.r.t. the font's size. The relative line space is derived as follows: line_space = size / line_height; Note that the descent is usually a negative value.
Set the relative baseline-to-baseline distance w.r.t. the font's size. The line space is mapped to line gap as follows: line_gap = size * (line_space - 1). A space < 1.0 will result in a negative line gap.
The relative baseline-to-baseline distance w.r.t. the font's size.
The size of the font in texture space (px).
The size of the font in texture space (px).
Add a glyph to the font face's set of glyphs. If the glyph already exists, the existing glyph remains.
The glyph to add to the set of glyphs.
Generates aan array of all comprised glyph indices.
Check if a glyph is depictable/renderable. If the glyph's sub-texture vertical or horizontal extent is zero the glyph does not need to be depicted/rendered. E.g., spaces, line feeds, other control sequences as well as unknown glyphs do not need to be processed for rendering.
Index of the glyph to access.
Direct access to an indexed glyph. If the glyph does not exist, an empty glyph is returned without adding it to glyphs. The glyph atlas might be loaded asynchronously, thus, new glyphs are expected to be added via addGlyph.
Index of the glyph to access.
Check if a glyph of a specific index is available.
Index of the glyph to access.
Kerning for a glyph and a subsequent glyph in texture space (px). If the glyph or the subsequent glyph are unknown to this font face (assertion), 0.f will be returned. For more details on kerning, refer to the Glyph class.
The current glyph index (e.g., of the current pen-position).
The glyph index of the subsequent/next glyph.
Set the kerning for a glyph w.r.t. to a subsequent glyph in texture space (px). If the glyph is known to this font face, the values are forwarded to the glyphs kerning setter (see Glyph for more information).
The target glyph index.
The glyph index of the respective subsequent/next glyph.
Kerning of the two glyphs in pixel.
Fetches a font face file, and, if successful, processes it and fetches referenced pages.
Resolving the promise:
let fontFace: FontFace | undefined;
FontFace.fromFile(context, './data/opensansr144.fnt').then((value) => fontFace = value);
Uniform resource locator string referencing the fnt-file that should be loaded.
Valid context to create the object for.
Whether or not to enable headless mode. If enabled, pages are not loaded.
Meaningful name/prefix for identification of fetched pages (glyph atlases).
Font related data for glyph based text rendering. The glyph-based font face is described by, e.g., font-size, line spacing, a glyph catalogue, as well as kerning information. The glyph catalogue is based on a set of glyphs referring to a texture atlas (@see {@link Glyph}). All measures are provided in float even though most glyph-textures and associated font data is encoded via integer values. A font face explicitly relies on floating values to reduce the need of casting as well as to simplify the use for dpi aware text rendering. The font face interface is designed to access most basic font settings ascent, descent, and line gap (leading). Additional font settings are provided via interface but are derived from or mapped to the above mentioned three settings, e.g., font size is the sum of descent and ascent. This is to provide as much convenience measures for type setting/font rendering as possible. Note: This class does not provide dpi awareness, which has to be handled outside of this class, e.g., during layouting and rendering.
A font can be loaded as follows: