An AudioIODeviceCallback object which streams audio through an AudioProcessor. More...
Inherits AudioIODeviceCallback, and MidiInputCallback.
Public Member Functions | |
| AudioProcessorPlayer () | |
| virtual | ~AudioProcessorPlayer () |
| Destructor. | |
| void | setProcessor (AudioProcessor *processorToPlay) |
| Sets the processor that should be played. | |
| AudioProcessor * | getCurrentProcessor () const |
| Returns the current audio processor that is being played. | |
| MidiMessageCollector & | getMidiMessageCollector () |
| Returns a midi message collector that you can pass midi messages to if you want them to be injected into the midi stream that is being sent to the processor. | |
| void | audioDeviceIOCallback (const float **inputChannelData, int totalNumInputChannels, float **outputChannelData, int totalNumOutputChannels, int numSamples) |
| Processes a block of incoming and outgoing audio data. | |
| void | audioDeviceAboutToStart (AudioIODevice *device) |
| Called to indicate that the device is about to start calling back. | |
| void | audioDeviceStopped () |
| Called to indicate that the device has stopped. | |
| void | handleIncomingMidiMessage (MidiInput *source, const MidiMessage &message) |
| Receives an incoming message. | |
An AudioIODeviceCallback object which streams audio through an AudioProcessor.
To use one of these, just make it the callback used by your AudioIODevice, and give it a processor to use by calling setProcessor().
It's also a MidiInputCallback, so you can connect it to both an audio and midi input to send both streams through the processor.
| AudioProcessorPlayer::AudioProcessorPlayer | ( | ) |
| virtual AudioProcessorPlayer::~AudioProcessorPlayer | ( | ) | [virtual] |
Destructor.
| void AudioProcessorPlayer::setProcessor | ( | AudioProcessor * | processorToPlay ) |
Sets the processor that should be played.
The processor that is passed in will not be deleted or owned by this object. To stop anything playing, pass in 0 to this method.
| AudioProcessor* AudioProcessorPlayer::getCurrentProcessor | ( | ) | const |
Returns the current audio processor that is being played.
| MidiMessageCollector& AudioProcessorPlayer::getMidiMessageCollector | ( | ) |
Returns a midi message collector that you can pass midi messages to if you want them to be injected into the midi stream that is being sent to the processor.
| void AudioProcessorPlayer::audioDeviceIOCallback | ( | const float ** | inputChannelData, |
| int | numInputChannels, | ||
| float ** | outputChannelData, | ||
| int | numOutputChannels, | ||
| int | numSamples | ||
| ) | [virtual] |
Processes a block of incoming and outgoing audio data.
The subclass's implementation should use the incoming audio for whatever purposes it needs to, and must fill all the output channels with the next block of output data before returning.
The channel data is arranged with the same array indices as the channel name array returned by AudioIODevice::getOutputChannelNames(), but those channels that aren't specified in AudioIODevice::open() will have a null pointer for their associated channel, so remember to check for this.
| inputChannelData | a set of arrays containing the audio data for each incoming channel - this data is valid until the function returns. There will be one channel of data for each input channel that was enabled when the audio device was opened (see AudioIODevice::open()) |
| numInputChannels | the number of pointers to channel data in the inputChannelData array. |
| outputChannelData | a set of arrays which need to be filled with the data that should be sent to each outgoing channel of the device. There will be one channel of data for each output channel that was enabled when the audio device was opened (see AudioIODevice::open()) The initial contents of the array is undefined, so the callback function must fill all the channels with zeros if its output is silence. Failing to do this could cause quite an unpleasant noise! |
| numOutputChannels | the number of pointers to channel data in the outputChannelData array. |
| numSamples | the number of samples in each channel of the input and output arrays. The number of samples will depend on the audio device's buffer size and will usually remain constant, although this isn't guaranteed, so make sure your code can cope with reasonable changes in the buffer size from one callback to the next. |
Implements AudioIODeviceCallback.
| void AudioProcessorPlayer::audioDeviceAboutToStart | ( | AudioIODevice * | device ) | [virtual] |
Called to indicate that the device is about to start calling back.
This will be called just before the audio callbacks begin, either when this callback has just been added to an audio device, or after the device has been restarted because of a sample-rate or block-size change.
You can use this opportunity to find out the sample rate and block size that the device is going to use by calling the AudioIODevice::getCurrentSampleRate() and AudioIODevice::getCurrentBufferSizeSamples() on the supplied pointer.
| device | the audio IO device that will be used to drive the callback. Note that if you're going to store this this pointer, it is only valid until the next time that audioDeviceStopped is called. |
Implements AudioIODeviceCallback.
| void AudioProcessorPlayer::audioDeviceStopped | ( | ) | [virtual] |
Called to indicate that the device has stopped.
Implements AudioIODeviceCallback.
| void AudioProcessorPlayer::handleIncomingMidiMessage | ( | MidiInput * | source, |
| const MidiMessage & | message | ||
| ) | [virtual] |
Receives an incoming message.
A MidiInput object will call this method when a midi event arrives. It'll be called on a high-priority system thread, so avoid doing anything time-consuming in here, and avoid making any UI calls. You might find the MidiBuffer class helpful for queueing incoming messages for use later.
| source | the MidiInput object that generated the message |
| message | the incoming message. The message's timestamp is set to a value equivalent to (Time::getMillisecondCounter() / 1000.0) to specify the time when the message arrived. |
Implements MidiInputCallback.
