#include <juce_MemoryMappedAudioFormatReader.h>
|
const File & | getFile () const noexcept |
|
bool | mapEntireFile () |
|
bool | mapSectionOfFile (Range< int64 > samplesToMap) |
|
Range< int64 > | getMappedSection () const noexcept |
|
void | touchSample (int64 sample) const noexcept |
|
virtual void | getSample (int64 sampleIndex, float *result) const noexcept=0 |
|
size_t | getNumBytesUsed () const |
|
virtual | ~AudioFormatReader () |
|
const String & | getFormatName () const noexcept |
|
bool | read (int *const *destSamples, int numDestChannels, int64 startSampleInSource, int numSamplesToRead, bool fillLeftoverChannelsWithCopies) |
|
void | read (AudioSampleBuffer *buffer, int startSampleInDestBuffer, int numSamples, int64 readerStartSample, bool useReaderLeftChan, bool useReaderRightChan) |
|
virtual void | readMaxLevels (int64 startSample, int64 numSamples, Range< float > *results, int numChannelsToRead) |
|
virtual void | readMaxLevels (int64 startSample, int64 numSamples, float &lowestLeft, float &highestLeft, float &lowestRight, float &highestRight) |
|
int64 | searchForLevel (int64 startSample, int64 numSamplesToSearch, double magnitudeRangeMinimum, double magnitudeRangeMaximum, int minimumConsecutiveSamples) |
|
virtual bool | readSamples (int **destSamples, int numDestChannels, int startOffsetInDestBuffer, int64 startSampleInFile, int numSamples)=0 |
|
A specialised type of AudioFormatReader that uses a MemoryMappedFile to read directly from an audio file.
This allows for incredibly fast random-access to sample data in the mapped region of the file, but not all audio formats support it - see AudioFormat::createMemoryMappedReader().
Note that before reading samples from a MemoryMappedAudioFormatReader, you must first call mapEntireFile() or mapSectionOfFile() to ensure that the region you want to read has been mapped.
- See Also
- AudioFormat::createMemoryMappedReader, AudioFormatReader
int64 MemoryMappedAudioFormatReader::filePosToSample |
( |
int64 |
filePos | ) |
const |
|
inlineprotectednoexcept |
Converts a byte position in the file to a sample index.
const File& MemoryMappedAudioFormatReader::getFile |
( |
| ) |
const |
|
inlinenoexcept |
Returns the file that is being mapped
Range<int64> MemoryMappedAudioFormatReader::getMappedSection |
( |
| ) |
const |
|
inlinenoexcept |
Returns the sample range that's currently memory-mapped and available for reading.
size_t MemoryMappedAudioFormatReader::getNumBytesUsed |
( |
| ) |
const |
|
inline |
Returns the number of bytes currently being mapped
virtual void MemoryMappedAudioFormatReader::getSample |
( |
int64 |
sampleIndex, |
|
|
float * |
result |
|
) |
| const |
|
pure virtualnoexcept |
Returns the samples for all channels at a given sample position. The result array must be large enough to hold a value for each channel that this reader contains.
Implemented in MemoryMappedWavReader, and MemoryMappedAiffReader.
bool MemoryMappedAudioFormatReader::mapEntireFile |
( |
| ) |
|
Attempts to map the entire file into memory.
bool MemoryMappedAudioFormatReader::mapSectionOfFile |
( |
Range< int64 > |
samplesToMap | ) |
|
Attempts to map a section of the file into memory.
int64 MemoryMappedAudioFormatReader::sampleToFilePos |
( |
int64 |
sample | ) |
const |
|
inlineprotectednoexcept |
Converts a sample index to a byte position in the file.
const void* MemoryMappedAudioFormatReader::sampleToPointer |
( |
int64 |
sample | ) |
const |
|
inlineprotectednoexcept |
Converts a sample index to a pointer to the mapped file memory.
template<typename SampleType , typename Endianness >
Range<float> MemoryMappedAudioFormatReader::scanMinAndMaxInterleaved |
( |
int |
channel, |
|
|
int64 |
startSampleInFile, |
|
|
int64 |
numSamples |
|
) |
| const |
|
inlineprotectednoexcept |
void MemoryMappedAudioFormatReader::touchSample |
( |
int64 |
sample | ) |
const |
|
noexcept |
Touches the memory for the given sample, to force it to be loaded into active memory.
int MemoryMappedAudioFormatReader::bytesPerFrame |
|
protected |
int64 MemoryMappedAudioFormatReader::dataChunkStart |
|
protected |
int64 MemoryMappedAudioFormatReader::dataLength |
|
protected |
File MemoryMappedAudioFormatReader::file |
|
protected |
Range<int64> MemoryMappedAudioFormatReader::mappedSection |
|
protected |
The documentation for this class was generated from the following files: