commit 1797cf45be1b17e50093f45eb45f6683ea22d895
parent ba4a6406d23d5e4214d3ebe1ee439a29a9a69f42
Author: Alexandre Bique <bique.alexandre@gmail.com>
Date: Fri, 10 Mar 2023 16:46:07 +0100
Merge pull request #255 from russellmcc/gui-threading-clarification
Add clarification note about threading while GUI is alive
Diffstat:
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/include/clap/ext/thread-check.h b/include/clap/ext/thread-check.h
@@ -14,7 +14,9 @@ extern "C" {
///
/// main-thread:
/// This is the thread in which most of the interaction between the plugin and host happens.
-/// It is usually the thread on which the GUI receives its events.
+/// This will be the same OS thread throughout the lifetime of the plug-in.
+/// On macOS and Windows, this must be the thread on which gui and timer events are received
+/// (i.e., the main thread of the program).
/// It isn't a realtime thread, yet this thread needs to respond fast enough to user interaction,
/// so it is recommended to run long and expensive tasks such as preset indexing or asset loading
/// in dedicated background threads.