feat: Musik, Timeline-Labels, Abschnittssprung, PDF-Export und responsive Dialoge
This commit is contained in:
parent
7bbd8c9c1d
commit
533a12ef1a
17 changed files with 3483 additions and 60 deletions
|
|
@ -340,7 +340,18 @@ Fahrtrichtung.
|
|||
den Marker während der Standzeit mit 1,5 Umdrehungen pro Sekunde. Während
|
||||
des Playbacks wird die aktuelle Section hervorgehoben,
|
||||
ohne die Bearbeitungs-Section zu wechseln. Steuerung: Play/Pause, Reset,
|
||||
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Die Dauer kommt aus dem
|
||||
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Ein optionales
|
||||
Musikstück (MP3/OGG/WAV) liegt neben der Kür-JSON in `user://routines/`
|
||||
und läuft über einen `AudioStreamPlayer` auf derselben Zeitbasis: Start,
|
||||
Pause, Reset, Scrubbing und Geschwindigkeit wirken auf Bild und Ton. Über
|
||||
der Timeline liegt eine Label-Spur: Labels von Segmenten und Kürzel von
|
||||
Elementen ohne Freitext erscheinen schräg an ihrem Startzeitpunkt (auch
|
||||
Elemente mit 0 s Standzeit); ein Klick in die Spur legt ein eigenes,
|
||||
frei beschriftetes Timeline-Label an, das per Klick wieder bearbeitet oder
|
||||
gelöscht werden kann. Ein Wechsel des aktiven Abschnitts setzt Marker,
|
||||
Timeline-Slider und Label-Spur an den Anfang dieses Abschnitts; eine
|
||||
laufende Wiedergabe hält dabei an. Die
|
||||
Dauer kommt aus dem
|
||||
Segment-Timing (Default Adult Gold, 4,3 m/s) bzw. bei Punktmarkern aus der
|
||||
Element-Standzeit. Nicht verbundene Segmente
|
||||
führen zu einem Sprung des Markers an den Start des nächsten Segments.
|
||||
|
|
@ -423,13 +434,23 @@ ggf. eines nach `touchend` (300-ms-Guard).
|
|||
(2560 × 1600) mit Titel, Section-Nummern und Legende.
|
||||
- **Umfang:** Gesamte Kür oder aktiver Abschnitt; Dateien landen unter
|
||||
`user://exports/`.
|
||||
- **PDF** ist nicht nativ in Godot. Erste Stufe: Browser-Druck aus SVG;
|
||||
eine echte PDF-Ausgabe ist ein separates Arbeitspaket.
|
||||
- **PDF** erzeugt `RoutinePdfExporter` direkt als Vektordokument über einen
|
||||
kleinen eigenen PDF-Writer (Helvetica/WinAnsi, keine externe Bibliothek):
|
||||
eine Übersichtsseite mit allen Laufwegen und der Abschnittstabelle, danach
|
||||
eine Seite pro Abschnitt mit nummerierten Laufwegen sowie Start-/Endzeit,
|
||||
Dauer und Element bzw. Label. Lange Abschnitte laufen auf
|
||||
Fortsetzungsseiten weiter. Die Kurven werden als PDF-Bézierkurven aus den
|
||||
`Curve2D`-Handles geschrieben. Nach jedem Export zeigt ein Abschlussdialog
|
||||
den absoluten Pfad und bietet **Öffnen**, **Ordner anzeigen** und
|
||||
**Pfad kopieren** über `OS.shell_open` / `OS.shell_show_in_file_manager`;
|
||||
optional startet das Ergebnis direkt im Standardprogramm.
|
||||
- **Persistenz** erfolgt lokal als JSON unter `user://routines/`
|
||||
(`RoutineFile`, Format `rinkplanner.routine`). Die Datei enthält
|
||||
`schema_version` (aktuell 2); neuere Schemata werden abgelehnt,
|
||||
Schema-1-Dateien beim Laden migriert. Die Elementfelder kamen additiv mit
|
||||
Defaults hinzu, deshalb bleibt das Schema bei 2. Legacy-`.tres`-Dateien
|
||||
`schema_version` (aktuell 4); neuere Schemata werden abgelehnt,
|
||||
ältere Dateien beim Laden migriert (Schema 1: Dauer→Tempo, Schema 2→3:
|
||||
additives Feld `music_file`, Schema 3→4: additive Timeline-Labels).
|
||||
Die Elementfelder kamen additiv mit
|
||||
Defaults hinzu. Legacy-`.tres`-Dateien
|
||||
bleiben lesbar: Vor `ResourceLoader.load` prüft `RoutineFile` eine
|
||||
Whitelist (nur die vier Modellskripte, kein eingebettetes GDScript, keine
|
||||
Szenen). Neue Speicherungen schreiben immer `.json`; eine geöffnete
|
||||
|
|
@ -438,6 +459,10 @@ ggf. eines nach `touchend` (300-ms-Guard).
|
|||
Kürläufe werden über das Datei-Menü gespeichert und geladen; der
|
||||
Öffnen-Dialog zeigt `.json` und Legacy-`.tres`, wobei eine vorhandene
|
||||
`.json` die gleichnamige `.tres` verdeckt.
|
||||
`music_file` nennt nur den Dateinamen; die Audiodatei liegt flach daneben
|
||||
in `user://routines/` und wird vom Sync mitübertragen.
|
||||
`timeline_labels` speichert freie Timeline-Annotationen als
|
||||
`{time_seconds, text}`.
|
||||
- **Autosave** schreibt nach 1,5 s Inaktivität nur bei ungespeicherten
|
||||
Änderungen nach `user://autosave.json`; beim Speichern oder Öffnen einer
|
||||
Datei wird der Autosave entfernt. Der letzte Dateipfad liegt in
|
||||
|
|
@ -599,4 +624,5 @@ Viewport-Screenshot; sie ersetzen die headless Tests nicht.
|
|||
umgesetzt. Offen sind Beschleunigung/Verzögerung innerhalb eines Segments
|
||||
und eine noch genauere Profilpflege aus eigenen Messungen.
|
||||
12. **Playback-Komfort:** Loop, Scrubbing während des Abspielens und
|
||||
Audio-Synchronisation sind bewusst noch nicht enthalten.
|
||||
Audio-Synchronisation sind umgesetzt; offen sind Loop-Modus und eine
|
||||
Lautstärkeregelung für die Musik.
|
||||
|
|
|
|||
|
|
@ -63,6 +63,63 @@ die 2D-Funktionen sind davon nicht betroffen.
|
|||
nicht.
|
||||
- Es gibt keine Bearbeitung und keine Auswahl in 3D.
|
||||
|
||||
## Musik
|
||||
|
||||
Ein Musikstück gehört optional zur Kür. **Musik…** in der Playback-Leiste
|
||||
öffnet die Dateiauswahl für **MP3** (auch OGG/WAV). Die Datei wird in den
|
||||
Kür-Ordner kopiert und in der Kür-JSON als Dateiname vermerkt.
|
||||
|
||||
- **Start/Pause/Reset** steuern Bild und Musik gemeinsam.
|
||||
- **Timeline-Scrubbing** setzt auch die Musik an die entsprechende Stelle.
|
||||
- **Geschwindigkeit** wirkt auf beide: bei 0,5× läuft die Musik langsamer
|
||||
(und tiefer), bei 2× schneller.
|
||||
- **×** entfernt die Musik aus der Kür, löscht die Datei aber nicht. So
|
||||
bleibt sie für andere Kürdateien erhalten.
|
||||
- Beim **Sync** wird die Musikdatei wie die Kür-JSON hoch- und
|
||||
heruntergeladen. Fehlt sie auf einem Gerät, zeigt die Leiste
|
||||
„(fehlt)“; nach dem nächsten Sync ist sie verfügbar.
|
||||
|
||||
## Timeline-Labels
|
||||
|
||||
Über der Playback-Timeline liegt eine Label-Spur:
|
||||
|
||||
- **Kür-Labels:** Segmente mit eigener Beschriftung erscheinen schräg an
|
||||
ihrem Startzeitpunkt (blau). Elemente ohne Freitext zeigen ihr Kürzel
|
||||
(z. B. `1Lz`, `CCoSp`, `StSq`); auch Elemente mit 0 s Standzeit bleiben
|
||||
sichtbar.
|
||||
- **Eigene Labels:** Ein Klick in eine freie Stelle der Spur legt ein Label
|
||||
an diesem Zeitpunkt an; der Text wird im Dialog eingegeben.
|
||||
- **Bearbeiten:** Ein Klick auf ein goldenes eigenes Label öffnet den Dialog
|
||||
erneut. Dort lässt es sich umbenennen oder löschen.
|
||||
- Labels gehören zur Kür, werden mitgespeichert und über Undo/Redo sowie den
|
||||
Sync mitgeführt.
|
||||
|
||||
## Abschnittswechsel und Playback
|
||||
|
||||
Wird in der Abschnittsliste ein anderer Abschnitt gewählt, springen die
|
||||
Abspielfigur und die Playback-Timeline an den **Anfang dieses Abschnitts**.
|
||||
Eine laufende Wiedergabe wird dabei angehalten; mit **Start** läuft sie ab
|
||||
dieser Stelle weiter. Die Position berücksichtigt alle davor liegenden
|
||||
Abschnitte inklusive Element-Standzeiten.
|
||||
|
||||
## Export
|
||||
|
||||
**Datei → Exportieren…** schreibt nach `user://exports/`. Zur Wahl stehen:
|
||||
|
||||
- **SVG (Vektor):** gesamte Kür oder aktiver Abschnitt als druckbares Blatt.
|
||||
- **PNG (hochauflösend):** 2560 × 1600 für Tablet-Weitergabe.
|
||||
- **PDF (Laufwege mit Zeit):** eine Übersichtsseite mit allen Laufwegen und
|
||||
Abschnittszeiten, danach eine Seite pro Abschnitt. Dort sind die Laufwege
|
||||
in Reihenfolge nummeriert; die Tabelle nennt Start, Ende, Dauer und
|
||||
Element/Label. Lange Abschnitte werden auf weiteren Seiten fortgesetzt.
|
||||
Bei „Aktiver Abschnitt“ entsteht nur die Seite dieses Abschnitts.
|
||||
|
||||
Nach dem Export erscheint der **absolute Dateipfad** mit den Buttons
|
||||
**Öffnen**, **Ordner anzeigen** und **Pfad kopieren**. Die Option
|
||||
**„Nach dem Export mit dem Standardprogramm öffnen“** ist standardmäßig
|
||||
aktiv; damit startet z. B. das PDF direkt im PDF-Betrachter. Über
|
||||
**Datei → Exportordner öffnen** erreicht man den Ordner auch später.
|
||||
|
||||
## Kürzel und Base Value
|
||||
|
||||
- Das **Kürzel** bezeichnet die Elementfamilie, z. B. `3Lz`, `CCoSp` oder
|
||||
|
|
|
|||
|
|
@ -29,6 +29,13 @@ Voraussetzung für Phase 1.
|
|||
Session-Restore (Legacy-`.tres` lesbar)
|
||||
- [x] Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und
|
||||
Geschwindigkeit 0,25×–2,0×
|
||||
- [x] Musikstück (MP3/OGG/WAV) je Kür laden; Wiedergabe, Scrubbing und
|
||||
Geschwindigkeit laufen synchron zum Läufer; der FTP-Sync überträgt die
|
||||
Musikdatei mit der Kür
|
||||
- [x] Timeline-Labels: Kür-Labels schräg auf der Timeline, eigene Labels per
|
||||
Klick anlegen, bearbeiten und löschen
|
||||
- [x] Abschnittswechsel setzt Abspielfigur und Timeline an den
|
||||
Abschnittsanfang
|
||||
- [x] Geschwindigkeits-Arbeitsannahmen in `docs/speed-assumptions.md`
|
||||
- [x] Headless-Tests und visuelle Smoke-Tests
|
||||
|
||||
|
|
@ -49,6 +56,10 @@ Voraussetzung für Phase 1.
|
|||
- [x] SVG direkt aus dem Modell (Kurven, Sections, Legende, Rink)
|
||||
- [x] Export der aktiven Section und des gesamten Programms
|
||||
- [x] SVG als Grundlage für Browser-Druck (PDF)
|
||||
- [x] Native PDF-Ausgabe der Laufwege mit Zeit (Übersicht + Abschnittsseiten,
|
||||
Vektorpfade, Tabellen, Fortsetzungsseiten)
|
||||
- [x] Export-Abschluss mit absolutem Pfad sowie „Öffnen“, „Ordner anzeigen“
|
||||
und „Pfad kopieren“; optional direkt im Standardprogramm öffnen
|
||||
- [x] Export-Tests: Geometrie, Section-Reihenfolge, Sichtbarkeit
|
||||
- [x] Export-Dialog mit Dateiname, Format und Umfang
|
||||
|
||||
|
|
@ -260,8 +271,8 @@ Schritte.
|
|||
|
||||
## Bewusst nicht jetzt
|
||||
|
||||
- Audio-Synchronisation (laut Definition in Phase 1 zurückgestellt)
|
||||
- Native PDF-Ausgabe
|
||||
- Native PDF-Ausgabe mit Bildern/Screenshots (die aktuelle PDF-Ausgabe ist
|
||||
vektorbasiert und enthält keine Fotos)
|
||||
- Vollständiges ISU-Regelwerk vor dem stabilen Planungs-Workflow
|
||||
- Sync-Komfort und visuelles UI-Refactoring (erst nach dem PoC)
|
||||
- 3D-Produktionsreife
|
||||
|
|
|
|||
11
docs/sync.md
11
docs/sync.md
|
|
@ -24,7 +24,9 @@ Danach **Datei → Jetzt synchronisieren**.
|
|||
## Was passiert
|
||||
|
||||
- Jede Kür liegt als `.json` unter `user://routines/` und wird 1:1 in das
|
||||
FTP-Verzeichnis gespiegelt (flach, keine Unterordner). Legacy-`.tres`-
|
||||
FTP-Verzeichnis gespiegelt (flach, keine Unterordner). Gehört eine
|
||||
Musikdatei zur Kür (`.mp3`, `.ogg`, `.wav`), liegt sie im selben Ordner und
|
||||
wird mit denselben Regeln hoch- und heruntergeladen. Legacy-`.tres`-
|
||||
Dateien werden weiterhin mit synchronisiert, damit bestehende Installationen
|
||||
ihre Serverkopien nicht verlieren; neue Speicherungen schreiben `.json`.
|
||||
Beim Laden wird eine `.tres` vor dem `ResourceLoader` gegen eine Whitelist
|
||||
|
|
@ -93,6 +95,13 @@ Kür öffnen und bearbeiten.
|
|||
Server kann damit keine eingebetteten GDScripts ausführen.
|
||||
- Neue Speicherungen sind JSON; der Sync akzeptiert weiterhin `.tres`, damit
|
||||
bestehende Dateien auf Server und Tablet nicht verschwinden.
|
||||
- Musikdateien werden als normale Anhänge der Kür behandelt: Die JSON nennt
|
||||
nur den Dateinamen (`music_file`), die Datei liegt daneben. Ändert sich die
|
||||
Musik auf einem Gerät, lädt der nächste Sync sie hoch; auf dem anderen Gerät
|
||||
wird sie heruntergeladen und beim Öffnen der Kür verwendet. Konfliktkopien
|
||||
behalten die Audio-Endung (z. B. `kuer (Server …).mp3`).
|
||||
- Eigene Timeline-Labels stehen in der Kür-JSON (`timeline_labels`) und
|
||||
werden ohne Zusatzdateien mit der Kür übertragen.
|
||||
- Zugangsdaten liegen in `user://sync.cfg` (Klartext, app-privat). Auf
|
||||
Android ist das der interne App-Speicher, auf dem Desktop
|
||||
`~/.local/share/godot/app_userdata/Rinkplanner/`.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue