- R = Auswahl 90° drehen (Szene um Auswahl-Mitte, Bauen-Bauteil um Fußpunkt, Gruppe komplett; Umschalt+R = -90°), Mausrad-Feindrehen 15° bleibt - Pfeiltasten = 2-m-Raster-Verschiebung, Richtung = Kamera-Blickrichtung auf nächste Weltachse gerastet (MoveMath.nudge_delta, pure) - Bild↑/↓ = ±0,25 m auf der GANZEN Auswahl (EIN Undo), Strg+Bild↑ = Fußpunkt aufs Terrain/Boden absetzen - G = Greifen (Blender-Semantik): Auswahl hängt an der Maus, LMB setzt mit Raster-Snap, Esc rollt byte-genau zurück (ShortcutPolicy cancel_grab) - Terrain-Pinsel: [ / ] = Preset-Zyklus Klein/Mittel/Groß (Slider/Label/Preset-Buttons wandern mit), 1-4 = Heben/Senken/Glätten/Malen (PAINT-Clamp-Fix, Palette mit Malen sichtbar); Ziffern NUR im Terrain-Werkzeug - Strg halten = temporärer Snap-Zwang beim Bewegen/Greifen/Platzieren - Tests: test_shortcuts.gd 157 Checks (R byte-genau, Pfeil-Raster, Lift-Stufen, Boden-Snap, Greifen+Esc, Pinsel-Zyklus, History-Eintrag pro Operation), test_gui_smoke.gd erweitert (38 Checks) und in run_tests.sh aufgenommen; F-Regression seit Karte 1 damit abgedeckt - Suite 9/9 grün (696 Checks), Builder-Export 21/0, Parse-Check 11 Dateien grün
93 lines
5.3 KiB
Markdown
93 lines
5.3 KiB
Markdown
# Tastatur & Maus — Map-Editor
|
||
|
||
Deutsche Tastenbelegung des ScopedVR Map-Editors. **Diese Datei ist die Source
|
||
of truth** für alle Shortcut-Karten (Karte 1/3: t_c46d31c2 — Navigation,
|
||
Auswahl, Löschen; Karte 2/3: t_55257792 — Objektmanipulation + Terrain;
|
||
Karte 3/3 ergänzt hier).
|
||
|
||
Konventionen (alle Karten):
|
||
|
||
- Tastaturcode-basiert: InputMap-Actions mit physischen `KEY_*`-Konstanten
|
||
(`src/editor/shortcut_keys.gd`). Die physische Taste liegt unabhängig vom
|
||
Tastaturlayout gleich — deutsches (QWERTZ) und Windows-Layout verhalten sich
|
||
identisch, keine OS-Hardcodes (PLAN.md Plattform-Regel).
|
||
- Jede Objekt-Operation = **EIN** ActionHistory-Eintrag (Strg+Z nimmt die
|
||
ganze Operation zurück). Ausnahme: reine Kamera-Aktionen (Orbit/Flug/Zoom)
|
||
betreffen die Map nicht und sind nicht in der Historie.
|
||
- **Strg halten = temporärer Snap-Zwang** (Karte 2/3): egal was der
|
||
Raster-Snap-Schalter sagt — solange Strg unten ist, rastet Bewegen
|
||
(Ziehen/Greifen) und Platzieren auf ganze Meter.
|
||
|
||
## Navigation (Kamera)
|
||
|
||
| Eingabe | Wirkung |
|
||
| --- | --- |
|
||
| Mittlere Maustaste ziehen | Orbit: Um die Karte drehen |
|
||
| Mittlere Maustaste + Umschalt ziehen | Pan: Karte verschieben |
|
||
| Mausrad | Zoom (aus, wenn Mausrad gerade ein Objekt dreht) |
|
||
| **Rechte Maustaste GEDACHT halten** | **Freelook-Flug:** Umsehen + W vor / S zurück / A links / D rechts; E hoch / Q runter |
|
||
| Umschalt (im Flug) | schneller fliegen (×3) |
|
||
| Alt (im Flug) | langsamer fliegen (×0,3) |
|
||
| Mausrad (im Flug) | Grundgeschwindigkeit dauerhaft ändern (2–300 m/s) |
|
||
| **Umschalt+F** | Freelook-Flug dauerhaft an/aus (Flug bleibt ohne gedrückte rechte Maustaste aktiv) |
|
||
| **F** | Auswahl ins Bild zentrieren (Focus Selection) |
|
||
|
||
Der Orbit-Modus ist der Default: Beim Verlassen des Flugs springt die Kamera
|
||
nicht — Ziel/Winkel/Abstand werden aus der Flugposition zurückgerechnet.
|
||
|
||
## Auswahl
|
||
|
||
| Eingabe | Wirkung |
|
||
| --- | --- |
|
||
| Linksklick | Objekt auswählen (ersetzt die Auswahl) |
|
||
| **Strg+Klick** (Viewport **und** Objektbaum) | Objekt zur Auswahl hinzufügen/entfernen (Mehrfachauswahl) |
|
||
| Umschalt+Klick | wie Strg+Klick (Mehrfachauswahl umschalten) |
|
||
| Ziehen über leeren Boden | Rahmen-Aufziehen: alle Objekte im Rahmen wählen |
|
||
| Umschalt + Rahmen | Rahmen-Auswahl zur bestehenden Auswahl hinzufügen |
|
||
| Esc | Werkzeug abbrechen → **Greifen zurückrollen** → Ghost-Preview abbrechen → Auswahl aufheben (Prioritätskette) |
|
||
|
||
Alle Bestandsaktionen wirken auf die GANZE Mehrfachauswahl: Entf löscht alle,
|
||
Strg+D dupliziert alle, Ziehen verschiebt gemeinsam, Anheben/Absenken hebt
|
||
alle, Strg+G gruppieren / Strg+Umschalt+G lösen.
|
||
|
||
## Objekt-Manipulation (Karte 2/3)
|
||
|
||
| Eingabe | Wirkung |
|
||
| --- | --- |
|
||
| **R** | Auswahl 90° drehen (Vierteldrehung; Umschalt+R = −90°). Szene-Objekte drehen um den Auswahl-Mittelpunkt, Bauen-Bauteile um ihren Fußpunkt. Ein Objekt aus einer Gruppe dreht die GANZE Gruppe. Dauerhaft (kein Vorschau-Zustand) |
|
||
| Mausrad (mit Auswahl) | Feindrehen im 15°-Raster (bleibt wie bisher) |
|
||
| **Pfeiltasten** | Auswahl im **2-m-Raster** verschieben — EINE Zelle pro Tastendruck, Richtung = Kamera-Ausrichtung nächste Weltachse (Godot-Editor-Konvention: ↑ = von der Kamera weg). Fußpunkt bleibt am Raster, Höhe wandert mit |
|
||
| **Bild↑ / Bild↓** | Auswahl +0,25 m / −0,25 m anheben/absenken (Mehrfachdruck = EIN Undo-Schritt) |
|
||
| **Strg+Bild↑** | Auswahl direkt auf das Terrain/Boden absetzen (Godot „Snap Object to Floor“-Äquivalent fürs Fußpunkt-Modell) |
|
||
| **G** | Auswahl **greifen** (Blender-Semantik): sie hängt an der Maus, Linksklick setzt die neue Position (mit Raster-Snap bzw. Strg-Zwang), **Esc** bricht ab und setzt die exakten alten Positionen zurück. Greifen der ganzen Gruppe/mehreren Objekte wandert gemeinsam |
|
||
| **Entf (DELETE)** | Auswahl SOFORT löschen, ohne Rückfrage — Strg+Z holt alles zurück. Wirkt auf Szene-Auswahl UND Objektbaum-Markierung |
|
||
| **Strg+D** | Auswahl duplizieren: Kopie +2 m in X versetzt (Rasterversatz), Füßpunkt unverändert; bei Mehrfachauswahl ALLE Objekte mit EINEM Undo-Schritt |
|
||
| Strg+Z / Strg+Y | Rückgängig / Wiederherstellen |
|
||
| Strg+S | Karte speichern |
|
||
| Strg+G / Strg+Umschalt+G | Auswahl gruppieren / Gruppe lösen |
|
||
|
||
## Terrain-Werkzeug (Karte 2/3) — nur aktiv, wenn das Terrain-Werkzeug an ist
|
||
|
||
| Eingabe | Wirkung |
|
||
| --- | --- |
|
||
| **[** | Pinselgröße verkleinern — durch die 3 Presets Klein (4 m) / Mittel (12 m) / Groß (32 m) zyklisch; Preset-Buttons, Slider und Label wandern mit |
|
||
| **]** | Pinselgröße vergrößern (gleicher Zyklus, andere Richtung) |
|
||
| **1** | Pinselmodus Heben |
|
||
| **2** | Pinselmodus Senken |
|
||
| **3** | Pinselmodus Glätten |
|
||
| **4** | Pinselmodus Malen (mit der zuletzt gewählten Materialfarbe) |
|
||
| Strg halten | temporärer Snap-Zwang beim Objekt-Bewegen/Platzieren (gilt editorweit, nicht nur hier) |
|
||
|
||
Konfliktfreiheit: Die Ziffern 1–4 sind NUR im Terrain-Werkzeug belegt — im
|
||
Objekt-/Bauen-Modus sind sie unbenutzt, im Flugmodus (rechte Maustaste
|
||
gehalten) bleiben E/Q die Kamera.
|
||
|
||
## Werkzeuge
|
||
|
||
| Eingabe | Wirkung |
|
||
| --- | --- |
|
||
| Esc (im Terrain-/Spawn-/Bauen-Werkzeug) | Werkzeug beenden — zurück zum Objekt-Werkzeug |
|
||
| Esc (beim Greifen) | Greifen abbrechen, alte Positionen zurück |
|
||
| Esc (beim Platzieren) | Ghost-Preview abbrechen |
|
||
|
||
*(Karte 3/3 ergänzt hier ihre Belegungen.)*
|