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

View file

@ -0,0 +1,61 @@
# Findings – Freeline-Werkzeug (2026-11-10)
## Ergebnis
Die Werkzeugleiste hat ein neues **Freeline**-Werkzeug. Es zeichnet den
Laufweg frei mit Maus oder Finger und speichert ihn als mehrpunktige Kurve.
Das Icon ist eine gekräuselte Linie mit Stift (`assets/icons/tools/freeline.svg`).
| Ziel | Ergebnis |
| :--- | :--- |
| Werkzeug | `Tool.FREELINE` zwischen den Bögen und den Element-Werkzeugen |
| Modell | `PathSegment.Template.FREEHAND` + mehrpunktige `Curve2D` |
| Sampling | ca. 2,5 px Punktabstand, max. 4.000 Punkte pro Segment |
| Bearbeitung | Start-/Endgriff verschieben den jeweiligen Endpunkt, ohne die Kurve zu kollabieren |
| Wiedergabe | Playback, 3D, SVG und PDF nutzen dieselbe Kurve wie Linie/Bogen |
| Persistenz | Schema 6, Vorlagenwert `freehand` |
| Tests | `./tools/test.sh` grün |
## Modell und Zeichnen
- Beim Start legt der Controller ein Segment mit einem Startpunkt an.
- Jede Bewegung wird in Rink-Koordinaten geklemmt und nur übernommen, wenn sie
weit genug vom letzten Punkt entfernt ist. Der Abstand orientiert sich mit
`FREELINE_POINT_STEP_PX` an der aktuellen Zoomstufe.
- Bei `draw_finished` wird der letzte Punkt ergänzt und die Dauer aus Länge und
Timing-Profil aktualisiert. Zu kurze Striche werden wie bei Linie/Bogen
verworfen.
- Start- und Endgriff bearbeiten bei `Template.FREEHAND` den ersten bzw.
letzten Kurvenpunkt direkt. Zusätzlich zeigt der Canvas bis zu 64
gleichmäßig verteilte Zwischenpunkte als kleine Griffe. Ein Drag bewegt den
jeweiligen Kurvenpunkt über einen Detail-Index im Handle-Signal; alle
anderen Punkte bleiben erhalten. Es gibt keinen Bogen-Griff.
- **Glätten:** Der Timing-Button führt zwei Laplacian-Durchgänge auf den
Innenpunkten aus. Start/Ende bleiben fest, die Punktanzahl bleibt gleich,
Länge/Dauer werden neu berechnet und jeder Druck ist undo-fähig.
- **Punktreduktion:** Eine iterative RDP-Reduktion läuft beim Abschluss einer
Freeline automatisch (ca. 1 px Toleranz, in Meter umgerechnet) und über den
Button „Vereinfachen“ für bestehende Segmente. Endpunkte bleiben erhalten;
die Aktion ist undo-fähig.
- Freeline-Segmente sind normale Pfadsegmente: Richtung, Kante, Label, Timing,
Löschen, Undo/Redo, Multi-Auswahl und Sequenzgruppierung funktionieren wie
bei Linie/Bogen.
## Oberfläche
- Neuer Toolbar-Button mit Tooltip „Freeline“. Im kompakten 1024-px-Layout
wurden die übrigen Topbar-Mindestbreiten leicht reduziert, damit die Leiste
weiterhin ohne Umbruch passt.
- Statusleiste zeigt „Freeline“ als Auswahlart und den Zeichenhinweis.
- Das Icon verwendet denselben weißen Strich wie die vorhandenen Werkzeuge.
## Offene Punkte
1. **Toleranz:** Die RDP-Reduktion nutzt einen konservativen Startwert von
etwa einem Bildschirmpixel. Eine einstellbare Stärke (z. B. für besonders
detailreiche Zeichnungen) ist noch offen.
2. **Sehr feine Kurven:** Bei mehr als 64 Punkten zeigt der Editor nur eine
gleichmäßige Auswahl als Griffe; nicht sichtbare Zwischenpunkte lassen
sich nicht direkt greifen.
3. **Druck/Export:** SVG/PDF übernehmen die Kurve; eine gesonderte
Freeline-Legende gibt es nicht.

View file

