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.
Examples
Creating a simple image font. Download this image file which will be used by LÖVE to create the font. Obviously when you want to create a font for your game you want to make the background transparent.
local font = love.graphics.newImageFont( 'font_example.png', ' ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789' )
function love.draw()
love.graphics.setFont( font )
love.graphics.print( 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789', 16, 16 )
love.graphics.print( 'Text is now drawn using the font', 16, 32 )
end See Also
© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/love.graphics.newImageFont