rinkplanner/docs/manual.md
torsten e79fa9635b feat: Kufenspur blendet am Kuer-Ende aus
- Trail-Fade in Echtzeit, wenn die Wiedergabe endet und die Figur steht
- Pausieren mitten in der Kuer laesst die Spur weiterhin stehen
- Controller synchronisiert den Fade bei Play/Pause/Seek/Ende
- 57 Praesentations-Assertions (1186 gesamt)
2026-10-31 14:46:54 +01:00

8.4 KiB
Raw Blame History

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:

./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:

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)