|
| ARAAudioSourceReader (ARAAudioSource *audioSource) |
| Use an ARAAudioSource to construct an audio source reader for the given audioSource .
|
|
| ~ARAAudioSourceReader () override |
|
bool | readSamples (int *const *destSamples, int numDestChannels, int startOffsetInDestBuffer, int64 startSampleInFile, int numSamples) override |
| Subclasses must implement this method to perform the low-level read operation.
|
|
bool | isValid () const |
| Returns true as long as the reader's underlying ARAAudioSource remains accessible and its sample content is not changed.
|
|
void | invalidate () |
| Invalidate the reader - the reader will call this internally if needed, but can also be invalidated from the outside (from message thread only!).
|
|
void | willUpdateAudioSourceProperties (ARAAudioSource *audioSource, ARAAudioSource::PropertiesPtr newProperties) override |
| Called before the audio source's properties are updated.
|
|
void | doUpdateAudioSourceContent (ARAAudioSource *audioSource, ARAContentUpdateScopes scopeFlags) override |
| Called when the audio source's content (i.e.
|
|
void | willEnableAudioSourceSamplesAccess (ARAAudioSource *audioSource, bool enable) override |
| Called before access to an audio source's samples is enabled or disabled.
|
|
void | didEnableAudioSourceSamplesAccess (ARAAudioSource *audioSource, bool enable) override |
| Called after access to an audio source's samples is enabled or disabled.
|
|
void | willDestroyAudioSource (ARAAudioSource *audioSource) override |
| Called before the audio source is destroyed.
|
|
virtual | ~AudioFormatReader () |
| Destructor.
|
|
const String & | getFormatName () const noexcept |
| Returns a description of what type of format this is.
|
|
bool | read (float *const *destChannels, int numDestChannels, int64 startSampleInSource, int numSamplesToRead) |
| Reads samples from the stream.
|
|
bool | read (int *const *destChannels, int numDestChannels, int64 startSampleInSource, int numSamplesToRead, bool fillLeftoverChannelsWithCopies) |
| Reads samples from the stream.
|
|
bool | read (AudioBuffer< float > *buffer, int startSampleInDestBuffer, int numSamples, int64 readerStartSample, bool useReaderLeftChan, bool useReaderRightChan) |
| Fills a section of an AudioBuffer from this reader.
|
|
virtual void | readMaxLevels (int64 startSample, int64 numSamples, Range< float > *results, int numChannelsToRead) |
| Finds the highest and lowest sample levels from a section of the audio stream.
|
|
virtual void | readMaxLevels (int64 startSample, int64 numSamples, float &lowestLeft, float &highestLeft, float &lowestRight, float &highestRight) |
| Finds the highest and lowest sample levels from a section of the audio stream.
|
|
int64 | searchForLevel (int64 startSample, int64 numSamplesToSearch, double magnitudeRangeMinimum, double magnitudeRangeMaximum, int minimumConsecutiveSamples) |
| Scans the source looking for a sample whose magnitude is in a specified range.
|
|
virtual AudioChannelSet | getChannelLayout () |
| Get the channel layout of the audio stream.
|
|
virtual bool | readSamples (int *const *destChannels, int numDestChannels, int startOffsetInDestBuffer, int64 startSampleInFile, int numSamples)=0 |
| Subclasses must implement this method to perform the low-level read operation.
|
|
Subclass of AudioFormatReader that reads samples from a single ARA audio source.
Plug-Ins typically use this from their rendering code, wrapped in a BufferingAudioReader to bridge between realtime rendering and non-realtime audio reading.
The reader becomes invalidated if
- the audio source content is updated in a way that affects its samples,
- the audio source sample access is disabled, or
- the audio source being read is destroyed.