# 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 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. ## 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 (hinten/seitlich versetzt) und der Übersicht (ganzes Rink). - **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. ## 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)