SoundRecorder.hpp

00001 
00002 //
00003 // SFML - Simple and Fast Multimedia Library
00004 // Copyright (C) 2007 Laurent Gomila (laurent.gom@gmail.com)
00005 //
00006 // This software is provided 'as-is', without any express or implied warranty.
00007 // In no event will the authors be held liable for any damages arising from the use of this software.
00008 //
00009 // Permission is granted to anyone to use this software for any purpose,
00010 // including commercial applications, and to alter it and redistribute it freely,
00011 // subject to the following restrictions:
00012 //
00013 // 1. The origin of this software must not be misrepresented;
00014 //    you must not claim that you wrote the original software.
00015 //    If you use this software in a product, an acknowledgment
00016 //    in the product documentation would be appreciated but is not required.
00017 //
00018 // 2. Altered source versions must be plainly marked as such,
00019 //    and must not be misrepresented as being the original software.
00020 //
00021 // 3. This notice may not be removed or altered from any source distribution.
00022 //
00024 
00025 #ifndef SFML_SOUNDRECORDER_HPP
00026 #define SFML_SOUNDRECORDER_HPP
00027 
00029 // Headers
00031 #include <SFML/System/Thread.hpp>
00032 #include <vector>
00033 
00034 
00035 namespace sf
00036 {
00041 class SFML_API SoundRecorder : private Thread
00042 {
00043 public :
00044 
00045     typedef bool (*FuncType)(const Int16*, std::size_t, void*);
00046 
00055     SoundRecorder(FuncType Callback, void* UserData = NULL);
00056 
00061     virtual ~SoundRecorder();
00062 
00071     void Start(unsigned int SampleRate = 44100);
00072 
00077     void Stop();
00078 
00085     unsigned int GetSampleRate() const;
00086 
00094     static bool CanCapture();
00095 
00096 protected :
00097 
00102     SoundRecorder();
00103 
00104 private :
00105 
00115     virtual bool ProcessSamples(const Int16* Samples, std::size_t SamplesCount);
00116 
00121     virtual void Run();
00122 
00127     void ProcessCapturedSamples();
00128 
00133     void CleanUp();
00134 
00136     // Member data
00138     FuncType           myCallback;    
00139     void*              myUserData;    
00140     std::vector<Int16> mySamples;     
00141     unsigned int       mySampleRate;  
00142     bool               myIsCapturing; 
00143 };
00144 
00145 } // namespace sf
00146 
00147 
00148 #endif // SFML_SOUNDRECORDER_HPP