@ -0,0 +1,62 @@
# Findings – Step Sequences als Elementgruppe (2026-11-10)
## Ergebnis
Schrittsequenzen können jetzt als **ein** Element über mehrere gezeichnete
Teilstrecken laufen. Das ist Option A aus dem Modell-Brainstorm: Die
Elementdaten bleiben am Lead-Segment, die Mitglieder verweisen über eine
gemeinsame `element_group_id` darauf.
| Ziel | Ergebnis |
| :--- | :--- |
| Modell | `PathSegment.element_group_id`; Lead trägt Typ, Kürzel, Level, Features |
| Auflösung | `RoutineSection.get_elements()` liefert `ResolvedElement`-Sichten |
| Wertung | Validator, Adult-Regeln und Basiswert zählen eine Gruppe einmal |
| Darstellung | ein Label pro Gruppe am Gruppenmittelpunkt (Canvas und SVG) |
| PDF | eine Tabellenzeile und ein Rink-Badge pro Element, nicht pro Segment |
| Bedienung | Sequenz-Zeichenmodus und nachträgliches Gruppieren per Mehrfachauswahl |
| Persistenz | Schema 5, additives `element_group_id` |
| Tests | `./tools/test.sh` grün |
## Modell
- `element_group_id` ist auf allen Mitgliedern gleich. Genau ein Segment ist
Lead (`element_type != NONE`); die übrigen sind normale Pfadsegmente ohne
Elementdaten.
- Gruppen sind zusammenhängend und liegen in einer Section. Mehrere Leads,
Lücken, Null-Längen-Mitglieder und Nicht-Sequenz-Typen werden abgelehnt.
- `ResolvedElement` kapselt Lead, Mitglieder, Dauer, Caption, Länge und den
Mittelpunkt der Gruppe. Die Sicht ist ephemär; ein erneutes Auflösen liefert
ein neues Objekt mit derselben `element_id`.
- Alte Dateien ohne Gruppen-ID bleiben gültig: Jedes getaggte Segment ist ein
Einzelelement. Schema 4 → 5 ist rein additiv.
## Bedienung
- Das Sequenz-Symbol startet den Zeichenmodus. Linie/Bogen/Freeline zeichnen
die Teilstrecken; die erste wird Lead. Erneutes Drücken, Esc oder ein
anderes Werkzeug beendet den Bereich.
- Eine bestehende Sequenz am Abschnittsende lässt sich fortsetzen: Mitglied
auswählen, Sequenz-Symbol drücken, weiterzeichnen.
- Ein beliebiges Mitglied öffnet im Element-Dialog immer die Gruppe.
- Lead löschen: Das nächste Mitglied übernimmt die Elementdaten.
- „Kein Element“ löst die Gruppe auf; die Pfadsegmente bleiben erhalten.
- Neue Bereiche starten mit `StSq` und Level Base.
- **Mehrfachauswahl:** Der Knopf im Abschnittsbereich schaltet auf
addierendes Antippen; auf dem Desktop geht auch Shift/Cmd/Ctrl-Klick.
„Sequenz gruppieren (N)“ fasst eine zusammenhängende Auswahl in einem
Undo-Schritt zusammen. Lücken, Marker und bestehende Elemente blockieren
die Aktion.
## Offene Punkte
1. **Teilen/Zusammenführen:** Eine Gruppe kann derzeit nur über Löschen oder
„Kein Element“ verändert werden; ein explizites Teilen fehlt.
2. **Gruppen-Hervorhebung:** Der Canvas markiert beim Auswählen nur das
gewählte Segment, nicht die gesamte Gruppe.
3. **Einzelne Sequenz-Tags zusammenführen:** Bereits separat getaggte
Sequenzen müssen vor dem Gruppieren über „Kein Element“ gelöst werden;
ein automatisches Zusammenführen mit Metadaten-Konfliktlösung fehlt.
4. **Punktmarker:** Sprung/Pirouette bleiben Einzelelemente mit einem
Ankersegment. Eine vollständige `RoutineElement`-Ablage (Option B) ist
weiterhin der langfristige Umbau.

View file

