SFML 2.5.1

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

- File List
- File Members

SoundRecorder.hpp
1 //
3 // SFML - Simple and Fast Multimedia Library
4 // Copyright (C) 2007-2018 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_SOUNDRECORDER_HPP
26 #define SFML_SOUNDRECORDER_HPP
27
29 // Headers
31 #include <SFML/Audio/Export.hpp>
32 #include <SFML/Audio/AlResource.hpp>
33 #include <SFML/System/Thread.hpp>
34 #include <SFML/System/Time.hpp>
35 #include <vector>
36 #include <string>
37
38
39 namespace sf
40 {
45 class SFML_AUDIO_API SoundRecorder : AlResource
46 {
47 public:
48
53 virtual ~SoundRecorder();
54
77 bool start(unsigned int sampleRate = 44100);
78
85 void stop();
86
97 unsigned int getSampleRate() const;
98
108 static std::vector<std::string> getAvailableDevices();
109
120 static std::string getDefaultDevice();
121
137 bool setDevice(const std::string& name);
138
145 const std::string& getDevice() const;
146
160 void setChannelCount(unsigned int channelCount);
161
173 unsigned int getChannelCount() const;
174
186 static bool isAvailable();
187
188 protected:
189
196 SoundRecorder();
197
214 void setProcessingInterval(Time interval);
215
227 virtual bool onStart();
228
243 virtual bool onProcessSamples(const Int16* samples, std::size_t sampleCount) = 0;
244
254 virtual void onStop();
255
256 private:
257
265 void record();
266
275 void processCapturedSamples();
276
283 void cleanup();
284
286 // Member data
288 Thread m_thread;
289 std::vector<Int16> m_samples;
290 unsigned int m_sampleRate;
291 Time m_processingInterval;
292 bool m_isCapturing;
293 std::string m_deviceName;
294 unsigned int m_channelCount;
295 };
296
297 } // namespace sf
298
299
300 #endif // SFML_SOUNDRECORDER_HPP
301
302
sf::AlResource
Base class for classes that require an OpenAL context.
Definition: AlResource.hpp:41
sf::SoundRecorder
Abstract base class for capturing sound data.
Definition: SoundRecorder.hpp:46
sf::SoundRecorder::getAvailableDevices
static std::vector< std::string > getAvailableDevices()
Get a list of the names of all available audio capture devices.
sf::SoundRecorder::onProcessSamples
virtual bool onProcessSamples(const Int16 *samples, std::size_t sampleCount)=0
Process a new chunk of recorded samples.
sf::SoundRecorder::SoundRecorder
SoundRecorder()
Default constructor.
sf::SoundRecorder::getChannelCount
unsigned int getChannelCount() const
Get the number of channels used by this recorder.
sf::SoundRecorder::start
bool start(unsigned int sampleRate=44100)
Start the capture.
sf::SoundRecorder::onStart
virtual bool onStart()
Start capturing audio data.
sf::SoundRecorder::setProcessingInterval
void setProcessingInterval(Time interval)
Set the processing interval.
sf::SoundRecorder::stop
void stop()
Stop the capture.
sf::SoundRecorder::setDevice
bool setDevice(const std::string &name)
Set the audio capture device.
sf::SoundRecorder::isAvailable
static bool isAvailable()
Check if the system supports audio capture.
sf::SoundRecorder::getDevice
const std::string & getDevice() const
Get the name of the current audio capture device.
sf::SoundRecorder::~SoundRecorder
virtual ~SoundRecorder()
destructor
sf::SoundRecorder::getDefaultDevice
static std::string getDefaultDevice()
Get the name of the default audio capture device.
sf::SoundRecorder::setChannelCount
void setChannelCount(unsigned int channelCount)
Set the channel count of the audio capture device.
sf::SoundRecorder::getSampleRate
unsigned int getSampleRate() const
Get the sample rate.
sf::SoundRecorder::onStop
virtual void onStop()
Stop capturing audio data.
sf::Thread
Utility class to manipulate threads.
Definition: Thread.hpp:49
sf::Time
Represents a time value.
Definition: Time.hpp:41