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

6.1 KiB
Raw Blame History

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.