OpenShot Audio Library | OpenShotAudio 0.4.0
|
#include <juce_AudioWorkgroup.h>
Public Types | |
using | Erased = FixedSizeFunction< 64, const WorkgroupProvider *()> |
Public Member Functions | |
AudioWorkgroup (Erased e) | |
AudioWorkgroup (AudioWorkgroup &&)=default | |
AudioWorkgroup & | operator= (AudioWorkgroup &&)=default |
AudioWorkgroup (const AudioWorkgroup &) | |
AudioWorkgroup & | operator= (const AudioWorkgroup &other) |
AudioWorkgroup ()=default | |
void | join (WorkgroupToken &token) const |
bool | operator== (const AudioWorkgroup &other) const |
bool | operator!= (const AudioWorkgroup &other) const |
operator bool () const | |
void | reset () |
size_t | getMaxParallelThreadCount () const |
A handle to an audio workgroup, which is a collection of realtime threads working together to produce audio by a common deadline.
You can use this class to join a real-time worker thread to a workgroup. Rather than constructing instances of this class directly, you should use functions like AudioProcessor::audioWorkgroupContextChanged() and AudioIODevice::getWorkgroup() to fetch an engaged workgroup from the system.
The class contains a single method, join(). Call this from your real-time thread to with register this workgroup.
Here's an example of how you might use this class:
Definition at line 141 of file juce_AudioWorkgroup.h.
using juce::AudioWorkgroup::Erased = FixedSizeFunction<64, const WorkgroupProvider*()> |
Definition at line 148 of file juce_AudioWorkgroup.h.
|
inlineexplicit |
Creates an AudioWorkgroup from a function returning a WorkgroupProvider.
Definition at line 154 of file juce_AudioWorkgroup.h.
|
default |
Move constructor.
juce::AudioWorkgroup::AudioWorkgroup | ( | const AudioWorkgroup & | other | ) |
Copy constructor.
Definition at line 178 of file juce_AudioWorkgroup.cpp.
|
default |
Constructs a disengaged handle that does not represent any workgroup.
size_t juce::AudioWorkgroup::getMaxParallelThreadCount | ( | ) | const |
Returns the recommended maximum number of parallel threads that should join this workgroup.
This recommendation is based on the workgroup attributes and current hardware, but not on system load. On a very busy system, it may be more effective to use fewer parallel threads.
Definition at line 207 of file juce_AudioWorkgroup.cpp.
void juce::AudioWorkgroup::join | ( | WorkgroupToken & | token | ) | const |
This method attempts to join the calling thread to this workgroup.
If the join operation is successful, the token will be engaged, i.e. its getTokenProvider() function will return non-null.
If the token is already engaged and represents a join to another workgroup, the thread will leave that workgroup before joining the workgroup represented by this object. If the 'token' is already engaged and is passed to the same workgroup, the method will not perform any action.
It's important to note that the lifetime of the token should not exceed the lifetime of the associated thread and must be destroyed on the same thread.
Definition at line 192 of file juce_AudioWorkgroup.cpp.
|
explicit |
Returns true if and only if this object represents a workgroup.
Definition at line 222 of file juce_AudioWorkgroup.cpp.
|
inline |
Inequality operator.
Definition at line 195 of file juce_AudioWorkgroup.h.
|
default |
Move assignment operator.
|
inline |
Copy assignment operator.
Definition at line 166 of file juce_AudioWorkgroup.h.
bool juce::AudioWorkgroup::operator== | ( | const AudioWorkgroup & | other | ) | const |
Equality operator.
Definition at line 187 of file juce_AudioWorkgroup.cpp.
Referenced by operator!=().
|
inline |
Disengages this instance so that it no longer represents a workgroup.
After this call, operator bool() will return false.
Definition at line 204 of file juce_AudioWorkgroup.h.