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

103 lines
5 KiB
Markdown
Raw 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` 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.