Package com.github.tommyettinger.textra
Class KnownFonts
java.lang.Object
com.github.tommyettinger.textra.KnownFonts
- All Implemented Interfaces:
com.badlogic.gdx.LifecycleListener
Preconfigured static
Typical usage involves calling one of the static methods like
There's some documentation for every known Font, including a link to a preview image and a listing of all required files to use a Font. The required files include any license you need to abide by; this doesn't necessarily belong in the
There are some special features in Font that are easier to use with parts of this class.
Font instances, with any important metric adjustments already applied. This uses a
singleton to ensure each font exists at most once, and implements LifecycleListener to ensure that when the
disposal stage of the lifecycle is called, then all Font instances here will be disposed and assigned null. This may
do more regarding its LifecycleListener code in the future, if Android turns out to need more work.
Typical usage involves calling one of the static methods like
getCozette() or getGentiumSDF() to get a
particular Font. This knows a fair amount of fonts, but it doesn't require the image assets for all of those to be
present in a game -- only the files mentioned in the documentation for a method are needed, and only if you call that
method. It's likely that many games would only use one Font, and so would generally only need a .fnt file, a
.png file, and some kind of license file. They could ignore all other assets required by other fonts. The files this
class needs are looked for in the assets root folder by default, but you can change the names or locations of asset
files with setAssetPrefix(String).
There's some documentation for every known Font, including a link to a preview image and a listing of all required files to use a Font. The required files include any license you need to abide by; this doesn't necessarily belong in the
assets folder like the rest of the files! Most of these fonts are either licensed under the OFL
or some Creative Commons license; the CC ones typically require attribution, but none of the fonts restrict usage to
noncommercial projects, and all are free as in beer as well. Please take care to attribute the authors of fonts you
use! Good fonts are not easy to make.
There are some special features in Font that are easier to use with parts of this class.
getStandardFamily()
pre-populates a FontFamily so you can switch between different fonts with the [@Sans] syntax.
addEmoji(Font) adds all of Twitter's emoji from the Twemoji
project to a given font, which lets you enter emoji with the [+man scientist, dark skin tone] syntax or the
generally-easier [+👨🏿🔬] syntax. If you want to use names for emoji, you may want to consult "Twemoji.atlas"
for the exact names used; some names changed from the standard because of technical restrictions. You can also add
the icons from game-icons.net using addGameIcons(Font). There is a
preview site for Twemoji, with names, another
preview site for OpenMoji, with names, and another
preview site for the game icons.-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringBase name for a fixed-width octagonal font.static final StringBase name for a variable-width serif font.static final StringBase name for a variable-width sans font.static final StringBase name for a fixed-width programming font.static final StringBase name for a variable-width handwriting font.static final StringBase name for a fixed-width pixel font.static final StringBase name for a variable-width sans font.static final StringBase name for a variable-width narrow sans font.static final StringBase name for a fixed-width programming font.static final StringBase name for a variable-width serif font.static final StringBase name for a variable-width narrow serif font.static final com.badlogic.gdx.utils.OrderedSet<String>static final StringBase name for a variable-width Unicode-heavy serif font.static final StringBase name for a variable-width Unicode-heavy "swashbuckling" serif font.static final StringBase name for a variable-width geometric font.static final StringBase name for a variable-width Unicode-heavy sans font.static final StringBase name for a variable-width heavy-weight serif font.static final StringBase name for a fixed-width CJK-heavy serif font.static final StringBase name for a fixed-width "traditional" pixel font.static final StringBase name for a fixed-width geometric/programming font.static final StringBase name for a fixed-width Unicode-heavy sans font.static final StringBase name for a fixed-width Unicode-heavy slab-serif font.static final com.badlogic.gdx.utils.OrderedSet<String>static final StringBase name for a variable-width ornate medieval font.static final StringBase name for a variable-width legible medieval font.static final StringBase name for a variable-width Unicode-heavy pixel font.static final StringBase name for a variable-width medium-weight serif font.static final StringBase name for a variable-width heavy-weight serif font.static final com.badlogic.gdx.utils.OrderedSet<String>static final StringBase name for a variable-width geometric font.static final StringBase name for a variable-width sans font.static final StringBase name for a variable-width geometric sans font.static final StringBase name for a variable-width sci-fi font.static final StringBase name for a tiny variable-width Unicode-heavy pixel font.static final StringBase name for a variable-width narrow sans font.static final com.badlogic.gdx.utils.OrderedSet<String>static final com.badlogic.gdx.utils.OrderedSet<String>static final com.badlogic.gdx.utils.OrderedSet<String>static final StringBase name for a variable-width script font.static final StringBase name for a variable-width humanist sans font.static final StringBase name for a variable-width "dark fantasy" font. -
Method Summary
Modifier and TypeMethodDescriptionstatic FontTakes a Font and adds the Twemoji icon set to it, making the glyphs available using[+name]syntax.static FontTakes a Font and adds the Twemoji icon set to it, making the glyphs available using[+name]syntax.static FontaddEmoji(Font changing, String prepend, String append, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the Twemoji icon set to it, making the glyphs available using[+name]syntax.static FontaddGameIcons(Font changing) Takes a Font and adds the Game-Icons.net icon set to it, making the glyphs available using[+name]syntax.static FontaddGameIcons(Font changing, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the Game-Icons.net icon set to it, making the glyphs available using[+name]syntax.static FontaddGameIcons(Font changing, String prepend, String append, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the Game-Icons.net icon set to it, making the glyphs available using[+name]syntax.static FontaddOpenMoji(Font changing, boolean color) Takes a Font and adds the OpenMoji icon set to it, making the glyphs available using[+name]syntax.static FontaddOpenMoji(Font changing, boolean color, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the OpenMoji icon set to it, making the glyphs available using[+name]syntax.static FontaddOpenMoji(Font changing, boolean color, String prepend, String append, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the OpenMoji icon set to it, making the glyphs available using[+name]syntax.voiddispose()static Font[]getAll()Returns a new array of Font instances, calling each getXyz() method in this class that returns any Font.static Font[]Returns a new array of Font instances, callinggetFont(String, DistanceFieldType)on every font name inSTANDARD_NAMESwithFont.DistanceFieldType.MSDFas the distance field type.static Font[]Returns a new array of Font instances, callinggetFont(String, DistanceFieldType)on every font name inSTANDARD_NAMESwithFont.DistanceFieldType.SDFas the distance field type.static Font[]Returns a new array of Font instances, callinggetFont(String, DistanceFieldType)on every font name inSTANDARD_NAMESwithFont.DistanceFieldType.STANDARDas the distance field type (meaning no distance field effect will be used).static FontReturns a very large fixed-width Font already configured to use a square font with 45-degree angled sections, based on the typeface used on the Atari ST console.static FontReturns a very large fixed-width Font already configured to use a square font with 45-degree angled sections, based on the typeface used on the Atari ST console.static FontReturns a very large fixed-width Font already configured to use a square font with 45-degree angled sections, based on the typeface used on the Atari ST console.static FontReturns a very large fixed-width Font already configured to use a tall font with angled sections, based on the typeface used on the Atari ST console.static FontReturns a very large fixed-width Font already configured to use a tall font with angled sections, based on the typeface used on the Atari ST console.static FontReturns a Font already configured to use a light-weight variable-width slab serif font with good Latin and Cyrillic script support, that should scale pretty well from a height of about 160 down to a height of maybe 30.static FontReturns a Font already configured to use a light-weight variable-width slab serif font with good Latin and Cyrillic script support, that should scale pretty well from a height of about 160 down to a height of maybe 30.static FontReturns a Font already configured to use a very-legible variable-width font with strong support for Canadian Aboriginal Syllabic, that should scale pretty well from a height of about 86 down to a height of maybe 30.static FontReturns a Font already configured to use a very-legible variable-width font with strong support for Canadian Aboriginal Syllabic, that should scale pretty well from a height of about 86 down to a height of maybe 30.static FontReturns a Font already configured to use a quirky fixed-width font with good Unicode support and a humanist style, that should scale well from a height of about 60 pixels to about 15 pixels.static FontReturns a Font already configured to use a quirky fixed-width font with good Unicode support and a humanist style, that should scale well from a height of about 60 pixels to about 15 pixels.static FontReturns a Font already configured to use a quirky fixed-width font with good Unicode support and a humanist style.static FontReturns a Font already configured to use a variable-width handwriting font with support for extended Latin and Cyrillic, that should scale pretty well from a height of about 160 down to a height of maybe 20.static FontReturns a Font already configured to use a variable-width handwriting font with support for extended Latin and Cyrillic, that should scale pretty well from a height of about 160 down to a height of maybe 20.static FontReturns a Font configured to use a cozy fixed-width bitmap font, Cozette by slavfox.static FontReturns a Font already configured to use a variable-width sans-serif font with excellent Unicode support.static FontReturns a Font already configured to use a variable-width sans-serif font with excellent Unicode support.static FontReturns a Font already configured to use a variable-width narrow sans-serif font with excellent Unicode support.static FontReturns a Font already configured to use a variable-width narrow sans-serif font with excellent Unicode support.static FontA nice old standby font with very broad language support, DejaVu Sans Mono is fixed-width and can be clearly readable but doesn't do anything unusual stylistically.static FontA nice old standby font with very broad language support, DejaVu Sans Mono is fixed-width and can be clearly readable but doesn't do anything unusual stylistically.static FontReturns a Font already configured to use a variable-width serif font with excellent Unicode support.static FontReturns a Font already configured to use a variable-width serif font with excellent Unicode support.static FontReturns a Font already configured to use a variable-width narrow serif font with excellent Unicode support.static FontReturns a Font already configured to use a variable-width narrow serif font with excellent Unicode support.static FontReturns a Font (getGentium()) with a FontFamily configured so that 15 Fonts with the givenFont.DistanceFieldTypecan be used with syntax like[@Sans].static FontA general way to get a copied Font from the known set of fonts, this takes a String name (which can be fromJSON_NAMES,FNT_NAMES, orSAD_NAMES, or more likely from a constant such asOPEN_SANS) and treats it as using no distance field effect (Font.DistanceFieldType.STANDARD).static FontgetFont(String baseName, Font.DistanceFieldType distanceField) A general way to get a copied Font from the known set of fonts, this takes a String name (which can be fromJSON_NAMES,FNT_NAMES, orSAD_NAMES, or more likely from a constant such asOPEN_SANS) and a DistanceFieldType (which is usuallyFont.DistanceFieldType.STANDARD, but could also beFont.DistanceFieldType.SDF,Font.DistanceFieldType.MSDF, or evenFont.DistanceFieldType.SDF_OUTLINE).static FontgetGameIconsFont(float width, float height) Gets a typically-square Font that is meant to be used in a FontFamily, allowing switching to a Font with the many game-icons.net icons.static FontReturns a Font already configured to use a variable-width serif font with excellent Unicode support, that should scale well from a height of about 132 down to a height of 24.static FontReturns a Font already configured to use a variable-width serif font with excellent Unicode support.static FontReturns a Font already configured to use a variable-width serif font with excellent Unicode support, that should scale cleanly to even very large sizes (using an MSDF technique).static FontReturns a Font already configured to use a variable-width serif font with excellent Unicode support, that should scale cleanly to even very large sizes (using an SDF technique).static FontReturns a Font already configured to use a variable-width "italic-like" serif font with excellent Unicode support, that should scale well from a height of about 97 down to a height of 30.static FontReturns a Font already configured to use a variable-width "italic-like" serif font with excellent Unicode support, that should scale well from a height of about 97 down to a height of 30.static FontReturns a Font already configured to use a variable-width geometric sans-serif font.static FontReturns a Font already configured to use a variable-width geometric sans-serif font.static FontReturns a Font already configured to use a variable-width sans-serif font with extreme pan-Unicode support, that should scale cleanly to medium-small sizes (but not large sizes).static FontReturns a Font already configured to use a variable-width sans-serif font with extreme pan-Unicode support.static FontReturns a Font already configured to use a variable-width sans-serif font with extreme pan-Unicode support, that should scale cleanly to even very large sizes (using an SDF technique).static FontReturns a Font already configured to use a variable-width, heavy-weight, legible gothic font.static FontReturns a Font already configured to use a variable-width, heavy-weight, legible gothic font.static FontReturns a Font already configured to use a variable-width, narrow font with nearly-complete CJK character coverage, plus Latin, Greek, and Cyrillic, that should scale pretty well down, but not up.static FontReturns a Font configured to use a classic, nostalgic fixed-width bitmap font, IBM 8x16 from the early, oft-beloved computer line.static FontA customized version of Inconsolata LGC, a fixed-width geometric font that supports a large range of Latin, Greek, and Cyrillic glyphs, plus box drawing and some dingbat characters (like zodiac signs).static FontA customized version of Inconsolata LGC, a fixed-width geometric font that supports a large range of Latin, Greek, and Cyrillic glyphs, plus box drawing and some dingbat characters (like zodiac signs).static FontA customized version of Inconsolata LGC, a fixed-width geometric font that supports a large range of Latin, Greek, and Cyrillic glyphs, plus box drawing and some dingbat characters (like zodiac signs).static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style.static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style.static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style, that should scale cleanly to even very large sizes (using an MSDF technique).static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style, that should scale cleanly to fairly large sizes (using an SDF technique).static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a slab-serif geometric style.static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style.static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a slab-serif geometric style, that should scale cleanly to even very large sizes (using an MSDF technique).static FontReturns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a slab-serif geometric style, that should scale cleanly to fairly large sizes (using an SDF technique).static FontReturns a Font already configured to use a fairly-legible variable-width ornamental/medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30.static FontReturns a Font already configured to use a fairly-legible variable-width ornamental/medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30.static FontReturns a Font already configured to use a clearly-legible variable-width medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30.static FontReturns a Font already configured to use a clearly-legible variable-width medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30.static FontReturns a Font already configured to use a variable-width pixel font with excellent Unicode support, that probably should only be used at integer multiples of its normal size.static FontReturns a Font already configured to use a variable-width serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels.static FontReturns a Font already configured to use a variable-width serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels.static FontReturns a Font already configured to use a variable-width heavy-weight serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels.static FontReturns a Font already configured to use a variable-width heavy-weight serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels.static FontReturns a Font already configured to use a variable-width geometric sans-serif font, that should scale cleanly to fairly large sizes or down to about 20 pixels.static FontReturns a Font already configured to use a variable-width geometric sans-serif font, that should scale cleanly to fairly large sizes or down to about 20 pixels.static FontReturns a Font configured to use a clean variable-width font, Open Sans.static FontReturns a Font configured to use a clean variable-width font, Open Sans.static FontReturns a Font configured to use an ALL-CAPS, variable-width, tall, very-heavy-weight sans-serif font, Ostrich Black.static FontReturns a Font configured to use an ALL-CAPS, variable-width, tall, very-heavy-weight sans-serif font, Ostrich Black.static FontReturns a Font already configured to use a variable-width "science-fiction/high-tech" font, that should scale pretty well down, but not up.static FontReturns a Font already configured to use a variable-width "science-fiction/high-tech" font, that should scale pretty well down, but not up.static FontReturns a Font configured to use a small variable-width bitmap font with extensive coverage of Asian scripts, QuanPixel.static FontReturns a Font already configured to use a very-legible condensed variable-width font with excellent Unicode support, that should scale pretty well from a height of about 62 down to a height of maybe 20.static FontReturns a Font already configured to use a very-legible condensed variable-width font with excellent Unicode support.static FontReturns a Font (getGentium()) with a FontFamily configured so that 15 non-distance-field Fonts can be used with syntax like[@Sans].static FontReturns a Font already configured to use a variable-width script font, that should scale pretty well down, but not up.static FontReturns a Font already configured to use a variable-width script font.static FontReturns a Font already configured to use a variable-width script font, that should scale pretty well down, but not up.static FontReturns a Font already configured to use a variable-width, narrow, humanist font, that should scale pretty well down, but not up.static FontReturns a Font already configured to use a variable-width, narrow, humanist font.static FontReturns a Font already configured to use a variable-width, narrow, humanist font.static FontReturns a Font already configured to use a variable-width, narrow, "dark fantasy" font.static FontReturns a Font already configured to use a variable-width, narrow, "dark fantasy" font.static FontReturns a Font already configured to use a variable-width, narrow, "dark fantasy" font.static com.badlogic.gdx.graphics.g2d.TextureAtlasloadUnicodeAtlas(com.badlogic.gdx.files.FileHandle packFile, com.badlogic.gdx.files.FileHandle imagesDir, boolean flip) This is exactly likeTextureAtlas(FileHandle, FileHandle, boolean), except it jumps through some hoops to ensure the atlas is loaded with UTF-8 encoding.voidpause()voidresume()static voidsetAssetPrefix(String prefix) Changes the String prepended to each filename this looks up.
-
Field Details
-
A_STARRY
Base name for a fixed-width octagonal font.- See Also:
-
BITTER
Base name for a variable-width serif font.- See Also:
-
CANADA1500
Base name for a variable-width sans font.- See Also:
-
CASCADIA_MONO
Base name for a fixed-width programming font.- See Also:
-
CAVEAT
Base name for a variable-width handwriting font.- See Also:
-
DEJAVU_SANS_CONDENSED
Base name for a variable-width narrow sans font.- See Also:
-
DEJAVU_SANS_MONO
Base name for a fixed-width programming font.- See Also:
-
DEJAVU_SANS
Base name for a variable-width sans font.- See Also:
-
DEJAVU_SERIF_CONDENSED
Base name for a variable-width narrow serif font.- See Also:
-
DEJAVU_SERIF
Base name for a variable-width serif font.- See Also:
-
GENTIUM
Base name for a variable-width Unicode-heavy serif font.- See Also:
-
GENTIUM_UN_ITALIC
Base name for a variable-width Unicode-heavy "swashbuckling" serif font.- See Also:
-
GLACIAL_INDIFFERENCE
Base name for a variable-width geometric font.- See Also:
-
GO_NOTO_UNIVERSAL
Base name for a variable-width Unicode-heavy sans font.- See Also:
-
GRENZE
Base name for a variable-width heavy-weight serif font.- See Also:
-
INCONSOLATA_LGC
Base name for a fixed-width geometric/programming font.- See Also:
-
IOSEVKA
Base name for a fixed-width Unicode-heavy sans font.- See Also:
-
IOSEVKA_SLAB
Base name for a fixed-width Unicode-heavy slab-serif font.- See Also:
-
KINGTHINGS_FOUNDATION
Base name for a variable-width ornate medieval font.- See Also:
-
KINGTHINGS_PETROCK
Base name for a variable-width legible medieval font.- See Also:
-
LIBERTINUS_SERIF
Base name for a variable-width medium-weight serif font.- See Also:
-
LIBERTINUS_SERIF_SEMIBOLD
Base name for a variable-width heavy-weight serif font.- See Also:
-
NOW_ALT
Base name for a variable-width geometric font.- See Also:
-
OPEN_SANS
Base name for a variable-width sans font.- See Also:
-
OSTRICH_BLACK
Base name for a variable-width geometric sans font.- See Also:
-
OXANIUM
Base name for a variable-width sci-fi font.- See Also:
-
ROBOTO_CONDENSED
Base name for a variable-width narrow sans font.- See Also:
-
TANGERINE
Base name for a variable-width script font.- See Also:
-
YANONE_KAFFEESATZ
Base name for a variable-width humanist sans font.- See Also:
-
YATAGHAN
Base name for a variable-width "dark fantasy" font.- See Also:
-
COZETTE
Base name for a fixed-width pixel font.- See Also:
-
HANAZONO
Base name for a fixed-width CJK-heavy serif font.- See Also:
-
LANAPIXEL
Base name for a variable-width Unicode-heavy pixel font.- See Also:
-
QUANPIXEL
Base name for a tiny variable-width Unicode-heavy pixel font.- See Also:
-
IBM_8X16
Base name for a fixed-width "traditional" pixel font.- See Also:
-
JSON_NAMES
-
FNT_NAMES
-
SAD_NAMES
-
STANDARD_NAMES
-
SDF_NAMES
-
MSDF_NAMES
-
-
Method Details
-
setAssetPrefix
Changes the String prepended to each filename this looks up. This should end in "/" if the files have the same name but are in a subdirectory (don't use backslashes for paths; they aren't cross-platform compatible). It can end without a "/" to prepend a String to the name of each file this looks up. The default prefix is "".- Parameters:
prefix- the new prefix to use before each filename, such as a subdirectory ending in "/"
-
getFont
A general way to get a copied Font from the known set of fonts, this takes a String name (which can be fromJSON_NAMES,FNT_NAMES, orSAD_NAMES, or more likely from a constant such asOPEN_SANS) and treats it as using no distance field effect (Font.DistanceFieldType.STANDARD). It looks up the appropriate file name, respecting asset prefix (seesetAssetPrefix(String)), creates the Font if necessary, then returns a copy of it.
If a more specialized method modifies a Font in theloadedcache when it runs, its effects will not necessarily be shown here.- Parameters:
baseName- typically a constant such asOPEN_SANSorLIBERTINUS_SERIF- Returns:
- a copy of the Font with the given name
-
getFont
A general way to get a copied Font from the known set of fonts, this takes a String name (which can be fromJSON_NAMES,FNT_NAMES, orSAD_NAMES, or more likely from a constant such asOPEN_SANS) and a DistanceFieldType (which is usuallyFont.DistanceFieldType.STANDARD, but could also beFont.DistanceFieldType.SDF,Font.DistanceFieldType.MSDF, or evenFont.DistanceFieldType.SDF_OUTLINE). It looks up the appropriate file name, respecting asset prefix (seesetAssetPrefix(String)), creates the Font if necessary, then returns a copy of it.
If a more specialized method modifies a Font in theloadedcache when it runs, its effects will not necessarily be shown here.- Parameters:
baseName- typically a constant such asOPEN_SANSorLIBERTINUS_SERIFdistanceField- a DistanceFieldType, usuallyFont.DistanceFieldType.STANDARD- Returns:
- a copy of the Font with the given name
-
getAStarry
Returns a very large fixed-width Font already configured to use a square font with 45-degree angled sections, based on the typeface used on the Atari ST console. This font only supports ASCII, but it supports all of it. Caches the result for later calls. The font is "a-starry", based on "Atari ST (low-res)" by Damien Guard; it is available under a CC-BY-SA-3.0 license, which requires attribution to Damien Guard (and technically Tommy Ettinger, because he made changes in a-starry) if you use it.
This returns the same thing asKnownFonts.getFont(KnownFonts.A_STARRY, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font A Starry
-
getAStarry
Returns a very large fixed-width Font already configured to use a square font with 45-degree angled sections, based on the typeface used on the Atari ST console. This font only supports ASCII, but it supports all of it. Caches the result for later calls. The font is "a-starry", based on "Atari ST (low-res)" by Damien Guard; it is available under a CC-BY-SA-3.0 license, which requires attribution to Damien Guard (and technically Tommy Ettinger, because he made changes in a-starry) if you use it.
Preview:
Needs files:
or,
or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font A Starry
-
getAStarryMSDF
Returns a very large fixed-width Font already configured to use a square font with 45-degree angled sections, based on the typeface used on the Atari ST console. This uses the MSDF distance field effect. This font only supports ASCII, but it supports all of it. Caches the result for later calls. The font is "a-starry", based on "Atari ST (low-res)" by Damien Guard; it is available under a CC-BY-SA-3.0 license, which requires attribution to Damien Guard (and technically Tommy Ettinger, because he made changes in a-starry) if you use it.
This returns the same thing asKnownFonts.getFont(KnownFonts.A_STARRY, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font A Starry
-
getAStarryTall
Returns a very large fixed-width Font already configured to use a tall font with angled sections, based on the typeface used on the Atari ST console. This font only supports ASCII, but it supports all of it. Caches the result for later calls. The font is "a-starry", based on "Atari ST (low-res)" by Damien Guard; it is available under a CC-BY-SA-3.0 license, which requires attribution to Damien Guard (and technically Tommy Ettinger, because he made changes in a-starry) if you use it. This is an extended-height version of a-starry, making it half the width relative to its height, instead of having equal width and height.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font A Starry, with half width
-
getAStarryTall
Returns a very large fixed-width Font already configured to use a tall font with angled sections, based on the typeface used on the Atari ST console. This font only supports ASCII, but it supports all of it. Caches the result for later calls. The font is "a-starry", based on "Atari ST (low-res)" by Damien Guard; it is available under a CC-BY-SA-3.0 license, which requires attribution to Damien Guard (and technically Tommy Ettinger, because he made changes in a-starry) if you use it. This is an extended-height version of a-starry, making it half the width relative to its height, instead of having equal width and height.
Preview:
Needs files:
or,
or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font A Starry, with half width
-
getBitter
Returns a Font already configured to use a light-weight variable-width slab serif font with good Latin and Cyrillic script support, that should scale pretty well from a height of about 160 down to a height of maybe 30. Caches the result for later calls. The font used is Bitter, a free (OFL) typeface by The Bitter Project. It supports quite a lot of Latin-based scripts and Cyrillic, but does not really cover Greek or any other scripts. This font can look good at its natural size, which uses width roughly equal to height, or squashed so height is slightly smaller. Bitter looks very similar togetGentium(), except that Bitter is quite a bit lighter, with thinner strokes and stylistic flourishes on some glyphs. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.BITTER, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Bitter-Light.ttf
-
getBitter
Returns a Font already configured to use a light-weight variable-width slab serif font with good Latin and Cyrillic script support, that should scale pretty well from a height of about 160 down to a height of maybe 30. Caches the result for later calls. The font used is Bitter, a free (OFL) typeface by The Bitter Project. It supports quite a lot of Latin-based scripts and Cyrillic, but does not really cover Greek or any other scripts. This font can look good at its natural size, which uses width roughly equal to height, or squashed so height is slightly smaller. Bitter looks very similar togetGentium(), except that Bitter is quite a bit lighter, with thinner strokes and stylistic flourishes on some glyphs.
Preview:
Needs files:
or,
or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Bitter
-
getCanada
Returns a Font already configured to use a very-legible variable-width font with strong support for Canadian Aboriginal Syllabic, that should scale pretty well from a height of about 86 down to a height of maybe 30. Caches the result for later calls. The font used is Canada1500, a free (public domain, via CC0) typeface by Ray Larabie. It supports quite a lot of Latin-based scripts, Greek, Cyrillic, Canadian Aboriginal Syllabic, arrows, many dingbats, and more. This font can look good at its natural size, which uses width roughly equal to height, or narrowed down so width is smaller. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.CANADA1500, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Canada1500
-
getCanada
Returns a Font already configured to use a very-legible variable-width font with strong support for Canadian Aboriginal Syllabic, that should scale pretty well from a height of about 86 down to a height of maybe 30. Caches the result for later calls. The font used is Canada1500, a free (public domain, via CC0) typeface by Ray Larabie. It supports quite a lot of Latin-based scripts, Greek, Cyrillic, Canadian Aboriginal Syllabic, arrows, many dingbats, and more. This font can look good at its natural size, which uses width roughly equal to height, or narrowed down so width is smaller.
Preview:
Needs files:
or,
or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Canada1500
-
getCascadiaMono
Returns a Font already configured to use a quirky fixed-width font with good Unicode support and a humanist style, that should scale well from a height of about 60 pixels to about 15 pixels. Caches the result for later calls. The font used is Cascadia Code Mono, an open-source (SIL Open Font License) typeface by Microsoft (see Microsoft's page). It supports a lot of glyphs, including most extended Latin, Greek, Braille, and Cyrillic. This uses a fairly-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.CASCADIA_MONO, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Cascadia Code Mono
-
getCascadiaMono
Returns a Font already configured to use a quirky fixed-width font with good Unicode support and a humanist style, that should scale well from a height of about 60 pixels to about 15 pixels. Caches the result for later calls. The font used is Cascadia Code Mono, an open-source (SIL Open Font License) typeface by Microsoft (see Microsoft's page). It supports a lot of glyphs, including most extended Latin, Greek, Braille, and Cyrillic. This uses a fairly-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
Preview:
Needs files:
or,
or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Cascadia Code Mono
-
getCascadiaMonoMSDF
Returns a Font already configured to use a quirky fixed-width font with good Unicode support and a humanist style. This uses the MSDF distance field effect. Caches the result for later calls. The font used is Cascadia Code Mono, an open-source (SIL Open Font License) typeface by Microsoft (see Microsoft's page). It supports a lot of glyphs, including most extended Latin, Greek, Braille, and Cyrillic.
This returns the same thing asKnownFonts.getFont(KnownFonts.CASCADIA_MONO, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Cascadia Code Mono
-
getCaveat
Returns a Font already configured to use a variable-width handwriting font with support for extended Latin and Cyrillic, that should scale pretty well from a height of about 160 down to a height of maybe 20. It will look sharper and more aliased at smaller sizes, but should be relatively smooth at a height of 32 or so. This is a sort of natural handwriting, as opposed to the formal script ingetTangerine(). Caches the result for later calls. The font used is Caveat, a free (OFL) typeface designed by Pablo Impallari. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.CAVEAT, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Caveat
-
getCaveat
Returns a Font already configured to use a variable-width handwriting font with support for extended Latin and Cyrillic, that should scale pretty well from a height of about 160 down to a height of maybe 20. It will look sharper and more aliased at smaller sizes, but should be relatively smooth at a height of 32 or so. This is a sort of natural handwriting, as opposed to the formal script ingetTangerine(). Caches the result for later calls. The font used is Caveat, a free (OFL) typeface designed by Pablo Impallari. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
Preview:
Needs files:
or,
or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Caveat
-
getCozette
Returns a Font configured to use a cozy fixed-width bitmap font, Cozette by slavfox. Cozette has broad coverage of Unicode, including Greek, Cyrillic, Braille, and tech-related icons. This does not scale well except to integer multiples, but it should look very crisp at its default size of 6x17 pixels. This defaults to havingFont.integerPositionset to true, which currently does nothing (the code that enforces integer positions seems to ruin the appearance of any font that uses it, so that code isn't ever used now). This may work well in a font family with other fonts that do not use a distance field effect.
Preview: Image link (uses width=6, height=17; this size is small enough to make the scaled text unreadable in some places)
Needs files:- Returns:
- the Font object that represents the 6x17px font Cozette
-
getDejaVuSans
Returns a Font already configured to use a variable-width sans-serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Sans, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. This does not use a distance field effect, as opposed togetDejaVuSansMono(). You may want to stick using just fonts that avoid distance fields if you have a family of fonts.
This returns the same thing asKnownFonts.getFont(KnownFonts.DEJAVU_SANS, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font DejaVuSans.ttf
-
getDejaVuSans
Returns a Font already configured to use a variable-width sans-serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Sans, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font DejaVuSans.ttf
-
getDejaVuSansCondensed
Returns a Font already configured to use a variable-width narrow sans-serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Sans Condensed, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. This does not use a distance field effect, as opposed togetDejaVuSansMono(). You may want to stick using just fonts that avoid distance fields if you have a family of fonts.
This returns the same thing asKnownFonts.getFont(KnownFonts.DEJAVU_SANS_CONDENSED, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font DejaVuSansCondensed.ttf
-
getDejaVuSansCondensed
Returns a Font already configured to use a variable-width narrow sans-serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Sans Condensed, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font DejaVuSansCondensed.ttf
-
getDejaVuSansMono
A nice old standby font with very broad language support, DejaVu Sans Mono is fixed-width and can be clearly readable but doesn't do anything unusual stylistically. It really does handle a lot of glyphs; not only does this have practically all Latin glyphs in Unicode (enough to support everything from Icelandic to Vietnamese), it has Greek (including Extended), Cyrillic (including some optional glyphs), IPA, Armenian (maybe the only font here to do so), Georgian (which won't be treated correctly by some case-insensitive code, so it should only be used if case doesn't matter), and Lao. It has full box drawing and Braille support, handles a wide variety of math symbols, technical marks, and dingbats, etc. This is an open-source typeface included in many Linux distros. This uses the Multi-channel Signed Distance Field (MSDF) technique as opposed to the normal Signed Distance Field technique, which gives the rendered font sharper edges and precise corners instead of rounded tips on strokes.
Note that the name here doesn't include "MSDF" for historical reasons. This omission is part of why usinggetFont(String, DistanceFieldType)is preferred.
The crispness is likely too high in this version. You can callKnownFonts.getDejaVuSansMono().setCrispness(0.5f)if you want significantly smoother edges.
This returns the same thing asKnownFonts.getFont(KnownFonts.DEJAVU_SANS_MONO, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font DejaVu Sans Mono using MSDF
-
getDejaVuSansMono
A nice old standby font with very broad language support, DejaVu Sans Mono is fixed-width and can be clearly readable but doesn't do anything unusual stylistically. It really does handle a lot of glyphs; not only does this have practically all Latin glyphs in Unicode (enough to support everything from Icelandic to Vietnamese), it has Greek (including Extended), Cyrillic (including some optional glyphs), IPA, Armenian (maybe the only font here to do so), Georgian (which won't be treated correctly by some case-insensitive code, so it should only be used if case doesn't matter), and Lao. It has full box drawing and Braille support, handles a wide variety of math symbols, technical marks, and dingbats, etc. This is an open-source typeface included in many Linux distros.
The crispness for the MSDF version is likely too high in this version. You can callKnownFonts.getDejaVuSansMono(Font.DistanceFieldType.MSDF).setCrispness(0.5f)if you want significantly smoother edges.
Preview:
Needs files: or, or- Returns:
- the Font object that can represent many sizes of the font DejaVu Sans Mono
-
getDejaVuSerif
Returns a Font already configured to use a variable-width serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Serif, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. This does not use a distance field effect, as opposed togetDejaVuSansMono(). You may want to stick using just fonts that avoid distance fields if you have a family of fonts.
This returns the same thing asKnownFonts.getFont(KnownFonts.DEJAVU_SERIF, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font DejaVuSerif.ttf
-
getDejaVuSerif
Returns a Font already configured to use a variable-width serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Serif, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font DejaVuSerif.ttf
-
getDejaVuSerifCondensed
Returns a Font already configured to use a variable-width narrow serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Serif Condensed, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. This does not use a distance field effect, as opposed togetDejaVuSansMono(). You may want to stick using just fonts that avoid distance fields if you have a family of fonts.
This returns the same thing asKnownFonts.getFont(KnownFonts.DEJAVU_SERIF_CONDENSED, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font DejaVuSerifCondensed.ttf
-
getDejaVuSerifCondensed
Returns a Font already configured to use a variable-width narrow serif font with excellent Unicode support. Caches the result for later calls. The font used is DejaVu Serif Condensed, an open-source typeface included in many Linux distros. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font DejaVuSerifCondensed.ttf
-
getGentium
Returns a Font already configured to use a variable-width serif font with excellent Unicode support, that should scale well from a height of about 132 down to a height of 24. Caches the result for later calls. The font used is Gentium, an open-source (SIL Open Font License) typeface by SIL (see SIL's page on Gentium here). It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. This does not use a distance field effect, as opposed togetGentiumSDF()orgetGentiumMSDF(). You may want to stick using just fonts that avoid distance fields if you have a family of fonts. You can also usegetStandardFamily()to obtain a variant on this Font that has a FontFamily already.
This returns the same thing asKnownFonts.getFont(KnownFonts.GENTIUM, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Gentium.ttf
-
getGentiumMSDF
Returns a Font already configured to use a variable-width serif font with excellent Unicode support, that should scale cleanly to even very large sizes (using an MSDF technique). Caches the result for later calls. The font used is Gentium, an open-source (SIL Open Font License) typeface by SIL (see SIL's page on Gentium here). It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. This uses the Multi-channel Signed Distance Field (MSDF) technique as opposed to the normal Signed Distance Field technique, which gives the rendered font sharper edges and precise corners instead of rounded tips on strokes.
This returns the same thing asKnownFonts.getFont(KnownFonts.GENTIUM, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Gentium.ttf using MSDF
-
getGentiumSDF
Returns a Font already configured to use a variable-width serif font with excellent Unicode support, that should scale cleanly to even very large sizes (using an SDF technique). Caches the result for later calls. The font used is Gentium, an open-source (SIL Open Font License) typeface by SIL (see SIL's page on Gentium here). It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. This uses the Signed Distance Field (SDF) technique, which may be slightly fuzzy when zoomed in heavily, but should be crisp enough when zoomed out.
This returns the same thing asKnownFonts.getFont(KnownFonts.GENTIUM, Font.DistanceFieldType.SDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Gentium.ttf using SDF
-
getGentium
Returns a Font already configured to use a variable-width serif font with excellent Unicode support. Caches the result for later calls. The font used is Gentium, an open-source (SIL Open Font License) typeface by SIL (see SIL's page on Gentium here). It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages.
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Gentium.ttf
-
getGentiumUnItalic
Returns a Font already configured to use a variable-width "italic-like" serif font with excellent Unicode support, that should scale well from a height of about 97 down to a height of 30. Caches the result for later calls. The font used is Gentium, an open-source (SIL Open Font License) typeface by SIL (see SIL's page on Gentium here), but this took Gentium Italic and removed the 8-degree slant it had, so it looks like a regular face but with the different serif style and the "flow" of an italic font. This helps it look closer to carefully-hand-written text mixed with a serif typeface, and may fit well as a main-text font for medieval or Renaissance-period games while something likegetKingthingsFoundation()is used for titles or headers. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. Even though glyphs are not especially wide here, this Font does need to be configured with a much larger width than height to be readable. This does not use a distance field effect. You may want to stick using just fonts that avoid distance fields if you have a family of fonts.
Thanks to Siavash Ranbar, who came up with the idea to take an italic version of a serif font and remove its slant, keeping the different flow from a simple oblique font.
This returns the same thing asKnownFonts.getFont(KnownFonts.GENTIUM_UN_ITALIC, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Gentium-Un-Italic.ttf
-
getGentiumUnItalic
Returns a Font already configured to use a variable-width "italic-like" serif font with excellent Unicode support, that should scale well from a height of about 97 down to a height of 30. Caches the result for later calls. The font used is Gentium, an open-source (SIL Open Font License) typeface by SIL (see SIL's page on Gentium here), but this took Gentium Italic and removed the 8-degree slant it had, so it looks like a regular face but with the different serif style and the "flow" of an italic font. This helps it look closer to carefully-hand-written text mixed with a serif typeface, and may fit well as a main-text font for medieval or Renaissance-period games while something likegetKingthingsFoundation()is used for titles or headers. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic, as well as some less-common glyphs from various real languages. Even though glyphs are not especially wide here, this Font does need to be configured with a much larger width than height to be readable. This does not use a distance field effect. You may want to stick using just fonts that avoid distance fields if you have a family of fonts.
Thanks to Siavash Ranbar, who came up with the idea to take an italic version of a serif font and remove its slant, keeping the different flow from a simple oblique font.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Gentium-Un-Italic.ttf
-
getGlacialIndifference
Returns a Font already configured to use a variable-width geometric sans-serif font. This looks similar, but not identical, togetNowAlt(). In particular, this font has a much lighter weight. Caches the result for later calls. The font used is Glacial Indifference, an open-source (SIL Open Font License) typeface. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.GLACIAL_INDIFFERENCE, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Glacial Indifference
-
getGlacialIndifference
Returns a Font already configured to use a variable-width geometric sans-serif font. This looks similar, but not identical, togetNowAlt(). In particular, this font has a much lighter weight. Caches the result for later calls. The font used is Glacial Indifference, an open-source (SIL Open Font License) typeface.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Glacial Indifference
-
getGoNotoUniversal
Returns a Font already configured to use a variable-width sans-serif font with extreme pan-Unicode support, that should scale cleanly to medium-small sizes (but not large sizes). Caches the result for later calls. The font used is Go Noto Universal, an open-source (SIL Open Font License) typeface that modifies Noto Sans by Google (see Go Noto Universal's page is here, and Noto Fonts have a page here). It supports... most glyphs, from many languages, including essentially all extended Latin, Greek, Cyrillic, Chinese, Japanese, Armenian, Ethiopic, Cherokee, Javanese... Most scripts are here, though not Hangul (used for Korean). This also has symbols for math, music, and other usage. The texture this uses is larger than many of the others here, at 4096x4096 pixels, but the file isn't too large; in fact, the 2048x2048 textures Gentium-msdf.png and Twemoji.png are each larger than Go-Noto-Universal-standard.png . The .dat has 21274 glyphs plus extensive kerning info, though, so it is large.
This returns the same thing asKnownFonts.getFont(KnownFonts.GO_NOTO_UNIVERSAL, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font GoNotoCurrent.ttf
-
getGoNotoUniversalSDF
Returns a Font already configured to use a variable-width sans-serif font with extreme pan-Unicode support, that should scale cleanly to even very large sizes (using an SDF technique). Caches the result for later calls. The font used is Go Noto Universal, an open-source (SIL Open Font License) typeface that modifies Noto Sans by Google (see Go Noto Universal's page is here, and Noto Fonts have a page here). It supports... most glyphs, from many languages, including essentially all extended Latin, Greek, Cyrillic, Chinese, Japanese, Armenian, Ethiopic, Cherokee, Javanese... Most scripts are here, though not Hangul (used for Korean). This also has symbols for math, music, and other usage. The baseline may be slightly uneven at larger sizes, but should even out when height is less than 40 or so. This uses the Signed Distance Field (SDF) technique, which may be slightly fuzzy when zoomed in heavily, but should be crisp enough when zoomed out. The texture this uses is larger than many of the others here, at 4096x4096 pixels, but the file isn't too large; in fact, the 2048x2048 textures Gentium-msdf.png and Twemoji.png are each larger than GoNotoUniversal-sdf.png . The .fnt has 24350 glyphs plus extensive kerning info, though, so it is quite large.
This returns the same thing asKnownFonts.getFont(KnownFonts.GO_NOTO_UNIVERSAL, Font.DistanceFieldType.SDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font GoNotoCurrent.ttf
-
getGoNotoUniversal
Returns a Font already configured to use a variable-width sans-serif font with extreme pan-Unicode support. The font used is Go Noto Universal, an open-source (SIL Open Font License) typeface that modifies Noto Sans by Google (see Go Noto Universal's page is here, and Noto Fonts have a page here). It supports... most glyphs, from many languages, including essentially all extended Latin, Greek, Cyrillic, Chinese, Japanese, Armenian, Ethiopic, Cherokee, Javanese... Most scripts are here, though not Hangul (used for Korean). This also has symbols for math, music, and other usage. The texture this uses is larger than many of the others here, at 4096x4096 pixels, but the file isn't too large; in fact, the 2048x2048 textures Gentium-msdf.png and Twemoji.png are each larger than Go-Noto-Universal-standard.png . The .dat has 21274 glyphs plus extensive kerning info, though, so it is large.
Preview:
Needs files: or, or,- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font GoNotoCurrent.ttf
-
getGrenze
Returns a Font already configured to use a variable-width, heavy-weight, legible gothic font. Caches the result for later calls. The font used is Grenze, a free (OFL) typeface designed by the Manuale Project. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.GRENZE, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Grenze
-
getGrenze
Returns a Font already configured to use a variable-width, heavy-weight, legible gothic font. Caches the result for later calls. The font used is Grenze, a free (OFL) typeface designed by the Manuale Project.
Preview:
Needs files:
or,
or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Grenze
-
getHanazono
Returns a Font already configured to use a variable-width, narrow font with nearly-complete CJK character coverage, plus Latin, Greek, and Cyrillic, that should scale pretty well down, but not up. Caches the result for later calls. The font used is Hanazono (HanMinA, specifically), a free (OFL) typeface. This uses a somewhat-small standard bitmap font because of how many glyphs are present (over 34000); it might not scale as well as other standard bitmap fonts here. You may want to considergetGoNotoUniversalSDF()if you can use an SDF font, since it scales up with higher quality. Otherwise, this may work well in a font family with other fonts that do not use a distance field effect.
Preview: Image link (uses width=16, height=20)
Needs files:- Returns:
- the Font object that can represent many sizes of the font HanMinA.ttf
-
getIBM8x16
Returns a Font configured to use a classic, nostalgic fixed-width bitmap font, IBM 8x16 from the early, oft-beloved computer line. This font is notably loaded from a SadConsole format file, which shouldn't affect how it looks (but in reality, it might). This does not scale except to integer multiples, but it should look very crisp at its default size of 8x16 pixels. This supports some extra characters, but not at the typical Unicode codepoints. This defaults to havingFont.integerPositionset to true, which currently does nothing (the code that enforces integer positions seems to ruin the appearance of any font that uses it, so that code isn't ever used now). This may work well in a font family with other fonts that do not use a distance field effect.
This does not include a license because the source, SadConsole's fonts, did not include one. It is doubtful that IBM would have any issues with respectful use of their signature font throughout the 1980s, but if the legality is concerning, you can usegetCozette()orgetQuanPixel()for a different bitmap font. There is alsogetAStarry()for a non-pixel font styled after a font from the same era.
Preview: Image link (uses width=8, height=16, done with fitCell(8, 16, false))
Needs files:- Returns:
- the Font object that represents an 8x16 font included with early IBM computers
-
getInconsolata
A customized version of Inconsolata LGC, a fixed-width geometric font that supports a large range of Latin, Greek, and Cyrillic glyphs, plus box drawing and some dingbat characters (like zodiac signs). The original font Inconsolata is by Raph Levien, and various other contributors added support for other languages. This does not use a distance field effect, as opposed togetInconsolataMSDF(). This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.INCONSOLATA_LGC, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Inconsolata LGC Custom
-
getInconsolataMSDF
A customized version of Inconsolata LGC, a fixed-width geometric font that supports a large range of Latin, Greek, and Cyrillic glyphs, plus box drawing and some dingbat characters (like zodiac signs). The original font Inconsolata is by Raph Levien, and various other contributors added support for other languages. This uses the Multi-channel Signed Distance Field (MSDF) technique as opposed to the normal Signed Distance Field technique, which gives the rendered font sharper edges and precise corners instead of rounded tips on strokes.
This returns the same thing asKnownFonts.getFont(KnownFonts.INCONSOLATA_LGC, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Inconsolata LGC Custom
-
getInconsolata
A customized version of Inconsolata LGC, a fixed-width geometric font that supports a large range of Latin, Greek, and Cyrillic glyphs, plus box drawing and some dingbat characters (like zodiac signs). The original font Inconsolata is by Raph Levien, and various other contributors added support for other languages. This does not use a distance field effect, as opposed togetInconsolataMSDF(). This may work well in a font family with other fonts that do not use a distance field effect.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Inconsolata LGC Custom
-
getIosevka
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style. Does not use a distance field effect. Caches the result for later calls. The font used is Iosevka, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.IOSEVKA, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Iosevka.ttf
-
getIosevkaMSDF
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style, that should scale cleanly to even very large sizes (using an MSDF technique). Caches the result for later calls. The font used is Iosevka, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This uses the Multi-channel Signed Distance Field (MSDF) technique as opposed to the normal Signed Distance Field technique, which gives the rendered font sharper edges and precise corners instead of rounded tips on strokes.
This returns the same thing asKnownFonts.getFont(KnownFonts.IOSEVKA, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Iosevka.ttf using MSDF
-
getIosevkaSDF
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style, that should scale cleanly to fairly large sizes (using an SDF technique). Caches the result for later calls. The font used is Iosevka, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This uses the Signed Distance Field (SDF) technique as opposed to the Multi-channel Signed Distance Field technique thatgetIosevkaMSDF()uses, which isn't as sharp at large sizes but can look a little better at small sizes.
This returns the same thing asKnownFonts.getFont(KnownFonts.IOSEVKA, Font.DistanceFieldType.SDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Iosevka.ttf using SDF
-
getIosevka
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style. Caches the result for later calls. The font used is Iosevka, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Iosevka.ttf
-
getIosevkaSlab
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a slab-serif geometric style. Does not use a distance field effect. Caches the result for later calls. The font used is Iosevka with Slab style, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.IOSEVKA_SLAB, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Iosevka-Slab.ttf
-
getIosevkaSlabMSDF
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a slab-serif geometric style, that should scale cleanly to even very large sizes (using an MSDF technique). Caches the result for later calls. The font used is Iosevka with Slab style, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This uses the Multi-channel Signed Distance Field (MSDF) technique as opposed to the normal Signed Distance Field technique, which gives the rendered font sharper edges and precise corners instead of rounded tips on strokes.
This returns the same thing asKnownFonts.getFont(KnownFonts.IOSEVKA_SLAB, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Iosevka-Slab.ttf using MSDF
-
getIosevkaSlabSDF
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a slab-serif geometric style, that should scale cleanly to fairly large sizes (using an SDF technique). Caches the result for later calls. The font used is Iosevka with Slab style, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This Font is already configured withFont.fitCell(float, float, boolean), and repeated calls to fitCell() have an unknown effect; you may want to stick to scaling this and not re-fitting if you encounter issues. This uses the Signed Distance Field (SDF) technique as opposed to the Multi-channel Signed Distance Field technique thatgetIosevkaSlabMSDF()uses, which isn't as sharp at large sizes but can look a little better at small sizes.
This returns the same thing asKnownFonts.getFont(KnownFonts.IOSEVKA_SLAB, Font.DistanceFieldType.SDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Iosevka-Slab.ttf using SDF
-
getIosevkaSlab
Returns a Font already configured to use a highly-legible fixed-width font with good Unicode support and a sans-serif geometric style. Caches the result for later calls. The font used is Iosevka, an open-source (SIL Open Font License) typeface by Belleve Invis, and it uses several customizations thanks to Iosevka's special build process. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Iosevka-Slab.ttf
-
getKingthingsFoundation
Returns a Font already configured to use a fairly-legible variable-width ornamental/medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30. Caches the result for later calls. The font used is Kingthings Foundation, a free (custom permissive license) typeface; this has faux-bold applied already in order to make some ornamental curls visible at more sizes. You can still apply bold again using markup. It supports only ASCII. You may want to also look atKingthings Petrock; where Petrock is less-ornamented, Foundation is heavily ornamented, and Foundation may make sense for text associated with writers of high social status. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.KINGTHINGS_FOUNDATION, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font KingthingsFoundation.ttf
-
getKingthingsFoundation
Returns a Font already configured to use a fairly-legible variable-width ornamental/medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30. Caches the result for later calls. The font used is Kingthings Foundation, a free (custom permissive license) typeface; this has faux-bold applied already in order to make some ornamental curls visible at more sizes. You can still apply bold again using markup. It supports only ASCII. You may want to also look atKingthings Petrock; where Petrock is less-ornamented, Foundation is heavily ornamented, and Foundation may make sense for text associated with writers of high social status.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font KingthingsFoundation.ttf
-
getKingthingsPetrock
Returns a Font already configured to use a clearly-legible variable-width medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30. Caches the result for later calls. The font used is Kingthings Petrock, a free (custom permissive license) typeface; it has a visual style similar to one used by some popular classic rock bands. It supports only ASCII and a small amount of extended Latin. Kingthings Petrock is similar toKingthings Foundation, but Petrock isn't as heavily-ornamented, and looks more like "every-day usable" medieval or maybe Renaissance text. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.KINGTHINGS_PETROCK, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font KingthingsPetrock.ttf
-
getKingthingsPetrock
Returns a Font already configured to use a clearly-legible variable-width medieval font, that should scale pretty well from a height of about 90 down to a height of maybe 30. Caches the result for later calls. The font used is Kingthings Petrock, a free (custom permissive license) typeface; it has a visual style similar to one used by some popular classic rock bands. It supports only ASCII and a small amount of extended Latin. Kingthings Petrock is similar toKingthings Foundation, but Petrock isn't as heavily-ornamented, and looks more like "every-day usable" medieval or maybe Renaissance text.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font KingthingsPetrock.ttf
-
getLanaPixel
Returns a Font already configured to use a variable-width pixel font with excellent Unicode support, that probably should only be used at integer multiples of its normal size. Caches the result for later calls. The font used is LanaPixel, an open-source (dual-licensed under the SIL Open Font License and Creative Commons Attribution License) typeface. It supports an incredible amount of glyphs, and is meant to allow localizing to just about any widely-used language. This uses a tiny standard bitmap font, and it can only be used as-is or scaled up by integer multiples. This defaults to havingFont.integerPositionset to true, which currently does nothing (the code that enforces integer positions seems to ruin the appearance of any font that uses it, so that code isn't ever used now). This may work well in a font family with other fonts that do not use a distance field effect.
Preview: Image link (uses width=20, height=15)
Needs files:- Returns:
- the Font object that can represent many sizes of the font LanaPixel.ttf
-
getLibertinusSerif
Returns a Font already configured to use a variable-width serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels. Caches the result for later calls. The font used is Libertinus Serif, an open-source (SIL Open Font License) typeface. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.LIBERTINUS_SERIF, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font LibertinusSerif.ttf
-
getLibertinusSerif
Returns a Font already configured to use a variable-width serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels. Caches the result for later calls. The font used is Libertinus Serif, an open-source (SIL Open Font License) typeface. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font LibertinusSerif.ttf
-
getLibertinusSerifSemibold
Returns a Font already configured to use a variable-width heavy-weight serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels. Caches the result for later calls. The font used is Libertinus Serif Semibold, an open-source (SIL Open Font License) typeface. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.LIBERTINUS_SERIF_SEMIBOLD, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font LibertinusSerifSemibold.ttf
-
getLibertinusSerifSemibold
Returns a Font already configured to use a variable-width heavy-weight serif font with good Unicode support, that should scale cleanly to fairly large sizes or down to about 20 pixels. Caches the result for later calls. The font used is Libertinus Serif Semibold, an open-source (SIL Open Font License) typeface. It supports a lot of glyphs, including quite a bit of extended Latin, Greek, and Cyrillic.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font LibertinusSerifSemibold.ttf
-
getNowAlt
Returns a Font already configured to use a variable-width geometric sans-serif font, that should scale cleanly to fairly large sizes or down to about 20 pixels. Caches the result for later calls. The font used is Now Alt, an open-source (SIL Open Font License) typeface by Hanken Design Co. It has decent glyph coverage for most European languages, but doesn't fully support Greek or Cyrillic. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.NOW_ALT, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font NowAlt.otf
-
getNowAlt
Returns a Font already configured to use a variable-width geometric sans-serif font, that should scale cleanly to fairly large sizes or down to about 20 pixels. Caches the result for later calls. The font used is Now Alt, an open-source (SIL Open Font License) typeface by Hanken Design Co. It has decent glyph coverage for most European languages, but doesn't fully support Greek or Cyrillic.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font NowAlt.otf
-
getOpenSans
Returns a Font configured to use a clean variable-width font, Open Sans. It has good extended-Latin coverage, but does not support Greek, Cyrillic, or other scripts. This makes an especially large font by default, but can be scaled down nicely. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.OPEN_SANS, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that represents the variable-width font OpenSans
-
getOpenSans
Returns a Font configured to use a clean variable-width font, Open Sans. It has good extended-Latin coverage, but does not support Greek, Cyrillic, or other scripts. This makes an especially large font by default, but can be scaled down nicely.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the variable-width font OpenSans
-
getOstrichBlack
Returns a Font configured to use an ALL-CAPS, variable-width, tall, very-heavy-weight sans-serif font, Ostrich Black. It is OFL-licensed and was made by Tyler Fink.
This returns the same thing asKnownFonts.getFont(KnownFonts.OSTRICH_BLACK, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that represents the variable-width font Ostrich Black
-
getOstrichBlack
Returns a Font configured to use an ALL-CAPS, variable-width, tall, very-heavy-weight sans-serif font, Ostrich Black. It is OFL-licensed and was made by Tyler Fink.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the variable-width font Ostrich Black
-
getOxanium
Returns a Font already configured to use a variable-width "science-fiction/high-tech" font, that should scale pretty well down, but not up. Caches the result for later calls. The font used is Oxanium, a free (OFL) typeface. It supports a lot of Latin and extended Latin, but not Greek or Cyrillic. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.OXANIUM, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Oxanium
-
getOxanium
Returns a Font already configured to use a variable-width "science-fiction/high-tech" font, that should scale pretty well down, but not up. Caches the result for later calls. The font used is Oxanium, a free (OFL) typeface. It supports a lot of Latin and extended Latin, but not Greek or Cyrillic.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font Oxanium
-
getQuanPixel
Returns a Font configured to use a small variable-width bitmap font with extensive coverage of Asian scripts, QuanPixel. QuanPixel has good coverage of Unicode, including all of Greek, at least most of Cyrillic, a good amount of extended Latin, all of Katakana and Hiragana, many Hangul syllables, and literally thousands of CJK ideograms. This does not scale well except to integer multiples, but it should look very crisp at its default size of about 8 pixels tall with variable width. This defaults to havingFont.integerPositionset to true, which currently does nothing (the code that enforces integer positions seems to ruin the appearance of any font that uses it, so that code isn't ever used now). This may work well in a font family with other fonts that do not use a distance field effect.
Preview: Image link (uses width=12, height=12; this size is small enough to make the scaled text unreadable in some places)
Needs files:- Returns:
- the Font object that represents the 8px tall font QuanPixel
-
getRobotoCondensed
Returns a Font already configured to use a very-legible condensed variable-width font with excellent Unicode support, that should scale pretty well from a height of about 62 down to a height of maybe 20. Caches the result for later calls. The font used is Roboto Condensed, a free (Apache 2.0) typeface by Christian Robertson. It supports Latin-based scripts almost entirely, plus Greek, (extended) Cyrillic, and more. This font is meant to be condensed in its natural appearance, but can be scaled to be wider if desired. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.ROBOTO_CONDENSED, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font RobotoCondensed.ttf
-
getRobotoCondensed
Returns a Font already configured to use a very-legible condensed variable-width font with excellent Unicode support. Caches the result for later calls. The font used is Roboto Condensed, a free (Apache 2.0) typeface by Christian Robertson. It supports Latin-based scripts almost entirely, plus Greek, (extended) Cyrillic, and more. This font is meant to be condensed in its natural appearance, but can be scaled to be wider if desired.
Preview:
Needs files: or, or- Parameters:
dft- which distance field type to use, such asFont.DistanceFieldType.STANDARDorFont.DistanceFieldType.SDF- Returns:
- the Font object that can represent many sizes of the font RobotoCondensed.ttf
-
getTangerine
Returns a Font already configured to use a variable-width script font, that should scale pretty well down, but not up. Caches the result for later calls. The font used is Tangerine, a free (OFL) typeface. It supports Latin only, with a little support for Western European languages, but not really anything else. It looks elegant, though. This uses a very-large standard bitmap font, which lets it be scaled down OK but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.TANGERINE, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Tangerine.ttf
-
getTangerineSDF
Returns a Font already configured to use a variable-width script font, that should scale pretty well down, but not up. Caches the result for later calls. The font used is Tangerine, a free (OFL) typeface. It supports Latin only, with a little support for Western European languages, but not really anything else. It looks elegant, though. This uses the Signed Distance Field (SDF) technique, which may be slightly fuzzy when zoomed in heavily, but should be crisp enough when zoomed out.
This returns the same thing asKnownFonts.getFont(KnownFonts.TANGERINE, Font.DistanceFieldType.SDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Tangerine.ttf using SDF
-
getTangerine
Returns a Font already configured to use a variable-width script font. Caches the result for later calls. The font used is Tangerine, a free (OFL) typeface. It supports Latin only, with a little support for Western European languages, but not really anything else. It looks elegant, though. Using MSDF is currently recommended.
Preview:
Needs files: or, or- Returns:
- the Font object that can represent many sizes of the font Tangerine.ttf
-
getYanoneKaffeesatz
Returns a Font already configured to use a variable-width, narrow, humanist font, that should scale pretty well down, but not up. Caches the result for later calls. The font used is Yanone Kaffeesatz, a free (OFL) typeface. It supports a lot of Latin, Cyrillic, and some extended Latin, but not Greek. This uses a very-large standard bitmap font, which lets it be scaled down nicely but not scaled up very well. This may work well in a font family with other fonts that do not use a distance field effect.
This returns the same thing asKnownFonts.getFont(KnownFonts.YANONE_KAFFEESATZ, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font YanoneKaffeesatz.ttf
-
getYanoneKaffeesatzMSDF
Returns a Font already configured to use a variable-width, narrow, humanist font. Caches the result for later calls. The font used is Yanone Kaffeesatz, a free (OFL) typeface. It supports a lot of Latin, Cyrillic, and some extended Latin, but not Greek. This uses the Multi-channel Signed Distance Field (MSDF) technique as opposed to the normal Signed Distance Field technique, which gives the rendered font sharper edges and precise corners instead of rounded tips on strokes.
This returns the same thing asKnownFonts.getFont(KnownFonts.YANONE_KAFFEESATZ, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font YanoneKaffeesatz.ttf using MSDF
-
getYanoneKaffeesatz
Returns a Font already configured to use a variable-width, narrow, humanist font. Caches the result for later calls. The font used is Yanone Kaffeesatz, a free (OFL) typeface. It supports a lot of Latin, Cyrillic, and some extended Latin, but not Greek.
Preview:
Needs files: or, or- Returns:
- the Font object that can represent many sizes of the font YanoneKaffeesatz.ttf
-
getYataghan
Returns a Font already configured to use a variable-width, narrow, "dark fantasy" font. Caches the result for later calls. The font used is Yataghan, a widely-distributed typeface. It supports ASCII and some extended Latin, but not much else.
I don't know who the original author of Yataghan was; if you are the original author and want attribution or want this font removed, please post an issue on the tommyettinger/textratypist GitHub repo, or email tommyettinger.
This returns the same thing asKnownFonts.getFont(KnownFonts.YATAGHAN, Font.DistanceFieldType.STANDARD); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Yataghan.ttf
-
getYataghanMSDF
Returns a Font already configured to use a variable-width, narrow, "dark fantasy" font. Caches the result for later calls. The font used is Yataghan, a widely-distributed typeface. It supports ASCII and some extended Latin, but not much else. This uses the Multi-channel Signed Distance Field (MSDF) technique as opposed to the normal Signed Distance Field technique, which gives the rendered font sharper edges and precise corners instead of rounded tips on strokes.
I don't know who the original author of Yataghan was; if you are the original author and want attribution or want this font removed, please post an issue on the tommyettinger/textratypist GitHub repo, or email tommyettinger.
This returns the same thing asKnownFonts.getFont(KnownFonts.YATAGHAN, Font.DistanceFieldType.MSDF); usinggetFont(String, DistanceFieldType)is preferred in new code unless a font needs special support.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Yataghan.ttf using MSDF
-
getYataghan
Returns a Font already configured to use a variable-width, narrow, "dark fantasy" font. Caches the result for later calls. The font used is Yataghan, a widely-distributed typeface. It supports ASCII and some extended Latin, but not much else.
I don't know who the original author of Yataghan was; if you are the original author and want attribution or want this font removed, please post an issue on the tommyettinger/textratypist GitHub repo, or email tommyettinger.
Preview:
Needs files:- Returns:
- the Font object that can represent many sizes of the font Yataghan.ttf using MSDF
-
loadUnicodeAtlas
public static com.badlogic.gdx.graphics.g2d.TextureAtlas loadUnicodeAtlas(com.badlogic.gdx.files.FileHandle packFile, com.badlogic.gdx.files.FileHandle imagesDir, boolean flip) This is exactly likeTextureAtlas(FileHandle, FileHandle, boolean), except it jumps through some hoops to ensure the atlas is loaded with UTF-8 encoding. Loading an atlas that uses Unicode names for its TextureRegions can have those names be unusable if TextureAtlas' normal default platform encoding is used; this primarily affects Java versions before 18 where the JVM flag-Dfile.encoding=UTF-8was missing when a JAR is launched.- Parameters:
packFile- the FileHandle for the atlas fileimagesDir- the FileHandle for the folder that holds the images used by the atlas fileflip- If true, all regions loaded will be flipped for use with a perspective where 0,0 is the upper left corner.- Returns:
- a new TextureAtlas loaded from the given files.
-
addEmoji
Takes a Font and adds the Twemoji icon set to it, making the glyphs available using[+name]syntax. You can use the name of an emoji, such as[+clown face], or equivalently use the actual emoji, such as[+🤡], with the latter preferred because the names can be unwieldy or hard to get right. This caches the Twemoji atlas for later calls. This tries to load the files "Twemoji.atlas" and "Twemoji.png" from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. There are over 3000 emoji in the Twemoji set; it requires attribution to use.
You can add emoji to a font as inline images with KnownFonts.addEmoji(Font). Emoji don't work at all with MSDF fonts, and don't support more than one color with SDF fonts, but work as intended with "standard" fonts (without a distance field effect). They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. There are over 3000 emoji in the Twemoji set, and they are accessible both by name, using the syntax[+clown face], and by entering the actual emoji, using the syntax[+🤡]. You can search for names inTwemoji.atlas, or use the emoji picker in Skin Composer to navigate by category. You can also use the emoji picker present in some OSes, such as how Win+. allows selecting an emoji on Windows 10 and up. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name or emoji, andFont.namesByCharCodeto go from such an internal code to an emoji (as UTF-8).
Note that there isn't enough available space in a Font to add both emoji with this and icons withaddGameIcons(Font). You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
Preview: Image link (uses the fontgetAStarry()and[%?blacken]mode)
You can see all emoji and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 3000 emoji added to it, with more aliases- Returns:
changing, after the emoji atlas has been added
-
addEmoji
public static Font addEmoji(Font changing, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the Twemoji icon set to it, making the glyphs available using[+name]syntax. You can use the name of an emoji, such as[+clown face], or equivalently use the actual emoji, such as[+🤡], with the latter preferred because the names can be unwieldy or hard to get right. This caches the Twemoji atlas for later calls. This tries to load the files "Twemoji.atlas" and "Twemoji.png" from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. There are over 3000 emoji in the Twemoji set; it requires attribution to use.
Emoji don't work at all with MSDF fonts, and don't support more than one color with SDF fonts, but work as intended with "standard" fonts (without a distance field effect). They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. You can search for names inTwemoji.atlas, or use the emoji picker in Skin Composer to navigate by category. You can also use the emoji picker present in some OSes, such as how Win+. allows selecting an emoji on Windows 10 and up. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name or emoji, andFont.namesByCharCodeto go from such an internal code to an emoji (as UTF-8).
Note that there isn't enough available space in a Font to add both emoji with this and icons withaddGameIcons(Font). You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
This overload allows customizing the x/y offsets and x-advance for every emoji this puts in a Font.
Preview: Image link (uses the fontgetAStarry()and[%?blacken]mode)
You can see all emoji and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 3000 emoji added to it, with more aliasesoffsetXChange- will be added to theFont.GlyphRegion.offsetXof each added glyphoffsetYChange- will be added to theFont.GlyphRegion.offsetYof each added glyphxAdvanceChange- will be added to theFont.xAdvance(com.github.tommyettinger.textra.Font, float, long)of each added glyph- Returns:
changing, after the emoji atlas has been added
-
addEmoji
public static Font addEmoji(Font changing, String prepend, String append, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the Twemoji icon set to it, making the glyphs available using[+name]syntax. You can use the name of an emoji, such as[+clown face], or equivalently use the actual emoji, such as[+🤡], with the latter preferred because the names can be unwieldy or hard to get right. This caches the Twemoji atlas for later calls. This tries to load the files "Twemoji.atlas" and "Twemoji.png" from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. There are over 3000 emoji in the Twemoji set; it requires attribution to use.
Emoji don't work at all with MSDF fonts, and don't support more than one color with SDF fonts, but work as intended with "standard" fonts (without a distance field effect). They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. You can search for names inTwemoji.atlas, or use the emoji picker in Skin Composer to navigate by category. You can also use the emoji picker present in some OSes, such as how Win+. allows selecting an emoji on Windows 10 and up. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name or emoji, andFont.namesByCharCodeto go from such an internal code to an emoji (as UTF-8).
Note that there isn't enough available space in a Font to add both emoji with this and icons withaddGameIcons(Font). You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
This overload allows customizing the x/y offsets and x-advance for every emoji this puts in a Font. It also allows specifying Strings to prepend before and append after each name in the font, including emoji names.
Preview: Image link (uses the fontgetAStarry()and[%?blacken]mode)
You can see all emoji and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 3000 emoji added to it, with more aliasesprepend- will be prepended before each name in the atlas; if null, will be treated as ""append- will be appended after each name in the atlas; if null, will be treated as ""offsetXChange- will be added to theFont.GlyphRegion.offsetXof each added glyphoffsetYChange- will be added to theFont.GlyphRegion.offsetYof each added glyphxAdvanceChange- will be added to theFont.xAdvance(com.github.tommyettinger.textra.Font, float, long)of each added glyph- Returns:
changing, after the emoji atlas has been added
-
addOpenMoji
Takes a Font and adds the OpenMoji icon set to it, making the glyphs available using[+name]syntax. You can use the name of an emoji, such as[+clown face], or equivalently use the actual emoji, such as[+🤡], with the latter preferred because the names can be unwieldy or hard to get right. This caches the OpenMoji atlas for later calls. There are two variants on the OpenMoji set here; one is in full color, and the other is line art with white lines (This version can be drawn with a color set using markup or the Batch). This tries to load the files "OpenMoji-color.atlas" and "OpenMoji-color.png" (if loading the full-color set) or "OpenMoji-white.atlas" and "OpenMoji-white.png" (if loading the line art set) from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. OpenMoji is licensed under Creative Commons-Attribution-Share-Alike, so make sure you attribute the OpenMoji project.
This set of emoji has a different style than the Twemoji used byaddEmoji(Font), with more flat areas of one color, frequent appearances of lines only partly covering the inner color, and very consistent patterns for things like the poses of people in emojis. There's also the white-line-only version you can use here, which has no equivalent in Twemoji. OpenMoji probably don't look quite as good at very small sizes when compared to Twemoji, though.
You can add OpenMoji emoji to a font as inline images with KnownFonts.addOpenMoji(Font, boolean). Emoji don't work at all with MSDF fonts, and don't support more than one color with SDF fonts, but work as intended with "standard" fonts (without a distance field effect). They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. There are over 3700 emoji in the OpenMoji set, and they are accessible both by name, using the syntax[+clown face], and by entering the actual emoji, using the syntax[+🤡]. You can search for names inOpenMoji.atlas, or use the emoji picker in Skin Composer to navigate by category (Skin Composer might not be using the current version of the emoji standard, and it defaults to Twemoji instead of OpenMoji, but most of the usage is the same, and an emoji for Twemoji should also work with OpenMoji). You can also use the emoji picker present in some OSes, such as how Win+. allows selecting an emoji on Windows 10 and up. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name or emoji, andFont.namesByCharCodeto go from such an internal code to an emoji (as UTF-8).
Note that there isn't enough available space in a Font to add both emoji with this and icons withaddGameIcons(Font). You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
Preview: Image link (uses white lines, the fontgetInconsolata(), and[%?whiten]mode)
You can see all emoji and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 3700 emoji added to it, with more aliases- Returns:
changing, after the emoji atlas has been added
-
addOpenMoji
public static Font addOpenMoji(Font changing, boolean color, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the OpenMoji icon set to it, making the glyphs available using[+name]syntax. You can use the name of an emoji, such as[+clown face], or equivalently use the actual emoji, such as[+🤡], with the latter preferred because the names can be unwieldy or hard to get right. This caches the OpenMoji atlas for later calls. There are two variants on the OpenMoji set here; one is in full color, and the other is line art with white lines (This version can be drawn with a color set using markup or the Batch). This tries to load the files "OpenMoji-color.atlas" and "OpenMoji-color.png" (if loading the full-color set) or "OpenMoji-white.atlas" and "OpenMoji-white.png" (if loading the line art set) from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. OpenMoji is licensed under Creative Commons-Attribution-Share-Alike, so make sure you attribute the OpenMoji project.
This set of emoji has a different style than the Twemoji used byaddEmoji(Font), with more flat areas of one color, frequent appearances of lines only partly covering the inner color, and very consistent patterns for things like the poses of people in emojis. There's also the white-line-only version you can use here, which has no equivalent in Twemoji. OpenMoji probably don't look quite as good at very small sizes when compared to Twemoji, though.
Emoji don't work at all with MSDF fonts, and don't support more than one color with SDF fonts, but work as intended with "standard" fonts (without a distance field effect). They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. You can search for names inOpenMoji.atlas, or use the emoji picker in Skin Composer to navigate by category. You can also use the emoji picker present in some OSes, such as how Win+. allows selecting an emoji on Windows 10 and up. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name or emoji, andFont.namesByCharCodeto go from such an internal code to an emoji (as UTF-8).
Note that there isn't enough available space in a Font to add both emoji with this and icons withaddGameIcons(Font). You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
This overload allows customizing the x/y offsets and x-advance for every emoji this puts in a Font.
Preview: Image link (uses white lines, the fontgetInconsolata(), and[%?whiten]mode)
You can see all emoji and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 3700 emoji added to it, with more aliasesoffsetXChange- will be added to theFont.GlyphRegion.offsetXof each added glyphoffsetYChange- will be added to theFont.GlyphRegion.offsetYof each added glyphxAdvanceChange- will be added to theFont.xAdvance(com.github.tommyettinger.textra.Font, float, long)of each added glyph- Returns:
changing, after the emoji atlas has been added
-
addOpenMoji
public static Font addOpenMoji(Font changing, boolean color, String prepend, String append, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the OpenMoji icon set to it, making the glyphs available using[+name]syntax. You can use the name of an emoji, such as[+clown face], or equivalently use the actual emoji, such as[+🤡], with the latter preferred because the names can be unwieldy or hard to get right. This caches the OpenMoji atlas for later calls. This tries to load the files "OpenMoji.atlas" and "OpenMoji.png" from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. There are two variants on the OpenMoji set here; one is in full color, and the other is line art with white lines (This version can be drawn with a color set using markup or the Batch). This tries to load the files "OpenMoji-color.atlas" and "OpenMoji-color.png" (if loading the full-color set) or "OpenMoji-white.atlas" and "OpenMoji-white.png" (if loading the line art set) from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. OpenMoji is licensed under Creative Commons-Attribution-Share-Alike, so make sure you attribute the OpenMoji project.
This set of emoji has a different style than the Twemoji used byaddEmoji(Font), with more flat areas of one color, frequent appearances of lines only partly covering the inner color, and very consistent patterns for things like the poses of people in emojis. There's also the white-line-only version you can use here, which has no equivalent in Twemoji. OpenMoji probably don't look quite as good at very small sizes when compared to Twemoji, though.
Emoji don't work at all with MSDF fonts, and don't support more than one color with SDF fonts, but work as intended with "standard" fonts (without a distance field effect). They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. You can search for names inOpenMoji.atlas, or use the emoji picker in Skin Composer to navigate by category. You can also use the emoji picker present in some OSes, such as how Win+. allows selecting an emoji on Windows 10 and up. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name or emoji, andFont.namesByCharCodeto go from such an internal code to an emoji (as UTF-8).
Note that there isn't enough available space in a Font to add both emoji with this and icons withaddGameIcons(Font). You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
This overload allows customizing the x/y offsets and x-advance for every emoji this puts in a Font. It also allows specifying Strings to prepend before and append after each name in the font, including emoji names.
Preview: Image link (uses white lines, the fontgetInconsolata(), and[%?whiten]mode)
You can see all emoji and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 3700 emoji added to it, with more aliasesprepend- will be prepended before each name in the atlas; if null, will be treated as ""append- will be appended after each name in the atlas; if null, will be treated as ""offsetXChange- will be added to theFont.GlyphRegion.offsetXof each added glyphoffsetYChange- will be added to theFont.GlyphRegion.offsetYof each added glyphxAdvanceChange- will be added to theFont.xAdvance(com.github.tommyettinger.textra.Font, float, long)of each added glyph- Returns:
changing, after the emoji atlas has been added
-
addGameIcons
Takes a Font and adds the Game-Icons.net icon set to it, making the glyphs available using[+name]syntax. Unlike the emoji used byaddEmoji(Font), icons here are always. retrieved by name, and names are always all-lower-case, separated by dashes ('-'). This caches the Game-Icons.net atlas for later calls. This tries to load the files "Game-Icons.atlas" and "Game-Icons.png" from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. There are 4131 images in this edition of the Game-Icons.net icons (from December 20, 2022), and it requires attribution to use.
Although these icons might work with MSDF fonts, they should work with standard and SDF fonts. They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. All icons use only the color white with various levels of transparency, so they can be colored like normal text glyphs. You can search for names inGame-Icons.atlas. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name, andFont.namesByCharCodeto go from such an internal code to the corresponding name.
Note that there isn't enough available space in a Font to add both emoji withaddEmoji(Font)and icons with this. You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
Preview: Image link (uses the fontgetNowAlt()and[%?blacken]mode)
You can see all icons and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 4000 icons added to it- Returns:
changing, after the icon atlas has been added
-
addGameIcons
public static Font addGameIcons(Font changing, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the Game-Icons.net icon set to it, making the glyphs available using[+name]syntax. Unlike the emoji used byaddEmoji(Font), icons here are always. retrieved by name, and names are always all-lower-case, separated by dashes ('-'). This caches the Game-Icons.net atlas for later calls. This tries to load the files "Game-Icons.atlas" and "Game-Icons.png" from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. There are 4131 images in this edition of the Game-Icons.net icons (from December 20, 2022), and it requires attribution to use.
Although these icons might work with MSDF fonts, they should work with standard and SDF fonts. They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. All icons use only the color white with various levels of transparency, so they can be colored like normal text glyphs. You can search for names inGame-Icons.atlas. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name, andFont.namesByCharCodeto go from such an internal code to the corresponding name.
Note that there isn't enough available space in a Font to add both emoji withaddEmoji(Font)and icons with this. You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
This overload allows customizing the x/y offsets and x-advance for every icon this puts in a Font.
Preview: Image link (uses the fontgetNowAlt()and[%?blacken]mode)
You can see all icons and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 4000 icons added to itoffsetXChange- will be added to theFont.GlyphRegion.offsetXof each added glyphoffsetYChange- will be added to theFont.GlyphRegion.offsetYof each added glyphxAdvanceChange- will be added to theFont.xAdvance(com.github.tommyettinger.textra.Font, float, long)of each added glyph- Returns:
changing, after the icon atlas has been added
-
addGameIcons
public static Font addGameIcons(Font changing, String prepend, String append, float offsetXChange, float offsetYChange, float xAdvanceChange) Takes a Font and adds the Game-Icons.net icon set to it, making the glyphs available using[+name]syntax. Unlike the emoji used byaddEmoji(Font), icons here are always. retrieved by name, and names are always all-lower-case, separated by dashes ('-'). This caches the Game-Icons.net atlas for later calls. This tries to load the files "Game-Icons.atlas" and "Game-Icons.png" from the internal storage first, and if that fails, it tries to load them from local storage in the current working directory. There are 4131 images in this edition of the Game-Icons.net icons (from December 20, 2022), and it requires attribution to use.
Although these icons might work with MSDF fonts, they should work with standard and SDF fonts. They can scale reasonably well down, and less-reasonably well up, but at typical text sizes (12-30 pixels in height) they tend to be legible. All icons use only the color white with various levels of transparency, so they can be colored like normal text glyphs. You can search for names inGame-Icons.atlas. Programmatically, you can useFont.nameLookupto look up the internalcharthis uses for a given name, andFont.namesByCharCodeto go from such an internal code to the corresponding name.
Note that there isn't enough available space in a Font to add both emoji withaddEmoji(Font)and icons with this. You can, however, make two copies of a Font, add emoji to one and icons to the other, and put both in a FontFamily, so you can access both atlases in the same block of text.
This overload allows customizing the x/y offsets and x-advance for every icon this puts in a Font. It also allows specifying Strings to prepend before and append after each name in the font.
Preview: Image link (uses the fontgetNowAlt()and[%?blacken]mode)
You can see all icons and the names they use at this GitHub Pages site.
Needs files:- Parameters:
changing- a Font that will have over 4000 icons added to itprepend- will be prepended before each name in the atlas; if null, will be treated as ""append- will be appended after each name in the atlas; if null, will be treated as ""offsetXChange- will be added to theFont.GlyphRegion.offsetXof each added glyphoffsetYChange- will be added to theFont.GlyphRegion.offsetYof each added glyphxAdvanceChange- will be added to theFont.xAdvance(com.github.tommyettinger.textra.Font, float, long)of each added glyph- Returns:
changing, after the icon atlas has been added
-
getGameIconsFont
Gets a typically-square Font that is meant to be used in a FontFamily, allowing switching to a Font with the many game-icons.net icons. The base Font this uses isgetAStarry(), because it is perfectly square by default, and this needs all of A-Starry's assets. It also needs the assets foraddGameIcons(Font)to be present, since those will be available with this Font. The name this will use in a FontFamily is "Icons". You can specify the width and height you want for the icons; typically they are the same, because the icons here are square, and you probably want the height to match the line height for your main font. It isn't expected that many users would want to use the non-icon glyphs in the font. The reason this is needed is that you can't fit both the emoji fromaddEmoji(Font)and the icons fromaddGameIcons(Font)in one Font, but you can swap between two different Fonts in a FontFamily, one with emoji and one with icons.
Needs files:- Parameters:
width- the width of a single glyph in the returned Font; usually matches the line-height of other textheight- the height of a single glyph in the returned Font; usually matches the line-height of other text- Returns:
- a preconfigured Font using
getAStarry()andaddGameIcons(Font), with name "Icons"
-
pause
public void pause()- Specified by:
pausein interfacecom.badlogic.gdx.LifecycleListener
-
resume
public void resume()- Specified by:
resumein interfacecom.badlogic.gdx.LifecycleListener
-
getAll
Returns a new array of Font instances, calling each getXyz() method in this class that returns any Font. This will only function at all if all the assets (for every known Font) are present and load-able. You should store the result of this method, rather than calling it often, because each call copies many Fonts.- Returns:
- a new array containing all Font instances this knows
-
getAllStandard
Returns a new array of Font instances, callinggetFont(String, DistanceFieldType)on every font name inSTANDARD_NAMESwithFont.DistanceFieldType.STANDARDas the distance field type (meaning no distance field effect will be used). This uses the more specific configuration in methods likegetCozette()for any .fnt or .font fonts it has to load, as well as forgetAStarryTall().
This will only function at all if all the assets (for every known standard Font) are present and load-able. You should store the result of this method, rather than calling it often, because each call copies many Fonts.- Returns:
- a new array containing all non-distance-field Font instances this knows
-
getStandardFamily
Returns a Font (getGentium()) with a FontFamily configured so that 15 non-distance-field Fonts can be used with syntax like[@Sans]. The names this supports can be accessed with code usinggetStandardFamily().family.fontAliases.keys(). These names are:Serif, which isgetGentium(),Sans, which isgetOpenSans(),Mono, which isgetInconsolata(),Condensed, which isgetRobotoCondensed(),Humanist, which isgetYanoneKaffeesatz(),Retro, which isgetIBM8x16(),Slab, which isgetIosevkaSlab(),Handwriting, which isgetCaveat(),Dark, which isgetGrenze(),Cozette, which isgetCozette(),Iosevka, which isgetIosevka(),Medieval, which isgetKingthingsFoundation(),Future, which isgetOxanium(),Console, which isgetAStarryTall(),Code, which isgetCascadiaMono(), andGeometric, which isgetNowAlt().
Font.getName().Serif, which isgetGentium(), will always be the default font used after a reset. For backwards compatibility,Bitteris an alias forgetGentium()(notgetBitter()), because Bitter and Gentium look very similar and because a slot was needed. Similarly,Canadais an alias forgetNowAlt()(notgetCanada()), because they're both geometric heavier-weight typefaces, and as before, a slot was needed.
This will only function at all if all the assets (for every listed Font) are present and load-able. You should store the result of this method, rather than calling it often, because each call copies many Fonts.- Returns:
- a Font that can switch between 16 different Fonts in its FontFamily, to any of several Fonts this knows
-
getFamily
Returns a Font (getGentium()) with a FontFamily configured so that 15 Fonts with the givenFont.DistanceFieldTypecan be used with syntax like[@Sans]. The names this supports can be accessed with code usinggetFamily(dft).family.fontAliases.keys(). These names are:Serif, which isgetGentium(DistanceFieldType),Sans, which isgetOpenSans(DistanceFieldType),Mono, which isgetInconsolata(DistanceFieldType),Condensed, which isgetRobotoCondensed(DistanceFieldType),Humanist, which isgetYanoneKaffeesatz(DistanceFieldType),Fantasy, which isgetGentiumUnItalic(DistanceFieldType),Slab, which isgetIosevkaSlab(DistanceFieldType),Handwriting, which isgetCaveat(DistanceFieldType),Dark, which isgetGrenze(DistanceFieldType),Script, which isgetTangerine(DistanceFieldType),Iosevka, which isgetIosevka(DistanceFieldType),Medieval, which isgetKingthingsFoundation(DistanceFieldType),Future, which isgetOxanium(DistanceFieldType),Console, which isgetAStarryTall(DistanceFieldType),Code, which isgetCascadiaMono(DistanceFieldType), andGeometric, which isgetNowAlt(DistanceFieldType).
Font.getName().Serif, which isgetGentium(DistanceFieldType), will always be the default font used after a reset. For backwards compatibility,Bitteris an alias forgetGentium(DistanceFieldType)(notgetBitter(DistanceFieldType)), because Bitter and Gentium look very similar and because a slot was needed. Similarly,Canadais an alias forgetNowAlt(DistanceFieldType)(notgetCanada(DistanceFieldType)), because they're both geometric heavier-weight typefaces, and as before, a slot was needed. Both "Retro" and "Cozette" are aliases forgetAStarryTall(DistanceFieldType), because those aliases have a meaning ingetStandardFamily(), and A Starry Tall is suitable for similar tasks.
This will only function at all if all the assets (for every listed Font, with the given distance field type) are present and load-able. You should store the result of this method, rather than calling it often, because each call copies many Fonts.- Returns:
- a Font that can switch between 16 different Fonts in its FontFamily, to any of several Fonts this knows
-
getAllSDF
Returns a new array of Font instances, callinggetFont(String, DistanceFieldType)on every font name inSTANDARD_NAMESwithFont.DistanceFieldType.SDFas the distance field type. This uses the more specific configuration ingetAStarryTall(DistanceFieldType).
This will only function at all if all the assets (for every known SDF Font) are present and load-able. You should store the result of this method, rather than calling it often, because each call copies many Fonts.- Returns:
- a new array containing all SDF Font instances this knows
-
getAllMSDF
Returns a new array of Font instances, callinggetFont(String, DistanceFieldType)on every font name inSTANDARD_NAMESwithFont.DistanceFieldType.MSDFas the distance field type. This uses the more specific configuration ingetAStarryTall(DistanceFieldType).
This will only function at all if all the assets (for every known MSDF Font) are present and load-able. You should store the result of this method, rather than calling it often, because each call copies many Fonts.- Returns:
- a new array containing all MSDF Font instances this knows
-
dispose
public void dispose()- Specified by:
disposein interfacecom.badlogic.gdx.LifecycleListener
-
