rinkplanner/docs/findings-2026-11-10-freeline.md
torsten 55e7b163b5 feat: add step-sequence groups, freehand editing and element PDF
- group contiguous path segments into one sequence element with shared group IDs
- resolve elements centrally and score/adult-count groups once
- add freehand tool with point editing, smoothing and RDP reduction
- render one PDF table row and badge per element instead of per segment
- turn playback start/pause/reset into icon buttons
- add multi-select grouping and extend tests/documentation
2026-11-10 15:50:03 +01:00

61 lines
3.1 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 – Freeline-Werkzeug (2026-11-10)
## Ergebnis
Die Werkzeugleiste hat ein neues **Freeline**-Werkzeug. Es zeichnet den
Laufweg frei mit Maus oder Finger und speichert ihn als mehrpunktige Kurve.
Das Icon ist eine gekräuselte Linie mit Stift (`assets/icons/tools/freeline.svg`).
| Ziel | Ergebnis |
| :--- | :--- |
| Werkzeug | `Tool.FREELINE` zwischen den Bögen und den Element-Werkzeugen |
| Modell | `PathSegment.Template.FREEHAND` + mehrpunktige `Curve2D` |
| Sampling | ca. 2,5 px Punktabstand, max. 4.000 Punkte pro Segment |
| Bearbeitung | Start-/Endgriff verschieben den jeweiligen Endpunkt, ohne die Kurve zu kollabieren |
| Wiedergabe | Playback, 3D, SVG und PDF nutzen dieselbe Kurve wie Linie/Bogen |
| Persistenz | Schema 6, Vorlagenwert `freehand` |
| Tests | `./tools/test.sh` grün |
## Modell und Zeichnen
- Beim Start legt der Controller ein Segment mit einem Startpunkt an.
- Jede Bewegung wird in Rink-Koordinaten geklemmt und nur übernommen, wenn sie
weit genug vom letzten Punkt entfernt ist. Der Abstand orientiert sich mit
`FREELINE_POINT_STEP_PX` an der aktuellen Zoomstufe.
- Bei `draw_finished` wird der letzte Punkt ergänzt und die Dauer aus Länge und
Timing-Profil aktualisiert. Zu kurze Striche werden wie bei Linie/Bogen
verworfen.
- Start- und Endgriff bearbeiten bei `Template.FREEHAND` den ersten bzw.
letzten Kurvenpunkt direkt. Zusätzlich zeigt der Canvas bis zu 64
gleichmäßig verteilte Zwischenpunkte als kleine Griffe. Ein Drag bewegt den
jeweiligen Kurvenpunkt über einen Detail-Index im Handle-Signal; alle
anderen Punkte bleiben erhalten. Es gibt keinen Bogen-Griff.
- **Glätten:** Der Timing-Button führt zwei Laplacian-Durchgänge auf den
Innenpunkten aus. Start/Ende bleiben fest, die Punktanzahl bleibt gleich,
Länge/Dauer werden neu berechnet und jeder Druck ist undo-fähig.
- **Punktreduktion:** Eine iterative RDP-Reduktion läuft beim Abschluss einer
Freeline automatisch (ca. 1 px Toleranz, in Meter umgerechnet) und über den
Button „Vereinfachen“ für bestehende Segmente. Endpunkte bleiben erhalten;
die Aktion ist undo-fähig.
- Freeline-Segmente sind normale Pfadsegmente: Richtung, Kante, Label, Timing,
Löschen, Undo/Redo, Multi-Auswahl und Sequenzgruppierung funktionieren wie
bei Linie/Bogen.
## Oberfläche
- Neuer Toolbar-Button mit Tooltip „Freeline“. Im kompakten 1024-px-Layout
wurden die übrigen Topbar-Mindestbreiten leicht reduziert, damit die Leiste
weiterhin ohne Umbruch passt.
- Statusleiste zeigt „Freeline“ als Auswahlart und den Zeichenhinweis.
- Das Icon verwendet denselben weißen Strich wie die vorhandenen Werkzeuge.
## Offene Punkte
1. **Toleranz:** Die RDP-Reduktion nutzt einen konservativen Startwert von
etwa einem Bildschirmpixel. Eine einstellbare Stärke (z. B. für besonders
detailreiche Zeichnungen) ist noch offen.
2. **Sehr feine Kurven:** Bei mehr als 64 Punkten zeigt der Editor nur eine
gleichmäßige Auswahl als Griffe; nicht sichtbare Zwischenpunkte lassen
sich nicht direkt greifen.
3. **Druck/Export:** SVG/PDF übernehmen die Kurve; eine gesonderte
Freeline-Legende gibt es nicht.