Difference between revisions of "love.graphics.setFont"

(We need to drive the point home that this function does allocate memory.)
Line 13: Line 13:
 
Nothing.
 
Nothing.
 
== Function ==
 
== Function ==
 +
{{oldin|[[0.8.0]]|type=variant}}
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Line 23: Line 24:
 
Nothing.
 
Nothing.
 
== Function ==
 
== Function ==
 +
{{oldin|[[0.8.0]]|type=variant}}
 
This variant creates a new font using the default font and the size specified, and sets it as the current font. '''Do not use this function in [[love.update]] or [[love.draw]].''' That would create a new font every frame, eating up memory very quickly.
 
This variant creates a new font using the default font and the size specified, and sets it as the current font. '''Do not use this function in [[love.update]] or [[love.draw]].''' That would create a new font every frame, eating up memory very quickly.
 
=== Synopsis ===
 
=== Synopsis ===

Revision as of 11:22, 8 January 2012

Set an already-loaded Font as the current font or create and load a new one from the file and size.

It's recommended that Font objects are created with love.graphics.newFont in the loading stage and then passed to this function in the drawing stage.

Function

Synopsis

love.graphics.setFont( font )

Arguments

Font font
The Font object to use.

Returns

Nothing.

Function

Removed in LÖVE 0.8.0
This variant is not supported in that and later versions.

Synopsis

love.graphics.setFont( filename, size )

Arguments

string filename
The filepath to the font.
number size (12)
The size of the font.

Returns

Nothing.

Function

Removed in LÖVE 0.8.0
This variant is not supported in that and later versions.

This variant creates a new font using the default font and the size specified, and sets it as the current font. Do not use this function in love.update or love.draw. That would create a new font every frame, eating up memory very quickly.

Synopsis

love.graphics.setFont( size )

Arguments

number size (12)
The size of the font.

Returns

Nothing.

Examples

Draw some text with default font, 18px

love.graphics.setFont(18)

function love.draw()
	love.graphics.print("Hello", 300, 300)
end

See Also


Other Languages