rinkplanner/docs/manual.md
torsten a8c5e61faf feat: Folgekamera folgt der Fahrtrichtung
- Kamera nutzt die Bahn-Tangente statt des Koerper-Yaw
- Rueckwaerts bleibt sie auf der Bahnseite und zeigt die Laeuferin von vorn
- Element-Marker behalten die letzte Fahrtrichtung
- 61 Praesentations-Assertions (1193 gesamt)
2026-10-31 15:43:14 +01:00

220 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 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.
## 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)