GNU Radio 3.7.2git-29-g7516b6dd C++ API
histogram_sink_f.h
Go to the documentation of this file.
1 /* -*- c++ -*- */
2 /*
3  * Copyright 2013 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 #ifndef INCLUDED_QTGUI_HISTOGRAM_SINK_F_H
24 #define INCLUDED_QTGUI_HISTOGRAM_SINK_F_H
25 
26 #include <Python.h>
27 #include <gnuradio/qtgui/api.h>
28 #include <gnuradio/sync_block.h>
29 #include <qapplication.h>
30 
31 namespace gr {
32  namespace qtgui {
33 
34  /*!
35  * \brief A graphical sink to display a histogram.
36  * \ingroup instrumentation_blk
37  * \ingroup qtgui_blk
38  *
39  * \details
40  * This is a QT-based graphical sink the displays a histogram of
41  * the data.
42  */
43  class QTGUI_API histogram_sink_f : virtual public sync_block
44  {
45  public:
46  // gr::qtgui::histogram_sink_f::sptr
48 
49  /*!
50  * \brief Build floating point histogram sink
51  *
52  * \param size number of points to plot at once
53  * \param bins number of bins to sort the data into
54  * \param xmin minimum x-axis value
55  * \param xmax maximum x-axis value
56  * \param name title for the plot
57  * \param nconnections number of signals connected to sink
58  * \param parent a QWidget parent object, if any
59  */
60  static sptr make(int size, int bins,
61  double xmin, double xmax,
62  const std::string &name,
63  int nconnections=1,
64  QWidget *parent=NULL);
65 
66  virtual void exec_() = 0;
67  virtual PyObject* pyqwidget() = 0;
68 
69  virtual void set_y_axis(double min, double max) = 0;
70  virtual void set_x_axis(double min, double max) = 0;
71  virtual void set_update_time(double t) = 0;
72  virtual void set_title(const std::string &title) = 0;
73  virtual void set_line_label(int which, const std::string &line) = 0;
74  virtual void set_line_color(int which, const std::string &color) = 0;
75  virtual void set_line_width(int which, int width) = 0;
76  virtual void set_line_style(int which, int style) = 0;
77  virtual void set_line_marker(int which, int marker) = 0;
78  virtual void set_line_alpha(int which, double alpha) = 0;
79  virtual void set_nsamps(const int newsize) = 0;
80  virtual void set_bins(const int bins) = 0;
81 
82  virtual std::string title() = 0;
83  virtual std::string line_label(int which) = 0;
84  virtual std::string line_color(int which) = 0;
85  virtual int line_width(int which) = 0;
86  virtual int line_style(int which) = 0;
87  virtual int line_marker(int which) = 0;
88  virtual double line_alpha(int which) = 0;
89 
90  virtual void set_size(int width, int height) = 0;
91 
92  virtual void enable_menu(bool en=true) = 0;
93  virtual void enable_grid(bool en=true) = 0;
94  virtual void enable_autoscale(bool en=true) = 0;
95  virtual void enable_semilogx(bool en=true) = 0;
96  virtual void enable_semilogy(bool en=true) = 0;
97  virtual void enable_accumulate(bool en=true) = 0;
98  virtual int nsamps() const = 0;
99  virtual int bins() const = 0;
100  virtual void reset() = 0;
101 
102  QApplication *d_qApplication;
103  };
104 
105  } /* namespace qtgui */
106 } /* namespace gr */
107 
108 #endif /* INCLUDED_QTGUI_HISTOGRAM_SINK_F_H */