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.

corner_vectors: dict = {}#
property cost: float#

Kosten für das Betreten dieser Kachel bei der Wegfindung (Standard: 1).

Darf nicht negativ sein. Kosten von 0 machen das Betreten der Kachel kostenlos.

Beispiele

swamp.cost = 3
road.cost = 0.5
Typ:

float

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:

dict

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.

Rückgabetyp:

TileBase

Parameter:
  • pixel_position (Tuple[float, float]) – Die Pixelposition (x, y).

  • world (world_mod.World) – Die Weltinstanz, die das Kachel-Layout enthält.

Rückgabe:

Das Kachelobjekt, das der gegebenen Pixelposition am nächsten liegt.

Rückgabetyp:

TileBase

abstract classmethod from_position(position, world)[Quellcode]#

Erstellt eine Kachel aus einer weltrelativen Position.

Rückgabetyp:

TileBase

get_actors()[Quellcode]#

Gibt alle Actors zurück, die sich aktuell auf dieser Kachel befinden.

Rückgabetyp:

List

static get_local_center_coordinate(world)[Quellcode]#

Gibt den Mittelpunkt-Versatz einer Kachel in lokalen Pixelkoordinaten zurück.

Rückgabetyp:

Tuple[float, float]

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.

Rückgabetyp:

List[Tile]

static get_position_pixel_dict(world)[Quellcode]#

Gibt eine Zuordnung von Kachelpositionen zu Pixelkoordinaten zurück.

Rückgabetyp:

dict

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:

None

property is_blocking: bool#

Ob die Wegfindung diese Kachel als nicht passierbar behandelt.

Actors mit is_blocking = True blockieren ihre Kachel ebenfalls; dieses Flag blockiert eine Kachel ohne Actor, zum Beispiel Wasser.

Beispiele

water_tile.is_blocking = True
Typ:

bool

merge(other)[Quellcode]#

Führt Kachelpositionen einer anderen Kachel an derselben Stelle zusammen.

property terrain#

Der Geländename dieser Kachel oder None (gespeichert als data["terrain"]).

Beispiele

tile.terrain = "forest"
if tile.terrain == "forest":
    print("wood")
tile_vectors: dict = {}#

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:

float

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:

Tile

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.

Rückgabetyp:

Tile

Parameter:
  • pixel_position (Tuple[float, float]) – Die Pixelposition (x, y).

  • world (world_mod.World) – Die Weltinstanz, die das Kachel-Layout enthält.

Rückgabe:

Das Kachelobjekt, das der gegebenen Pixelposition am nächsten liegt.

Rückgabetyp:

TileBase

classmethod from_position(position, world)[Quellcode]#

Erstellt eine Kachel aus einer weltrelativen Position.

Rückgabetyp:

Tile

get_neighbour_corners()[Quellcode]#
Rückgabetyp:

List[Corner]

static get_position_pixel_dict(world)[Quellcode]#

Gibt eine Zuordnung von Kachelpositionen zu Pixelkoordinaten zurück.

Rückgabetyp:

dict

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]#
Rückgabetyp:

Tuple[float, float]

to_pixel()[Quellcode]#
Rückgabetyp:

Tuple[float, float]

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.

Parameter:
  • pixel_position (Tuple[float, float]) – Die Pixelposition (x, y).

  • world (world_mod.World) – Die Weltinstanz, die das Kachel-Layout enthält.

Rückgabe:

Das Kachelobjekt, das der gegebenen Pixelposition am nächsten liegt.

Rückgabetyp:

TileBase

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).