]> sigrok.org Git - pulseview.git/blame_incremental - pv/views/trace/ruler.cpp
DecodeTrace: Fix on_setting_changed() handling
[pulseview.git] / pv / views / trace / ruler.cpp
... / ...
CommitLineData
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#include <extdef.h>
21
22#include <QFontMetrics>
23#include <QMenu>
24#include <QMouseEvent>
25
26#include <pv/globalsettings.hpp>
27
28#include "ruler.hpp"
29#include "view.hpp"
30
31using namespace Qt;
32
33using std::function;
34using std::max;
35using std::min;
36using std::shared_ptr;
37using std::vector;
38
39namespace pv {
40namespace views {
41namespace trace {
42
43const float Ruler::RulerHeight = 2.5f; // x Text Height
44
45const float Ruler::HoverArrowSize = 0.5f; // x Text Height
46
47Ruler::Ruler(View &parent) :
48 MarginWidget(parent)
49{
50 setMouseTracking(true);
51
52 connect(&view_, SIGNAL(hover_point_changed(const QWidget*, QPoint)),
53 this, SLOT(on_hover_point_changed(const QWidget*, QPoint)));
54 connect(&view_, SIGNAL(offset_changed()),
55 this, SLOT(invalidate_tick_position_cache()));
56 connect(&view_, SIGNAL(scale_changed()),
57 this, SLOT(invalidate_tick_position_cache()));
58 connect(&view_, SIGNAL(tick_prefix_changed()),
59 this, SLOT(invalidate_tick_position_cache()));
60 connect(&view_, SIGNAL(tick_precision_changed()),
61 this, SLOT(invalidate_tick_position_cache()));
62 connect(&view_, SIGNAL(tick_period_changed()),
63 this, SLOT(invalidate_tick_position_cache()));
64 connect(&view_, SIGNAL(time_unit_changed()),
65 this, SLOT(invalidate_tick_position_cache()));
66}
67
68QSize Ruler::sizeHint() const
69{
70 const int text_height = calculate_text_height();
71 return QSize(0, RulerHeight * text_height);
72}
73
74QSize Ruler::extended_size_hint() const
75{
76 QRectF max_rect;
77 vector< shared_ptr<TimeItem> > items(view_.time_items());
78 for (auto &i : items)
79 max_rect = max_rect.united(i->label_rect(QRect()));
80 return QSize(0, sizeHint().height() - max_rect.top() / 2 +
81 ViewItem::HighlightRadius);
82}
83
84QString Ruler::format_time_with_distance(
85 const pv::util::Timestamp& distance,
86 const pv::util::Timestamp& t,
87 pv::util::SIPrefix prefix,
88 pv::util::TimeUnit unit,
89 unsigned precision,
90 bool sign)
91{
92 const unsigned limit = 60;
93
94 if (t.is_zero())
95 return "0";
96
97 // If we have to use samples then we have no alternative formats
98 if (unit == pv::util::TimeUnit::Samples)
99 return pv::util::format_time_si_adjusted(t, prefix, precision, "sa", sign);
100
101 QString unit_string;
102 if (unit == pv::util::TimeUnit::Time)
103 unit_string = "s";
104 // Note: In case of pv::util::TimeUnit::None, unit_string remains empty
105
106 // View zoomed way out -> low precision (0), big distance (>=60s)
107 // -> DD:HH:MM
108 if ((precision == 0) && (distance >= limit))
109 return pv::util::format_time_minutes(t, 0, sign);
110
111 // View in "normal" range -> medium precision, medium step size
112 // -> HH:MM:SS.mmm... or xxxx (si unit) if less than limit seconds
113 // View zoomed way in -> high precision (>3), low step size (<1s)
114 // -> HH:MM:SS.mmm... or xxxx (si unit) if less than limit seconds
115 if (abs(t) < limit)
116 return pv::util::format_time_si_adjusted(t, prefix, precision, unit_string, sign);
117 else
118 return pv::util::format_time_minutes(t, precision, sign);
119}
120
121pv::util::Timestamp Ruler::get_absolute_time_from_x_pos(uint32_t x) const
122{
123 return view_.offset() + ((double)x + 0.5) * view_.scale();
124}
125
126pv::util::Timestamp Ruler::get_ruler_time_from_x_pos(uint32_t x) const
127{
128 return view_.ruler_offset() + ((double)x + 0.5) * view_.scale();
129}
130
131pv::util::Timestamp Ruler::get_ruler_time_from_absolute_time(const pv::util::Timestamp& abs_time) const
132{
133 return abs_time + view_.zero_offset();
134}
135
136pv::util::Timestamp Ruler::get_absolute_time_from_ruler_time(const pv::util::Timestamp& ruler_time) const
137{
138 return ruler_time - view_.zero_offset();
139}
140
141void Ruler::contextMenuEvent(QContextMenuEvent *event)
142{
143 MarginWidget::contextMenuEvent(event);
144
145 // Don't show a context menu if the MarginWidget found a widget that shows one
146 if (event->isAccepted())
147 return;
148
149 context_menu_x_pos_ = event->pos().x();
150
151 QMenu *const menu = new QMenu(this);
152
153 QAction *const create_marker = new QAction(tr("Create marker here"), this);
154 connect(create_marker, SIGNAL(triggered()), this, SLOT(on_createMarker()));
155 menu->addAction(create_marker);
156
157 QAction *const set_zero_position = new QAction(tr("Set as zero point"), this);
158 connect(set_zero_position, SIGNAL(triggered()), this, SLOT(on_setZeroPosition()));
159 menu->addAction(set_zero_position);
160
161 QAction *const toggle_hover_marker = new QAction(this);
162 connect(toggle_hover_marker, SIGNAL(triggered()), this, SLOT(on_toggleHoverMarker()));
163 menu->addAction(toggle_hover_marker);
164
165 GlobalSettings settings;
166 const bool hover_marker_shown =
167 settings.value(GlobalSettings::Key_View_ShowHoverMarker).toBool();
168 toggle_hover_marker->setText(hover_marker_shown ?
169 tr("Disable mouse hover marker") : tr("Enable mouse hover marker"));
170
171 event->setAccepted(true);
172 menu->popup(event->globalPos());
173}
174
175void Ruler::resizeEvent(QResizeEvent*)
176{
177 // the tick calculation depends on the width of this widget
178 invalidate_tick_position_cache();
179}
180
181vector< shared_ptr<ViewItem> > Ruler::items()
182{
183 const vector< shared_ptr<TimeItem> > time_items(view_.time_items());
184 return vector< shared_ptr<ViewItem> >(
185 time_items.begin(), time_items.end());
186}
187
188void Ruler::item_hover(const shared_ptr<ViewItem> &item, QPoint pos)
189{
190 (void)pos;
191
192 hover_item_ = dynamic_pointer_cast<TimeItem>(item);
193}
194
195shared_ptr<TimeItem> Ruler::get_reference_item() const
196{
197 // Note: time() returns 0 if item returns no valid time
198
199 if (mouse_modifiers_ & Qt::ShiftModifier)
200 return nullptr;
201
202 if (hover_item_ && (hover_item_->time() != 0))
203 return hover_item_;
204
205 shared_ptr<TimeItem> ref_item;
206 const vector< shared_ptr<TimeItem> > items(view_.time_items());
207
208 for (auto i = items.rbegin(); i != items.rend(); i++) {
209 if ((*i)->enabled() && (*i)->selected()) {
210 if (!ref_item)
211 ref_item = *i;
212 else {
213 // Return nothing if multiple items are selected
214 ref_item.reset();
215 break;
216 }
217 }
218 }
219
220 if (ref_item && (ref_item->time() == 0))
221 ref_item.reset();
222
223 return ref_item;
224}
225
226shared_ptr<ViewItem> Ruler::get_mouse_over_item(const QPoint &pt)
227{
228 const vector< shared_ptr<TimeItem> > items(view_.time_items());
229
230 for (auto i = items.rbegin(); i != items.rend(); i++)
231 if ((*i)->enabled() && (*i)->label_rect(rect()).contains(pt))
232 return *i;
233
234 return nullptr;
235}
236
237void Ruler::mouseDoubleClickEvent(QMouseEvent *event)
238{
239 hover_item_ = view_.add_flag(get_absolute_time_from_x_pos(event->x()));
240}
241
242void Ruler::paintEvent(QPaintEvent*)
243{
244 if (!tick_position_cache_) {
245 auto ffunc = [this](const pv::util::Timestamp& t) {
246 return format_time_with_distance(
247 this->view_.tick_period(),
248 t,
249 this->view_.tick_prefix(),
250 this->view_.time_unit(),
251 this->view_.tick_precision());
252 };
253
254 tick_position_cache_ = calculate_tick_positions(
255 view_.tick_period(),
256 view_.ruler_offset(),
257 view_.scale(),
258 width(),
259 view_.minor_tick_count(),
260 ffunc);
261 }
262
263 const int ValueMargin = 3;
264
265 const int text_height = calculate_text_height();
266 const int ruler_height = RulerHeight * text_height;
267 const int major_tick_y1 = text_height + ValueMargin * 2;
268 const int minor_tick_y1 = (major_tick_y1 + ruler_height) / 2;
269
270 QPainter p(this);
271
272 // Draw the tick marks
273 p.setPen(palette().color(foregroundRole()));
274
275 for (const auto& tick: tick_position_cache_->major) {
276 const int leftedge = 0;
277 const int rightedge = width();
278 const int x_tick = tick.first;
279 if ((x_tick > leftedge) && (x_tick < rightedge)) {
280 const int x_left_bound = QFontMetrics(font()).width(tick.second) / 2;
281 const int x_right_bound = rightedge - x_left_bound;
282 const int x_legend = min(max(x_tick, x_left_bound), x_right_bound);
283 p.drawText(x_legend, ValueMargin, 0, text_height,
284 AlignCenter | AlignTop | TextDontClip, tick.second);
285 p.drawLine(QPointF(x_tick, major_tick_y1),
286 QPointF(tick.first, ruler_height));
287 }
288 }
289
290 for (const auto& tick: tick_position_cache_->minor) {
291 p.drawLine(QPointF(tick, minor_tick_y1),
292 QPointF(tick, ruler_height));
293 }
294
295 // Draw the hover mark
296 draw_hover_mark(p, text_height);
297
298 p.setRenderHint(QPainter::Antialiasing);
299
300 // The cursor labels are not drawn with the arrows exactly on the
301 // bottom line of the widget, because then the selection shadow
302 // would be clipped away.
303 const QRect r = rect().adjusted(0, 0, 0, -ViewItem::HighlightRadius);
304
305 // Draw the items
306 const vector< shared_ptr<TimeItem> > items(view_.time_items());
307 for (auto &i : items) {
308 const bool highlight = !item_dragging_ &&
309 i->label_rect(r).contains(mouse_point_);
310 i->paint_label(p, r, highlight);
311 }
312}
313
314void Ruler::draw_hover_mark(QPainter &p, int text_height)
315{
316 const int x = view_.hover_point().x();
317
318 if (x == -1)
319 return;
320
321 p.setPen(QPen(Qt::NoPen));
322 p.setBrush(QBrush(palette().color(foregroundRole())));
323
324 const int b = RulerHeight * text_height;
325 const float hover_arrow_size = HoverArrowSize * text_height;
326 const QPointF points[] = {
327 QPointF(x, b),
328 QPointF(x - hover_arrow_size, b - hover_arrow_size),
329 QPointF(x + hover_arrow_size, b - hover_arrow_size)
330 };
331 p.drawPolygon(points, countof(points));
332}
333
334int Ruler::calculate_text_height() const
335{
336 return QFontMetrics(font()).ascent();
337}
338
339TickPositions Ruler::calculate_tick_positions(
340 const pv::util::Timestamp& major_period,
341 const pv::util::Timestamp& offset,
342 const double scale,
343 const int width,
344 const unsigned int minor_tick_count,
345 function<QString(const pv::util::Timestamp&)> format_function)
346{
347 TickPositions tp;
348
349 const pv::util::Timestamp minor_period = major_period / minor_tick_count;
350 const pv::util::Timestamp first_major_division = floor(offset / major_period);
351 const pv::util::Timestamp first_minor_division = ceil(offset / minor_period);
352 const pv::util::Timestamp t0 = first_major_division * major_period;
353
354 int division = (round(first_minor_division -
355 first_major_division * minor_tick_count)).convert_to<int>() - 1;
356
357 double x;
358
359 do {
360 pv::util::Timestamp t = t0 + division * minor_period;
361 x = ((t - offset) / scale).convert_to<double>();
362
363 if (division % minor_tick_count == 0) {
364 // Recalculate 't' without using 'minor_period' which is a fraction
365 t = t0 + division / minor_tick_count * major_period;
366 tp.major.emplace_back(x, format_function(t));
367 } else {
368 tp.minor.emplace_back(x);
369 }
370
371 division++;
372 } while (x < width);
373
374 return tp;
375}
376
377void Ruler::on_hover_point_changed(const QWidget* widget, const QPoint &hp)
378{
379 (void)widget;
380 (void)hp;
381
382 update();
383}
384
385void Ruler::invalidate_tick_position_cache()
386{
387 tick_position_cache_ = boost::none;
388}
389
390void Ruler::on_createMarker()
391{
392 hover_item_ = view_.add_flag(get_absolute_time_from_x_pos(mouse_down_point_.x()));
393}
394
395void Ruler::on_setZeroPosition()
396{
397 view_.set_zero_position(get_absolute_time_from_x_pos(mouse_down_point_.x()));
398}
399
400void Ruler::on_toggleHoverMarker()
401{
402 GlobalSettings settings;
403 const bool state = settings.value(GlobalSettings::Key_View_ShowHoverMarker).toBool();
404 settings.setValue(GlobalSettings::Key_View_ShowHoverMarker, !state);
405}
406
407} // namespace trace
408} // namespace views
409} // namespace pv