- 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
61 lines
3.1 KiB
Markdown
61 lines
3.1 KiB
Markdown
# 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.
|