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
This commit is contained in:
torsten 2026-10-30 23:48:47 +01:00
parent 5968272691
commit 6eca94e6db
11 changed files with 359 additions and 37 deletions

View file

@ -72,7 +72,8 @@ Ein Segment mit Länge braucht eine positive Dauer. Ein reiner Element-Marker
(Länge 0, z. B. Sprungpunkt) darf Dauer 0 haben und wird über `is_marker()`
erkannt. Seit der Element-Marker-Session trägt das Segment zusätzlich
`element_type` (Sprung, Pirouette, Sequenz), `element_code` (Kürzel, max.
24 Zeichen) und `element_level` (0 = Base, 1–4). Ein Punktmarker ist ein
24 Zeichen), `element_level` (0 = Base, 1–4) und `element_duration_seconds`
(Standzeit, nur Punktmarker). Ein Punktmarker ist ein
Segment mit einer Ein-Punkt-Kurve, `is_element_marker()` ist wahr. Eine
Sequenz als Bereich bleibt ein normales Segment mit Länge und wird nur
getaggt; `element_id` bleibt für die spätere Regelwerk-Referenz reserviert.
@ -136,7 +137,9 @@ eine Abkürzung. So kann die UI Fehler konkret anzeigen.
„Element“ öffnet den Inspector für Typ, Kürzel und Level. Im
Auswahlmodus lässt sich der Marker über seinen Griff verschieben. Sequenz-
Bereiche entstehen, indem ein gezeichnetes Segment über den Inspector
getaggt wird. Marker zählen nicht zur Playback-Zeit. Die Timing-Details
getaggt wird. Punktmarker haben eine **Standzeit** (`element_duration_seconds`)
mit Typ-Defaults (Sprung 0,7 s, Pirouette 8 s, Sequenz 0 s), die im
Inspector übersteuert wird und in die Timeline eingeht. Die Timing-Details
(Dauer/Tempo/Profil) werden beim Setzen und für Punktmarker ausgeblendet,
damit die Leiste auch im Landscape kompakt bleibt.
- **Section-Verwaltung:** Ein Panel rechts zeigt die chronologische
@ -158,10 +161,13 @@ eine Abkürzung. So kann die UI Fehler konkret anzeigen.
kontinuierlich per Bogenlängen-Sampling (`sample_baked()`). Die Blickrichtung
folgt der Kurventangente; bei Rückwärts-Segmenten wird sie um 180° gedreht,
sodass die Bewegung entlang des Pfades und die Körperrichtung getrennt
sichtbar sind. Während des Playbacks wird die aktuelle Section hervorgehoben,
sichtbar sind. Punktmarker halten die Ankunftsrichtung, Pirouetten drehen
den Marker während der Standzeit mit 1,5 Umdrehungen pro Sekunde. Während
des Playbacks wird die aktuelle Section hervorgehoben,
ohne die Bearbeitungs-Section zu wechseln. Steuerung: Play/Pause, Reset,
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Die Dauer kommt aus dem
Segment-Timing (Default Adult Gold, 4,3 m/s). Nicht verbundene Segmente
Segment-Timing (Default Adult Gold, 4,3 m/s) bzw. bei Punktmarkern aus der
Element-Standzeit. Nicht verbundene Segmente
führen zu einem Sprung des Markers an den Start des nächsten Segments.
- **Geschwindigkeitsannahmen:** Die belastbaren Referenzwerte, Level-Profile
und Kalibrierung stehen in `docs/speed-assumptions.md`.
@ -280,24 +286,25 @@ Headless, ohne Editor und ohne Display:
Aktueller Stand:
- **Model:** 74 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Timing-Modi, Template-Metadaten, Element-Marker samt Kürzel-/Level-Grenzen,
- **Model:** 81 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Timing-Modi, Template-Metadaten, Element-Marker samt Kürzel-/Level-/Dauer-Grenzen,
Schema-Version, Section-Aggregation und Routine-Validierung.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Whiteboard:** 193 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 201 Assertions für Controller-Verdrahtung, Segmenterzeugung,
Linien-/Bogenpfade, Klemmen an der Bande, Auswahl, Griff- und
Richtungs-/Kanten-Bearbeitung, Segmentlöschung, Element-Marker (Setzen,
Typwechsel, Inspector, Verschieben, Löschen), Section-Verwaltung,
Typwechsel, Inspector inkl. Standzeit, Verschieben, Löschen), Section-Verwaltung,
Ghosting-Zustand, Segment-Labels inklusive Dialog und Sichtbarkeits-Schalter,
Speichern/Laden, Schema-Prüfung, Dirty-State,
Navigationsmodus und den Maus-Drag-Pfad.
- **History:** 53 Assertions für Undo/Redo von Segmenten, Kanten, Labels, Sections,
Zeichengesten und Griff-Bearbeitung, Toolbar-Buttons, Erhalt der Ansicht
sowie das Zurücksetzen der Historie.
- **Playback:** 38 Assertions für Dauer/Timeline, Vorwärts-/Rückwärts-
- **Playback:** 45 Assertions für Dauer/Timeline, Vorwärts-/Rückwärts-
Blickrichtung, Section-Hervorhebung, Play/Pause/Reset inklusive
Button-Verdrahtung, Scrubbing und Geschwindigkeitswechsel.
Button-Verdrahtung, Scrubbing, Geschwindigkeitswechsel, Standzeiten von
Elementen und die Rotation des Markers in einer Pirouette.
- **Timing:** 41 Assertions für Dauer-/Tempo-Kopplung, Level-Presets,
Kalibrierung, Undo, Persistenz und Schema-1-Migration.
- **Export:** 26 Assertions für SVG-Struktur, Titel-Escaping, Segment-Labels,

