diff --git a/docs/architecture.md b/docs/architecture.md index ff45f7b..e54ef0d 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -216,7 +216,8 @@ Clipnamen; die Zuordnung Element → Clip ist ein späterer Schritt. Details: `SkateTrail3D` zeichnet zwei Ribbons an den geschätzten Blade-Positionen. Die Farbe kommt aus `PathSegment.direction`: türkis für vorwärts, orange für rückwärts. Die Alterung läuft über die Playback-Zeit (1,3 s), nicht über die -Echtzeit; beim Pausieren bleibt die Spur stehen. Bei Positionssprüngen über +Echtzeit; beim Pausieren bleibt die Spur stehen. Am Kür-Ende, wenn die +Wiedergabe stoppt, läuft sie in Echtzeit aus. Bei Positionssprüngen über 1,5 m, Zeit-Rücksprüngen oder `clear_pose` wird sie verworfen. Sie schreibt keine Modelldaten und ist nur in der 3D-Vorschau sichtbar. @@ -492,9 +493,10 @@ Aktueller Stand: - **3D-Assets:** 54 Assertions für Manifest-Schema, Pfade, FTP-Pfade, Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert – Größe und SHA-256 der GLB-Datei. -- **3D-Vorschau:** 52 Assertions für Koordinatenabbildung, Rink-Geometrie, - Kamera-Modi, Platzhalter-Fallback, Kufenspur (Farbe, zwei Kufen, Reset) - und den 2D/3D-Moduswechsel samt geteilter Playback-Position. +- **3D-Vorschau:** 57 Assertions für Koordinatenabbildung, Rink-Geometrie, + Kamera-Modi, Platzhalter-Fallback, Kufenspur (Farbe, zwei Kufen, Reset, + Abbau am Kür-Ende) und den 2D/3D-Moduswechsel samt geteilter + Playback-Position. - **Blender-Werkbank:** Rotoscoping wird separat geprüft (`tools/rotoscope.sh test-reference` → `setup` → `export` → `promote --dry-run`), nicht in `./tools/test.sh`, weil Blender und ffmpeg diff --git a/docs/findings-2026-10-31-kufenspur.md b/docs/findings-2026-10-31-kufenspur.md index d9e4645..56e510e 100644 --- a/docs/findings-2026-10-31-kufenspur.md +++ b/docs/findings-2026-10-31-kufenspur.md @@ -18,7 +18,8 @@ Neu: `src/presentation3d/skate_trail_3d.gd` (`SkateTrail3D`). - **türkis** `#0ea5e9` = vorwärts, - **orange** `#f97316` = rückwärts. - Die Alterung läuft über die **Playback-Zeit**, nicht über die Echtzeit: - Beim Pausieren bleibt die Spur stehen. + Beim Pausieren bleibt die Spur stehen. Am Kür-Ende, wenn die Wiedergabe + stoppt, wird sie in Echtzeit abgebaut. - Reset bei Positionssprung > 1,5 m, Zeit-Rücksprung (Loop/Scrub) und `clear_pose`. - Während Element-Markern (Pirouette, Sprung) werden keine neuen Samples @@ -58,8 +59,28 @@ Es ist nur im 3D-Modus sichtbar und blockiert keine Eingaben. - großer Sprung leert die Spur, - `clear_pose` leert die Spur, - Legende sichtbar in 3D / verborgen in 2D. +- Abbau beim Stehen (Trail-Fade) und am Ende der Wiedergabe + (Controller-Integration). -Ergebnis: **52 Assertions** (vorher 44), Gesamtsuite **1181** grün. +Ergebnis: **57 Assertions** (vorher 44), Gesamtsuite **1186** grün. + +## Nachtrag: Abbau am Kür-Ende + +Wenn die Wiedergabe das Ende erreicht, bleibt die Figur stehen. Die Spur soll +dann nicht einfrieren, sondern ausblenden. + +- `SkateTrail3D.start_fade()` setzt den Fade-Modus; `_process(delta)` erhöht + die Trail-Zeit in Echtzeit, entfernt alte Samples und baut das Mesh neu. + Ist der Puffer leer, stoppt der Prozess. +- `WhiteboardController._sync_trail_fade()` startet den Fade nur, wenn die + Wiedergabe am Ende ist und nicht läuft. Beim Pausieren mitten in der Kür + bleibt die Spur stehen. +- Wird weiterbewegt, gescrubbt oder neu gestartet, beendet `add_sample()` + den Fade; ein Zeit-Rücksprung leert die Spur. + +Damit verschwindet die Spur nach dem letzten bewegten Segment innerhalb von +1,3 s. Endet die Kür mit einer Pirouette, ist sie bereits während der +Standzeit ausgelaufen. ## Visuelle Prüfung diff --git a/docs/manual.md b/docs/manual.md index ad23e91..500a1be 100644 --- a/docs/manual.md +++ b/docs/manual.md @@ -27,7 +27,8 @@ der bisherige Bearbeitungsstand wieder da. Folgekamera (hinten/seitlich versetzt) und der Übersicht (ganzes Rink). - **Kufenspur:** Zwei verblassende Spuren an den Kufen zeigen die Fahrtrichtung: **türkis = vorwärts**, **orange = rückwärts**. Beim - Pausieren bleibt die Spur stehen; bei Sprüngen, Scrubben oder einem + Pausieren bleibt die Spur stehen; am Kür-Ende, wenn die Wiedergabe + stoppt, läuft sie in Echtzeit aus. Bei Sprüngen, Scrubben oder einem Sprung in der Zeit wird sie zurückgesetzt. Die Legende steht oben links im 3D-Bild. - **Zurück:** erneut **2D** drücken oder **Esc**. diff --git a/docs/roadmap.md b/docs/roadmap.md index 9e33b9f..c938b02 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -187,7 +187,7 @@ UI-Feedback der Tester ohnehin noch ausstehen. - [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export) - [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`) - [x] 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau) -- [x] Kufenspur mit Richtungsfarbe (vorwärts türkis, rückwärts orange) +- [x] Kufenspur mit Richtungsfarbe (vorwärts türkis, rückwärts orange, Abbau am Kür-Ende) - [x] Erster Produktionsclip `Glide` als 2-s-Loop - [x] Rotoscoping-Workflow (Blender-Werkbank, Referenz, Multi-Clip-Export, Manifest) - [ ] Erste echte Clips aus Referenzmaterial (Vorwärts, Rückwärts, Pirouette) diff --git a/rinkplanner/src/presentation3d/presentation_3d.gd b/rinkplanner/src/presentation3d/presentation_3d.gd index 7f924da..0f99adb 100644 --- a/rinkplanner/src/presentation3d/presentation_3d.gd +++ b/rinkplanner/src/presentation3d/presentation_3d.gd @@ -130,6 +130,14 @@ func clear_pose() -> void: _update_camera(0.0, true) +func fade_trail_out() -> void: + trail.start_fade() + + +func stop_trail_fade() -> void: + trail.stop_fade() + + func set_camera_mode(mode: CameraMode) -> void: if _camera_mode == mode: return diff --git a/rinkplanner/src/presentation3d/skate_trail_3d.gd b/rinkplanner/src/presentation3d/skate_trail_3d.gd index d9354c3..c8973e8 100644 --- a/rinkplanner/src/presentation3d/skate_trail_3d.gd +++ b/rinkplanner/src/presentation3d/skate_trail_3d.gd @@ -14,6 +14,7 @@ var _samples: Array[Dictionary] = [] var _mesh: ImmediateMesh var _mesh_instance: MeshInstance3D var _time: float = 0.0 +var _fading: bool = false func _ready() -> void: @@ -30,6 +31,33 @@ func _ready() -> void: material.albedo_color = Color.WHITE _mesh_instance.material_override = material add_child(_mesh_instance) + set_process(false) + + +func _process(delta: float) -> void: + if not _fading: + return + _time += delta + _prune() + _rebuild() + if _samples.is_empty(): + stop_fade() + + +func start_fade() -> void: + if _samples.is_empty(): + return + _fading = true + set_process(true) + + +func stop_fade() -> void: + _fading = false + set_process(false) + + +func is_fading() -> bool: + return _fading func add_sample( @@ -38,6 +66,7 @@ func add_sample( color: Color, time_seconds: float = -1.0 ) -> void: + stop_fade() _time = time_seconds if time_seconds >= 0.0 else _now() _prune() @@ -65,6 +94,7 @@ func add_sample( func clear() -> void: + stop_fade() _samples.clear() if _mesh != null: _mesh.clear_surfaces() diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 337b76d..e0c344a 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -2695,6 +2695,7 @@ func play() -> void: _update_play_button() _update_playback_ui() _update_status() + _sync_trail_fade() func pause() -> void: @@ -2703,6 +2704,7 @@ func pause() -> void: _playing = false _update_play_button() _update_playback_ui() + _sync_trail_fade() func reset_playback() -> void: @@ -2715,6 +2717,7 @@ func reset_playback() -> void: if _view_3d_active and _presentation_3d != null: _presentation_3d.clear_pose() _update_playback_ui() + _sync_trail_fade() func seek_playback(time: float) -> void: @@ -2724,6 +2727,7 @@ func seek_playback(time: float) -> void: else: _update_playback_state(0.0, true) _update_playback_ui() + _sync_trail_fade() func advance_playback(delta: float) -> void: @@ -2741,6 +2745,7 @@ func advance_playback(delta: float) -> void: _playing = false _update_play_button() _update_playback_ui() + _sync_trail_fade() return _update_playback_state(delta) @@ -3015,6 +3020,7 @@ func open_3d_view() -> void: _update_camera_mode_button() rink_canvas.cancel_interaction() _update_status() + _sync_trail_fade() func close_3d_view() -> void: @@ -3023,6 +3029,7 @@ func close_3d_view() -> void: _view_3d_active = false if _presentation_3d != null: + _presentation_3d.stop_trail_fade() _presentation_3d.set_active(false) _set_2d_controls_visible(true) @@ -3063,6 +3070,20 @@ func _update_camera_mode_button() -> void: ) +func _sync_trail_fade() -> void: + if _presentation_3d == null or not _view_3d_active: + return + + var at_end := ( + _playback_total_duration > 0.0 + and _playback_time >= _playback_total_duration - 0.0001 + ) + if at_end and not _playing: + _presentation_3d.fade_trail_out() + else: + _presentation_3d.stop_trail_fade() + + func _setup_presentation_3d() -> void: var packed := load(PRESENTATION_3D_SCENE_PATH) as PackedScene if packed == null: diff --git a/rinkplanner/tests/manual/capture_3d.gd b/rinkplanner/tests/manual/capture_3d.gd index c8cf408..051d524 100644 --- a/rinkplanner/tests/manual/capture_3d.gd +++ b/rinkplanner/tests/manual/capture_3d.gd @@ -20,6 +20,8 @@ func _capture() -> void: var output := args[2] if args.size() > 2 else "user://capture_3d.png" var seek_time := float(args[3]) if args.size() > 3 else 4.0 var camera_mode := args[4] if args.size() > 4 else "follow" + var fade_wait := float(args[5]) if args.size() > 5 else 0.0 + var with_marker := not (args.size() > 6 and args[6] == "no-marker") var controller := WhiteboardScene.instantiate() as WhiteboardController controller.restore_autosave = false @@ -48,12 +50,13 @@ func _capture() -> void: PathSegment.Direction.BACKWARD, PathSegment.Edge.OUTSIDE ) - controller.add_element_marker( - Vector2(4.0, 8.0), - PathSegment.ElementType.SPIN, - "CCoSp4", - 3 - ) + if with_marker: + controller.add_element_marker( + Vector2(4.0, 8.0), + PathSegment.ElementType.SPIN, + "CCoSp4", + 3 + ) controller.open_3d_view() if camera_mode == "overview": @@ -67,6 +70,8 @@ func _capture() -> void: controller.pause() await process_frame await process_frame + if fade_wait > 0.0: + await create_timer(fade_wait).timeout var presentation := controller.get_presentation_3d() print( @@ -81,7 +86,9 @@ func _capture() -> void: "TRAIL ", presentation.trail.get_sample_count(), " ", - presentation.trail.get_last_color() + presentation.trail.get_last_color(), + " fading ", + presentation.trail.is_fading() ) var image := root.get_texture().get_image() diff --git a/rinkplanner/tests/run_presentation3d_tests.gd b/rinkplanner/tests/run_presentation3d_tests.gd index 72cb85d..cb0ece2 100644 --- a/rinkplanner/tests/run_presentation3d_tests.gd +++ b/rinkplanner/tests/run_presentation3d_tests.gd @@ -157,6 +157,23 @@ func _test_presentation() -> void: "backward trail is orange" ) + presentation.trail.start_fade() + _check(presentation.trail.is_fading(), "the trail can fade out") + presentation.trail._process(2.0) + _check( + presentation.trail.get_sample_count() == 0, + "the trail fades out when the skater stands" + ) + presentation.update_pose( + Vector2(3.0, 0.0), + Vector2.RIGHT, + forward_segment + ) + _check( + not presentation.trail.is_fading(), + "new movement stops the fade" + ) + presentation.update_pose( Vector2(20.0, 0.0), Vector2.RIGHT, @@ -240,6 +257,15 @@ func _test_controller() -> void: "camera button switches the camera mode" ) + controller.seek_playback(maxf(duration - 0.05, 0.0)) + controller.play() + controller.advance_playback(1.0) + _check(not controller.is_playing(), "playback stops at the end") + _check( + presentation.trail.is_fading(), + "trail fades after the program ends" + ) + controller.close_3d_view() _check(not controller.is_3d_view_active(), "3D view closes") _check(controller.view_3d_button.text == "3D", "toolbar returns to 3D action")