- 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
5 KiB
5 KiB
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
PathSegmentmit 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_idbleibt 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.
3LzoderCCoSp4 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 überpaint-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
- Elementkatalog: Kürzel sind Freitext. Vorschläge, Base Values und
Feature-Prüfung kommen mit dem ISU-Regelwerk;
element_idist der Anknüpfungspunkt. - Sequenzbereiche: Sie werden getaggt, aber (noch) nicht anders als normale Pfade gezeichnet. Eine eigene Bereichsmarkierung kann folgen.
- Marker-Overlap: Bei dicht beieinanderliegenden Markern überlappen die Kürzel-Pillen. Eine Kollisionsvermeidung ist bewusst offen.
- Level bei Sprüngen: Das Modell erlaubt Level 0–4 für alle Typen; die Caption zeigt Level nur bei Pirouetten und Sequenzen.