Make annotation export customizable
[pulseview.git] / pv / views / trace / timemarker.hpp
1 /*
2  * This file is part of the PulseView project.
3  *
4  * Copyright (C) 2012 Joel Holdsworth <joel@airwebreathe.org.uk>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, see <http://www.gnu.org/licenses/>.
18  */
19
20 #ifndef PULSEVIEW_PV_VIEWS_TRACEVIEW_MARKER_HPP
21 #define PULSEVIEW_PV_VIEWS_TRACEVIEW_MARKER_HPP
22
23 #include <QColor>
24 #include <QDoubleSpinBox>
25 #include <QObject>
26 #include <QRectF>
27 #include <QWidgetAction>
28
29 #include "timeitem.hpp"
30
31 class QPainter;
32 class QRect;
33
34 namespace pv {
35 namespace widgets {
36         class TimestampSpinBox;
37 }
38
39 namespace views {
40 namespace trace {
41
42 class View;
43
44 /**
45  * The TimeMarker class represents items on the @ref Ruler that highlight a
46  * single point in time to the user. Aside from this, it is generic in nature.
47  */
48 class TimeMarker : public TimeItem
49 {
50         Q_OBJECT
51
52 public:
53         static const int ArrowSize;
54
55 protected:
56         /**
57          * Constructor.
58          * @param view A reference to the view that owns this marker.
59          * @param color A reference to the color of this cursor.
60          * @param time The time to set the flag to.
61          */
62         TimeMarker(View &view, const QColor &color, const pv::util::Timestamp& time);
63
64 public:
65         /**
66          * Gets the time of the marker.
67          */
68         const pv::util::Timestamp& time() const;
69
70         /**
71          * Sets the time of the marker.
72          */
73         void set_time(const pv::util::Timestamp& time) override;
74
75         float get_x() const override;
76
77         /**
78          * Gets the arrow-tip point of the time marker.
79          * @param rect the rectangle of the ruler area.
80          */
81         QPoint drag_point(const QRect &rect) const override;
82
83         /**
84          * Computes the outline rectangle of a label.
85          * @param rect the rectangle of the header area.
86          * @return Returns the rectangle of the signal label.
87          */
88         QRectF label_rect(const QRectF &rect) const override;
89
90         /**
91          * Computes the outline rectangle of the viewport hit-box.
92          * @param rect the rectangle of the viewport area.
93          * @return Returns the rectangle of the hit-box.
94          */
95         QRectF hit_box_rect(const ViewItemPaintParams &pp) const override;
96
97         /**
98          * Gets the text to show in the marker.
99          */
100         virtual QString get_text() const = 0;
101
102         /**
103          * Paints the marker's label to the ruler.
104          * @param p The painter to draw with.
105          * @param rect The rectangle of the ruler client area.
106          * @param hover true if the label is being hovered over by the mouse.
107          */
108         void paint_label(QPainter &p, const QRect &rect, bool hover) override;
109
110         /**
111          * Paints the foreground layer of the item with a QPainter
112          * @param p the QPainter to paint into.
113          * @param pp the painting parameters object to paint with.
114          */
115         void paint_fore(QPainter &p, ViewItemPaintParams &pp) override;
116
117         virtual pv::widgets::Popup* create_popup(QWidget *parent) override;
118
119 private Q_SLOTS:
120         void on_value_changed(const pv::util::Timestamp& value);
121
122 protected:
123         const QColor &color_;
124
125         pv::util::Timestamp time_;
126
127         QSizeF text_size_;
128
129         QWidgetAction *value_action_;
130         pv::widgets::TimestampSpinBox *value_widget_;
131         bool updating_value_widget_;
132 };
133
134 } // namespace trace
135 } // namespace views
136 } // namespace pv
137
138 #endif // PULSEVIEW_PV_VIEWS_TRACEVIEW_MARKER_HPP