rinkplanner/docs/findings-2026-10-30-element-marker.md
torsten 5968272691 feat: Element-Marker mit Inspector und Export
- PathSegment traegt element_type/element_code/element_level (D3)
- Element-Werkzeug setzt Punktmarker per Tipp; Inspector fuer Typ,
  Kuerzel und Level; Marker per Griff verschiebbar
- Darstellung auf Canvas und in Praesentation inkl. Ghosting,
  Labels-Schalter blendet Kuerzel aus
- Sequenzbereiche sind getaggte Segmente, Tag ueber Inspector setzbar
- SVG/PNG-Export mit Typform und Kuerzel
- Timing-Leiste blendet irrelevante Regler im Element-Modus aus
- Griff-Drag beginnt erst mit der ersten Bewegung (kein Undo bei Tipp)
- Tests: 577 Assertions gruen; Findings, Architektur und Roadmap aktuell
2026-10-30 23:38:57 +01:00

5 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 am Segment
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

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_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.
  • Marker erzeugen keine Playback-Zeit; die Timeline ignoriert Dauer 0 bereits.

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 (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.
  • Export (26): Marker-Gruppen, Kürzel mit Level, Form, Abschnittsfilter.
  • Touch (28): Ein Tipp setzt einen Marker und selektiert ihn.

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.