SFML - Simple and Fast Multimedia Library

SFML 2.6.1

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

- File List
- File Members

Loading...
Searching...
No Matches
InputSoundFile.hpp
1
2//
3// SFML - Simple and Fast Multimedia Library
4// Copyright (C) 2007-2023 Laurent Gomila (laurent@sfml-dev.org)
5//
6// This software is provided 'as-is', without any express or implied warranty.
7// In no event will the authors be held liable for any damages arising from the use of this software.
8//
9// Permission is granted to anyone to use this software for any purpose,
10// including commercial applications, and to alter it and redistribute it freely,
11// subject to the following restrictions:
12//
13// 1. The origin of this software must not be misrepresented;
14// you must not claim that you wrote the original software.
15// If you use this software in a product, an acknowledgment
16// in the product documentation would be appreciated but is not required.
17//
18// 2. Altered source versions must be plainly marked as such,
19// and must not be misrepresented as being the original software.
20//
21// 3. This notice may not be removed or altered from any source distribution.
22//
24
25#ifndef SFML_INPUTSOUNDFILE_HPP
26#define SFML_INPUTSOUNDFILE_HPP
27
29// Headers
31#include <SFML/Audio/Export.hpp>
32#include <SFML/System/NonCopyable.hpp>
33#include <SFML/System/Time.hpp>
34#include <string>
35#include <cstddef>
36
37
38namespace sf
39{
40class InputStream;
41class SoundFileReader;
42
47 class SFML_AUDIO_API InputSoundFile : NonCopyable
48{
49public:
50
55 InputSoundFile();
56
61 ~InputSoundFile();
62
79 bool openFromFile(const std::string& filename);
80
93 bool openFromMemory(const void* data, std::size_t sizeInBytes);
94
106 bool openFromStream(InputStream& stream);
107
114 Uint64 getSampleCount() const;
115
122 unsigned int getChannelCount() const;
123
130 unsigned int getSampleRate() const;
131
141 Time getDuration() const;
142
149 Time getTimeOffset() const;
150
157 Uint64 getSampleOffset() const;
158
176 void seek(Uint64 sampleOffset);
177
190 void seek(Time timeOffset);
191
201 Uint64 read(Int16* samples, Uint64 maxCount);
202
207 void close();
208
209private:
210
212 // Member data
214 SoundFileReader* m_reader;
215 InputStream* m_stream;
216 bool m_streamOwned;
217 Uint64 m_sampleOffset;
218 Uint64 m_sampleCount;
219 unsigned int m_channelCount;
220 unsigned int m_sampleRate;
221};
222
223} // namespace sf
224
225
226#endif // SFML_INPUTSOUNDFILE_HPP
227
228
sf::InputSoundFile
Provide read access to sound files.
Definition InputSoundFile.hpp:48
sf::InputSoundFile::~InputSoundFile
~InputSoundFile()
Destructor.
sf::InputSoundFile::openFromStream
bool openFromStream(InputStream &stream)
Open a sound file from a custom stream for reading.
sf::InputSoundFile::InputSoundFile
InputSoundFile()
Default constructor.
sf::InputSoundFile::openFromMemory
bool openFromMemory(const void *data, std::size_t sizeInBytes)
Open a sound file in memory for reading.
sf::InputSoundFile::getChannelCount
unsigned int getChannelCount() const
Get the number of channels used by the sound.
sf::InputSoundFile::getSampleCount
Uint64 getSampleCount() const
Get the total number of audio samples in the file.
sf::InputSoundFile::getSampleRate
unsigned int getSampleRate() const
Get the sample rate of the sound.
sf::InputSoundFile::getSampleOffset
Uint64 getSampleOffset() const
Get the read offset of the file in samples.
sf::InputSoundFile::read
Uint64 read(Int16 *samples, Uint64 maxCount)
Read audio samples from the open file.
sf::InputSoundFile::seek
void seek(Time timeOffset)
Change the current read position to the given time offset.
sf::InputSoundFile::getDuration
Time getDuration() const
Get the total duration of the sound file.
sf::InputSoundFile::seek
void seek(Uint64 sampleOffset)
Change the current read position to the given sample offset.
sf::InputSoundFile::getTimeOffset
Time getTimeOffset() const
Get the read offset of the file in time.
sf::InputSoundFile::close
void close()
Close the current file.
sf::InputSoundFile::openFromFile
bool openFromFile(const std::string &filename)
Open a sound file from the disk for reading.
sf::InputStream
Abstract class for custom file input streams.
Definition InputStream.hpp:42
sf::NonCopyable
Utility class that makes any derived class non-copyable.
Definition NonCopyable.hpp:42
sf::SoundFileReader
Abstract base class for sound file decoding.
Definition SoundFileReader.hpp:44
sf::Time
Represents a time value.
Definition Time.hpp:41