proejct commit

docs/CONTROLS.md

@@ -0,0 +1,55 @@
+# Bedienung
+
+## Maus in der Welt
+
+| Eingabe | Aktion |
+|---|---|
+| **Linksklick ins Leere** | Erzeugt ein Objekt mit den Einstellungen der Sidebar an der Mausposition. Hält man die Taste gedrückt, hängt das neue Objekt sofort an der Maus und kann direkt geworfen werden. |
+| **Linksklick auf ein Objekt, gedrückt halten** | Greift das Objekt (gelbe Umrandung). Es folgt der Maus, kollidiert dabei aber weiter: Leichtere Objekte werden weggeschoben, Wände und schwere Stapel bremsen es. |
+| **Loslassen während der Bewegung** | Wirft das Objekt mit der (geglätteten) Mausgeschwindigkeit der letzten Frames. Der gelbe Pfeil zeigt beim Ziehen Richtung und Stärke des Wurfs. |
+| **Loslassen nach kurzem Stillhalten** | Das Objekt fällt einfach herunter, ohne Schwung. |
+| **Rechtsklick auf ein Objekt** | Löscht das Objekt. |
+| **Mausrad** | Ändert die Größe neuer Objekte. |
+| **Maus über einem Objekt** | Weiße Umrandung und Hand-Cursor: Das Objekt kann gegriffen werden. |
+| **Maus über leerer Fläche** | Halbtransparente Vorschau des Objekts, das ein Klick erzeugen würde. |
+
+## Sidebar
+
+| Element | Wirkung |
+|---|---|
+| **Kreis / Rechteck** | Form neuer Objekte. |
+| **Größe** | Radius bzw. halbe Kantenlänge (12–80 px). |
+| **Seitenverhältnis** | Breite : Höhe von Rechtecken (0,5–2). Die Fläche und damit die Masse bleibt dabei gleich – außer bei sehr kleinen Rechtecken, deren kurze Seite nicht unter die Mindestgröße (24 px) fallen darf. Bei Kreisen ausgegraut. |
+| **Elastizität** | Stoßzahl 0 (kein Abprallen) bis 1 (vollkommen elastisch). |
+| **Dichte** | Masse pro Fläche (0,2–5). Schwere Objekte schieben leichte leichter weg. |
+| **Farbe** | Feste Farbe oder (erstes Feld) Zufallsfarbe. |
+| **Vorschau-Kachel** | Zeigt das nächste Objekt in seiner echten Farbe. Mit gedrückter Maustaste in die Welt ziehen: Das Objekt erscheint am Weltrand und hängt an der Maus. Wird über der Sidebar losgelassen, entsteht kein Objekt. |
+| **Pause / Weiter** | Hält die Simulation an. Im Pausenmodus lassen sich Objekte erzeugen und exakt platzieren; beim Loslassen werden sie nicht geworfen. |
+| **Schwerkraft an / aus** | Schaltet die Schwerkraft um und weckt alle ruhenden Objekte. |
+| **Alles löschen** | Entfernt alle Objekte. |
+
+Alle Regler reagieren auf Klicken, Ziehen und das Mausrad (in Rasterschritten). Beim Ziehen
+darf die Maus die Sidebar verlassen.
+
+## Tastatur
+
+| Taste | Aktion |
+|---|---|
+| `Leertaste` | Pause / Weiter |
+| `G` | Schwerkraft an / aus |
+| `C` | Alles löschen |
+| `Entf` | Objekt unter der Maus löschen |
+| `1` | Form: Kreis |
+| `2` | Form: Rechteck |
+| `F1` | Debug-Ansicht: Kontaktpunkte (gelb), Kontaktnormalen (rot), schlafende Objekte (graue Umrandung), Kennzahlen |
+| `Esc` | Beenden |
+
+Die Tastenbelegung steht in `KEY_BINDINGS` in [`src/sandbox/config.py`](../src/sandbox/config.py).
+
+## Kommandozeile
+
+| Option | Wirkung |
+|---|---|
+| `--demo` | startet mit einer Beispielszene |
+| `--screenshot DATEI` | läuft `--seconds` Sekunden, speichert ein Bildschirmfoto und beendet sich |
+| `--seconds S` | Laufzeit vor dem Bildschirmfoto (Standard: 3) |