SpriteFontPlus

Library that extends functionality of the SpriteFont.

Features

• Creation of SpriteFont in the run-time from ttf.
• Creation of SpriteFont in the run-time from AngelCode BMFont(only XML with single texture works for now).
• DynamicSpriteFont class that renders glyphs on demand to the underlying texture atlas. Also it supports 32-bit characters and blurry text.

Adding Reference

There are two ways of referencing SpriteFontPlus in the project:

1. Through nuget(works only for MonoGame): https://www.nuget.org/packages/SpriteFontPlus/

2. As source code(works for both MonoGame and FNA):

   a. Clone this repo.

   b. Execute git submodule update --init --recursive within the folder the repo was cloned to.

   c. Add src/SpriteFontPlus.MonoGame.csproj or src/SpriteFontPlus.FNA.csproj to the solution.

   • If FNA is used, then the folder structure is expected to be following:

Loading SpriteFont from a ttf

Following code creates a SpriteFont from a ttf:

var fontBakeResult = TtfFontBaker.Bake(File.ReadAllBytes(@"C:\\Windows\\Fonts\arial.ttf"),
	25,
	1024,
	1024,
	new[]
	{
		CharacterRange.BasicLatin,
		CharacterRange.Latin1Supplement,
		CharacterRange.LatinExtendedA,
		CharacterRange.Cyrillic
	}
);

SpriteFont font = fontBakeResult.CreateSpriteFont(GraphicsDevice);

Full sample is here: samples/SpriteFontPlus.Samples.TtfBaking

Loading SpriteFont from AngelCode BMFont

Texture2D texture;
using (var stream = TitleContainer.OpenStream("Fonts/test_0.png"))
{
	texture = Texture2D.FromStream(GraphicsDevice, stream);
}

string fontData;
using (var stream = TitleContainer.OpenStream("Fonts/test.fnt"))
{
	using (var reader = new StreamReader(stream))
	{
		fontData = reader.ReadToEnd();
	}
}

// As we use font with one texture, always return it independently from requested name
SpriteFont font = BMFontLoader.LoadXml(fontData, name => texture);

Full sample is here: samples/SpriteFontPlus.Samples.BMFont

DynamicSpriteFont

DynamicSpriteFont renders glyphs on demand to the underlying texture atlas. Thus it doesnt require to explicity specify character ranges that are going to be used during the font creation.

Following code creates DynamicSpriteFont from 3 different ttfs:

	_font = DynamicSpriteFont.FromTtf(File.ReadAllBytes(@"Fonts/DroidSans.ttf"), 20);
	_font.AddTtf(File.ReadAllBytes(@"Fonts/DroidSansJapanese.ttf"));
	_font.AddTtf(File.ReadAllBytes(@"Fonts/Symbola-Emoji.ttf"));

Now it's possible to draw text using glyphs from all those fonts, using Size property to change the font size.

I.e. consider following code:

	_spriteBatch.Begin();

	// Render some text
	_font.Size = 18;
	_spriteBatch.DrawString(_font, "The quick いろは brown\nfox にほへ jumps over\nt🙌h📦e l👏a👏zy dog", new Vector2(0, 0), Color.White);

	_font.Size = 30;
	_spriteBatch.DrawString(_font, "The quick いろは brown\nfox にほへ jumps over\nt🙌h📦e l👏a👏zy dog", new Vector2(0, 80), Color.Yellow);

	_spriteBatch.End();

It would render following:

Full sample is here: samples/SpriteFontPlus.Samples.DynamicSpriteFont

Building From Source Code

1. Clone this repo.
2. git submodule update --init --recursive
3. Open a solution from the "build" folder.

Credits

• MonoGame
• FNA
• BMFont
• Cyotek.Drawing.BitmapFont
• stb
• fontstash