2026-10-30 23:38:57 +01:00
|
|
|
|
# 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 |
|
|
|
|
|
|
| :--- | :--- |
|
2026-10-30 23:48:47 +01:00
|
|
|
|
| Marker-Modell | `element_type`, `element_code`, `element_level`, `element_duration_seconds` |
|
2026-10-30 23:38:57 +01:00
|
|
|
|
| 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 |
|
2026-10-30 23:48:47 +01:00
|
|
|
|
| Tests | 599 Assertions, `./tools/test.sh` grün |
|
2026-10-30 23:38:57 +01:00
|
|
|
|
|
|
|
|
|
|
## 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.
|
2026-10-30 23:48:47 +01:00
|
|
|
|
- `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.
|
2026-10-30 23:38:57 +01:00
|
|
|
|
- `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.
|
2026-10-30 23:48:47 +01:00
|
|
|
|
- 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.
|
2026-10-30 23:38:57 +01:00
|
|
|
|
|
|
|
|
|
|
## 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:
|
|
|
|
|
|
|
2026-10-30 23:48:47 +01:00
|
|
|
|
- **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.
|
2026-10-30 23:38:57 +01:00
|
|
|
|
- **Export (26):** Marker-Gruppen, Kürzel mit Level, Form, Abschnittsfilter.
|
2026-10-30 23:48:47 +01:00
|
|
|
|
- **Touch (28):** Ein Tipp setzt einen Marker und selektiert ihn, ein Tipp auf
|
|
|
|
|
|
den Marker wählt ihn ohne Undo-Eintrag aus.
|
2026-10-30 23:38:57 +01:00
|
|
|
|
|
|
|
|
|
|
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.
|
2026-10-30 23:48:47 +01:00
|
|
|
|
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.
|