Blender  V2.59
Public Member Functions
AUD_LoopReader Class Reference

#include <AUD_LoopReader.h>

Inheritance diagram for AUD_LoopReader:
Inheritance graph
[legend]

List of all members.

Public Member Functions

 AUD_LoopReader (AUD_IReader *reader, int loop)
virtual void seek (int position)
virtual int getLength () const
virtual int getPosition () const
virtual void read (int &length, sample_t *&buffer)

Detailed Description

This class reads another reader and loops it.

Note:
The other reader must be seekable.

Definition at line 42 of file AUD_LoopReader.h.


Constructor & Destructor Documentation

AUD_LoopReader::AUD_LoopReader ( AUD_IReader reader,
int  loop 
)

Creates a new loop reader.

Parameters:
readerThe reader to read from.
loopThe desired loop count, negative values result in endless looping.

Definition at line 37 of file AUD_LoopReader.cpp.


Member Function Documentation

int AUD_LoopReader::getLength ( ) const [virtual]

Returns an approximated length of the source in samples. For readers of the type buffer this has to return a correct value!

Returns:
The length as sample count. May be negative if unknown.
See also:
getType

Reimplemented from AUD_EffectReader.

Definition at line 59 of file AUD_LoopReader.cpp.

References AUD_IReader::getLength(), and AUD_EffectReader::m_reader.

int AUD_LoopReader::getPosition ( ) const [virtual]

Returns the position of the source as a sample count value.

Returns:
The current position in the source. A negative value indicates that the position is unknown.
Warning:
The value returned doesn't always have to be correct for readers of the stream type, especially after seeking, it must though for the buffer ones.
See also:
getType

Reimplemented from AUD_EffectReader.

Definition at line 66 of file AUD_LoopReader.cpp.

References AUD_IReader::getPosition(), and AUD_EffectReader::m_reader.

void AUD_LoopReader::read ( int &  length,
sample_t *&  buffer 
) [virtual]

Request to read the next length samples out of the source. The buffer for reading has to stay valid until the next call of this method or until the reader is deleted.

Parameters:
[in,out]lengthThe count of samples that should be read. Shall contain the real count of samples after reading, in case there were only fewer samples available. A smaller value also indicates the end of the reader.
[out]bufferThe pointer to the buffer with the samples.

Reimplemented from AUD_EffectReader.

Definition at line 71 of file AUD_LoopReader.cpp.

References AUD_SAMPLE_SIZE, AUD_Specs::channels, AUD_Buffer::getBuffer(), AUD_Buffer::getSize(), AUD_IReader::getSpecs(), length(), AUD_EffectReader::m_reader, AUD_IReader::read(), AUD_Buffer::resize(), and AUD_IReader::seek().

void AUD_LoopReader::seek ( int  position) [virtual]

Seeks to a specific position in the source. This function must work for buffer type readers.

Parameters:
positionThe position to seek for measured in samples. To get from a given time to the samples you simply have to multiply the time value in seconds with the sample rate of the reader.
Warning:
This may work or not, depending on the actual reader.
See also:
getType

Reimplemented from AUD_EffectReader.

Definition at line 42 of file AUD_LoopReader.cpp.

References AUD_IReader::getLength(), AUD_EffectReader::m_reader, and AUD_IReader::seek().


The documentation for this class was generated from the following files: