love.graphics.newImageFont
love.graphics.newImageFont
Creates a new Font by loading a specifically formatted image.
In versions prior to 0.9.0, LÖVE expects ISO 8859-1 encoding for the glyphs string.
This function can be slow if it is called repeatedly, such as from love.update or love.draw. If you need to use a specific resource often, create it once and store it somewhere it can be reused!
Function
Synopsis
font = love.graphics.newImageFont( filename, glyphs )
Arguments
string filename- The filepath to the image file.
string glyphs- A string of the characters in the image in order from left to right.
Returns
Font font- A Font object which can be used to draw text on screen.
Function
Synopsis
font = love.graphics.newImageFont( imagedata, glyphs )
Arguments
ImageData imageData- The ImageData object to create the font from.
string glyphs- A string of the characters in the image in order from left to right.
Returns
Font font- A Font object which can be used to draw text on screen.
Function
Available since LÖVE 0.10.0
This variant is not supported in earlier versions.
Synopsis
font = love.graphics.newImageFont( filename, glyphs, extraspacing )
Arguments
string filename- The filepath to the image file.
string glyphs- A string of the characters in the image in order from left to right.
number extraspacing- Additional spacing (positive or negative) to apply to each glyph in the Font.
Returns
Font font- A Font object which can be used to draw text on screen.
Notes
Instead of using this function, consider using a BMFont generator such as bmfont, littera, or bmGlyph with love.graphics.newFont. Because slime said it was better.
See Also
© 2006–2016 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/love.graphics.newImageFont
