`pyxen.Text`

Rendert einen Textstring auf einem Entity unter Verwendung einer Bitmap-Schriftart.

Text-Entities verwenden einen Schrift-Atlas zum Rendern — jedes Zeichen wird als Quad aus der Atlas-Textur gezeichnet.

Konstruktor

Text(
    content,
    *,
    font="_default",
    color=None,
    align="left"
)

Parameter

Parameter	Typ	Beschreibung
`content`	`str`	Der anzuzeigende Textstring
`font`	`str`	Name des Schrift-Assets (Standard: eingebaute Schriftart)
`color`	`(r, g, b, a)`	Einfärbefarbe (Standard: Weiß)
`align`	`str`	Textausrichtung: `"left"`, `"center"` oder `"right"`

`content` (Erforderlich)

Der zu rendernde Textstring.

Text("Hello World")

`font` (Optional)

Name des zu verwendenden Schrift-Assets. Wenn weggelassen, wird die eingebaute Standardschrift verwendet.

Text("Score: 0", font="myfont")

Ein Schrift-Asset besteht aus einem .font.json-Deskriptor und einem .font.png-Atlasbild.

`color` (Optional)

Färbt den gerenderten Text ein.

Text("Warning!", color=(1, 0, 0, 1))

Standard: (1.0, 1.0, 1.0, 1.0) (Weiß, vollständig deckend).

`align` (Optional)

Steuert die horizontale Textausrichtung relativ zur Entity-Position.

Text("Centered", align="center")

Wert	Beschreibung
`"left"`	Text beginnt an der Entity-Position (Standard)
`"center"`	Text ist zentriert auf der Entity-Position
`"right"`	Text endet an der Entity-Position

Text zuweisen

Du kannst beim Erstellen zuweisen:

label = world.spawn(
    text=Text("Score: 0"),
    x=10, y=10, layer=200
)

Oder nachträglich:

label.text = Text("Game Over", color=(1, 0, 0, 1))

Text zur Laufzeit aktualisieren

Greife über das Entity auf die Text-Komponente zu, um Eigenschaften zu ändern:

label.text.content = "Score: 100"
label.text.color = (1, 1, 0, 1)
label.text.align = "center"

Text entfernen

Setze den Text auf None, um ihn zu entfernen:

label.text = None

Beispiel

from pyxen import *

score = 0

label = world.spawn(
    text=Text("Score: 0", color=(1, 1, 1, 1)),
    x=10, y=10, layer=200
)

def update():
    global score
    score += 1
    label.text.content = f"Score: {score}"

pyxen.Text