View file

@ -9,12 +9,12 @@ Bedienung und des Exports.
| Ziel | Ergebnis |
| :--- | :--- |
| Marker-Modell | `element_type`, `element_code`, `element_level` am Segment |
| 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 | 577 Assertions, `./tools/test.sh` grün |
| Tests | 599 Assertions, `./tools/test.sh` grün |
## Modellentscheidung
@ -27,6 +27,9 @@ bestehende Entscheidung D3, erweitert:
- `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
@ -63,7 +66,14 @@ Elementtyp sind Fehler. `set_element()` trimmt, kürzt und klemmt die Werte;
- 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.
- Marker erzeugen keine Playback-Zeit; die Timeline ignoriert Dauer 0 bereits.
- 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
@ -78,14 +88,18 @@ Elementtyp sind Fehler. `set_element()` trimmt, kürzt und klemmt die Werte;
Neu bzw. erweitert:
- **Model (74):** Punktmarker, Typen, Kürzel-Trimmen/-Kürzen, Level-Klemmen,
Caption-Bildung, Tag-löschen, Kürzel ohne Typ als Fehler.
- **Whiteboard (193):** Setzen per Maus, Typwechsel, Inspector-Dialog,
Griff-Drag, Undo/Redo, Löschen über „Kein Element“, Tagging und Entfernen
von Sequenzbereichen, Persistenz der Elementfelder, Marker zählen nicht zur
Playback-Zeit.
- **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.
- **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.
@ -101,3 +115,6 @@ Visuell geprüft über `tests/manual/capture_elements.gd` (normal, `dialog`,
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.

View file

@ -102,6 +102,8 @@ Voraussetzung für Phase 1.
- [x] Entscheidung: Marker als Segment mit Ein-Punkt-Kurve und
`element_type`/`element_code`/`element_level` (D3), Sequenzbereiche als
getaggte Segmente
- [x] Standzeit je Typ (Sprung 0,7 s, Pirouette 8 s) mit Inspector-Override
- [x] Pirouetten-Dot rotiert während der Standzeit
- [x] Tests für Marker-Modell, Interaktion und Export erweitern
- [ ] Optional: Elementkatalog mit Kürzelvorschlägen (Teil des ISU-Regelwerks)