feat: add step-sequence groups, freehand editing and element PDF

- group contiguous path segments into one sequence element with shared group IDs
- resolve elements centrally and score/adult-count groups once
- add freehand tool with point editing, smoothing and RDP reduction
- render one PDF table row and badge per element instead of per segment
- turn playback start/pause/reset into icon buttons
- add multi-select grouping and extend tests/documentation
This commit is contained in:
torsten 2026-11-10 15:50:03 +01:00
parent e9d520459e
commit 55e7b163b5
33 changed files with 4623 additions and 345 deletions

View file

@ -58,8 +58,9 @@ Implementiert in `rinkplanner/src/core/model/`:
| Klasse | Verantwortung |
| :--- | :--- |
| `Routine` | Wurzelaggregat, Validierung, Gesamtdauer/-länge, Section-Lookup, Adult-Kategorie |
| `RoutineSection` | chronologischer Block, Ghosting-Einheit, Segmentliste |
| `PathSegment` | Pfad mit Richtung, Kante, Dauer, Element-Marker, Sprungkombination und Label |
| `RoutineSection` | chronologischer Block, Ghosting-Einheit, Segmentliste, Elementauflösung |
| `PathSegment` | Pfad mit Richtung, Kante, Dauer, Elementdaten (Lead), Gruppen-ID und Label |
| `ResolvedElement` | Lese-Sicht auf ein Element: Lead, Mitgliedssegmente, Dauer, Caption, Gruppenanker |
| `RinkDimensions` | Maße, Koordinaten, Punkte-/Kurvenprüfung |
| `RoutineFile` | JSON-Serialisierung, atomare Saves, Legacy-`.tres`-Import |
@ -255,10 +256,23 @@ Fahrtrichtung.
(Segment anlegen, Kante umschalten, Section wechseln, Playback steuern).
- **Zeichenwerkzeuge:** `WhiteboardController` hält eine Draft-Routine mit
einer Section. Die Toolbar bietet Auswählen, Linie, Bogen links, Bogen
rechts und Element; Richtung (vorwärts/rückwärts) und Kante (innen/außen)
gelten für das nächste Segment. Neue Segmente starten mit dem gewählten
Timing-Profil (Default Adult Gold, 4,3 m/s); Züge über die Bande werden per
`clamp_point()` auf die Eisfläche begrenzt.
rechts, Freeline und Element; Richtung (vorwärts/rückwärts) und Kante
(innen/außen) gelten für das nächste Segment. Neue Segmente starten mit dem
gewählten Timing-Profil (Default Adult Gold, 4,3 m/s); Züge über die Bande
werden per `clamp_point()` auf die Eisfläche begrenzt.
- **Freeline:** Der Freeline-Modus sammelt die gezogene Bewegung als
mehrpunktige `Curve2D` (ca. 2,5 px Punktabstand, max. 4.000 Punkte pro
Segment). Die Vorlage `Template.FREEHAND` bleibt erhalten, damit
Start-/Endgriffe nur den jeweiligen Endpunkt verschieben und die Kurve
nicht zu einer Linie zusammenfällt. Im Auswahlmodus zeigt der Canvas bis zu
64 gleichmäßig verteilte Zwischenpunkte als kleine Griffe; ein Drag bewegt
den jeweiligen Kurvenpunkt (Detail-Index im Handle-Signal), alle anderen
Punkte bleiben unverändert. „Glätten“ in der Timing-Leiste führt zwei
Laplacian-Durchgänge auf den Innenpunkten aus (Endpunkte fest, undo-fähig,
mehrfach anwendbar). Eine iterative RDP-Reduktion entfernt beim Abschluss
(ca. 1 px Toleranz, zoomabhängig) und über „Vereinfachen“ überflüssige
Zwischenpunkte; Endpunkte und Form bleiben erhalten. Länge, Dauer, Playback,
3D, SVG und PDF nutzen dieselbe Kurve wie die anderen Pfadsegmente.
- **Bogen-Vorlage:** `ArcGeometry` erzeugt einen Kreisbogen mit 40 % der
Sehnenlänge als Pfeilhöhe und liefert eine gesampelte `Curve2D`-Polyline.
Liegt der Bogen außerhalb des Rinks, wird die Pfeilhöhe schrittweise
@ -277,15 +291,48 @@ Fahrtrichtung.
nicht interaktiv. Die Bogenparameter werden als `template`,
`arc_depth_ratio` und `arc_bulge_left` am `PathSegment` gespeichert, damit
die Kurve nach dem Editieren neu aufgebaut werden kann.
- **Element-Marker:** Das Werkzeug „Element“ setzt per Tipp einen Punktmarker
(Ein-Punkt-Kurve, Dauer 0) des in der Timing-Leiste gewählten Typs
(Sprung/Pirouette/Sequenz). Der Marker wird direkt ausgewählt; der Button
- **Element-Marker:** Die Werkzeuge „Sprung“ und „Pirouette“ setzen per Tipp
einen Punktmarker (Ein-Punkt-Kurve, Dauer 0) des jeweiligen Typs; der Typ ist
damit schon vor dem Platzieren festgelegt. Die Einfügeposition folgt der
gezeichneten Laufspur: Der Marker landet an der Stelle zwischen den
Segmenten, deren Pfad dem Tipp am nächsten liegt – auch am Anfang oder in
der Mitte eines Abschnitts. Wiederholte Tipps an derselben Stelle behalten
ihre Reihenfolge. Der Marker wird direkt ausgewählt; der Button
„Element“ öffnet den Inspector für Typ, Kürzel und Level. Im
Auswahlmodus lässt sich der Marker über seinen Griff verschieben. Sequenz-
Bereiche entstehen, indem ein gezeichnetes Segment über den Inspector
getaggt wird. Punktmarker haben eine **Standzeit** (`element_duration_seconds`)
mit Typ-Defaults (Sprung 0,7 s, Pirouette 8 s, Sequenz 0 s), die im
Inspector übersteuert wird und in die Timeline eingeht. Das Kürzel wird
Auswahlmodus lässt sich der Marker über seinen Griff verschieben.
Das **Sequenz-Symbol** startet den Sequenz-Zeichenmodus: Die erste
gezeichnete Strecke wird Lead eines Bereichs, weitere Strecken treten über
dieselbe `element_group_id` bei. Die Gruppe zählt in Prüfung, Basiswert,
Adult-Regeln, Timeline und Export als **ein** Element. Ein beliebiges
Mitglied lässt sich auswählen; der Inspector bearbeitet immer das Lead-
Segment. Beim Löschen des Leads übernimmt das nächste Mitglied die
Elementdaten. `RoutineSection.get_elements()` löst Einzelelemente und
Gruppen zu `ResolvedElement`-Sichten auf; alle Wertungs- und Anzeigepfade
iterieren darüber statt über die Rohsegmente. Die **Mehrfachauswahl**
(Knopf im Abschnittsbereich oder Shift/Cmd/Ctrl-Klick) erlaubt das
nachträgliche Gruppieren zusammenhängender Segmente über
„Sequenz gruppieren“; der Controller prüft Lücken, Marker und bestehende
Elemente, bevor er den Undo-fähigen Gruppenschritt ausführt. Punktmarker haben eine
**Standzeit** (`element_duration_seconds`)
mit Typ-Defaults (Sprung 0,7 s, Pirouette 4 s, Sequenz 0 s), die im
Inspector übersteuert wird und in die Timeline eingeht. Pirouetten tragen
zusätzlich eine **Umdrehungszahl** (`element_revolutions`, Default aus
4 s × 2,5 U/s = 10) und eine **Drehrichtung**
(`element_rotation_direction`, Default linksherum, weil ~85–90 % der Läufer
gegen den Uhrzeigersinn drehen); der Playback dreht mit Umdrehungen /
Standzeit in dieser Richtung. Sprünge zeigen im Canvas einen **Sprungvektor**
entlang der Ankunftsrichtung mit der Distanz im Kürzel-Label
(`3Lz · 3,0 m`); ohne manuelle Änderung wird die Weite aus dem Kürzel
abgeleitet (1 m pro Luftumdrehung, Axel +0,5). Die **Pfeilspitze ist ein
Griff**: Ziehen speichert Richtung und Weite in `element_jump_vector` und
überschreibt damit die Heuristik. Beim Abspielen wächst der Marker in der
Luft
(Sinuskurve über die Standzeit) und dreht sich mit der Sprungdrehung
(3Lz = 3 Umdrehungen), ebenfalls in der eingestellten Richtung. Beim
Abspielen wandert der Marker entlang des Sprungvektors vom Absprung zum
Landepunkt; folgt die gezeichnete Spur nicht dort weiter, springt der Marker
wie bei anderen nicht verbundenen Segmenten zum nächsten Startpunkt. Das
Kürzel wird
über eine Auswahlbox aus dem Katalog gewählt (mit Freitext-Fallback für
Kombinationen und Varianten). Der Inspector zeigt
außerdem den **Base Value** des eingegebenen Kürzels und Levels aus dem
@ -336,12 +383,18 @@ Fahrtrichtung.
kontinuierlich per Bogenlängen-Sampling (`sample_baked()`). Die Blickrichtung
folgt der Kurventangente; bei Rückwärts-Segmenten wird sie um 180° gedreht,
sodass die Bewegung entlang des Pfades und die Körperrichtung getrennt
sichtbar sind. Punktmarker halten die Ankunftsrichtung, Pirouetten drehen
den Marker während der Standzeit mit 1,5 Umdrehungen pro Sekunde. Während
sichtbar sind. Punktmarker halten die Ankunftsrichtung. Pirouetten drehen
den Marker während der Standzeit mit der geplanten Umdrehungszahl geteilt
durch die Standzeit (Fallback für alte Dateien: 2,5 U/s) in der
eingestellten Drehrichtung. Sprünge drehen sich mit ihrer Luftumdrehung
(aus dem Kürzel, z. B. 3Lz = 3), wandern dabei vom Absprung entlang des
Sprungvektors zum Landepunkt und der Marker wächst zur Sprungmitte hin
auf das 1,85-Fache, um die Luftphase zu zeigen. Während
des Playbacks wird die aktuelle Section hervorgehoben,
ohne die Bearbeitungs-Section zu wechseln. Ein **▶** markiert sie in der
Abschnittsliste; ihr Name erscheint kurz oben auf der Eisfläche und blendet
sich innerhalb von zwei Sekunden aus. Steuerung: Play/Pause, Reset,
sich innerhalb von zwei Sekunden aus. Steuerung: Icon-Knöpfe für
Start/Pause und Reset (Rekorder-Symbole, Tooltips nennen die Aktion),
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Ein optionales
Musikstück (MP3/OGG/WAV) liegt neben der Kür-JSON in `user://routines/`
und läuft über einen `AudioStreamPlayer` auf derselben Zeitbasis: Start,
@ -401,10 +454,17 @@ wird trotzdem in Gerätepixeln gerendert:
### Responsive Leiste
- Ab 1280 px Breite: volle Beschriftungen („Rinkplanner“, „Werkzeug“,
- Die Werkzeuge liegen als Icon-Leiste in der Kopfzeile: Mauszeiger für
„Auswählen“, Linie, linker und rechter Bogen sowie drei Element-Icons
(springendes Strichmännchen mit Pfeil = Sprung, hockendes mit Kreispfeil =
Pirouette, gehendes = Sequenz). Beim Start ist „Auswählen“ aktiv. Das aktive
Werkzeug wird erhellt (weißes Icon) und mit einem weißen Rahmen markiert;
Tooltips nennen den Namen.
- Ab 1390 px Breite: volle Beschriftungen („Rinkplanner“, „Vorwärts“,
„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.
- Unter 1390 px: kompakte Beschriftungen („Undo“, „Redo“, „Vor“, „Rück“,
„Fit“, „Kalib.“), der Titel entfällt, die Werkzeug-Icons werden 44 statt
48 px breit, das Sections-Panel 260 statt 300 px.
- Die Timing-Leiste ist ein `HFlowContainer` und bricht bei Bedarf um, statt
seitlich abgeschnitten zu werden.
- Geprüfte Landschaftsbreiten: 1024 px (kleine Tablets) und 1400 px
@ -440,18 +500,22 @@ ggf. eines nach `touchend` (300-ms-Guard).
- **PDF** erzeugt `RoutinePdfExporter` direkt als Vektordokument über einen
kleinen eigenen PDF-Writer (Helvetica/WinAnsi, keine externe Bibliothek):
eine Übersichtsseite mit allen Laufwegen und der Abschnittstabelle, danach
eine Seite pro Abschnitt mit nummerierten Laufwegen sowie Start-/Endzeit,
Dauer und Element bzw. Label. Lange Abschnitte laufen auf
Fortsetzungsseiten weiter. Die Kurven werden als PDF-Bézierkurven aus den
eine Seite pro Abschnitt. Die Badges nummerieren die **Elemente** in
Reihenfolge; die Tabelle hat eine Zeile pro Element mit Start-/Endzeit,
Dauer, Element/Label und bei Sequenzbereichen der Teilstrecken-Anzahl.
Reine Laufwege ohne Element werden gezeichnet, aber nicht tabelliert.
Lange Abschnitte laufen auf Fortsetzungsseiten weiter. Die Kurven werden als PDF-Bézierkurven aus den
`Curve2D`-Handles geschrieben. Nach jedem Export zeigt ein Abschlussdialog
den absoluten Pfad und bietet **Öffnen**, **Ordner anzeigen** und
**Pfad kopieren** über `OS.shell_open` / `OS.shell_show_in_file_manager`;
optional startet das Ergebnis direkt im Standardprogramm.
- **Persistenz** erfolgt lokal als JSON unter `user://routines/`
(`RoutineFile`, Format `rinkplanner.routine`). Die Datei enthält
`schema_version` (aktuell 4); neuere Schemata werden abgelehnt,
`schema_version` (aktuell 6); neuere Schemata werden abgelehnt,
ältere Dateien beim Laden migriert (Schema 1: Dauer→Tempo, Schema 2→3:
additives Feld `music_file`, Schema 3→4: additive Timeline-Labels).
additives Feld `music_file`, Schema 3→4: additive Timeline-Labels,
Schema 4→5: additives Feld `element_group_id` für Sequenzbereiche,
Schema 5→6: Vorlagenwert `freehand` für Freeline-Segmente).
Die Elementfelder kamen additiv mit
Defaults hinzu. Legacy-`.tres`-Dateien
bleiben lesbar: Vor `ResourceLoader.load` prüft `RoutineFile` eine