rinkplanner/docs/findings-2026-10-30-element-marker.md
torsten 6eca94e6db feat: Element-Standzeit und rotierender Pirouetten-Dot
- PathSegment.element_duration_seconds (0-120 s) fuer Punktmarker
- Typ-Defaults: Sprung 0,7 s, Pirouette 8 s, im Inspector uebersteuerbar
- Section- und Routine-Dauer sowie Timeline enthalten die Standzeiten
- Playback haelt am Marker; Pirouette dreht den Dot mit 1,5 U/s
- Tests: 599 Assertions gruen; Doku aktualisiert
2026-10-30 23:48:47 +01:00

120 lines
6.1 KiB
Markdown
Raw Permalink 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.

# Findings – Session: Element-Marker (2026-10-30)
Ergänzung zu `docs/findings-2026-10-30.md` (Tablet-/Build-/Sync-Session).
Diese Session hat die erste offene Phase-1-Lücke geschlossen: Sprungpunkte,
Pirouettenzentren und Sequenzbereiche sind jetzt Teil des Modells, der
Bedienung und des Exports.
## Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Marker-Modell | `element_type`, `element_code`, `element_level`, `element_duration_seconds` |
| Platzieren | Werkzeug „Element“, ein Tipp setzt einen Punktmarker |
| Bearbeiten | Inspector (Typ, Kürzel, Level), Verschieben per Griff |
| Darstellung | Typform + Kürzel auf Canvas, Ghosting und Präsentation |
| Export | SVG-Gruppe `element-marker`, PNG über die Export-Szene |
| Tests | 599 Assertions, `./tools/test.sh` grün |
## Modellentscheidung
Die Roadmap ließ „eigenes Markerobjekt oder Segment“ offen. Umgesetzt ist die
bestehende Entscheidung D3, erweitert:
- Ein Punktmarker ist ein `PathSegment` mit **Ein-Punkt-Kurve**. `is_marker()`
bleibt die geometrische Prüfung (Länge 0), `is_element_marker()` verlangt
zusätzlich einen Elementtyp.
- `element_type`: `NONE`, `JUMP`, `SPIN`, `SEQUENCE`.
- `element_code`: Freitext-Kürzel, getrimmt, max. 24 Zeichen.
- `element_level`: 0 = Base, 1–4; nur für Pirouetten und Sequenzen im Kürzel.
- `element_duration_seconds`: Standzeit eines Punktmarkers (0–120 s). Sie ist
unabhängig von der Geometrie und geht als Timeline-Zeit ein. Sequenzbereiche
nutzen weiterhin `duration_seconds` des Pfades.
- `element_id` bleibt unangetastet und ist für die spätere Referenz auf den
ISU-Elementkatalog reserviert.
- Eine **Sequenz als Bereich** ist kein Punktmarker, sondern ein normales
Segment mit Länge, das über den Inspector getaggt wird.
Validierung: Level außerhalb 0–4, zu lange Kürzel und ein Kürzel ohne
Elementtyp sind Fehler. `set_element()` trimmt, kürzt und klemmt die Werte;
`set_element(NONE, …)` leert Kürzel und Level.
## Bedienung
- Neues Werkzeug „Element“ in der Werkzeugliste. Ein Tipp innerhalb der Bande
setzt einen Marker des zuletzt gewählten Typs; der Marker wird direkt
ausgewählt. Tipps außerhalb der Eisfläche pannen wie gewohnt.
- Die Timing-Leiste zeigt im Element-Modus nur die relevanten Regler
(Label, Element, Typ, Labels). Dauer-/Tempo-/Profilregler werden
ausgeblendet, ebenso bei Auswahl eines Punktmarkers. Dadurch bleibt die
Leiste bei 1024, 1317 und 1400 px auf einer Zeile.
- Typwechsel über das Optionsfeld wirkt auf die nächste Platzierung und – bei
Auswahl – sofort auf das markierte Segment (mit Undo).
- Inspector-Dialog „Element“: Typ (inkl. „Kein Element“), Kürzel, Level.
„Kein Element“ entfernt bei einem Sequenzbereich nur den Tag; ein reiner
Punktmarker wird gelöscht, weil er ohne Element keine Bedeutung hat.
- Im Auswahlmodus hat ein Marker genau einen Griff; Ziehen verschiebt den
Punkt und wird als ein Undo-Schritt verbucht.
## Darstellung
- Sprung: Raute (bernstein), Pirouette: Kreis (violett), Sequenz: Quadrat
(grün), jeweils mit dunkler Kontur; Auswahl erhält einen hellen Halo.
- Kürzel steht in einer dunklen Pille über der Form, z. B. `3Lz` oder
`CCoSp4 L3`. Der Schalter „Labels“ blendet die Kürzel aus; die Form bleibt
sichtbar, damit Marker nicht unsichtbar werden.
- Sequenzbereiche zeigen ihr Kürzel wie ein Label am Segmentmittelpunkt, wenn
kein Freitext-Label gesetzt ist.
- Ghost-Sections zeichnen Marker mit 20 % Deckkraft, aber ohne Kürzel.
- Punktmarker haben eine **Standzeit**: Sprung 0,7 s, Pirouette 8 s, Sequenz 0 s
als Default. Sie wird beim Platzieren gesetzt, im Inspector übersteuert und
bei einem Typwechsel auf den Typ-Default zurückgesetzt.
- In der Timeline hält der Punkt während der Standzeit an. Bei einer Pirouette
dreht sich die Blickrichtung mit 1,5 Umdrehungen pro Sekunde; Sprünge und
Sequenzpunkte behalten die Ankunftsrichtung des vorherigen Pfades.
- `Routine`/`Section` summieren die effektive Dauer, damit Programmdauer,
Statusleiste und Export die Standzeiten enthalten.
## Export
- SVG: pro Marker eine Gruppe `<g class="element-marker" data-element="…">`
mit Typform und Kürzel (weiße Kontur über `paint-order="stroke"`), gefiltert
nach dem gewählten Abschnitt.
- PNG: läuft über die vorhandene Export-Szene und zeigt Marker, Kürzel und
Sequenz-Tags automatisch mit.
- Ein Abschnittsexport enthält nur die Marker des gewählten Abschnitts.
## Tests
Neu bzw. erweitert:
- **Model (81):** Punktmarker, Typen, Kürzel-Trimmen/-Kürzen, Level-Klemmen,
Standzeit-Klemmen und -Grenzen, effektive Dauer, Caption-Bildung,
Tag-löschen, Kürzel ohne Typ als Fehler.
- **Whiteboard (201):** Setzen per Maus, Typwechsel, Inspector-Dialog inkl.
Standzeit, Griff-Drag, Undo/Redo, Löschen über „Kein Element“, Tagging und
Entfernen von Sequenzbereichen, Persistenz der Elementfelder, Standzeit in
der Programmdauer.
- **Playback (45):** Standzeit im Timeline-Verlauf, Halten am Sprung-Marker und
Rotation des Dots in der Pirouette.
- **Export (26):** Marker-Gruppen, Kürzel mit Level, Form, Abschnittsfilter.
- **Touch (28):** Ein Tipp setzt einen Marker und selektiert ihn, ein Tipp auf
den Marker wählt ihn ohne Undo-Eintrag aus.
Visuell geprüft über `tests/manual/capture_elements.gd` (normal, `dialog`,
`place`) bei 1024 × 768, 1317 × 824 und 1400 × 876 sowie im PNG-Export.
## Offene Punkte
1. **Elementkatalog:** Kürzel sind Freitext. Vorschläge, Base Values und
Feature-Prüfung kommen mit dem ISU-Regelwerk; `element_id` ist der
Anknüpfungspunkt.
2. **Sequenzbereiche:** Sie werden getaggt, aber (noch) nicht anders als
normale Pfade gezeichnet. Eine eigene Bereichsmarkierung kann folgen.
3. **Marker-Overlap:** Bei dicht beieinanderliegenden Markern überlappen die
Kürzel-Pillen. Eine Kollisionsvermeidung ist bewusst offen.
4. **Level bei Sprüngen:** Das Modell erlaubt Level 0–4 für alle Typen; die
Caption zeigt Level nur bei Pirouetten und Sequenzen.
5. **Standzeit-Defaults:** 0,7 s bzw. 8 s sind plausible Startwerte, aber
nicht regelbasiert. Mit dem ISU-Katalog können sie aus Element und Level
abgeleitet werden; die Rotationsrate (1,5 U/s) ist ebenfalls eine Annahme.