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:
parent
0df49873d1
commit
d44a4e1e2f
18 changed files with 924 additions and 111 deletions
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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
95
docs/web-test.md
Normal 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue