Skip to content

scriptum/UBFG

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

82 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ultimate Bitmap Font Generator

Ultimate bitmap font generator - useful tool to create compact font textures for games

If you know Russian - welcome: http://www.gamedev.ru/projects/forum/?id=152527

Feature list:

  • multiple fonts may be packed into one texture
  • extremely effective packing algorithm + subcharacters merging
  • optimizied not only for English: generate Russian, Japanese, Chinese fonts
  • easy-to-create characters list from text
  • distance fields for easy OpenGL scalable fonts
  • exporting kerning pairs
  • free and open-source project

UBFG can export font into XML format (image in base64 format also stored in XML) or into it's own .fnt format, - ready to use with Cheetah 2D engine. XML format is self-described, .fnt format uses following spec.

UBFG generates two files: font.png and font.fnt.

  • font.png is an image, that represents your font texture. You must load it as texture.
  • font.fnt is a text file, that contains information about all chars on font.png.

This information looks like:

Arial 9pt -- font name and size
Char  X pos   Y pos   Width   Height   Xoffset  Yoffset  Orig W   Orig H
32    0       0       0       0        3        14       3        14
97    90      36      5       7        1        4        7        14
98    0       41      5       9        1        2        7        14
kerning pairs:
32 97 -1
32 98 -0.5

Here:

  • Char - UNICODE number of your char (codepage varies and may be specified before export). For example, 32 is a 'space'
  • X pos - x position of glyph on texture
  • Y pos - y position of glyph on texture
  • Width - width of glyph on texture (glyphs are cropped and Width and Orig Width aren't equal)
  • Height - height of glyph on texture
  • Xoffset - distance on the x-axis, on which glyph must be shifted
  • Yoffset - distance on the y-axis, on which glyph must be shifted
  • Orig W - original width of glyph
  • Orig H - original height of glyph

Also fnt format may have kerning pairs: a set of kerning pairs listed after phrase "kerning pairs:". First number if a first character in pair, second number - second character in pair, third number - kerning value. Note: this value may be with floating point if you use distance fields.

Help image

Screenshot:

Screenshot

Releases

No releases published

Packages

No packages published