Welt > Tiled-Elemente#
TiledWorld stellt Hilfsklassen für Kachel-Projekte bereit. Sie sind am nützlichsten, wenn du Kacheln, Kanten oder Ecken direkt untersuchen oder anpassen willst.
TileFactory#
- class miniworlds.worlds.tiled_world.tile_factory.TileFactory[Quellcode]#
TileBase#
- class miniworlds.worlds.tiled_world.tile_elements.TileBase(position, world=None)[Quellcode]#
Basisklasse für Kacheln und Kachel-Begrenzer (wie Ecken und Kanten).
- add_actor(actor)[Quellcode]#
Platziert einen Actor auf dieser Kachel.
- property cost: float#
Kosten für das Betreten dieser Kachel bei der Wegfindung (Standard:
1).Darf nicht negativ sein. Kosten von
0machen das Betreten der Kachel kostenlos.Beispiele
swamp.cost = 3 road.cost = 0.5
- Typ:
- property data: dict#
Freie Spieldaten, die auf dieser Kachel gespeichert sind.
Verwende es für alles, was dein Spiel pro Kachel braucht, zum Beispiel einen Rohstoff, einen Besitzer oder eine Würfelzahl. Das Dictionary wird beim ersten Zugriff angelegt und bleibt an der Kachel.
Beispiele
tile = world.get_tile((2, 3)) tile.data["dice_number"] = 8 print(tile.data.get("dice_number"))
- Typ:
- classmethod from_pixel(pixel_position, world)[Quellcode]#
Findet die Kachel, die einer gegebenen Pixelkoordinate am nächsten liegt.
Diese Methode nutzt Caching, um die Zuordnung zwischen Kachelpositionen im Raster und ihren Pixelkoordinaten für eine gegebene Welt nicht unnötig neu zu berechnen. Außerdem verwendet sie den quadrierten statt des euklidischen Abstands, um schneller zu sein.
- abstract classmethod from_position(position, world)[Quellcode]#
Erstellt eine Kachel aus einer weltrelativen Position.
- Rückgabetyp:
- get_actors()[Quellcode]#
Gibt alle Actors zurück, die sich aktuell auf dieser Kachel befinden.
- Rückgabetyp:
- static get_local_center_coordinate(world)[Quellcode]#
Gibt den Mittelpunkt-Versatz einer Kachel in lokalen Pixelkoordinaten zurück.
- get_local_corner_points()[Quellcode]#
Gibt die Versätze der Eckpunkte für das Rendern zurück.
- get_neighbour_tiles()[Quellcode]#
Gibt die benachbarten Kacheln dieser Kachel zurück.
- static get_position_pixel_dict(world)[Quellcode]#
Gibt eine Zuordnung von Kachelpositionen zu Pixelkoordinaten zurück.
- Rückgabetyp:
- classmethod invalidate_position_pixel_cache(world)[Quellcode]#
Verwirft die zwischengespeicherte Zuordnung von Position zu Pixel einer Welt.
Der Cache ordnet Kachelpositionen Pixelkoordinaten für
from_pixel-Abfragen zu. Er muss verworfen werden, sobald Kacheln, Ecken oder Kanten hinzugefügt oder entfernt werden, sonst liefern Abfragen veraltete Positionen.- Rückgabetyp:
- property is_blocking: bool#
Ob die Wegfindung diese Kachel als nicht passierbar behandelt.
Actors mit
is_blocking = Trueblockieren ihre Kachel ebenfalls; dieses Flag blockiert eine Kachel ohne Actor, zum Beispiel Wasser.Beispiele
water_tile.is_blocking = True
- Typ:
- merge(other)[Quellcode]#
Führt Kachelpositionen einer anderen Kachel an derselben Stelle zusammen.
- property terrain#
Der Geländename dieser Kachel oder
None(gespeichert alsdata["terrain"]).Beispiele
tile.terrain = "forest" if tile.terrain == "forest": print("wood")
Tile#
- class miniworlds.worlds.tiled_world.tile.Tile(position, world=None)[Quellcode]#
- corner_vectors: OrderedDict[str, Tuple[float, float]] = {'no': (-0.5, 0.5), 'nw': (0.5, 0.5), 'so': (-0.5, -0.5), 'sw': (0.5, -0.5)}#
- distance_to(other)[Quellcode]#
- Rückgabetyp:
- edge_vectors: dict[str, Tuple[float, float]] = {'n': (0, -0.5), 'o': (0.5, 0), 's': (0, 0.5), 'w': (-0.5, 0)}#
- classmethod from_actor(actor)[Quellcode]#
- Rückgabetyp:
- classmethod from_pixel(pixel_position, world=None)[Quellcode]#
Findet die Kachel, die einer gegebenen Pixelkoordinate am nächsten liegt.
Diese Methode nutzt Caching, um die Zuordnung zwischen Kachelpositionen im Raster und ihren Pixelkoordinaten für eine gegebene Welt nicht unnötig neu zu berechnen. Außerdem verwendet sie den quadrierten statt des euklidischen Abstands, um schneller zu sein.
- classmethod from_position(position, world)[Quellcode]#
Erstellt eine Kachel aus einer weltrelativen Position.
- Rückgabetyp:
- get_neighbour_corners()[Quellcode]#
- static get_position_pixel_dict(world)[Quellcode]#
Gibt eine Zuordnung von Kachelpositionen zu Pixelkoordinaten zurück.
- Rückgabetyp:
- tile_vectors: dict[str, Tuple[int, int]] = {'no': (-1, 1), 'nw': (1, 1), 'o': (-1, 0), 'so': (-1, -1), 'sw': (1, -1), 'w': (1, 0)}#
- to_center()[Quellcode]#
- to_pixel()[Quellcode]#
Edge#
- class miniworlds.worlds.tiled_world.edge.Edge(position, direction, world)[Quellcode]#
- angles: Dict[str, int] = {'n': 3, 'o': 0, 's': 1, 'w': 2}#
- direction_angles: Dict[str, int] = {'n': 90, 'o': 0, 's': 90, 'w': 0}#
- static direction_vectors()[Quellcode]#
Gibt die verfügbaren Richtungen zurück.
- classmethod from_position(position, world)[Quellcode]#
Erstellt einen Kachel-Begrenzer (Überschreiben erwartet).
- static get_position_pixel_dict(world)[Quellcode]#
Gibt eine Zuordnung von Kachelpositionen zu Pixelkoordinaten zurück.
- start_angle()[Quellcode]#
Überschreiben: Start-Winkelversatz für das Layout (z. B. Hex-Rotation).
- tile_vectors: dict = {'n': [(0, 0.5), (0, -0.5)], 'o': [(-0.5, 0), (0.5, 0)], 's': [(0, 0.5), (0, -0.5)], 'w': [(-0.5, 0), (0.5, 0)]}#
Corner#
- class miniworlds.worlds.tiled_world.corner.Corner(position, direction, world)[Quellcode]#
- angles: Dict[str, int] = {'no': 0, 'nw': 1, 'so': 3, 'sw': 2}#
- direction_angles: Dict[str, int] = {'no': 0, 'nw': 0, 'so': 0, 'sw': 0}#
- static direction_vectors()[Quellcode]#
Gibt die verfügbaren Richtungen zurück.
- classmethod from_pixel(position, world=None)[Quellcode]#
Findet die Kachel, die einer gegebenen Pixelkoordinate am nächsten liegt.
Diese Methode nutzt Caching, um die Zuordnung zwischen Kachelpositionen im Raster und ihren Pixelkoordinaten für eine gegebene Welt nicht unnötig neu zu berechnen. Außerdem verwendet sie den quadrierten statt des euklidischen Abstands, um schneller zu sein.
- classmethod from_position(position, world)[Quellcode]#
Erstellt einen Kachel-Begrenzer (Überschreiben erwartet).
- classmethod from_tile(position, direction_string)[Quellcode]#
- start_angle()[Quellcode]#
Überschreiben: Start-Winkelversatz für das Layout (z. B. Hex-Rotation).