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

3.5 KiB
Raw Blame History

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

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

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.