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