@ -9,12 +9,89 @@ App über den Button **?** in der Statusleiste erreichbar.
1. Kür anlegen oder öffnen.
2. In der Statusleiste die **Adult-Kategorie** wählen (Gold, Silver, Bronze,
Masters, Masters Elite).
3. Elemente aufs Eis setzen: Linie, Bogen oder Element-Marker.
3. Elemente aufs Eis setzen: Linie, Bogen, Freeline oder Element-Marker.
4. Im Element-Dialog **Kürzel**, **Features** und ggf. **Standzeit** festlegen.
5. **Prüfen** öffnen: Prüfliste, Befunde und Punktschätzung ansehen.
6. Optional **3D** in der oberen Leiste öffnen, um die Kür als Vorschau
abzuspielen.
## Laufwege zeichnen
- **Linie** und die beiden **Bogen**-Werkzeuge erzeugen eine gerade Strecke
bzw. einen Kreisbogen zwischen Start- und Endpunkt.
- **Freeline** zeichnet den Weg frei mit der Maus oder dem Finger. Die
Bewegung wird als mehrpunktige Kurve gespeichert; sie bleibt damit auch in
Playback, 3D-Vorschau sowie SVG-/PDF-Export eine echte Freiform.
- Im Auswahlmodus zeigt eine Freeline neben den großen Start-/Endgriffen
kleine weiße Punkte entlang der Kurve. Jeder dieser Punkte lässt sich
ziehen und formt die Freeline nachträglich um; die übrigen Punkte bleiben
erhalten. Bei sehr langen Freelines werden bis zu 64 Punkte als Griffe
angeboten.
- **Glätten** in der Timing-Leiste zeichnet die ausgewählte Freeline weicher.
Ein Druck glättet in zwei Durchgängen; Start- und Endpunkt bleiben fest.
Die Aktion ist undo-fähig und kann mehrfach angewendet werden.
- **Vereinfachen** entfernt überflüssige Zwischenpunkte (Ramer-Douglas-
Peucker) und lässt die Form dabei erhalten. Das passiert beim Abschluss
einer Freeline automatisch mit einer Toleranz von etwa einem Bildschirm-
pixel; für bestehende Freelines gibt es den gleichnamigen Button. Auch
diese Aktion ist undo-fähig.
- Richtung (vorwärts/rückwärts) und Kante (innen/außen) gelten wie bei den
anderen Werkzeugen für das nächste Segment und lassen sich nachträglich
ändern. Dauer und Tempo stehen in der Timing-Leiste.
## Elemente platzieren
Die Werkzeuge **Sprung**, **Pirouette** und **Sequenz** setzen per Tipp einen
Element-Marker. Wo der Marker in der Kür erscheint, entscheidet die gezeichnete
Laufspur:
- Ein Tipp am **Anfang** der Spur setzt das Element an den Abschnittsanfang.
- Ein Tipp **zwischen zwei Segmenten** fügt das Element an dieser Stelle ein.
- Ein Tipp **hinter dem letzten Segment** hängt das Element hinten an.
Mehrere Marker an derselben Stelle behalten die Reihenfolge, in der sie gesetzt
wurden. Der Tipp bestimmt nur die zeitliche Position; der Marker selbst bleibt
an der getippten Stelle auf dem Eis und lässt sich im Auswahlmodus verschieben.
### Schrittsequenzen als Bereich
Eine Schrittsequenz besteht oft aus mehreren Teilstrecken, zählt aber als
**ein** Element mit einem Kürzel, einem Level und einem Basiswert.
- Das **Sequenz-Symbol** in der Werkzeugleiste startet den Sequenz-Zeichenmodus.
- Mit **Linie**, **Bogen** oder **Freeline** werden die Teilstrecken
gezeichnet. Die erste Strecke wird das Lead-Segment, alle weiteren treten
derselben Sequenz bei.
- Erneut **Sequenz** drücken oder ein anderes Werkzeug als Linie/Bogen/
Freeline wählen beendet den Bereich. Neue Strecken danach gehören nicht
mehr dazu.
- Eine bestehende Sequenz lässt sich fortsetzen, solange sie am Abschnittsende
liegt: ein Mitglied auswählen, das Sequenz-Symbol drücken und
weiterzeichnen.
- Klickt man ein beliebiges Mitglied an, öffnet der **Element**-Dialog die
ganze Sequenz. Kürzel, Level und Features gelten einmal für alle Teilstrecken.
- Wird das Lead-Segment gelöscht, übernimmt das nächste Mitglied automatisch
die Elementdaten. **Kein Element** im Dialog löst die Gruppe auf; die
gezeichneten Teilstrecken bleiben erhalten.
- Neue Sequenzbereiche starten mit dem Kürzel `StSq` und Level Base; beides
lässt sich im Element-Dialog ändern.
### Nachträglich gruppieren
Bestehende Teilstrecken lassen sich ohne Neuzeichnen zu einer Sequenz
zusammenfassen:
1. **Mehrfachauswahl** im Abschnittsbereich aktivieren.
2. Die gewünschten Segmente antippen. Erneutes Antippen entfernt ein Segment
wieder aus der Auswahl. Auf dem Desktop funktioniert auch
**Shift/Cmd/Ctrl + Klick** ohne aktivierte Mehrfachauswahl.
3. **Sequenz gruppieren (N)** drücken.
Die Auswahl muss aus mindestens zwei **zusammenhängenden** Pfadsegmenten
bestehen und darf keine bestehenden Elemente oder Sprung-/Pirouettenmarker
enthalten. Nach dem Gruppieren wird das Lead-Segment ausgewählt und die
Mehrfachauswahl beendet. Esc bricht die Mehrfachauswahl ab.
## 3D-Vorschau
Der Button **3D** in der oberen Leiste wechselt in eine schreibgeschützte
@ -69,7 +146,8 @@ Ein Musikstück gehört optional zur Kür. **Musik…** in der Playback-Leiste
öffnet die Dateiauswahl für **MP3** (auch OGG/WAV). Die Datei wird in den
Kür-Ordner kopiert und in der Kür-JSON als Dateiname vermerkt.
- **Start/Pause/Reset** steuern Bild und Musik gemeinsam.
- Die Symbolknöpfe **Start/Pause** (▶/⏸) und **Reset** (⏮) steuern Bild und
Musik gemeinsam; die Tooltips nennen die jeweilige Aktion.
- **Timeline-Scrubbing** setzt auch die Musik an die entsprechende Stelle.
- **Geschwindigkeit** wirkt auf beide: bei 0,5× läuft die Musik langsamer
(und tiefer), bei 2× schneller.
@ -100,8 +178,8 @@ Kür-Ordner kopiert und in der Kür-JSON als Dateiname vermerkt.
Wird in der Abschnittsliste ein anderer Abschnitt gewählt, springen die
Abspielfigur und die Playback-Timeline an den **Anfang dieses Abschnitts**.
Eine laufende Wiedergabe wird dabei angehalten; mit **Start** läuft sie ab
dieser Stelle weiter. Die Position berücksichtigt alle davor liegenden
Eine laufende Wiedergabe wird dabei angehalten; mit dem **Start-Symbol**
läuft sie ab dieser Stelle weiter. Die Position berücksichtigt alle davor liegenden
Abschnitte inklusive Element-Standzeiten.
Während der Wiedergabe markiert ein **▶** den aktuellen Abschnitt in der
@ -115,9 +193,11 @@ und blendet sich innerhalb von zwei Sekunden weich aus.
- **SVG (Vektor):** gesamte Kür oder aktiver Abschnitt als druckbares Blatt.
- **PNG (hochauflösend):** 2560 × 1600 für Tablet-Weitergabe.
- **PDF (Laufwege mit Zeit):** eine Übersichtsseite mit allen Laufwegen und
Abschnittszeiten, danach eine Seite pro Abschnitt. Dort sind die Laufwege
in Reihenfolge nummeriert; die Tabelle nennt Start, Ende, Dauer und
Element/Label. Lange Abschnitte werden auf weiteren Seiten fortgesetzt.
Abschnittszeiten, danach eine Seite pro Abschnitt. Die Zahlen im Rink
nummerieren die **Elemente** in Reihenfolge; die Tabelle hat eine Zeile pro
Element mit Start, Ende, Dauer und Element/Label. Sequenzbereiche nennen
zusätzlich ihre Teilstrecken-Anzahl. Reine Laufwege ohne Element stehen nur
im Rink. Lange Abschnitte werden auf weiteren Seiten fortgesetzt.
Bei „Aktiver Abschnitt“ entsteht nur die Seite dieses Abschnitts.
Nach dem Export erscheint der **absolute Dateipfad** mit den Buttons

