feat: Kufenspur blendet am Kuer-Ende aus

- Trail-Fade in Echtzeit, wenn die Wiedergabe endet und die Figur steht
- Pausieren mitten in der Kuer laesst die Spur weiterhin stehen
- Controller synchronisiert den Fade bei Play/Pause/Seek/Ende
- 57 Praesentations-Assertions (1186 gesamt)
This commit is contained in:
torsten 2026-10-31 14:46:54 +01:00
parent 1530914814
commit e79fa9635b
9 changed files with 131 additions and 15 deletions

View file

@ -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. `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 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 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 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. 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, - **3D-Assets:** 54 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert
– Größe und SHA-256 der GLB-Datei. – Größe und SHA-256 der GLB-Datei.
- **3D-Vorschau:** 52 Assertions für Koordinatenabbildung, Rink-Geometrie, - **3D-Vorschau:** 57 Assertions für Koordinatenabbildung, Rink-Geometrie,
Kamera-Modi, Platzhalter-Fallback, Kufenspur (Farbe, zwei Kufen, Reset) Kamera-Modi, Platzhalter-Fallback, Kufenspur (Farbe, zwei Kufen, Reset,
und den 2D/3D-Moduswechsel samt geteilter Playback-Position. Abbau am Kür-Ende) und den 2D/3D-Moduswechsel samt geteilter
Playback-Position.
- **Blender-Werkbank:** Rotoscoping wird separat geprüft - **Blender-Werkbank:** Rotoscoping wird separat geprüft
(`tools/rotoscope.sh test-reference` → `setup` → `export` → `promote (`tools/rotoscope.sh test-reference` → `setup` → `export` → `promote
--dry-run`), nicht in `./tools/test.sh`, weil Blender und ffmpeg --dry-run`), nicht in `./tools/test.sh`, weil Blender und ffmpeg

View file

@ -18,7 +18,8 @@ Neu: `src/presentation3d/skate_trail_3d.gd` (`SkateTrail3D`).
- **türkis** `#0ea5e9` = vorwärts, - **türkis** `#0ea5e9` = vorwärts,
- **orange** `#f97316` = rückwärts. - **orange** `#f97316` = rückwärts.
- Die Alterung läuft über die **Playback-Zeit**, nicht über die Echtzeit: - 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 - Reset bei Positionssprung > 1,5 m, Zeit-Rücksprung (Loop/Scrub) und
`clear_pose`. `clear_pose`.
- Während Element-Markern (Pirouette, Sprung) werden keine neuen Samples - 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, - großer Sprung leert die Spur,
- `clear_pose` leert die Spur, - `clear_pose` leert die Spur,
- Legende sichtbar in 3D / verborgen in 2D. - 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 ## Visuelle Prüfung

View file

@ -27,7 +27,8 @@ der bisherige Bearbeitungsstand wieder da.
Folgekamera (hinten/seitlich versetzt) und der Übersicht (ganzes Rink). Folgekamera (hinten/seitlich versetzt) und der Übersicht (ganzes Rink).
- **Kufenspur:** Zwei verblassende Spuren an den Kufen zeigen die - **Kufenspur:** Zwei verblassende Spuren an den Kufen zeigen die
Fahrtrichtung: **türkis = vorwärts**, **orange = rückwärts**. Beim 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 Sprung in der Zeit wird sie zurückgesetzt. Die Legende steht oben links
im 3D-Bild. im 3D-Bild.
- **Zurück:** erneut **2D** drücken oder **Esc**. - **Zurück:** erneut **2D** drücken oder **Esc**.

View file

@ -187,7 +187,7 @@ UI-Feedback der Tester ohnehin noch ausstehen.
- [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export) - [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export)
- [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`) - [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`)
- [x] 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau) - [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] Erster Produktionsclip `Glide` als 2-s-Loop
- [x] Rotoscoping-Workflow (Blender-Werkbank, Referenz, Multi-Clip-Export, Manifest) - [x] Rotoscoping-Workflow (Blender-Werkbank, Referenz, Multi-Clip-Export, Manifest)
- [ ] Erste echte Clips aus Referenzmaterial (Vorwärts, Rückwärts, Pirouette) - [ ] Erste echte Clips aus Referenzmaterial (Vorwärts, Rückwärts, Pirouette)

View file

@ -130,6 +130,14 @@ func clear_pose() -> void:
_update_camera(0.0, true) _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: func set_camera_mode(mode: CameraMode) -> void:
if _camera_mode == mode: if _camera_mode == mode:
return return

View file

