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