Zum Hauptinhalt springen

Ein Textbildobjekt erstellen (image.new_text_image)

Deklaration​

bild = image.new_text_image(Text[, {
font = Schriftart,
size = Schriftgröße,
color = Schriftfarbe,
alpha = Schriftdeckkraft,
back_color = Hintergrundfarbe,
back_alpha = Hintergrunddeckkraft,
}])

Parameter​

  • Text
    Text; zu zeichnender Inhalt
  • Schriftart
    Text; optional, Schriftart des zu zeichnenden Textes, standardmäßig „Arial“
  • Schriftgröße
    Reelle Zahl; optional, Schriftgröße des zu zeichnenden Textes, standardmäßig 20.0
  • Schriftfarbe
    Ganzzahl; optional, Schriftfarbe, standardmäßig 0xffffff (Weiß)
  • Schriftdeckkraft
    Ganzzahl; optional, Deckkraft der Schrift, Bereich 0~255, standardmäßig 255
  • Hintergrundfarbe
    Ganzzahl; optional, Hintergrundfarbe des Bildes, standardmäßig 0x000000 (Schwarz)
  • Hintergrunddeckkraft
    Ganzzahl; optional, Deckkraft des Bildhintergrunds, Bereich 0~255, standardmäßig 255

Rückgabewert​

  • Bild
    Bildobjekt; gibt das neu erstellte Bildobjekt zurück

Beschreibung​

Erstellt ein Bildobjekt mit passenden Abmessungen und zeichnet den Text darauf.
Diese Methode erzeugt ein neues Bildobjekt. Für eine effiziente, häufige Verwendung sollte sie zusammen mit image:destroy verwendet werden.