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:
parent
e9d520459e
commit
55e7b163b5
33 changed files with 4623 additions and 345 deletions
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue