#include <AUD_SinusReader.h>
Public Member Functions | |
| AUD_SinusReader (float frequency, AUD_SampleRate sampleRate) | |
| 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 class is used for sine tone playback. The output format is in the 16 bit format and stereo, the sample rate can be specified. As the two channels both play the same the output could also be mono, but in most cases this will result in having to resample for output, so stereo sound is created directly.
Definition at line 46 of file AUD_SinusReader.h.
Constructor & Destructor Documentation
| AUD_SinusReader::AUD_SinusReader | ( | float | frequency, |
| AUD_SampleRate | sampleRate | ||
| ) |
Creates a new reader.
- Parameters:
-
frequency The frequency of the sine wave. sampleRate The output sample rate.
Definition at line 40 of file AUD_SinusReader.cpp.
Member Function Documentation
| int AUD_SinusReader::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 57 of file AUD_SinusReader.cpp.
| int AUD_SinusReader::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 62 of file AUD_SinusReader.cpp.
| AUD_Specs AUD_SinusReader::getSpecs | ( | ) | const [virtual] |
Returns the specification of the reader.
- Returns:
- The AUD_Specs structure.
Implements AUD_IReader.
Definition at line 67 of file AUD_SinusReader.cpp.
References AUD_CHANNELS_MONO, AUD_Specs::channels, and AUD_Specs::rate.
| bool AUD_SinusReader::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 47 of file AUD_SinusReader.cpp.
| void AUD_SinusReader::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] length The 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] buffer The pointer to the buffer with the samples.
Implements AUD_IReader.
Definition at line 75 of file AUD_SinusReader.cpp.
References AUD_Buffer::getBuffer(), AUD_Buffer::getSize(), i, length(), M_PI, AUD_Buffer::resize(), and sin().
| void AUD_SinusReader::seek | ( | int | position | ) | [virtual] |
Seeks to a specific position in the source. This function must work for buffer type readers.
- Parameters:
-
position The 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 52 of file AUD_SinusReader.cpp.
The documentation for this class was generated from the following files: