- compare size and SHA-256 before copying a track into the routine folder - keep the file the current routine already references when content matches - convert M4A/AAC into a scratch file and dedupe it by content - extend playback tests for repeated loads and same-name variants
16 KiB
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
- Kür anlegen oder öffnen.
- In der Statusleiste die Adult-Kategorie wählen (Gold, Silver, Bronze, Masters, Masters Elite).
- Elemente aufs Eis setzen: Linie, Bogen, Freeline oder Element-Marker.
- Im Element-Dialog Kürzel, Features und ggf. Standzeit festlegen.
- Prüfen öffnen: Prüfliste, Befunde und Punktschätzung ansehen.
- 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
StSqund Level Base; beides lässt sich im Element-Dialog ändern.
Nachträglich gruppieren
Bestehende Teilstrecken lassen sich ohne Neuzeichnen zu einer Sequenz zusammenfassen:
- Mehrfachauswahl im Abschnittsbereich aktivieren.
- 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.
- 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:
./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, OGG und WAV. Auf macOS werden
zusätzlich M4A/AAC angeboten; sie werden beim Import automatisch in ein
PCM-WAV umgewandelt. Das erkennt auch Dateien, die nur falsch als .mp3
benannt sind. Auf anderen Systemen müssen M4A/AAC vorher extern konvertiert
werden. Die Datei wird in den Kür-Ordner kopiert und in der Kür-JSON als
Dateiname vermerkt.
- Kann eine Datei nicht geladen werden, zeigt die Leiste „(nicht abspielbar)“ und einen Tooltip mit den unterstützten Formaten.
- 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.
- Dasselbe Stück kann beliebig oft geladen werden: Ist der Inhalt schon im
Kür-Ordner vorhanden, wird die vorhandene Datei weiterverwendet. Eine
Nummer im Namen (
… 2.mp3) entsteht nur bei echt unterschiedlichem Inhalt gleichen Namens. - 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,CCoSpoderStSq. - 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) undChSp(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+2Twerden 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/ChSpfest 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:
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:
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)