Difference between revisions of "love.graphics.printf"

m (Changed wording of newly added note, made it bold. Don't use second person on a wiki!)
Line 3: Line 3:
 
See additional notes in [[love.graphics.print]].
 
See additional notes in [[love.graphics.print]].
  
NOTE: aligning does not work like you think it does! It doesn't align to the x/y coordinates given, but in a rectangle. See https://love2d.org/forums/viewtopic.php?f=4&t=9709&p=59709
+
'''NOTE: aligning does not work like as one might expect! It doesn't align to the x/y coordinates given, but in a rectangle. See https://love2d.org/forums/viewtopic.php?f=4&t=9709&p=59709'''
  
 
== Function ==
 
== Function ==

Revision as of 03:45, 18 November 2012

Draws formatted text, with word wrap and alignment.

See additional notes in love.graphics.print.

NOTE: aligning does not work like as one might expect! It doesn't align to the x/y coordinates given, but in a rectangle. See https://love2d.org/forums/viewtopic.php?f=4&t=9709&p=59709

Function

Synopsis

love.graphics.printf( text, x, y, limit, align )

Arguments

string text
A text string.
number x
The position on the x-axis.
number y
The position on the y-axis.
number limit
Wrap the line after this many horizontal pixels.
AlignMode align ("left")
The alignment.

Returns

Nothing.

Examples

Draw text to the screen with right alignment and a horizontal limit of 125.

love.graphics.printf("This text is aligned right, and wraps when it gets too big.", 25, 25, 125, "right")

Notes

Note that the limit argument affects the position of your text for 'center' and 'right' alignment.

love.graphics.printf("This text is aligned center",100, 100, 200,"center") -- center your text around x = 200/2 + 100 = 200
love.graphics.printf("This text is aligned right",100, 100, 200,"right") -- align right to x = 100 + 200 = 300

See Also


Other Languages