#include <audiostream.h>
Public Member Functions | |
SubLoopingAudioStream (SeekableAudioStream *stream, uint loops, const Timestamp loopStart, const Timestamp loopEnd, DisposeAfterUse::Flag disposeAfterUse=DisposeAfterUse::YES) | |
int | readBuffer (int16 *buffer, const int numSamples) |
bool | endOfData () const |
bool | endOfStream () const |
bool | isStereo () const |
int | getRate () const |
uint | getCompleteIterations () const |
void | setRemainingIterations (uint loops) |
A looping audio stream that features looping of a nested part of the stream.
Important: This can be merged with SubSeekableAudioStream for playback purposes. To do this, it must be extended to accept a start time.
Audio::SubLoopingAudioStream::SubLoopingAudioStream | ( | SeekableAudioStream * | stream, |
uint | loops, | ||
const Timestamp | loopStart, | ||
const Timestamp | loopEnd, | ||
DisposeAfterUse::Flag | disposeAfterUse = DisposeAfterUse::YES |
||
) |
Constructor for a SubLoopingAudioStream.
On creation of the SubLoopingAudioStream object, the underlying stream will be rewound.
stream | The stream to loop. |
loops | How often the stream should be looped (0 means infinite). |
loopStart | Start of the loop (this must be smaller than loopEnd ). |
loopEnd | End of the loop (thus must be greater than loopStart ). |
disposeAfterUse | Whether the stream should be disposed when the SubLoopingAudioStream is destroyed. |
|
virtual |
Fill the given buffer with up to numSamples
samples.
Data must be in native endianness, 16 bits per sample, signed. For stereo stream, the buffer will be filled with interleaved left and right channel samples, starting with the left sample. Furthermore, the samples in the left and right are summed up. So if you request 4 samples from a stereo stream, you will get a total of two left channel and two right channel samples.
Implements Audio::AudioStream.
|
virtual |
Check whether end of data has been reached.
If this returns true, it indicates that at this time there is no data available in the stream. However, there might be more data in the future.
This is used by e.g. a rate converter to decide whether to keep on converting data or to stop.
Implements Audio::AudioStream.
|
virtual |
Check whether end of stream has been reached.
If this returns true, it indicates that all data in this stream is used up and no additional data will appear in it in the future.
This is used by the mixer to decide whether a given stream shall be removed from the list of active streams (and thus be destroyed). By default, this maps to endOfData().
Reimplemented from Audio::AudioStream.
|
inlinevirtual |
Check whether this is a stereo stream.
Implements Audio::AudioStream.
|
inlinevirtual |
Sample rate of the stream.
Implements Audio::AudioStream.
|
inlinevirtual |
Return the number of loops that the stream has played.
Implements Audio::LoopableAudioStream.
|
inlinevirtual |
Set the number of remaining loops the stream should play before stopping.
Implements Audio::LoopableAudioStream.