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

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.