openshot-audio
0.1.7
|
#include <juce_AudioSampleBuffer.h>
Public Member Functions | |
AudioSampleBuffer () noexcept | |
AudioSampleBuffer (int numChannels, int numSamples) noexcept | |
AudioSampleBuffer (float *const *dataToReferTo, int numChannels, int numSamples) noexcept | |
AudioSampleBuffer (float *const *dataToReferTo, int numChannels, int startSample, int numSamples) noexcept | |
AudioSampleBuffer (const AudioSampleBuffer &) noexcept | |
AudioSampleBuffer & | operator= (const AudioSampleBuffer &) noexcept |
~AudioSampleBuffer () noexcept | |
int | getNumChannels () const noexcept |
int | getNumSamples () const noexcept |
const float * | getReadPointer (int channelNumber) const noexcept |
const float * | getReadPointer (int channelNumber, int sampleIndex) const noexcept |
float * | getWritePointer (int channelNumber) noexcept |
float * | getWritePointer (int channelNumber, int sampleIndex) noexcept |
const float ** | getArrayOfReadPointers () const noexcept |
float ** | getArrayOfWritePointers () noexcept |
void | setSize (int newNumChannels, int newNumSamples, bool keepExistingContent=false, bool clearExtraSpace=false, bool avoidReallocating=false) noexcept |
void | setDataToReferTo (float **dataToReferTo, int numChannels, int numSamples) noexcept |
void | clear () noexcept |
void | clear (int startSample, int numSamples) noexcept |
void | clear (int channel, int startSample, int numSamples) noexcept |
bool | hasBeenCleared () const noexcept |
float | getSample (int channel, int sampleIndex) const noexcept |
void | setSample (int destChannel, int destSample, float newValue) noexcept |
void | addSample (int destChannel, int destSample, float valueToAdd) noexcept |
void | applyGain (int channel, int startSample, int numSamples, float gain) noexcept |
void | applyGain (int startSample, int numSamples, float gain) noexcept |
void | applyGain (float gain) noexcept |
void | applyGainRamp (int channel, int startSample, int numSamples, float startGain, float endGain) noexcept |
void | applyGainRamp (int startSample, int numSamples, float startGain, float endGain) noexcept |
void | addFrom (int destChannel, int destStartSample, const AudioSampleBuffer &source, int sourceChannel, int sourceStartSample, int numSamples, float gainToApplyToSource=1.0f) noexcept |
void | addFrom (int destChannel, int destStartSample, const float *source, int numSamples, float gainToApplyToSource=1.0f) noexcept |
void | addFromWithRamp (int destChannel, int destStartSample, const float *source, int numSamples, float startGain, float endGain) noexcept |
void | copyFrom (int destChannel, int destStartSample, const AudioSampleBuffer &source, int sourceChannel, int sourceStartSample, int numSamples) noexcept |
void | copyFrom (int destChannel, int destStartSample, const float *source, int numSamples) noexcept |
void | copyFrom (int destChannel, int destStartSample, const float *source, int numSamples, float gain) noexcept |
void | copyFromWithRamp (int destChannel, int destStartSample, const float *source, int numSamples, float startGain, float endGain) noexcept |
Range< float > | findMinMax (int channel, int startSample, int numSamples) const noexcept |
float | getMagnitude (int channel, int startSample, int numSamples) const noexcept |
float | getMagnitude (int startSample, int numSamples) const noexcept |
float | getRMSLevel (int channel, int startSample, int numSamples) const noexcept |
void | reverse (int channel, int startSample, int numSamples) const noexcept |
void | reverse (int startSample, int numSamples) const noexcept |
JUCE_DEPRECATED_WITH_BODY (const float *getSampleData(int channel) const, { return getReadPointer(channel);}) JUCE_DEPRECATED_WITH_BODY(const float *getSampleData(int channel | |
int index | JUCE_DEPRECATED_WITH_BODY (float *getSampleData(int channel), { return getWritePointer(channel);}) JUCE_DEPRECATED_WITH_BODY(float *getSampleData(int channel |
int index int | JUCE_DEPRECATED_WITH_BODY (const float **getArrayOfChannels() const, { return getArrayOfReadPointers();}) JUCE_DEPRECATED_WITH_BODY(float **getArrayOfChannels() |
Public Attributes | |
int index | const |
int index int | index |
A multi-channel buffer of 32-bit floating point audio samples.
|
noexcept |
Creates an empty buffer with 0 channels and 0 length.
|
noexcept |
Creates a buffer with a specified number of channels and samples.
The contents of the buffer will initially be undefined, so use clear() to set all the samples to zero.
The buffer will allocate its memory internally, and this will be released when the buffer is deleted. If the memory can't be allocated, this will throw a std::bad_alloc exception.
|
noexcept |
Creates a buffer using a pre-allocated block of memory.
Note that if the buffer is resized or its number of channels is changed, it will re-allocate memory internally and copy the existing data to this new area, so it will then stop directly addressing this memory.
dataToReferTo | a pre-allocated array containing pointers to the data for each channel that should be used by this buffer. The buffer will only refer to this memory, it won't try to delete it when the buffer is deleted or resized. |
numChannels | the number of channels to use - this must correspond to the number of elements in the array passed in |
numSamples | the number of samples to use - this must correspond to the size of the arrays passed in |
|
noexcept |
Creates a buffer using a pre-allocated block of memory.
Note that if the buffer is resized or its number of channels is changed, it will re-allocate memory internally and copy the existing data to this new area, so it will then stop directly addressing this memory.
dataToReferTo | a pre-allocated array containing pointers to the data for each channel that should be used by this buffer. The buffer will only refer to this memory, it won't try to delete it when the buffer is deleted or resized. |
numChannels | the number of channels to use - this must correspond to the number of elements in the array passed in |
startSample | the offset within the arrays at which the data begins |
numSamples | the number of samples to use - this must correspond to the size of the arrays passed in |
|
noexcept |
Copies another buffer.
This buffer will make its own copy of the other's data, unless the buffer was created using an external data buffer, in which case boths buffers will just point to the same shared block of data.
|
noexcept |
Destructor. This will free any memory allocated by the buffer.
|
noexcept |
Adds samples from another buffer to this one.
destChannel | the channel within this buffer to add the samples to |
destStartSample | the start sample within this buffer's channel |
source | the source buffer to add from |
sourceChannel | the channel within the source buffer to read from |
sourceStartSample | the offset within the source buffer's channel to start reading samples from |
numSamples | the number of samples to process |
gainToApplyToSource | an optional gain to apply to the source samples before they are added to this buffer's samples |
|
noexcept |
Adds samples from an array of floats to one of the channels.
destChannel | the channel within this buffer to add the samples to |
destStartSample | the start sample within this buffer's channel |
source | the source data to use |
numSamples | the number of samples to process |
gainToApplyToSource | an optional gain to apply to the source samples before they are added to this buffer's samples |
|
noexcept |
Adds samples from an array of floats, applying a gain ramp to them.
destChannel | the channel within this buffer to add the samples to |
destStartSample | the start sample within this buffer's channel |
source | the source data to use |
numSamples | the number of samples to process |
startGain | the gain to apply to the first sample (this is multiplied with the source samples before they are added to this buffer) |
endGain | the gain to apply to the final sample. The gain is linearly interpolated between the first and last samples. |
|
noexcept |
Adds a value to a sample in the buffer. The channel and index are not checked - they are expected to be in-range. If not, an assertion will be thrown, but in a release build, you're into 'undefined behaviour' territory.
|
noexcept |
Applies a gain multiple to a region of one channel.
For speed, this doesn't check whether the channel and sample number are in-range, so be careful!
|
noexcept |
Applies a gain multiple to a region of all the channels.
For speed, this doesn't check whether the sample numbers are in-range, so be careful!
|
noexcept |
Applies a gain multiple to all the audio data.
|
noexcept |
Applies a range of gains to a region of a channel.
The gain that is applied to each sample will vary from startGain on the first sample to endGain on the last Sample, so it can be used to do basic fades.
For speed, this doesn't check whether the sample numbers are in-range, so be careful!
|
noexcept |
Applies a range of gains to a region of all channels.
The gain that is applied to each sample will vary from startGain on the first sample to endGain on the last Sample, so it can be used to do basic fades.
For speed, this doesn't check whether the sample numbers are in-range, so be careful!
|
noexcept |
Clears all the samples in all channels.
|
noexcept |
Clears a specified region of all the channels.
For speed, this doesn't check whether the channel and sample number are in-range, so be careful!
|
noexcept |
Clears a specified region of just one channel.
For speed, this doesn't check whether the channel and sample number are in-range, so be careful!
|
noexcept |
Copies samples from another buffer to this one.
destChannel | the channel within this buffer to copy the samples to |
destStartSample | the start sample within this buffer's channel |
source | the source buffer to read from |
sourceChannel | the channel within the source buffer to read from |
sourceStartSample | the offset within the source buffer's channel to start reading samples from |
numSamples | the number of samples to process |
|
noexcept |
Copies samples from an array of floats into one of the channels.
destChannel | the channel within this buffer to copy the samples to |
destStartSample | the start sample within this buffer's channel |
source | the source buffer to read from |
numSamples | the number of samples to process |
|
noexcept |
Copies samples from an array of floats into one of the channels, applying a gain to it.
destChannel | the channel within this buffer to copy the samples to |
destStartSample | the start sample within this buffer's channel |
source | the source buffer to read from |
numSamples | the number of samples to process |
gain | the gain to apply |
|
noexcept |
Copies samples from an array of floats into one of the channels, applying a gain ramp.
destChannel | the channel within this buffer to copy the samples to |
destStartSample | the start sample within this buffer's channel |
source | the source buffer to read from |
numSamples | the number of samples to process |
startGain | the gain to apply to the first sample (this is multiplied with the source samples before they are copied to this buffer) |
endGain | the gain to apply to the final sample. The gain is linearly interpolated between the first and last samples. |
|
noexcept |
Returns a Range indicating the lowest and highest sample values in a given section.
channel | the channel to read from |
startSample | the start sample within the channel |
numSamples | the number of samples to check |
|
inlinenoexcept |
Returns an array of pointers to the channels in the buffer.
Don't modify any of the pointers that are returned, and bear in mind that these will become invalid if the buffer is resized.
|
inlinenoexcept |
Returns an array of pointers to the channels in the buffer.
Don't modify any of the pointers that are returned, and bear in mind that these will become invalid if the buffer is resized.
|
noexcept |
Finds the highest absolute sample value within a region of a channel.
|
noexcept |
Finds the highest absolute sample value within a region on all channels.
|
inlinenoexcept |
Returns the number of channels of audio data that this buffer contains.
|
inlinenoexcept |
Returns the number of samples allocated in each of the buffer's channels.
|
inlinenoexcept |
Returns a pointer to an array of read-only samples in one of the buffer's channels. For speed, this doesn't check whether the channel number is out of range, so be careful when using it! If you need to write to the data, do NOT call this method and const_cast the result! Instead, you must call getWritePointer so that the buffer knows you're planning on modifying the data.
|
inlinenoexcept |
Returns a pointer to an array of read-only samples in one of the buffer's channels. For speed, this doesn't check whether the channel number or index are out of range, so be careful when using it! If you need to write to the data, do NOT call this method and const_cast the result! Instead, you must call getWritePointer so that the buffer knows you're planning on modifying the data.
|
noexcept |
Returns the root mean squared level for a region of a channel.
|
noexcept |
Returns a sample from the buffer. The channel and index are not checked - they are expected to be in-range. If not, an assertion will be thrown, but in a release build, you're into 'undefined behaviour' territory.
|
inlinenoexcept |
Returns a writeable pointer to one of the buffer's channels. For speed, this doesn't check whether the channel number is out of range, so be careful when using it! Note that if you're not planning on writing to the data, you should always use getReadPointer instead.
|
inlinenoexcept |
Returns a writeable pointer to one of the buffer's channels. For speed, this doesn't check whether the channel number or index are out of range, so be careful when using it! Note that if you're not planning on writing to the data, you should use getReadPointer instead.
|
inlinenoexcept |
Returns true if the buffer has been entirely cleared. Note that this does not actually measure the contents of the buffer - it simply returns a flag that is set when the buffer is cleared, and which is reset whenever functions like getWritePointer() are invoked. That means the method does not take any time, but it may return false negatives when in fact the buffer is still empty.
AudioSampleBuffer::JUCE_DEPRECATED_WITH_BODY | ( | const float *getSampleData(int channel) | const, |
{ return getReadPointer(channel);} | |||
) | const |
int index AudioSampleBuffer::JUCE_DEPRECATED_WITH_BODY | ( | float * | getSampleDataint channel, |
{ return getWritePointer(channel);} | |||
) |
int index int AudioSampleBuffer::JUCE_DEPRECATED_WITH_BODY | ( | const float **getArrayOfChannels() | const, |
{ return getArrayOfReadPointers();} | |||
) |
|
noexcept |
Copies another buffer onto this one. This buffer's size will be changed to that of the other buffer.
|
noexcept |
Reverses a part of a channel.
|
noexcept |
Reverses a part of the buffer.
|
noexcept |
Makes this buffer point to a pre-allocated set of channel data arrays.
There's also a constructor that lets you specify arrays like this, but this lets you change the channels dynamically.
Note that if the buffer is resized or its number of channels is changed, it will re-allocate memory internally and copy the existing data to this new area, so it will then stop directly addressing this memory.
dataToReferTo | a pre-allocated array containing pointers to the data for each channel that should be used by this buffer. The buffer will only refer to this memory, it won't try to delete it when the buffer is deleted or resized. |
numChannels | the number of channels to use - this must correspond to the number of elements in the array passed in |
numSamples | the number of samples to use - this must correspond to the size of the arrays passed in |
|
noexcept |
Sets a sample in the buffer. The channel and index are not checked - they are expected to be in-range. If not, an assertion will be thrown, but in a release build, you're into 'undefined behaviour' territory.
|
noexcept |
Changes the buffer's size or number of channels.
This can expand or contract the buffer's length, and add or remove channels.
If keepExistingContent is true, it will try to preserve as much of the old data as it can in the new buffer.
If clearExtraSpace is true, then any extra channels or space that is allocated will be also be cleared. If false, then this space is left uninitialised.
If avoidReallocating is true, then changing the buffer's size won't reduce the amount of memory that is currently allocated (but it will still increase it if the new size is bigger than the amount it currently has). If this is false, then a new allocation will be done so that the buffer uses takes up the minimum amount of memory that it needs.
If the required memory can't be allocated, this will throw a std::bad_alloc exception.
int index AudioSampleBuffer::const |
int index int AudioSampleBuffer::index |