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. *