Difference between revisions of "ImageFontFormat"

(quick draft of an actual explanation; needs wrok & chekcing!!1)
 
(Edited negative spacing paragraph to reflect information in the lg.newImageFont article.)
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The imagefont file is an image file in a format that Löve can load. It can contain transparent pixels, so a PNG file is preferable, and it also needs to contain spacer color that will separate the different font glyphs.
+
The imagefont file is an image file in a format that LÖVE can load. It can contain transparent pixels, so a PNG file is preferable, and it also needs to contain spacer color that will separate the different font glyphs.
  
 
The ''upper left pixel'' of the image file is always taken to be the spacer color. All columns that have this color as their uppermost pixel are interpreted as separators of font glyphs. The areas between these separators are interpreted as the actual font glyphs.
 
The ''upper left pixel'' of the image file is always taken to be the spacer color. All columns that have this color as their uppermost pixel are interpreted as separators of font glyphs. The areas between these separators are interpreted as the actual font glyphs.
  
The width of the separator areas affect the spacing of the font glyphs. It is possible to have more areas in the image than are required for the font in the [[love.graphics.newImageFont |love.graphics.newImagefont()]] call. The extra areas are ignored.
+
It is possible to have more areas in the image than are required for the font in the [[love.graphics.newImageFont]]() call. The extra areas are ignored.
  
TODO: Link to tutorial, upload a PoT sample image that works on every computer.
+
In versions prior to [[0.10.0]] the width of the separator area after a particular font glyph sets the amount of space that goes after the glyph. As of [[0.10.0]], it is possible to add negative spacing for all characters by using the 3-parameter version of [[love.graphics.newImageFont]] and giving a negative number as the third parameter.
 +
 
 +
== See Also ==
 +
* [[Tutorial:Fonts and Text]]
 +
 
 +
== Other Languages ==
 +
{{i18n|ImageFontFormat}}

Latest revision as of 07:30, 15 January 2016

The imagefont file is an image file in a format that LÖVE can load. It can contain transparent pixels, so a PNG file is preferable, and it also needs to contain spacer color that will separate the different font glyphs.

The upper left pixel of the image file is always taken to be the spacer color. All columns that have this color as their uppermost pixel are interpreted as separators of font glyphs. The areas between these separators are interpreted as the actual font glyphs.

It is possible to have more areas in the image than are required for the font in the love.graphics.newImageFont() call. The extra areas are ignored.

In versions prior to 0.10.0 the width of the separator area after a particular font glyph sets the amount of space that goes after the glyph. As of 0.10.0, it is possible to add negative spacing for all characters by using the 3-parameter version of love.graphics.newImageFont and giving a negative number as the third parameter.

See Also

Other Languages