freetypist

Provides FreeType font loading for TextraTypist.

You can load anything FWSkin (from TextraTypist) can load, such as .fnt and (optionally compressed) Structured JSON files from FontWriter, as well as anything FreeTypeSkin (from Stripe) can load, such as FreeType font config. This also will load TextraTypist's Styles.Whatever types when it loads the corresponding scene2d.ui style. Importantly, this can load both the .dat and .fnt files distributed in TextraTypist's knownFonts/ folder.

This depends on FreeType, so you must have the appropriate platform dependencies for that, if you don't already. It also, naturally, depends on TextraTypist. It has no other dependencies of its own.

Versions here are linked to TextraTypist versions, so version 1.1.0.1 uses TextraTypist 1.1.0, with a bugfix or other patch applied to append .1. In the case of 1.1.0.1, that patch allows SelectBoxStyle to be read in, and fixes some optional properties that other styles may have in a Skin JSON file. That version still depends on the same version of TextraTypist, 1.1.0, as the release before it. When a new TextraTypist version comes out, such as 1.1.1, then the corresponding version of FreeTypist would be 1.1.1.0.

Dependency

Using Maven Central:

implementation 'com.github.tommyettinger:freetypist:1.1.0.1'

Using JitPack: (Instead of 93e338da1b, you can use any recent commit listed here under Commits.)

implementation 'com.github.tommyettinger:freetypist:93e338da1b'

You could also just copy the two source files, FreeTypistSkin.java and FreeTypistSkinLoader.java, into your own project, which is probably the easiest route. This is what TextraTypist does for its tests. You still will need the FreeType dependencies, including its platform dependencies.

Quirks

You might have to add or remove padding from Table Cells/Containers that have TextraLabels or TypingLabels in them, if the dimensions of that cell or container are determined by the label. In particular, using someCell.padBottom(-myFont.descent); may be all you need, and this may only be needed for some FreeType fonts. It looks like FreeType handles some positions differently from FontWriter, which is what the .dat fonts distributed in TextraTypist's KnownFonts used most of the time.

History

This project was previously a subproject of the textratypist repo, but with the way that that was structured, I had some real issues when releasing. That's why the release numbersing was sketchy for a while early on. FreeTypist was moved to its own repo because it doesn't actually depend on the latest TextraTypist commit anyway, and it can reasonably be its own small project.

License

Apache 2.0, the same as TextraTypist.