View file

@ -20,6 +20,9 @@ Voraussetzung für Phase 1.
- [x] 2D-Rink-Canvas mit Meter→Pixel-Transform, Pan/Zoom und Touch-Pinch
- [x] Linien zeichnen, Richtung und Kante umschalten
- [x] Bogen-/Lobe-Vorlage mit automatischer Abflachung an der Bande
- [x] Freeline-Werkzeug für frei gezeichnete, mehrpunktige Laufwege
- [x] Freeline-Zwischenpunkte bearbeiten, glätten und per RDP reduzieren
- [x] Playback-Steuerung als Icon-Knöpfe (Start/Pause/Reset)
- [x] Auswahl, Start-/Endpunkt-Griffe, Bogen-Griff für Tiefe und Seite
- [x] Richtung/Kante auch nachträglich am ausgewählten Segment ändern
- [x] Segment löschen, Undo/Redo mit Snapshot-Historie
@ -121,6 +124,18 @@ Voraussetzung für Phase 1.
- [x] Tests für Marker-Modell, Interaktion und Export erweitern
- [ ] Optional: Elementkatalog mit Kürzelvorschlägen (Teil des ISU-Regelwerks)
### Erledigt: Step-Sequence-Gruppen (Option A)
- [x] `element_group_id` am Segment, Lead trägt die Elementdaten
- [x] `RoutineSection.get_elements()` / `ResolvedElement` als Auflösungsschicht
- [x] Validator, Adult-Regeln und Basiswert zählen eine Gruppe einmal
- [x] Sequenz-Zeichenmodus und Fortsetzen einer bestehenden Gruppe
- [x] Ein Gruppenlabel in Canvas und SVG
- [x] Schema 5 mit additivem `element_group_id`
- [x] Mehrfachauswahl und nachträgliches Gruppieren in der UI
- [x] PDF-Zeile pro Element statt pro Segment
- [ ] Gruppe teilen/zusammenführen
### In Arbeit: ISU-Regelwerk
- [x] Elementkatalog als strukturierte Daten (JSON/Resources)