initialer commit

This commit is contained in:
wittmannzl103469 committed 2026-10-28 21:15:33 +01:00
1 parent 74776ef485
commit a3095c2df9
18 files changed
+1073

No files matched your search

@@ -0,0 +1 @@
"""Paket spiel: Basisklasse, Matrixfunktionen und der rotierende Würfel."""
+136
View File
@@ -0,0 +1,136 @@
"""Funktionen zur linearen Algebra auf Matrizen als verschachtelte Listen."""
import math
def matmul(
matrix_a: list[list[float]], matrix_b: list[list[float]]
) -> list[list[float]]:
"""
Multipliziert zwei Matrizen miteinander (A * B).
:param matrix_a: Linke Matrix mit m Zeilen und n Spalten
:param matrix_b: Rechte Matrix mit n Zeilen und p Spalten
:return: Ergebnismatrix mit m Zeilen und p Spalten
:raises ValueError: Wenn die Spaltenzahl von A nicht der Zeilenzahl von B entspricht
"""
if len(matrix_a[0]) != len(matrix_b):
raise ValueError("Spaltenzahl von A muss der Zeilenzahl von B entsprechen.")
result = []
for row in matrix_a:
new_row = []
for col_index in range(len(matrix_b[0])):
value = 0
for k in range(len(row)):
value += row[k] * matrix_b[k][col_index]
new_row.append(value)
result.append(new_row)
return result
def transpose(matrix: list[list[float]]) -> list[list[float]]:
"""
Transponiert eine Matrix: Zeilen werden zu Spalten und Spalten zu Zeilen.
:param matrix: Matrix mit m Zeilen und n Spalten
:return: Transponierte Matrix mit n Zeilen und m Spalten
:raises ValueError: Bei leerer Matrix oder unterschiedlich langen Zeilen
"""
if not matrix or not matrix[0]:
raise ValueError("Die Matrix darf nicht leer sein.")
column_count = len(matrix[0])
for row in matrix:
if len(row) != column_count:
raise ValueError("Alle Zeilen müssen gleich viele Spalten haben.")
result = []
for col_index in range(column_count):
new_row = []
for row in matrix:
new_row.append(row[col_index])
result.append(new_row)
return result
def rot_2D(angle: float) -> list[list[float]]:
"""
Liefert die 2D-Rotationsmatrix für eine Drehung um den Ursprung.
:param angle: Drehwinkel im Bogenmaß (gegen den Uhrzeigersinn)
:return: 2x2-Rotationsmatrix [[cos, -sin], [sin, cos]]
"""
return [
[math.cos(angle), -math.sin(angle)],
[math.sin(angle), math.cos(angle)],
]
def rot_3D(angle: float, axis: str) -> list[list[float]]:
"""
Liefert die 3D-Rotationsmatrix für eine Drehung um eine Koordinatenachse.
Formeln (θ = angle):
- x-Achse: [[1, 0, 0], [0, cos θ, -sin θ], [0, sin θ, cos θ]]
- y-Achse: [[cos θ, 0, sin θ], [0, 1, 0], [-sin θ, 0, cos θ]]
- z-Achse: [[cos θ, -sin θ, 0], [sin θ, cos θ, 0], [0, 0, 1]]
:param angle: Drehwinkel im Bogenmaß
:param axis: Drehachse, "x", "y" oder "z"
:return: 3x3-Rotationsmatrix
:raises ValueError: Wenn axis nicht "x", "y" oder "z" ist
"""
cos = math.cos(angle)
sin = math.sin(angle)
if axis == "x":
return [[1, 0, 0], [0, cos, -sin], [0, sin, cos]]
if axis == "y":
return [[cos, 0, sin], [0, 1, 0], [-sin, 0, cos]]
if axis == "z":
return [[cos, -sin, 0], [sin, cos, 0], [0, 0, 1]]
raise ValueError(f"Ungültige Achse '{axis}', erlaubt sind 'x', 'y' und 'z'.")
def project_ortho(
point: tuple[float, float, float], scale: float = 1
) -> tuple[float, float]:
"""
Projiziert einen 3D-Punkt orthogonal auf die xy-Ebene.
Die z-Koordinate wird ignoriert, x und y werden mit scale multipliziert.
:param point: 3D-Punkt (x, y, z)
:param scale: Skalierungsfaktor für das Ergebnis
:return: 2D-Punkt (x * scale, y * scale)
"""
x, y, _ = point
return (x * scale, y * scale)
def project_perspective(
point: tuple[float, float, float],
focal_length: float = 1.0,
scale: float = 1.0,
camera_distance: float = 4.0,
) -> tuple[float, float]:
"""
Projiziert einen 3D-Punkt perspektivisch auf die Bildschirmebene.
Formel: x' = x * focal_length / (z + camera_distance) * scale,
y' entsprechend.
:param point: 3D-Punkt (x, y, z)
:param focal_length: Brennweite, steuert die Stärke der Perspektive
:param scale: Skalierungsfaktor für das Ergebnis
:param camera_distance: Abstand der Kamera zum Ursprung
:return: 2D-Punkt (x', y')
:raises ValueError: Wenn der Punkt auf Höhe oder hinter der Kamera liegt
"""
x, y, z = point
depth = z + camera_distance
if depth <= 0:
raise ValueError("Der Punkt liegt auf Höhe oder hinter der Kamera.")
factor = focal_length / depth * scale
return (x * factor, y * factor)
+115
View File
@@ -0,0 +1,115 @@
"""Ein Würfel, der sich mit den Pfeiltasten drehen lässt."""
import pygame
from .compute import matmul, project_ortho, rot_3D, transpose
from .game import Game
VERTICES = [
(-1, -1, -1),
(1, -1, -1),
(1, 1, -1),
(-1, 1, -1),
(-1, -1, 1),
(1, -1, 1),
(1, 1, 1),
(-1, 1, 1),
]
SCALE = 100
ANGLE_STEP = 0.05
BLACK = (0, 0, 0)
WHITE = (255, 255, 255)
class CubeGame(Game):
"""Rotierender Würfel: Pfeiltasten drehen um die x- und y-Achse."""
def __init__(
self,
title: str = "Rotierender Würfel",
fps: int = 60,
size: tuple[int, int] = (640, 400),
) -> None:
"""Legt Startwinkel, Kanten und Bildschirmpunkte des Würfels fest."""
super().__init__(title, fps, size)
self.angle_x: float = 0
self.angle_y: float = 0
self.edges: list[tuple[int, int]] = find_edges(VERTICES)
self.screen_points: list[tuple[float, float]] = []
def init_game(self) -> None:
"""Initialisiert pygame und lässt gedrückte Tasten wiederholen."""
super().init_game()
pygame.key.set_repeat(30, 30)
def handle_event(self, event: pygame.event.Event) -> bool:
"""Ändert die Drehwinkel bei Druck auf die Pfeiltasten."""
if event.type == pygame.KEYDOWN:
if event.key == pygame.K_UP:
self.angle_x -= ANGLE_STEP
elif event.key == pygame.K_DOWN:
self.angle_x += ANGLE_STEP
elif event.key == pygame.K_LEFT:
self.angle_y -= ANGLE_STEP
elif event.key == pygame.K_RIGHT:
self.angle_y += ANGLE_STEP
return super().handle_event(event)
def update_game(self) -> bool:
"""Berechnet die Bildschirmpositionen aller Eckpunkte neu."""
rotation = matmul(rot_3D(self.angle_y, "y"), rot_3D(self.angle_x, "x"))
self.screen_points = [
self.to_screen(rotate(rotation, vertex)) for vertex in VERTICES
]
return True
def draw_game(self) -> None:
"""Zeichnet alle Kanten des Würfels."""
self.screen.fill(BLACK)
for start, end in self.edges:
pygame.draw.line(
self.screen, WHITE, self.screen_points[start], self.screen_points[end]
)
pygame.display.flip()
def to_screen(self, point: tuple[float, float, float]) -> tuple[float, float]:
"""
Projiziert einen 3D-Punkt orthogonal und verschiebt ihn in die Fenstermitte.
:param point: 3D-Punkt (x, y, z)
:return: Punkt in Fensterkoordinaten
"""
x, y = project_ortho(point, scale=SCALE)
return (x + self.size[0] / 2, y + self.size[1] / 2)
def rotate(
rotation: list[list[float]], point: tuple[float, float, float]
) -> tuple[float, float, float]:
"""
Dreht einen 3D-Punkt mit einer Rotationsmatrix.
:param rotation: 3x3-Rotationsmatrix
:param point: 3D-Punkt (x, y, z)
:return: Gedrehter 3D-Punkt
"""
result = matmul(rotation, transpose([list(point)]))
return (result[0][0], result[1][0], result[2][0])
def find_edges(vertices: list[tuple[int, int, int]]) -> list[tuple[int, int]]:
"""
Findet alle Kanten des Würfels.
Zwei Ecken sind verbunden, wenn sie sich in genau einer Koordinate unterscheiden.
:param vertices: Eckpunkte des Würfels
:return: Liste von Indexpaaren (Start, Ende)
"""
edges = []
for i in range(len(vertices)):
for j in range(i + 1, len(vertices)):
differences = sum(a != b for a, b in zip(vertices[i], vertices[j]))
if differences == 1:
edges.append((i, j))
return edges
+98
View File
@@ -0,0 +1,98 @@
"""Basisklasse ``Game`` für einfache pygame-Anwendungen."""
import pygame
class Game:
"""Basisklasse für pygame-Spiele.
Unterklassen passen das Verhalten durch Überschreiben von
:meth:`handle_event`, :meth:`update_game` und :meth:`draw_game` an.
"""
def __init__(
self,
title: str,
fps: int = 60,
size: tuple[int, int] = (640, 400),
) -> None:
"""Legt Fenstertitel, Bildrate und Fenstergröße fest.
Args:
title: Titel des Fensters.
fps: Maximale Bilder pro Sekunde.
size: Fenstergröße als (Breite, Höhe) in Pixeln.
"""
self.title: str = title
self.fps: int = fps
self.size: tuple[int, int] = size
self.clock: pygame.time.Clock = pygame.time.Clock()
self.dt: float = 0
self.screen: pygame.Surface | None = None
def init_game(self) -> None:
"""Initialisiert pygame und erzeugt das Fenster."""
pygame.init()
pygame.display.set_caption(self.title)
self.screen = pygame.display.set_mode(self.size)
def game_loop(self) -> None:
"""Führt die Hauptschleife aus, bis Events oder Update ``False`` liefern."""
while True:
# Berechnung der Zeitdifferenz seit dem letzten Frame
self.dt = self.clock.tick(self.fps) / 1000
if self.event_handling() == False:
break
if self.update_game() == False:
break
self.draw_game()
def exit_game(self) -> None:
"""Beendet pygame."""
pygame.quit()
def event_handling(self) -> bool:
"""Verteilt alle anstehenden Events an :meth:`handle_event`.
Bleibt in der Unterklasse unverändert.
Returns:
``False``, sobald ein Event das Spiel beenden soll, sonst ``True``.
"""
for event in pygame.event.get():
if not self.handle_event(event):
return False
return True
def handle_event(self, event: pygame.event.Event) -> bool:
"""Verarbeitet ein einzelnes Event.
Wird in der Unterklasse überschrieben.
Args:
event: Das zu verarbeitende pygame-Event.
Returns:
``False`` bei ``pygame.QUIT``, sonst ``True``.
"""
if event.type == pygame.QUIT:
return False
return True
def update_game(self) -> bool:
"""Aktualisiert den Spielzustand um einen Frame.
Returns:
``False``, wenn das Spiel beendet werden soll, sonst ``True``.
"""
return True
def draw_game(self) -> None:
"""Zeichnet den aktuellen Frame und bringt ihn zur Anzeige."""
pygame.display.flip()
def run(self) -> None:
"""Startet das Spiel: Initialisierung, Hauptschleife, Beenden."""
self.init_game()
self.game_loop()
self.exit_game()