Initial release

engine/vendor/vst3sdk/vstgui4/vstgui/standalone/include/iasync.h

@@ -0,0 +1,60 @@
+// This file is part of VSTGUI. It is subject to the license terms 
+// in the LICENSE file found in the top-level directory of this
+// distribution and at http://github.com/steinbergmedia/vstgui/LICENSE
+
+#pragma once
+
+#include "fwd.h"
+#include <functional>
+
+//------------------------------------------------------------------------
+namespace VSTGUI {
+namespace Standalone {
+/** %asynchronous tasks
+ *	@ingroup standalone
+ */
+namespace Async {
+
+//------------------------------------------------------------------------
+using Task = std::function<void ()>;
+
+//------------------------------------------------------------------------
+/** Get main/UI serial queue.
+ *
+ *	Tasks scheduled on this queue are performed serially on the main/ui thread.
+ */
+const QueuePtr& mainQueue ();
+
+//------------------------------------------------------------------------
+/** Get background concurrent queue.
+ *
+ *	Tasks scheduled on this queue are performed concurrently on background threads.
+ *	The number of background threads are depending on the systems number of CPU cores.
+ */
+const QueuePtr& backgroundQueue ();
+
+//------------------------------------------------------------------------
+/** Make a new serial queue.
+ *
+ *	Tasks scheduled on this queue are performed serially on a background thread.
+ *
+ *	@param name		the name of the serial queue (optional)
+ *	@return 		a new serial queue
+ */
+QueuePtr makeSerialQueue (const char* name);
+
+//------------------------------------------------------------------------
+/** Schedule a task to be performed asynchronous on a queue.
+ *
+ *	Can be called from any thread, but should not be called from realtime constraint threads as it
+ *	may involves locks and memory allocations
+ *
+ *	@param queue	on which queue to perform the task
+ *	@param task		task to be performed
+ */
+void schedule (QueuePtr queue, Task&& task);
+
+//------------------------------------------------------------------------
+} // Async
+} // Standalone
+} // VSTGUI