- 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
363 lines
16 KiB
Markdown
363 lines
16 KiB
Markdown
# Rinkplanner – Anleitung und Annahmen
|
||
|
||
Diese Anleitung erklärt die wichtigsten Begriffe und die Annahmen, die die
|
||
App für Prüfung und Punktschätzung verwendet. Dieselbe Erklärung ist in der
|
||
App über den Button **?** in der Statusleiste erreichbar.
|
||
|
||
## Schnellstart
|
||
|
||
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, 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
|
||
3D-Ansicht. Die 2D-Bearbeitung bleibt unverändert; beim Zurückwechseln steht
|
||
der bisherige Bearbeitungsstand wieder da.
|
||
|
||
- **Playback geteilt:** Start/Pause, Reset, Timeline und Geschwindigkeit
|
||
wirken auf den 2D-Marker und den 3D-Skater gleichzeitig.
|
||
- **Kamera:** Der Button „Kamera: Folge" wechselt zwischen der
|
||
Folgekamera und der Übersicht (ganzes Rink). Die Folgekamera orientiert
|
||
sich an der **Fahrtrichtung**: vorwärts sieht man den Rücken, rückwärts
|
||
bleibt sie auf derselben Bahnseite und zeigt die Läuferin von vorn.
|
||
- **Kufenspur:** Zwei verblassende Spuren an den Kufen zeigen die
|
||
Fahrtrichtung: **türkis = vorwärts**, **orange = rückwärts**. Beim
|
||
Pausieren bleibt die Spur stehen; am Kür-Ende, wenn die Wiedergabe
|
||
stoppt, läuft sie in Echtzeit aus. Bei Sprüngen, Scrubben oder einem
|
||
Sprung in der Zeit wird sie zurückgesetzt. Die Legende steht oben links
|
||
im 3D-Bild.
|
||
- **Zurück:** erneut **2D** drücken oder **Esc**.
|
||
- **Statusleiste:** zeigt im 3D-Modus den Hinweis „Esc: 2D" und die aktive
|
||
Kamera.
|
||
- **Inhalt:** Rink mit Bande, Mittelkreis und Mittellinie; der Skater fährt
|
||
dieselben `Curve2D`-Bahnen wie der 2D-Marker, inklusive Blickrichtung und
|
||
Standzeiten.
|
||
|
||
Die 3D-Ansicht ist eine Präsentationsschicht, kein Editor. Elemente werden
|
||
weiterhin ausschließlich in 2D gesetzt und bearbeitet.
|
||
|
||
### Voraussetzungen
|
||
|
||
Die 3D-Ansicht lädt die Skater-GLB über das Asset-Manifest aus
|
||
`assets/external/`. Auf einem frischen Checkout zuerst:
|
||
|
||
```bash
|
||
./tools/sync_assets.sh --sync
|
||
```
|
||
|
||
Fehlt die Datei, zeigt die Vorschau einen Platzhalter aus Kapsel und Kopf;
|
||
die 2D-Funktionen sind davon nicht betroffen.
|
||
|
||
### Aktuelle Grenzen
|
||
|
||
- Der Skater spielt den 2s-Clip `Glide`. Sprünge, Pirouetten und Kantenwechsel
|
||
haben noch keine eigenen Animationen.
|
||
- Die Folgekamera schaut von hinten; eine frei drehbare Kamera gibt es noch
|
||
nicht.
|
||
- Es gibt keine Bearbeitung und keine Auswahl in 3D.
|
||
|
||
## Musik
|
||
|
||
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.
|
||
|
||
- 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.
|
||
- **×** entfernt die Musik aus der Kür, löscht die Datei aber nicht. So
|
||
bleibt sie für andere Kürdateien erhalten.
|
||
- Beim **Sync** wird die Musikdatei wie die Kür-JSON hoch- und
|
||
heruntergeladen. Fehlt sie auf einem Gerät, zeigt die Leiste
|
||
„(fehlt)“; nach dem nächsten Sync ist sie verfügbar.
|
||
|
||
## Timeline-Labels
|
||
|
||
Über der Playback-Timeline liegt eine Label-Spur:
|
||
|
||
- **Kür-Labels:** Segmente mit eigener Beschriftung erscheinen schräg an
|
||
ihrem Startzeitpunkt (blau). Elemente ohne Freitext zeigen ihr Kürzel
|
||
(z. B. `1Lz`, `CCoSp`, `StSq`); auch Elemente mit 0 s Standzeit bleiben
|
||
sichtbar.
|
||
- **Eigene Labels:** Ein Klick in eine freie Stelle der Spur legt ein Label
|
||
an diesem Zeitpunkt an; der Text wird im Dialog eingegeben.
|
||
- **Bearbeiten:** Ein Klick auf ein goldenes eigenes Label öffnet den Dialog
|
||
erneut. Dort lässt es sich umbenennen oder löschen.
|
||
- **Zeit-Tooltip:** Beim Überfahren eines Element-Labels zeigt ein Tooltip
|
||
dessen Zeitpunkt im Track, z. B. `1A · 12,3 s`.
|
||
- Labels gehören zur Kür, werden mitgespeichert und über Undo/Redo sowie den
|
||
Sync mitgeführt.
|
||
|
||
## Abschnittswechsel und Playback
|
||
|
||
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 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
|
||
Liste rechts. Der Name des Abschnitts erscheint kurz oben auf der Eisfläche
|
||
und blendet sich innerhalb von zwei Sekunden weich aus.
|
||
|
||
## Export
|
||
|
||
**Datei → Exportieren…** schreibt nach `user://exports/`. Zur Wahl stehen:
|
||
|
||
- **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. 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
|
||
**Öffnen**, **Ordner anzeigen** und **Pfad kopieren**. Die Option
|
||
**„Nach dem Export mit dem Standardprogramm öffnen“** ist standardmäßig
|
||
aktiv; damit startet z. B. das PDF direkt im PDF-Betrachter. Über
|
||
**Datei → Exportordner öffnen** erreicht man den Ordner auch später.
|
||
|
||
## Kürzel und Base Value
|
||
|
||
- Das **Kürzel** bezeichnet die Elementfamilie, z. B. `3Lz`, `CCoSp` oder
|
||
`StSq`.
|
||
- Der **Level** ist die Schwierigkeitsstufe. Bei Pirouetten und
|
||
Schrittsequenzen folgt er aus den Features.
|
||
- Der **Base Value** wird aus Kürzel und Level im Saisonkatalog 2026/27
|
||
nachgeschlagen (ISU Communication 2786).
|
||
- **Sprünge** haben keinen Level; ihr Base Value hängt von Rotation und
|
||
Sprungtyp ab.
|
||
- **`ChSq`** (Choreo-Sequenz) und **`ChSp`** (Choreographic Spin) sind fest
|
||
Level 1.
|
||
- Unbekannte Freitext-Codes haben keinen Katalogwert und werden in der
|
||
Schätzung nicht gewertet.
|
||
|
||
Der Katalog wird jährlich ersetzt. Die Daten liegen unter
|
||
`rinkplanner/src/core/rules/data/` und tragen Saison, Quelle und
|
||
Gültigkeitsdatum.
|
||
|
||
## Sprungkombinationen
|
||
|
||
Sprungkombinationen und -folgen sind strukturiert:
|
||
|
||
- Das **Kürzel** ist der erste Sprung, z. B. `3Lz`.
|
||
- Über **Sprungkombination** im Element-Dialog werden Art und weitere Sprünge
|
||
gewählt:
|
||
- **Einzelsprung** – keine weiteren Sprünge
|
||
- **Kombination** – bis zu zwei weitere Sprünge, z. B. `3Lz+2T`
|
||
- **Folge (SEQ)** – bis zu zwei weitere Sprünge, Anzeige mit `+SEQ`
|
||
- Die Base Values der einzelnen Sprünge werden summiert.
|
||
- Eine **Folge** braucht einen Axel (1A/2A/3A) als zweiten oder dritten
|
||
Sprung; der Dialog zeigt einen entsprechenden Hinweis.
|
||
- Wiederholungen und Kombinationsgrenzen werden anhand der strukturierten
|
||
Teile geprüft, nicht mehr aus dem Kürzeltext geraten.
|
||
- Alte Freitext-Kürzel wie `3Lz+2T` werden weiterhin als Fallback gelesen und
|
||
beim Laden oder Übernehmen automatisch in die strukturierte Form überführt.
|
||
|
||
## Level aus Features
|
||
|
||
Für Pirouetten und Schrittsequenzen gilt:
|
||
|
||
| Anzahl Features | Level |
|
||
| :--- | :--- |
|
||
| 0 | Base |
|
||
| 1 | Level 1 |
|
||
| 2 | Level 2 |
|
||
| 3 | Level 3 |
|
||
| 4 oder mehr | Level 4 |
|
||
|
||
- **Pirouetten:** 15 Features (2026/27). Maximal zwei schwierige Variationen
|
||
zählen pro Pirouette. Für Level 4 ist zusätzlich eines dieser Features
|
||
nötig: schwieriger Ausgang, klare Kantenänderung, beide Richtungen, klare
|
||
Temposteigerung, schwieriger Flug-Eingang oder **Windmills**.
|
||
- **Schrittsequenzen:** 5 Features. Feature 1 (Vielfalt schwieriger Schritte
|
||
und Drehungen) ist Pflicht.
|
||
- Features beschreiben die **Ausführung**. Die App kann sie nicht aus der
|
||
gezeichneten Linie ableiten; sie werden im Element-Dialog ausgewählt.
|
||
- Bei Katalog-Elementen ist der Level-Regler read-only. Der Level folgt aus
|
||
den Features; Springe sind Base, `ChSq`/`ChSp` fest Level 1.
|
||
|
||
## Adult-Kategorien
|
||
|
||
Die Kategorie wird in der Statusleiste gewählt und mit der Kür gespeichert.
|
||
|
||
| | Gold | Silver | Bronze |
|
||
| :--- | :--- | :--- | :--- |
|
||
| Dauer | 2:50 ±10 s | 2:00 ±10 s | 1:40 ±10 s |
|
||
| Sprünge | max. 5 | max. 4 | max. 4 |
|
||
| Erlaubt | Einfach/Double, ohne 2F/2Lz/2A/Triple | nur Einfach inkl. 1A | nur Einfach ohne Axel |
|
||
| Pirouetten | max. 3, inkl. `ChSp` | max. 2 | max. 2 |
|
||
| Sequenz | 1 Schrittsequenz | 1 `ChSq` | 1 `ChSq` |
|
||
| Level-Cap | Spins 3 / Sequenz 2 | 2 / 2 | 1 / 1 |
|
||
| PCS-Faktor | 2,67 | 2,00 | 2,00 |
|
||
| Sturzabzug | 1,0 | 0,5 außerhalb Elemente | 0,5 außerhalb Elemente |
|
||
|
||
Masters und Masters Elite sind ebenfalls wählbar. Grundlage ist das IAFSC
|
||
Technical Announcement 2026/27; es hat bei Konflikten Vorrang vor allgemeinen
|
||
ISU-Regeln.
|
||
|
||
## Prüfung
|
||
|
||
Der Button **Prüfen** zeigt:
|
||
|
||
- Kürzel im Katalog, Elementtyp und Level
|
||
- Feature-Auswahl, Pflichtfeatures und Level aus Features
|
||
- Einmal-pro-Programm-Features
|
||
- bei Kategorie: Sprunganzahl, erlaubte Sprünge, Pirouetten, Sequenzen,
|
||
Level-Grenzen, Pflichtelemente, Dauer, Wiederholungen und Kombinationen
|
||
- Basiswert, PCS-Annahme, Sturzabzug und geschätzte Summe
|
||
|
||
Nicht anwendbare Prüfungen nennen den Grund, z. B. „nicht anwendbar (keine
|
||
Features gesetzt)“. Warnungen blockieren Speichern und Export nicht.
|
||
|
||
## Punktschätzung und Annahmen
|
||
|
||
Die Schätzung besteht aus drei Teilen:
|
||
|
||
```text
|
||
Basiswert = Summe der Base Values
|
||
PCS-Annahme = Durchschnitt × 3 Komponenten × Kategorie-Faktor
|
||
Sturzabzug = Anzahl Stürze × Kategorie-Abzug
|
||
Geschätzte Summe = Basiswert + PCS-Annahme - Sturzabzug
|
||
```
|
||
|
||
### PCS-Annahme
|
||
|
||
PCS steht für **Program Component Score**. Im ISU-System bewerten die Judges
|
||
drei Komponenten:
|
||
|
||
- **Composition** – Aufbau, Muster, Musikbezug
|
||
- **Presentation** – Ausdruck, Energie, Musikalität
|
||
- **Skating Skills** – Kanten, Schritte, Kontrolle, Flow
|
||
|
||
Jede Komponente wird mit 0,25 bis 10,00 bewertet. Die drei Werte werden
|
||
summiert und mit dem Kategorie-Faktor multipliziert.
|
||
|
||
Die App kennt keine echten Judge-Werte und arbeitet deshalb mit **einem
|
||
Durchschnitt pro Komponente** (Startwert **5,00**). Das ist eine
|
||
Planungsannahme, kein Regelwert. Über **ⓘ Annahmen ändern** im Prüfdialog
|
||
lassen sich Durchschnitt und Sturzzahl anpassen; beides wird mit der Kür
|
||
gespeichert.
|
||
|
||
Beispiel Gold:
|
||
|
||
```text
|
||
5,00 × 3 × 2,67 = 40,05 PCS
|
||
Basiswert 9,50
|
||
Geschätzte Summe 49,55
|
||
```
|
||
|
||
### Was nicht enthalten ist
|
||
|
||
- **GOE** (Ausführungsqualität der Judges)
|
||
- **1,1-Faktor** für die zweite Programmhälfte
|
||
- nicht katalogisierte Kombinationen/Varianten
|
||
- die offizielle Wettkampfwertung
|
||
|
||
Die Schätzung ist eine Planungshilfe, keine vorhergesagte Punktzahl. Für eine
|
||
realistische PCS-Annahme helfen Protokolle früherer Wettkämpfe; der
|
||
Durchschnitt sollte zum aktuellen Leistungsstand passen, nicht zum Wunschziel.
|
||
|
||
## Grenzen
|
||
|
||
- Features und PCS sind Eingaben, keine Messungen aus der Zeichnung.
|
||
- Alte Freitext-Kombinationen werden beim Laden/Übernehmen migriert; nicht
|
||
parsebare Sonderfälle bleiben als Text erhalten.
|
||
- Max. zwei Features pro Fuß und Feature-Positionsregeln sind offen.
|
||
- Adult-spezifische Sonderfälle außerhalb des Announcements 2026/27 sind
|
||
nicht abgebildet.
|
||
|
||
## Quellen
|
||
|
||
- ISU Communication No. 2786 – Scale of Values 2026/27
|
||
- ISU Communication No. 2788 – Levels of Difficulty / GOE 2026/27
|
||
- IAFSC Technical Announcement 2026/27 (Adult-Wettbewerbe, Oberstdorf 2027)
|