pv/views/trace/cursorpair.cpp

   1 /*
   2  * This file is part of the PulseView project.
   3  *
   4  * Copyright (C) 2013 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 <algorithm>
  21 #include <cassert>
  22
  23 #include <QColor>
  24 #include <QToolTip>
  25
  26 #include "cursorpair.hpp"
  27
  28 #include "pv/globalsettings.hpp"
  29 #include "pv/util.hpp"
  30 #include "ruler.hpp"
  31 #include "view.hpp"
  32
  33 using std::max;
  34 using std::make_pair;
  35 using std::min;
  36 using std::shared_ptr;
  37 using std::pair;
  38
  39 namespace pv {
  40 namespace views {
  41 namespace trace {
  42
  43 const int CursorPair::DeltaPadding = 8;
  44
  45 CursorPair::CursorPair(View &view) :
  46         TimeItem(view),
  47         first_(new Cursor(view, 0.0)),
  48         second_(new Cursor(view, 1.0))
  49 {
  50         GlobalSettings::add_change_handler(this);
  51
  52         GlobalSettings settings;
  53         fill_color_ = QColor::fromRgba(settings.value(
  54                 GlobalSettings::Key_View_CursorFillColor).value<uint32_t>());
  55
  56         connect(&view_, SIGNAL(hover_point_changed(const QWidget*, QPoint)),
  57                 this, SLOT(on_hover_point_changed(const QWidget*, QPoint)));
  58 }
  59
  60 CursorPair::~CursorPair()
  61 {
  62         GlobalSettings::remove_change_handler(this);
  63 }
  64
  65 bool CursorPair::enabled() const
  66 {
  67         return view_.cursors_shown();
  68 }
  69
  70 shared_ptr<Cursor> CursorPair::first() const
  71 {
  72         return first_;
  73 }
  74
  75 shared_ptr<Cursor> CursorPair::second() const
  76 {
  77         return second_;
  78 }
  79
  80 void CursorPair::set_time(const pv::util::Timestamp& time)
  81 {
  82         const pv::util::Timestamp delta = second_->time() - first_->time();
  83         first_->set_time(time);
  84         second_->set_time(time + delta);
  85 }
  86
  87 float CursorPair::get_x() const
  88 {
  89         return (first_->get_x() + second_->get_x()) / 2.0f;
  90 }
  91
  92 QPoint CursorPair::drag_point(const QRect &rect) const
  93 {
  94         return first_->drag_point(rect);
  95 }
  96
  97 pv::widgets::Popup* CursorPair::create_popup(QWidget *parent)
  98 {
  99         (void)parent;
 100         return nullptr;
 101 }
 102
 103 QRectF CursorPair::label_rect(const QRectF &rect) const
 104 {
 105         const QSizeF label_size(text_size_ + LabelPadding * 2);
 106         const pair<float, float> offsets(get_cursor_offsets());
 107         const pair<float, float> normal_offsets(
 108                 (offsets.first < offsets.second) ? offsets :
 109                 make_pair(offsets.second, offsets.first));
 110
 111         const float height = label_size.height();
 112         const float left = max(normal_offsets.first + DeltaPadding, -height);
 113         const float right = min(normal_offsets.second - DeltaPadding,
 114                 (float)rect.width() + height);
 115
 116         return QRectF(left, rect.height() - label_size.height() -
 117                 TimeMarker::ArrowSize - 0.5f,
 118                 right - left, height);
 119 }
 120
 121 void CursorPair::paint_label(QPainter &p, const QRect &rect, bool hover)
 122 {
 123         assert(first_);
 124         assert(second_);
 125
 126         if (!enabled())
 127                 return;
 128
 129         const QColor text_color = ViewItem::select_text_color(Cursor::FillColor);
 130         p.setPen(text_color);
 131
 132         QRectF delta_rect(label_rect(rect));
 133         const int radius = delta_rect.height() / 2;
 134         QRectF text_rect(delta_rect.intersected(rect).adjusted(radius, 0, -radius, 0));
 135
 136         QString text = format_string(text_rect.width(), [&p](const QString& s) -> qreal {
 137                         return p.boundingRect(QRectF(), 0, s).width();
 138                 });
 139         text_size_ = p.boundingRect(QRectF(), 0, text).size();
 140
 141         if (selected()) {
 142                 p.setBrush(Qt::transparent);
 143                 p.setPen(highlight_pen());
 144                 p.drawRoundedRect(delta_rect, radius, radius);
 145         }
 146
 147         p.setBrush(hover ? Cursor::FillColor.lighter() : Cursor::FillColor);
 148         p.setPen(Cursor::FillColor.darker());
 149         p.drawRoundedRect(delta_rect, radius, radius);
 150
 151         delta_rect.adjust(1, 1, -1, -1);
 152         p.setPen(Cursor::FillColor.lighter());
 153         const int highlight_radius = delta_rect.height() / 2 - 2;
 154         p.drawRoundedRect(delta_rect, highlight_radius, highlight_radius);
 155         label_area_ = delta_rect;
 156
 157         p.setPen(text_color);
 158         p.drawText(text_rect, Qt::AlignCenter | Qt::AlignVCenter, text);
 159 }
 160
 161 void CursorPair::paint_back(QPainter &p, ViewItemPaintParams &pp)
 162 {
 163         if (!enabled())
 164                 return;
 165
 166         p.setPen(Qt::NoPen);
 167         p.setBrush(fill_color_);
 168
 169         const pair<float, float> offsets(get_cursor_offsets());
 170         const int l = (int)max(min(offsets.first, offsets.second), 0.0f);
 171         const int r = (int)min(max(offsets.first, offsets.second), (float)pp.width());
 172
 173         p.drawRect(l, pp.top(), r - l, pp.height());
 174 }
 175
 176 QString CursorPair::format_string(qreal max_width, std::function<qreal(const QString&)> query_size)
 177 {
 178         constexpr int time_precision = 12;
 179         constexpr int freq_precision = 4;
 180
 181         const pv::util::SIPrefix prefix = view_.tick_prefix();
 182         const pv::util::Timestamp diff = abs(second_->time() - first_->time());
 183
 184         const QString time = Ruler::format_time_with_distance(
 185                         diff, diff, prefix, view_.time_unit(), time_precision, false);
 186         const QString freq = util::format_time_si(
 187                 1 / diff, pv::util::SIPrefix::unspecified, freq_precision, "Hz", false);
 188         const QString out = QString("%1 / %2").arg(time, freq);
 189
 190         // Try full "{time} ms / {freq} Hz" format
 191         if (max_width <= 0 || query_size(out) <= max_width) {
 192                 label_incomplete_ = false;
 193                 return out;
 194         }
 195
 196         label_incomplete_ = true;
 197
 198         // Try just "{time}ms" format and gradually reduce time precision down to zero
 199         for (int shrinkage=0; shrinkage <= time_precision; shrinkage++) {
 200                 int prec = time_precision - shrinkage ;
 201
 202                 const QString time = Ruler::format_time_with_distance(
 203                         diff, diff, prefix, view_.time_unit(),
 204                         prec, false);
 205
 206                 if (query_size(time) <= max_width)
 207                         return time;
 208         }
 209
 210         // Try no trailing digits and drop the unit to at least display something. The unit should be obvious from the ruler
 211         // anyway.
 212         const QString bare_number = Ruler::format_time_with_distance(
 213                 diff, diff, prefix, view_.time_unit(),
 214                 0, false, false);
 215         if (query_size(bare_number) <= max_width)
 216                 return bare_number;
 217
 218         // Give up.
 219         return "...";
 220 }
 221
 222 pair<float, float> CursorPair::get_cursor_offsets() const
 223 {
 224         assert(first_);
 225         assert(second_);
 226
 227         return pair<float, float>(first_->get_x(), second_->get_x());
 228 }
 229
 230 void CursorPair::on_setting_changed(const QString &key, const QVariant &value)
 231 {
 232         if (key == GlobalSettings::Key_View_CursorFillColor)
 233                 fill_color_ = QColor::fromRgba(value.value<uint32_t>());
 234 }
 235
 236 void CursorPair::on_hover_point_changed(const QWidget* widget, const QPoint& hp)
 237 {
 238         if (widget != view_.ruler())
 239                 return;
 240
 241         if (!label_incomplete_)
 242                 return;
 243
 244         if (label_area_.contains(hp))
 245                 QToolTip::showText(view_.mapToGlobal(hp), format_string());
 246         else
 247                 QToolTip::hideText();  // TODO Will break other tooltips when there can be others
 248 }
 249
 250 } // namespace trace
 251 } // namespace views
 252 } // namespace pv