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

@ -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