Documentation of SFML 2.4.1

Warning: this page refers to an old version of SFML. Click here to switch to the latest version.
InputSoundFile.hpp
1 //
3 // SFML - Simple and Fast Multimedia Library
4 // Copyright (C) 2007-2016 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 
36 
37 namespace sf
38 {
39 class InputStream;
40 class SoundFileReader;
41 
46 class SFML_AUDIO_API InputSoundFile : NonCopyable
47 {
48 public:
49 
55 
60  ~InputSoundFile();
61 
73  bool openFromFile(const std::string& filename);
74 
87  bool openFromMemory(const void* data, std::size_t sizeInBytes);
88 
100  bool openFromStream(InputStream& stream);
101 
112  bool openForWriting(const std::string& filename, unsigned int channelCount, unsigned int sampleRate);
113 
120  Uint64 getSampleCount() const;
121 
128  unsigned int getChannelCount() const;
129 
136  unsigned int getSampleRate() const;
137 
147  Time getDuration() const;
148 
165  void seek(Uint64 sampleOffset);
166 
179  void seek(Time timeOffset);
180 
190  Uint64 read(Int16* samples, Uint64 maxCount);
191 
192 private:
193 
198  void close();
199 
201  // Member data
203  SoundFileReader* m_reader;
204  InputStream* m_stream;
205  bool m_streamOwned;
206  Uint64 m_sampleCount;
207  unsigned int m_channelCount;
208  unsigned int m_sampleRate;
209 };
210 
211 } // namespace sf
212 
213 
214 #endif // SFML_INPUTSOUNDFILE_HPP
215 
216 
Abstract class for custom file input streams.
Definition: InputStream.hpp:41
Represents a time value.
Definition: Time.hpp:40
Provide read access to sound files.
Utility class that makes any derived class non-copyable.
Definition: NonCopyable.hpp:41
Abstract base class for sound file decoding.