love.graphics.printf (Deutsch)

Zeichnet formatierten Text mit Zeilenumbrüchen und Textausrichtung.

O.png Zeilenumbrüche werden dadurch erzeugt, dass der Text in einzelne Worte aufgespalten und anschließend unter Berücksichtigung des Textlimits wieder zusammengefügt wird. Da der Umbruch an Stellen geschieht, an denen Leerzeichen gefunden werden, kann es passieren, dass zusätzliche Leerzeichen zwischen Worten verloren gehen und einige Zeilen trotzdem das angegebene Limit überschreiten können!  

O.png Die Ausrichtung des Textes richtet sich nicht nach den xy-Koordinaten, sondern geschieht in einer Box die so breit ist, wie das angegebene Textlimit.  

Funktion

Übersicht

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

Argumente

string (Deutsch) text
Ein String.
number (Deutsch) x
Die Position auf der x-Achse.
number (Deutsch) y
Die Position auf der y-Achse.
number (Deutsch) limit
Bestimmt nach wievielen Pixeln die Zeile umgebrochen werden soll.
AlignMode (Deutsch) align ("left")
Der Modus zur Ausrichtung des Strings.

Rückgabewerte

Keine.

Funktion

Available since LÖVE 0.9.0
This variant is not supported in earlier versions.

Übersicht

love.graphics.printf( text, x, y, limit, align, r, sx, sy, ox, oy, kx, ky )

Argumente

string text
Ein String.
number x
Die Position auf der x-Achse.
number y
Die Position auf der y-Achse.
number limit
Bestimmt nach wievielen Pixeln die Zeile umgebrochen werden soll.
AlignMode align ("left")
Der Modus zur Ausrichtung des Strings.
number r (0)
Ausrichtung (Radianten).
number sx (1)
Skalierungsfaktor (x-Achse).
number sy (sx)
Skalierungsfaktor (y-Achse).
number ox (0)
Verschiebung des Ursprungs in Pixeln (x-Achse).
number oy (0)
Verschiebung des Ursprungs in Pixeln (y-Achse).
number kx (0)
Scherfaktor (x-Achse).
number ky (0)
Scherfaktor (y-Achse).

Rückgabewerte

Keine.

Beispiele

Zeichnet einen Text der am rechten Rand ausgerichtet ist und eine horizontale Begrenzung von 125 Pixeln hat.

love.graphics.printf("Dieser Text ist rechts ausgerichtet und wird umgebrochen sobald er zu lang wird.", 25, 25, 125, "right")

Anmerkungen

Zu beachten ist, dass die Begrenzung die Position des Texts bei den Ausrichtungsmodi 'center' und 'right' beeinflusst.

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

Siehe auch


Andere Sprachen