rinkplanner/docs/web-test.md
torsten d44a4e1e2f 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
2026-10-30 09:37:14 +01:00

95 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.