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