Blender  V2.59
Public Member Functions
AUD_DoubleReader Class Reference

#include <AUD_DoubleReader.h>

Inheritance diagram for AUD_DoubleReader:
Inheritance graph
[legend]

List of all members.

Public Member Functions

 AUD_DoubleReader (AUD_IReader *reader1, AUD_IReader *reader2)
virtual ~AUD_DoubleReader ()
virtual bool isSeekable () const
virtual void seek (int position)
virtual int getLength () const
virtual int getPosition () const
virtual AUD_Specs getSpecs () const
virtual void read (int &length, sample_t *&buffer)

Detailed Description

This reader plays two readers with the same specs sequently.

Definition at line 41 of file AUD_DoubleReader.h.


Constructor & Destructor Documentation

AUD_DoubleReader::AUD_DoubleReader ( AUD_IReader reader1,
AUD_IReader reader2 
)

Creates a new ping pong reader.

Parameters:
reader1The first reader to read from.
reader2The second reader to read from.
Exceptions:
AUD_ExceptionThrown if the specs from the readers differ.

Definition at line 39 of file AUD_DoubleReader.cpp.

References AUD_ERROR_SPECS, AUD_THROW, AUD_IReader::getSpecs(), and specs_error.

AUD_DoubleReader::~AUD_DoubleReader ( ) [virtual]

Destroys the reader.

Definition at line 54 of file AUD_DoubleReader.cpp.


Member Function Documentation

int AUD_DoubleReader::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

Implements AUD_IReader.

Definition at line 77 of file AUD_DoubleReader.cpp.

References AUD_IReader::getLength().

int AUD_DoubleReader::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

Implements AUD_IReader.

Definition at line 86 of file AUD_DoubleReader.cpp.

References AUD_IReader::getPosition().

AUD_Specs AUD_DoubleReader::getSpecs ( ) const [virtual]

Returns the specification of the reader.

Returns:
The AUD_Specs structure.

Implements AUD_IReader.

Definition at line 91 of file AUD_DoubleReader.cpp.

References AUD_IReader::getSpecs().

bool AUD_DoubleReader::isSeekable ( ) const [virtual]

Tells whether the source provides seeking functionality or not.

Warning:
This doesn't mean that the seeking always has to succeed.
Returns:
Always returns true for readers of the buffer type.
See also:
getType

Implements AUD_IReader.

Definition at line 60 of file AUD_DoubleReader.cpp.

References AUD_IReader::isSeekable().

void AUD_DoubleReader::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.

Implements AUD_IReader.

Definition at line 96 of file AUD_DoubleReader.cpp.

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

void AUD_DoubleReader::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

Implements AUD_IReader.

Definition at line 65 of file AUD_DoubleReader.cpp.

References AUD_IReader::getPosition(), and AUD_IReader::seek().


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