Imported Upstream version 3.2.2
[debian/gnuradio] / gnuradio-core / src / lib / runtime / gr_top_block.i
1 /* -*- c++ -*- */
2 /*
3  * Copyright 2007,2008 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
23 %include <gr_top_block.i>
24
25 class gr_top_block;
26 typedef boost::shared_ptr<gr_top_block> gr_top_block_sptr;
27 %template(gr_top_block_sptr) boost::shared_ptr<gr_top_block>;
28
29 // Hack to have a Python shim implementation of gr.top_block
30 // that instantiates one of these and passes through calls
31 %rename(top_block_swig) gr_make_top_block;
32 gr_top_block_sptr gr_make_top_block(const std::string name) 
33   throw (std::logic_error);
34
35 class gr_top_block : public gr_hier_block2
36 {
37 private:
38   gr_top_block(const std::string &name);
39     
40 public:
41   ~gr_top_block();
42
43   void start() throw (std::runtime_error);
44   void stop();
45   void wait();
46   void run();
47   void lock();
48   void unlock() throw (std::runtime_error);
49   void dump();
50 };
51
52 %inline %{
53 void top_block_run_unlocked(gr_top_block_sptr r) throw (std::runtime_error) 
54 {
55     Py_BEGIN_ALLOW_THREADS;             // release global interpreter lock
56     r->run();
57     Py_END_ALLOW_THREADS;               // acquire global interpreter lock
58 }
59
60 void top_block_wait_unlocked(gr_top_block_sptr r) throw (std::runtime_error) 
61 {
62     Py_BEGIN_ALLOW_THREADS;             // release global interpreter lock
63     r->wait();
64     Py_END_ALLOW_THREADS;               // acquire global interpreter lock
65 }
66 %}