Merge commit 'v3.3.0' into upstream
[debian/gnuradio] / gr-audio-portaudio / src / audio_portaudio_source.h
1 /* -*- c++ -*- */
2 /*
3  * Copyright 2006.2010 Free Software Foundation, Inc.
4  * 
5  * This file is part of GNU Radio
6  * 
7  * GNU Radio is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 3, or (at your option)
10  * any later version.
11  * 
12  * GNU Radio is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  * 
17  * You should have received a copy of the GNU General Public License
18  * along with GNU Radio; see the file COPYING.  If not, write to
19  * the Free Software Foundation, Inc., 51 Franklin Street,
20  * Boston, MA 02110-1301, USA.
21  */
22 #ifndef INCLUDED_AUDIO_PORTAUDIO_SOURCE_H
23 #define INCLUDED_AUDIO_PORTAUDIO_SOURCE_H
24
25 #include <gr_sync_block.h>
26 #include <gr_buffer.h>
27 #include <gruel/thread.h>
28 #include <string>
29 #include <portaudio.h>
30 #include <stdexcept>
31
32 class audio_portaudio_source;
33 typedef boost::shared_ptr<audio_portaudio_source> audio_portaudio_source_sptr;
34
35 /*!
36  * \brief PORTAUDIO audio source.
37  *
38  * \param sampling_rate sampling rate in Hz
39  * \param device_name PORTAUDIO device name, e.g., "pa:"
40  * \param ok_to_block   true if it's ok for us to block
41  */
42 audio_portaudio_source_sptr
43 audio_portaudio_make_source (int sampling_rate,
44                            const std::string device_name = "",
45                            bool ok_to_block = true);
46
47 PaStreamCallback portaudio_source_callback;
48
49
50 /*!
51  * \ Audio source using PORTAUDIO
52  *
53  * Input samples must be in the range [-1,1].
54  */
55 class audio_portaudio_source : public gr_sync_block {
56   friend audio_portaudio_source_sptr
57   audio_portaudio_make_source (int sampling_rate,
58                              const std::string device_name,
59                              bool ok_to_block);
60
61   friend PaStreamCallback portaudio_source_callback;
62
63
64   unsigned int          d_sampling_rate;
65   std::string           d_device_name;
66   bool                  d_ok_to_block;
67   bool                  d_verbose;
68
69   unsigned int          d_portaudio_buffer_size_frames; // number of frames in a portaudio buffer
70
71   PaStream              *d_stream;
72   PaStreamParameters    d_input_parameters;
73
74   gr_buffer_sptr        d_writer;               // buffer used between work and callback
75   gr_buffer_reader_sptr d_reader;
76
77   gruel::mutex          d_ringbuffer_mutex;
78   gruel::condition_variable d_ringbuffer_cond;
79   bool                  d_ringbuffer_ready;
80
81   // random stats
82   int                   d_noverruns;            // count of overruns
83
84   void output_error_msg (const char *msg, int err);
85   void bail (const char *msg, int err) throw (std::runtime_error);
86   void create_ringbuffer();
87
88
89  protected:
90   audio_portaudio_source (int sampling_rate, const std::string device_name,
91                           bool ok_to_block);
92
93  public:
94   ~audio_portaudio_source ();
95   
96   bool check_topology (int ninputs, int noutputs);
97
98   int work (int ninput_items,
99             gr_vector_const_void_star &input_items,
100             gr_vector_void_star &output_items);
101 };
102
103 #endif /* INCLUDED_AUDIO_PORTAUDIO_SOURCE_H */