feat: Tablet- und Web-Bedienung härten

- Oberfläche in CSS-Pixeln layouten (stretch disabled,
  content_scale_factor = Bildschirm-Skalierung), damit 56-px-Ziele auf
  Tablets auch 56 CSS-Pixel groß sind
- Kompakte Werkzeugleiste unter 1280 px, umbruchfähige Timing-Leiste;
  1024 px (iPad-Landscape) und 1400 px (Tab S9+) geprüft
- Chrome-Guard gegen synthetische Maus-Events vor/nach Touch-Gesten
- Web-Export-Preset und tools/export_web.sh (single-threaded)
- Kurven-Cache und Linien-Fastpath: Stresstest mit 480 Segmenten von
  ca. 48 ms auf ca. 7-10 ms pro Redraw
- Neue Suiten für Touch/Layout und Performance, Tablet-Testanleitung in
  docs/web-test.md
This commit is contained in:
torsten 2026-10-30 09:37:14 +01:00
parent 0df49873d1
commit d44a4e1e2f
18 changed files with 924 additions and 111 deletions

View file

@ -164,12 +164,45 @@ Gesetzt in `rinkplanner/project.godot`:
| Mobile | `mobile` |
| Web (Wasm) | `gl_compatibility` |
Die Designauflösung ist 1920 × 1200 mit `canvas_items` / `expand`; die
Oberfläche skaliert mit, das Rink-Koordinatensystem bleibt in Metern.
### UI-Skalierung (Touch-first)
Touch-Ziele: mindestens 48 × 48 px. Für Desktop-Tests kann temporär
`window/stretch/mode="disabled"`: Die Oberfläche wird in realen Fenster- bzw.
CSS-Pixeln gelayoutet. Zusätzlich setzt der Controller
`Window.content_scale_factor` auf die Bildschirm-Skalierung
(`DisplayServer.screen_get_scale()`). Damit entspricht eine Layout-Einheit auf
Tablets einem CSS-Pixel und wird trotzdem in Gerätepixeln gerendert:
- Ein 56-px-Button ist auf dem Tablet wirklich 56 CSS-Pixel groß, statt durch
eine feste Designauflösung kleingerechnet zu werden.
- Das Rink bleibt in Metern; nur die Pixelabbildung ändert sich.
- Der PNG-Export ist unabhängig davon (eigener `SubViewport`, 2560 × 1600).
### Responsive Leiste
- Ab 1280 px Breite: volle Beschriftungen („Rinkplanner“, „Werkzeug“,
„Rückgängig“, „Wiederholen“, „Kalibrieren“).
- Unter 1280 px: kompakte Beschriftungen („Undo“, „Redo“, „Kalib.“), Titel und
Werkzeug-Label entfallen, das Sections-Panel wird 260 statt 300 px breit.
- Die Timing-Leiste ist ein `HFlowContainer` und bricht bei Bedarf um, statt
seitlich abgeschnitten zu werden.
- Geprüfte Landschaftsbreiten: 1024 px (iPad-Landscape) und 1400 px
(Galaxy Tab S9+). Hochformat ist noch nicht gestaltet.
### Zeichen-Cache
`RinkCanvas` cached die in Bildschirmpunkte gesampelten Kurven pro Segment.
Der Cache wird verworfen, sobald sich Pan/Zoom oder die Kontrollpunkte ändern.
Gerade Linien (zwei Punkte ohne Griffe) werden direkt als zwei Punkte
gezeichnet. Im Stresstest (480 Segmente, 12 Sections) sinkt die mittlere
Redraw-Zeit dadurch von ca. 48 ms auf ca. 7–10 ms.
### Touch-Ziele
Mindestens 56 × 56 px. Für Desktop-Tests kann temporär
`input_devices/pointing/emulate_touch_from_mouse=true` aktiviert werden;
standardmäßig bleibt es aus.
standardmäßig bleibt es aus. Chrome sendet zusätzlich synthetische
Maus-Events: eines vor `touchstart` (wird beim Touch-Start verworfen) und
ggf. eines nach `touchend` (300-ms-Guard).
## 6. Export und Persistenz
@ -191,9 +224,11 @@ standardmäßig bleibt es aus.
- **Autosave** schreibt nach 1,5 s Inaktivität nach `user://autosave.tres`
und wird beim Start automatisch wiederhergestellt. Der Dirty-State wird im
Fenstertitel als `*` angezeigt. Beim Verlassen wird zusätzlich gespeichert.
- **Web:** `FileAccess` schreibt in den IndexedDB-Speicher. Die Persistenz
funktioniert dort über `user://`; ein echter Browser-/Tablet-Test steht
noch aus.
- **Web:** `FileAccess` schreibt in den IndexedDB-Speicher. Im echten
Chrome-Touch-Test auf einem 1024-px- und einem 1400-px-Layout (DPR 2)
überlebt die Kür einen Browser-Reload.
- **Web-Build:** `tools/export_web.sh` exportiert nach `build/web/`
(single-threaded, kein COOP/COEP nötig). Details in `docs/web-test.md`.
## 7. Tests
@ -225,6 +260,12 @@ Aktueller Stand:
Kalibrierung, Undo, Persistenz und Schema-1-Migration.
- **Export:** 17 Assertions für SVG-Struktur, Titel-Escaping, Section-Filter,
Segmentfarben/-strichelung und das Schreiben der Exportdatei.
- **Touch/Tablet:** 21 Assertions für Ein-Finger-Zeichnen, Zwei-Finger-Pan,
Pinch-Zoom, Tipp-Auswahl, Griff-Bearbeitung, Abbruch bei zweitem Finger,
Unterdrückung synthetischer Maus-Events aus Chrome sowie das responsive
Leistenlayout bei 1024 und 1400 px.
- **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere
Redraw-Zeit muss unter 120 ms bleiben (aktuell ca. 7–10 ms).
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
end-to-end geprüft.

