GNU Radio Manual and C++ API Reference
3.7.5
The Free & Open Software Radio Ecosystem
All
Classes
Namespaces
Files
Functions
Variables
Typedefs
Enumerations
Enumerator
Properties
Friends
Macros
Groups
Pages
const_sink_c.h
Go to the documentation of this file.
1
/* -*- c++ -*- */
2
/*
3
* Copyright 2012,2014 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_CONST_SINK_C_H
24
#define INCLUDED_QTGUI_CONST_SINK_C_H
25
26
#ifdef ENABLE_PYTHON
27
#include <Python.h>
28
#endif
29
30
#include <
gnuradio/qtgui/api.h
>
31
#include <
gnuradio/qtgui/trigger_mode.h
>
32
#include <
gnuradio/sync_block.h
>
33
#include <qapplication.h>
34
#include <
gnuradio/filter/firdes.h
>
35
36
namespace
gr {
37
namespace
qtgui {
38
39
/*!
40
* \brief A graphical sink to display the IQ constellation of multiple signals.
41
* \ingroup instrumentation_blk
42
* \ingroup qtgui_blk
43
*
44
* \details
45
* This is a QT-based graphical sink the takes set of a complex
46
* streams and plots them on an IQ constellation plot.
47
*/
48
class
QTGUI_API
const_sink_c
:
virtual
public
sync_block
49
{
50
public
:
51
// gr::qtgui::const_sink_c::sptr
52
typedef
boost::shared_ptr<const_sink_c>
sptr
;
53
54
/*!
55
* \brief Build a constellation plot sink.
56
*
57
* \param size number of points to plot at once
58
* \param name title for the plot
59
* \param nconnections number of signals connected to sink
60
* \param parent a QWidget parent object, if any
61
*/
62
static
sptr
make(
int
size,
63
const
std::string &name,
64
int
nconnections=1,
65
QWidget *parent=NULL);
66
67
virtual
void
exec_() = 0;
68
virtual
QWidget* qwidget() = 0;
69
70
#ifdef ENABLE_PYTHON
71
virtual
PyObject* pyqwidget() = 0;
72
#else
73
virtual
void
* pyqwidget() = 0;
74
#endif
75
76
virtual
void
set_y_axis(
double
min
,
double
max) = 0;
77
virtual
void
set_x_axis(
double
min
,
double
max) = 0;
78
79
virtual
void
set_update_time(
double
t) = 0;
80
virtual
void
set_title(
const
std::string &title) = 0;
81
virtual
void
set_line_label(
int
which,
const
std::string &label) = 0;
82
virtual
void
set_line_color(
int
which,
const
std::string &color) = 0;
83
virtual
void
set_line_width(
int
which,
int
width) = 0;
84
virtual
void
set_line_style(
int
which,
int
style) = 0;
85
virtual
void
set_line_marker(
int
which,
int
marker) = 0;
86
virtual
void
set_nsamps(
const
int
newsize) = 0;
87
virtual
void
set_line_alpha(
int
which,
double
alpha) = 0;
88
89
/*!
90
* Set up a trigger for the sink to know when to start
91
* plotting. Useful to isolate events and avoid noise.
92
*
93
* The trigger modes are Free, Auto, Normal, and Tag (see
94
* gr::qtgui::trigger_mode). The first three are like a normal
95
* oscope trigger function. Free means free running with no
96
* trigger, auto will trigger if the trigger event is seen, but
97
* will still plot otherwise, and normal will hold until the
98
* trigger event is observed. The Tag trigger mode allows us to
99
* trigger off a specific stream tag. The tag trigger is based
100
* only on the name of the tag, so when a tag of the given name
101
* is seen, the trigger is activated.
102
*
103
* In auto and normal mode, we look for the slope of the
104
* magnitude of the signal. As a constellation sink, this only
105
* takes in complex numbers to plot. Given a
106
* gr::qtgui::trigger_slope as either Positive or Negative, if
107
* the magnitude between two samples moves in the given
108
* direction (x[1] > x[0] for Positive or x[1] < x[0] for
109
* Negative), then the trigger is activated.
110
*
111
* \param mode The trigger_mode: free, auto, normal, or tag.
112
* \param slope The trigger_slope: positive or negative. Only
113
* used for auto and normal modes.
114
* \param level The magnitude of the trigger even for auto or normal modes.
115
* \param channel Which input channel to use for the trigger events.
116
* \param tag_key The name (as a string) of the tag to trigger off
117
* of if using the tag mode.
118
*/
119
virtual
void
set_trigger_mode(
trigger_mode
mode,
trigger_slope
slope,
120
float
level,
int
channel,
121
const
std::string &tag_key=
""
) = 0;
122
123
virtual
std::string title() = 0;
124
virtual
std::string line_label(
int
which) = 0;
125
virtual
std::string line_color(
int
which) = 0;
126
virtual
int
line_width(
int
which) = 0;
127
virtual
int
line_style(
int
which) = 0;
128
virtual
int
line_marker(
int
which) = 0;
129
virtual
double
line_alpha(
int
which) = 0;
130
131
virtual
void
set_size(
int
width,
int
height) = 0;
132
133
virtual
void
enable_menu(
bool
en=
true
) = 0;
134
virtual
void
enable_autoscale(
bool
en) = 0;
135
virtual
void
enable_grid(
bool
en) = 0;
136
virtual
int
nsamps()
const
= 0;
137
virtual
void
reset() = 0;
138
139
QApplication *
d_qApplication
;
140
};
141
142
}
/* namespace qtgui */
143
}
/* namespace gr */
144
145
#endif
/* INCLUDED_QTGUI_CONST_SINK_C_H */
gr-qtgui
include
gnuradio
qtgui
const_sink_c.h
Generated on Fri Oct 3 2014 00:33:50 for GNU Radio Manual and C++ API Reference by
1.8.1.2