rinkplanner/docs/findings-2026-11-10-freeline.md

62 lines
3.1 KiB
Markdown
Raw Normal View History

# 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.