sf::InputSoundFile Class Reference

Warning

This page refers to an old version of SFML. Click here to switch to the latest version.

• Main Page
• Related Pages
• Topics
• Namespaces
• Classes
• Files

• Class List
• Class Index
• Class Hierarchy
• Class Members

• sf
• InputSoundFile

Public Member Functions | List of all members

sf::InputSoundFile Class Reference

Provide read access to sound files. More...

#include <SFML/Audio/InputSoundFile.hpp>

Inheritance diagram for sf::InputSoundFile:

Public Member Functions
	InputSoundFile ()
	Default constructor.
	~InputSoundFile ()
	Destructor.
bool	openFromFile (const std::string &filename)
	Open a sound file from the disk for reading.
bool	openFromMemory (const void *data, std::size_t sizeInBytes)
	Open a sound file in memory for reading.
bool	openFromStream (InputStream &stream)
	Open a sound file from a custom stream for reading.
bool	openForWriting (const std::string &filename, unsigned int channelCount, unsigned int sampleRate)
	Open the sound file from the disk for writing.
Uint64	getSampleCount () const
	Get the total number of audio samples in the file.
unsigned int	getChannelCount () const
	Get the number of channels used by the sound.
unsigned int	getSampleRate () const
	Get the sample rate of the sound.
Time	getDuration () const
	Get the total duration of the sound file.
void	seek (Uint64 sampleOffset)
	Change the current read position to the given sample offset.
void	seek (Time timeOffset)
	Change the current read position to the given time offset.
Uint64	read (Int16 *samples, Uint64 maxCount)
	Read audio samples from the open file.

Detailed Description

Provide read access to sound files.

This class decodes audio samples from a sound file.

It is used internally by higher-level classes such as sf::SoundBuffer and sf::Music, but can also be useful if you want to process or analyze audio files without playing them, or if you want to implement your own version of sf::Music with more specific features.

Usage example:

// Open a sound file
sf::InputSoundFile file;
if (!file.openFromFile("music.ogg"))
    /* error */;
 
// Print the sound attributes
std::cout << "duration: " << file.getDuration().asSeconds() << std::endl;
std::cout << "channels: " << file.getChannelCount() << std::endl;
std::cout << "sample rate: " << file.getSampleRate() << std::endl;
std::cout << "sample count: " << file.getSampleCount() << std::endl;
 
// Read and process batches of samples until the end of file is reached
sf::Int16 samples[1024];
sf::Uint64 count;
do
{
    count = file.read(samples, 1024);
 
    // process, analyze, play, convert, or whatever
    // you want to do with the samples...
}
while (count > 0);

See also

sf::SoundFileReader, sf::OutputSoundFile

Definition at line 46 of file InputSoundFile.hpp.

Constructor & Destructor Documentation

InputSoundFile()

sf::InputSoundFile::InputSoundFile

(

)

Default constructor.

~InputSoundFile()

sf::InputSoundFile::~InputSoundFile

(

)

Destructor.

Member Function Documentation

getChannelCount()

unsigned int sf::InputSoundFile::getChannelCount

(

)

const

Get the number of channels used by the sound.

Returns

Number of channels (1 = mono, 2 = stereo)

getDuration()

Time sf::InputSoundFile::getDuration

(

)

const

Get the total duration of the sound file.

This function is provided for convenience, the duration is deduced from the other sound file attributes.

Returns

Duration of the sound file

getSampleCount()

Uint64 sf::InputSoundFile::getSampleCount

(

)

const

Get the total number of audio samples in the file.

Returns

Number of samples

getSampleRate()

unsigned int sf::InputSoundFile::getSampleRate

(

)

const

Get the sample rate of the sound.

Returns

Sample rate, in samples per second

openForWriting()

bool sf::InputSoundFile::openForWriting	(	const std::string &	filename,
		unsigned int	channelCount,
		unsigned int	sampleRate )

Open the sound file from the disk for writing.

Parameters

filename	Path of the sound file to write
channelCount	Number of channels in the sound
sampleRate	Sample rate of the sound

Returns

True if the file was successfully opened

openFromFile()

bool sf::InputSoundFile::openFromFile

(

const std::string &

filename

)

Open a sound file from the disk for reading.

The supported audio formats are: WAV, OGG/Vorbis, FLAC.

Parameters

filename

Path of the sound file to load

Returns

True if the file was successfully opened

openFromMemory()

bool sf::InputSoundFile::openFromMemory	(	const void *	data,
		std::size_t	sizeInBytes )

Open a sound file in memory for reading.

The supported audio formats are: WAV, OGG/Vorbis, FLAC.

Parameters

data	Pointer to the file data in memory
sizeInBytes	Size of the data to load, in bytes

Returns

True if the file was successfully opened

openFromStream()

bool sf::InputSoundFile::openFromStream

(

InputStream &

stream

)

Open a sound file from a custom stream for reading.

The supported audio formats are: WAV, OGG/Vorbis, FLAC.

Parameters

stream

Source stream to read from

Returns

True if the file was successfully opened

read()

Uint64 sf::InputSoundFile::read	(	Int16 *	samples,
		Uint64	maxCount )

Read audio samples from the open file.

Parameters

samples	Pointer to the sample array to fill
maxCount	Maximum number of samples to read

Returns

Number of samples actually read (may be less than maxCount)

seek() [1/2]

void sf::InputSoundFile::seek

(

Time

timeOffset

)

Change the current read position to the given time offset.

Using a time offset is handy but imprecise. If you need an accurate result, consider using the overload which takes a sample offset.

If the given time exceeds to total duration, this function jumps to the end of the sound file.

Parameters

timeOffset

Time to jump to, relative to the beginning

seek() [2/2]

void sf::InputSoundFile::seek

(

Uint64

sampleOffset

)

Change the current read position to the given sample offset.

This function takes a sample offset to provide maximum precision. If you need to jump to a given time, use the other overload.

If the given offset exceeds to total number of samples, this function jumps to the end of the sound file.

Parameters

sampleOffset

Index of the sample to jump to, relative to the beginning

---

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

• InputSoundFile.hpp