PixiJS

Class: BitmapFont

PIXI.BitmapFont

BitmapFont represents a typeface available for use with the BitmapText class. Use the install method for adding a font to be used.

new PIXI.BitmapFont (data, textures, ownsTextures)

BitmapFont.ts:171
Name Type Attributes Description
data PIXI.BitmapFontData
textures PIXI.Texture[] | PIXI.Texture<utils.Dict>
ownsTextures boolean <optional>

Setting to true will destroy page textures when the font is uninstalled.

Members

PIXI.BitmapFont.ALPHA Array<Array<string>> staticreadonly

This character set includes all the letters in the alphabet (both lower- and upper- case).

Example
BitmapFont.from('ExampleFont', style, { chars: BitmapFont.ALPHA })

PIXI.BitmapFont.ALPHANUMERIC Array<Array<string>> staticreadonly

This character set is the union of BitmapFont.ALPHA and BitmapFont.NUMERIC.

PIXI.BitmapFont.ASCII Array<Array<string>> staticreadonly

This character set consists of all the ASCII table.

See:

PIXI.BitmapFont.available utils.Dict<PIXI.BitmapFont> staticreadonly

Collection of available/installed fonts.

PIXI.BitmapFont.defaultOptions PIXI.IBitmapFontOptions staticreadonly

Collection of default options when using BitmapFont.from.

Properties:
Name Type Attributes Default Value Description
chars string | Array<string> | Array<Array<string>> <constant>
 PIXI.BitmapFont.ALPHANUMERIC
padding number <optional>
 4
resolution number <optional>
 1
textureHeight number <optional>
 512
textureWidth number <optional>
 512

PIXI.BitmapFont.NUMERIC Array<Array<string>> staticreadonly

This character set includes all decimal digits (from 0 to 9).

Example
BitmapFont.from('ExampleFont', style, { chars: BitmapFont.NUMERIC })

chars utils.Dict<IBitmapFontCharacter> readonly

The map of characters by character code.

distanceFieldRange number readonly

The range of the distance field in pixels.

distanceFieldType string readonly

The kind of distance field for this font or "none".

font string readonly

The name of the font face.

lineHeight number readonly

The line-height of the font face in pixels.

pageTextures utils.Dict<PIXI.Texture> readonly

The map of base page textures (i.e., sheets of glyphs).

size number readonly

The size of the font face in pixels.

Methods

PIXI.BitmapFont.from (name, textStyle, options) PIXI.BitmapFont static

BitmapFont.ts:353

Generates a bitmap-font for the given style and character set. This does not support kernings yet. With style properties, only the following non-layout properties are used:

Name Type Attributes Description
name string

The name of the custom font to use with BitmapText.
textStyle PIXI.TextStyle | PIXI.ITextStyle<Partial> <optional>

Style options to render with BitmapFont.
options PIXI.IBitmapFontOptions <optional>

Setup options for font or name of the font.
Returns:
Type Description
PIXI.BitmapFont Font generated by style options.
Example
 import { BitmapFont, BitmapText } from 'pixi.js';

 BitmapFont.from('TitleFont', {
     fontFamily: 'Arial',
     fontSize: 12,
     strokeThickness: 2,
     fill: 'purple',
 });

 const title = new BitmapText('This is the title', { fontName: 'TitleFont' });

PIXI.BitmapFont.install (data, textures, ownsTextures) PIXI.BitmapFont static

BitmapFont.ts:288

Register a new bitmap font.

Name Type Attributes Description
data string | XMLDocument | PIXI.BitmapFontData

The characters map that could be provided as xml or raw string.
textures PIXI.Texture | PIXI.Texture[] | utils.Dict<PIXI.Texture>

List of textures for each page.
ownsTextures boolean <optional>

Set to true to destroy page textures when the font is uninstalled. By default fonts created with BitmapFont.from or from the BitmapFontLoader are true.
Returns:
Type Description
PIXI.BitmapFont Result font object with font, size, lineHeight and char fields.

PIXI.BitmapFont.uninstall (name) void static

BitmapFont.ts:336

Remove bitmap font by name.

Name Type Description
name string

Name of the font to uninstall.

destroy () void

BitmapFont.ts:264

Remove references to created glyph textures.