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

3.1 KiB
Raw Blame 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.