@ -14,6 +14,7 @@ var _samples: Array[Dictionary] = []
var _mesh: ImmediateMesh var _mesh: ImmediateMesh
var _mesh_instance: MeshInstance3D var _mesh_instance: MeshInstance3D
var _time: float = 0.0 var _time: float = 0.0
var _fading: bool = false
func _ready() -> void: func _ready() -> void:
@ -30,6 +31,33 @@ func _ready() -> void:
material.albedo_color = Color.WHITE material.albedo_color = Color.WHITE
_mesh_instance.material_override = material _mesh_instance.material_override = material
add_child(_mesh_instance) 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( func add_sample(
@ -38,6 +66,7 @@ func add_sample(
color: Color, color: Color,
time_seconds: float = -1.0 time_seconds: float = -1.0
) -> void: ) -> void:
stop_fade()
_time = time_seconds if time_seconds >= 0.0 else _now() _time = time_seconds if time_seconds >= 0.0 else _now()
_prune() _prune()
@ -65,6 +94,7 @@ func add_sample(
func clear() -> void: func clear() -> void:
stop_fade()
_samples.clear() _samples.clear()
if _mesh != null: if _mesh != null:
_mesh.clear_surfaces() _mesh.clear_surfaces()

View file

@ -2695,6 +2695,7 @@ func play() -> void:
_update_play_button() _update_play_button()
_update_playback_ui() _update_playback_ui()
_update_status() _update_status()
_sync_trail_fade()
func pause() -> void: func pause() -> void:
@ -2703,6 +2704,7 @@ func pause() -> void:
_playing = false _playing = false
_update_play_button() _update_play_button()
_update_playback_ui() _update_playback_ui()
_sync_trail_fade()
func reset_playback() -> void: func reset_playback() -> void:
@ -2715,6 +2717,7 @@ func reset_playback() -> void:
if _view_3d_active and _presentation_3d != null: if _view_3d_active and _presentation_3d != null:
_presentation_3d.clear_pose() _presentation_3d.clear_pose()
_update_playback_ui() _update_playback_ui()
_sync_trail_fade()
func seek_playback(time: float) -> void: func seek_playback(time: float) -> void:
@ -2724,6 +2727,7 @@ func seek_playback(time: float) -> void:
else: else:
_update_playback_state(0.0, true) _update_playback_state(0.0, true)
_update_playback_ui() _update_playback_ui()
_sync_trail_fade()
func advance_playback(delta: float) -> void: func advance_playback(delta: float) -> void:
@ -2741,6 +2745,7 @@ func advance_playback(delta: float) -> void:
_playing = false _playing = false
_update_play_button() _update_play_button()
_update_playback_ui() _update_playback_ui()
_sync_trail_fade()
return return
_update_playback_state(delta) _update_playback_state(delta)
@ -3015,6 +3020,7 @@ func open_3d_view() -> void:
_update_camera_mode_button() _update_camera_mode_button()
rink_canvas.cancel_interaction() rink_canvas.cancel_interaction()
_update_status() _update_status()
_sync_trail_fade()
func close_3d_view() -> void: func close_3d_view() -> void:
@ -3023,6 +3029,7 @@ func close_3d_view() -> void:
_view_3d_active = false _view_3d_active = false
if _presentation_3d != null: if _presentation_3d != null:
_presentation_3d.stop_trail_fade()
_presentation_3d.set_active(false) _presentation_3d.set_active(false)
_set_2d_controls_visible(true) _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: func _setup_presentation_3d() -> void:
var packed := load(PRESENTATION_3D_SCENE_PATH) as PackedScene var packed := load(PRESENTATION_3D_SCENE_PATH) as PackedScene
if packed == null: if packed == null:

View file

@ -20,6 +20,8 @@ func _capture() -> void:
var output := args[2] if args.size() > 2 else "user://capture_3d.png" 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 seek_time := float(args[3]) if args.size() > 3 else 4.0
var camera_mode := args[4] if args.size() > 4 else "follow" 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 var controller := WhiteboardScene.instantiate() as WhiteboardController
controller.restore_autosave = false controller.restore_autosave = false
@ -48,12 +50,13 @@ func _capture() -> void:
PathSegment.Direction.BACKWARD, PathSegment.Direction.BACKWARD,
PathSegment.Edge.OUTSIDE PathSegment.Edge.OUTSIDE
) )
controller.add_element_marker( if with_marker:
Vector2(4.0, 8.0), controller.add_element_marker(
PathSegment.ElementType.SPIN, Vector2(4.0, 8.0),
"CCoSp4", PathSegment.ElementType.SPIN,
3 "CCoSp4",
) 3
)
controller.open_3d_view() controller.open_3d_view()
if camera_mode == "overview": if camera_mode == "overview":
@ -67,6 +70,8 @@ func _capture() -> void:
controller.pause() controller.pause()
await process_frame await process_frame
await process_frame await process_frame
if fade_wait > 0.0:
await create_timer(fade_wait).timeout
var presentation := controller.get_presentation_3d() var presentation := controller.get_presentation_3d()
print( print(
@ -81,7 +86,9 @@ func _capture() -> void:
"TRAIL ", "TRAIL ",
presentation.trail.get_sample_count(), 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() var image := root.get_texture().get_image()

View file

@ -157,6 +157,23 @@ func _test_presentation() -> void:
"backward trail is orange" "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( presentation.update_pose(
Vector2(20.0, 0.0), Vector2(20.0, 0.0),
Vector2.RIGHT, Vector2.RIGHT,
@ -240,6 +257,15 @@ func _test_controller() -> void:
"camera button switches the camera mode" "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() controller.close_3d_view()
_check(not controller.is_3d_view_active(), "3D view closes") _check(not controller.is_3d_view_active(), "3D view closes")
_check(controller.view_3d_button.text == "3D", "toolbar returns to 3D action") _check(controller.view_3d_button.text == "3D", "toolbar returns to 3D action")