From 5acd8bf9eea23b10f50f8ba6ff8dc9f7f00a6663 Mon Sep 17 00:00:00 2001 From: Mischa Date: Sat, 24 Jan 2026 23:34:00 -0800 Subject: [PATCH] Clarify async loading documentation in preset load callback --- src/playlist/api/projectM-4/playlist_callbacks.h | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/playlist/api/projectM-4/playlist_callbacks.h b/src/playlist/api/projectM-4/playlist_callbacks.h index 17e5f965a..1c20c040d 100644 --- a/src/playlist/api/projectM-4/playlist_callbacks.h +++ b/src/playlist/api/projectM-4/playlist_callbacks.h @@ -76,7 +76,6 @@ typedef void (*projectm_playlist_preset_switch_failed_event)(const char* preset_ * letting the playlist library load presets from the filesystem. This is useful for: * - Loading presets from archives (e.g., ZIP files) * - Loading presets from network sources (e.g., HTTP) - * - Asynchronous preset loading * - Custom preset storage solutions * * When this callback is set and returns true, the playlist library will NOT attempt @@ -86,6 +85,9 @@ typedef void (*projectm_playlist_preset_switch_failed_event)(const char* preset_ * - Handling any loading errors * - Firing the preset_switched_event callback when the preset is ready (if desired) * + * Note: If implementing asynchronous loading, the application must complete the load and + * fire the preset_switched_event callback itself after the async operation completes. + * * If the callback returns false or is not set, the playlist library will use the * default behavior of loading the preset from the filesystem. *