View file

@ -52,12 +52,14 @@ Voraussetzung für Phase 1.
### Nächster Schritt: Touch-/Tablet-/Web-Härtung
- [ ] Test auf echtem Tablet
- [ ] Web-Export mit Compatibility-Renderer
- [ ] Kleine Displays und Hochformat prüfen
- [ ] Touch-Ziele, Gesten und Scrollverhalten prüfen
- [ ] Performance bei vielen Segmenten und Sections
- [ ] Persistenz auf Web/IndexedDB verifizieren
- [x] Web-Export mit Compatibility-Renderer (`tools/export_web.sh`)
- [x] Touch-Ziele auf 56 px erhöht, Chrome-Doppel-Segment-Guard
- [x] Kleine Displays (1024 px) und kompakte Leiste geprüft
- [x] Performance bei vielen Segmenten und Sections (Cache + Stresstest)
- [x] Persistenz auf Web/IndexedDB verifizieren (Reload-Test)
- [ ] Test auf echtem Tablet (Galaxy Tab S9+)
- [ ] Hochformat-Layout (nur prüfen, falls benötigt)
- [ ] Optional: iPad/Safari-Test
### Danach: Element-Marker

95
docs/web-test.md Normal file
View file

@ -0,0 +1,95 @@
# Web-/Tablet-Test
Zielgerät: **Samsung Galaxy Tab S9+**, Android, Chrome, Landscape.
Zusätzlich geprüft: **1024 × 768 CSS-Pixel** (iPad-Landscape-Größe) und
Desktop-Chromium.
## 1. Voraussetzungen
- Godot 4.7.2 (oder eine kompatible 4.x-Version) mit installierten
**Web-Export-Templates** derselben Version.
- Auf diesem Rechner waren bei der Einrichtung nur die 4.6-Web-Templates
installiert; der erste Testbuild lief deshalb mit Godot 4.6. Für den
finalen Build die 4.7.2-Templates über den Godot-Editor installieren
(`Editor → Manage Export Templates`).
## 2. Web-Build erzeugen
```bash
./tools/export_web.sh
```
Das Skript importiert das Projekt und schreibt den Build nach:
```
build/web/index.html
```
`build/` ist nicht versioniert. Der Export ist **single-threaded** und braucht
keine COOP/COEP-Header. Der Web-Renderer ist `gl_compatibility` (WebGL 2).
## 3. Lokal testen
```bash
python3 -m http.server 8000 --directory build/web
```
Auf dem Tablet im gleichen WLAN öffnen:
```
http://<IP-des-Rechners>:8000/
```
Die IP z. B. mit `ip addr` oder `hostname -I` ermitteln.
## 4. Testcheckliste auf dem Tablet
- [ ] Start im Landscape-Modus, Canvas füllt den Bildschirm
- [ ] Ein-Finger-Ziehen zeichnet genau ein Segment (kein Doppel-Segment)
- [ ] Zwei-Finger-Ziehen pannt
- [ ] Pinch zoomt
- [ ] Tippen im Modus „Auswählen“ wählt ein Segment
- [ ] Start-/Endpunkt- und Bogen-Griffe lassen sich mit dem Finger ziehen
- [ ] Richtung/Kante über die Toolbar ändern
- [ ] Sections anlegen, wechseln, umbenennen, sortieren
- [ ] Timing-Leiste: Dauer/Tempo ändern, Profil wählen, Kalibrieren
- [ ] Playback: Start/Pause/Reset, Timeline-Scrub, Geschwindigkeit
- [ ] Speichern/Laden über das Datei-Menü
- [ ] Autosave: Seite neu laden → Kür ist wieder da
- [ ] SVG- und PNG-Export erzeugen und Datei öffnen
- [ ] Keine abgeschnittenen Buttons, kein horizontales Scrollen
## 5. UI-Skalierung im Browser
Der Web-Build läuft mit `window/stretch/mode="disabled"`. Godot legt das
Canvas in Gerätepixeln an (bei DPR 2 also 2800 × 1580 für 1400 × 790 CSS).
Der Controller setzt deshalb `Window.content_scale_factor` auf
`DisplayServer.screen_get_scale()` (im Browser = `devicePixelRatio`). Damit
gilt:
- Layout-Einheit = CSS-Pixel; ein 56-px-Button ist 56 CSS-Pixel groß.
- Rendering bleibt scharf (2× Backing Store auf dem Tablet).
- Ab 1280 CSS-Pixel erscheinen die vollen Beschriftungen, darunter die
kompakte Leiste („Undo“, „Redo“, „Kalib.“, ohne Titel).
## 6. Bereits geprüft (Chromium, echtes Touch-Event)
- WebGL2/Compatibility-Renderer startet ohne Konsolenfehler
- Ein Chrome-Touch-Drag erzeugt genau **ein** Segment; das synthetische
Maus-Event vor `touchstart` wird verworfen, ein spätes nach `touchend`
ebenfalls (300-ms-Guard)
- Autosave/IndexedDB: Reload stellt die Kür wieder her (1024 und 1400 px)
- Layout bei 1024 × 768 (kompakt) und 1400 × 790 (voll) ohne Abschneiden
- Touch-Ziele 56 × 56 px; Menü/Undo/Redo sind Textbuttons, damit
Web-Font-Fallbacks keine Kästchen erzeugen
- Performance: 480 Segmente / 12 Sections ≈ 7–10 ms pro Redraw (headless,
ohne GPU-Zeichnung)
## 7. Bekannte Grenzen
- **Hochformat** (< 1024 px Breite) ist noch nicht gestaltet; die
Werkzeugleiste wäre dort zu breit. Ziel bleibt Landscape.
- Safari/iOS ist noch nicht getestet. Der Build ist thread-frei und nutzt
WebGL2, also grundsätzlich lauffähig; separat zu prüfen sind
Touch-Event-Reihenfolge, IndexedDB-Limits und Safe-Area im Landscape.
- Audio wird in Phase 1 nicht genutzt.