2 * This file is part of the PulseView project.
4 * Copyright (C) 2012 Joel Holdsworth <joel@airwebreathe.org.uk>
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.
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.
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/>.
22 #include <QApplication>
23 #include <QFontMetrics>
24 #include <QMouseEvent>
34 using std::shared_ptr;
41 const float Ruler::RulerHeight = 2.5f; // x Text Height
43 const float Ruler::HoverArrowSize = 0.5f; // x Text Height
45 Ruler::Ruler(View &parent) :
48 setMouseTracking(true);
50 connect(&view_, SIGNAL(hover_point_changed(QPoint)),
51 this, SLOT(hover_point_changed(QPoint)));
52 connect(&view_, SIGNAL(offset_changed()),
53 this, SLOT(invalidate_tick_position_cache()));
54 connect(&view_, SIGNAL(scale_changed()),
55 this, SLOT(invalidate_tick_position_cache()));
56 connect(&view_, SIGNAL(tick_prefix_changed()),
57 this, SLOT(invalidate_tick_position_cache()));
58 connect(&view_, SIGNAL(tick_precision_changed()),
59 this, SLOT(invalidate_tick_position_cache()));
60 connect(&view_, SIGNAL(tick_period_changed()),
61 this, SLOT(invalidate_tick_position_cache()));
62 connect(&view_, SIGNAL(time_unit_changed()),
63 this, SLOT(invalidate_tick_position_cache()));
66 QSize Ruler::sizeHint() const
68 const int text_height = calculate_text_height();
69 return QSize(0, RulerHeight * text_height);
72 QSize Ruler::extended_size_hint() const
75 vector< shared_ptr<TimeItem> > items(view_.time_items());
77 max_rect = max_rect.united(i->label_rect(QRect()));
78 return QSize(0, sizeHint().height() - max_rect.top() / 2 +
79 ViewItem::HighlightRadius);
82 QString Ruler::format_time_with_distance(
83 const pv::util::Timestamp& distance,
84 const pv::util::Timestamp& t,
85 pv::util::SIPrefix prefix,
86 pv::util::TimeUnit unit,
90 const unsigned limit = 60;
95 // If we have to use samples then we have no alternative formats
96 if (unit == pv::util::TimeUnit::Samples)
97 return pv::util::format_time_si_adjusted(t, prefix, precision, "sa", sign);
99 // View zoomed way out -> low precision (0), big distance (>=60s)
101 if ((precision == 0) && (distance >= limit))
102 return pv::util::format_time_minutes(t, 0, sign);
104 // View in "normal" range -> medium precision, medium step size
105 // -> HH:MM:SS.mmm... or xxxx (si unit) if less than limit seconds
106 // View zoomed way in -> high precision (>3), low step size (<1s)
107 // -> HH:MM:SS.mmm... or xxxx (si unit) if less than limit seconds
109 return pv::util::format_time_si_adjusted(t, prefix, precision, "s", sign);
111 return pv::util::format_time_minutes(t, precision, sign);
114 vector< shared_ptr<ViewItem> > Ruler::items()
116 const vector< shared_ptr<TimeItem> > time_items(view_.time_items());
117 return vector< shared_ptr<ViewItem> >(
118 time_items.begin(), time_items.end());
121 shared_ptr<ViewItem> Ruler::get_mouse_over_item(const QPoint &pt)
123 const vector< shared_ptr<TimeItem> > items(view_.time_items());
124 for (auto i = items.rbegin(); i != items.rend(); i++)
125 if ((*i)->enabled() && (*i)->label_rect(rect()).contains(pt))
130 void Ruler::paintEvent(QPaintEvent*)
132 if (!tick_position_cache_) {
133 auto ffunc = [this](const pv::util::Timestamp& t) {
134 return format_time_with_distance(
135 this->view_.tick_period(),
137 this->view_.tick_prefix(),
138 this->view_.time_unit(),
139 this->view_.tick_precision());
142 tick_position_cache_ = calculate_tick_positions(
144 view_.ruler_offset(),
147 view_.minor_tick_count(),
151 const int ValueMargin = 3;
153 const int text_height = calculate_text_height();
154 const int ruler_height = RulerHeight * text_height;
155 const int major_tick_y1 = text_height + ValueMargin * 2;
156 const int minor_tick_y1 = (major_tick_y1 + ruler_height) / 2;
160 // Draw the tick marks
161 p.setPen(palette().color(foregroundRole()));
163 for (const auto& tick: tick_position_cache_->major) {
164 const int leftedge = 0;
165 const int rightedge = width();
166 const int x_tick = tick.first;
167 if ((x_tick > leftedge) && (x_tick < rightedge)) {
168 const int x_left_bound = QFontMetrics(font()).width(tick.second) / 2;
169 const int x_right_bound = rightedge - x_left_bound;
170 const int x_legend = min(max(x_tick, x_left_bound), x_right_bound);
171 p.drawText(x_legend, ValueMargin, 0, text_height,
172 AlignCenter | AlignTop | TextDontClip, tick.second);
173 p.drawLine(QPointF(x_tick, major_tick_y1),
174 QPointF(tick.first, ruler_height));
178 for (const auto& tick: tick_position_cache_->minor) {
179 p.drawLine(QPointF(tick, minor_tick_y1),
180 QPointF(tick, ruler_height));
183 // Draw the hover mark
184 draw_hover_mark(p, text_height);
186 p.setRenderHint(QPainter::Antialiasing);
188 // The cursor labels are not drawn with the arrows exactly on the
189 // bottom line of the widget, because then the selection shadow
190 // would be clipped away.
191 const QRect r = rect().adjusted(0, 0, 0, -ViewItem::HighlightRadius);
194 const vector< shared_ptr<TimeItem> > items(view_.time_items());
195 for (auto &i : items) {
196 const bool highlight = !item_dragging_ &&
197 i->label_rect(r).contains(mouse_point_);
198 i->paint_label(p, r, highlight);
202 Ruler::TickPositions Ruler::calculate_tick_positions(
203 const pv::util::Timestamp& major_period,
204 const pv::util::Timestamp& offset,
207 const unsigned int minor_tick_count,
208 function<QString(const pv::util::Timestamp&)> format_function)
212 const pv::util::Timestamp minor_period = major_period / minor_tick_count;
213 const pv::util::Timestamp first_major_division = floor(offset / major_period);
214 const pv::util::Timestamp first_minor_division = ceil(offset / minor_period);
215 const pv::util::Timestamp t0 = first_major_division * major_period;
217 int division = (round(first_minor_division -
218 first_major_division * minor_tick_count)).convert_to<int>() - 1;
223 pv::util::Timestamp t = t0 + division * minor_period;
224 x = ((t - offset) / scale).convert_to<double>();
226 if (division % minor_tick_count == 0) {
227 // Recalculate 't' without using 'minor_period' which is a fraction
228 t = t0 + division / minor_tick_count * major_period;
229 tp.major.emplace_back(x, format_function(t));
231 tp.minor.emplace_back(x);
240 void Ruler::mouseDoubleClickEvent(QMouseEvent *event)
242 view_.add_flag(view_.ruler_offset() + ((double)event->x() + 0.5) * view_.scale());
245 void Ruler::draw_hover_mark(QPainter &p, int text_height)
247 const int x = view_.hover_point().x();
252 p.setPen(QPen(Qt::NoPen));
253 p.setBrush(QBrush(palette().color(foregroundRole())));
255 const int b = RulerHeight * text_height;
256 const float hover_arrow_size = HoverArrowSize * text_height;
257 const QPointF points[] = {
259 QPointF(x - hover_arrow_size, b - hover_arrow_size),
260 QPointF(x + hover_arrow_size, b - hover_arrow_size)
262 p.drawPolygon(points, countof(points));
265 int Ruler::calculate_text_height() const
267 return QFontMetrics(font()).ascent();
270 void Ruler::hover_point_changed(const QPoint &hp)
277 void Ruler::invalidate_tick_position_cache()
279 tick_position_cache_ = boost::none;
282 void Ruler::resizeEvent(QResizeEvent*)
284 // the tick calculation depends on the width of this widget
285 invalidate_tick_position_cache();