pv/view/view.cpp

   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, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
  19  */
  20
  21 #ifdef ENABLE_DECODE
  22 #include <libsigrokdecode/libsigrokdecode.h>
  23 #endif
  24
  25 #include <cassert>
  26 #include <climits>
  27 #include <cmath>
  28 #include <mutex>
  29
  30 #include <QEvent>
  31 #include <QMouseEvent>
  32 #include <QScrollBar>
  33
  34 #include "cursorheader.h"
  35 #include "decodetrace.h"
  36 #include "header.h"
  37 #include "ruler.h"
  38 #include "signal.h"
  39 #include "view.h"
  40 #include "viewport.h"
  41
  42 #include "pv/sigsession.h"
  43 #include "pv/data/logic.h"
  44 #include "pv/data/logicsnapshot.h"
  45
  46 using boost::shared_lock;
  47 using boost::shared_mutex;
  48 using pv::data::SignalData;
  49 using std::back_inserter;
  50 using std::deque;
  51 using std::list;
  52 using std::lock_guard;
  53 using std::max;
  54 using std::make_pair;
  55 using std::min;
  56 using std::pair;
  57 using std::set;
  58 using std::shared_ptr;
  59 using std::vector;
  60 using std::weak_ptr;
  61
  62 namespace pv {
  63 namespace view {
  64
  65 const double View::MaxScale = 1e9;
  66 const double View::MinScale = 1e-15;
  67
  68 const int View::MaxScrollValue = INT_MAX / 2;
  69
  70 const QColor View::CursorAreaColour(220, 231, 243);
  71
  72 const QSizeF View::LabelPadding(4, 0);
  73
  74 View::View(SigSession &session, QWidget *parent) :
  75         QAbstractScrollArea(parent),
  76         _session(session),
  77         _viewport(new Viewport(*this)),
  78         _ruler(new Ruler(*this)),
  79         _cursorheader(new CursorHeader(*this)),
  80         _header(new Header(*this)),
  81         _scale(1e-6),
  82         _offset(0),
  83         _v_offset(0),
  84         _updating_scroll(false),
  85         _show_cursors(false),
  86         _cursors(*this),
  87         _hover_point(-1, -1)
  88 {
  89         connect(horizontalScrollBar(), SIGNAL(valueChanged(int)),
  90                 this, SLOT(h_scroll_value_changed(int)));
  91         connect(verticalScrollBar(), SIGNAL(valueChanged(int)),
  92                 this, SLOT(v_scroll_value_changed(int)));
  93
  94         connect(&_session, SIGNAL(signals_changed()),
  95                 this, SLOT(signals_changed()));
  96         connect(&_session, SIGNAL(capture_state_changed(int)),
  97                 this, SLOT(data_updated()));
  98         connect(&_session, SIGNAL(data_received()),
  99                 this, SLOT(data_updated()));
 100         connect(&_session, SIGNAL(frame_ended()),
 101                 this, SLOT(data_updated()));
 102
 103         connect(_cursors.first().get(), SIGNAL(time_changed()),
 104                 this, SLOT(marker_time_changed()));
 105         connect(_cursors.second().get(), SIGNAL(time_changed()),
 106                 this, SLOT(marker_time_changed()));
 107
 108         connect(_header, SIGNAL(signals_moved()),
 109                 this, SLOT(on_signals_moved()));
 110
 111         connect(_header, SIGNAL(selection_changed()),
 112                 _cursorheader, SLOT(clear_selection()));
 113         connect(_cursorheader, SIGNAL(selection_changed()),
 114                 _header, SLOT(clear_selection()));
 115
 116         connect(_header, SIGNAL(selection_changed()),
 117                 this, SIGNAL(selection_changed()));
 118         connect(_cursorheader, SIGNAL(selection_changed()),
 119                 this, SIGNAL(selection_changed()));
 120
 121         connect(this, SIGNAL(hover_point_changed()),
 122                 this, SLOT(on_hover_point_changed()));
 123
 124         connect(&_lazy_event_handler, SIGNAL(timeout()),
 125                 this, SLOT(process_sticky_events()));
 126         _lazy_event_handler.setSingleShot(true);
 127
 128         setViewport(_viewport);
 129
 130         _viewport->installEventFilter(this);
 131         _ruler->installEventFilter(this);
 132         _cursorheader->installEventFilter(this);
 133         _header->installEventFilter(this);
 134
 135         // Trigger the initial event manually. The default device has signals
 136         // which were created before this object came into being
 137         signals_changed();
 138
 139         // make sure the transparent widgets are on the top
 140         _cursorheader->raise();
 141         _header->raise();
 142 }
 143
 144 SigSession& View::session()
 145 {
 146         return _session;
 147 }
 148
 149 const SigSession& View::session() const
 150 {
 151         return _session;
 152 }
 153
 154 View* View::view()
 155 {
 156         return this;
 157 }
 158
 159 const View* View::view() const
 160 {
 161         return this;
 162 }
 163
 164 Viewport* View::viewport()
 165 {
 166         return _viewport;
 167 }
 168
 169 const Viewport* View::viewport() const
 170 {
 171         return _viewport;
 172 }
 173
 174 double View::scale() const
 175 {
 176         return _scale;
 177 }
 178
 179 double View::offset() const
 180 {
 181         return _offset;
 182 }
 183
 184 int View::owner_v_offset() const
 185 {
 186         return -_v_offset;
 187 }
 188
 189 unsigned int View::depth() const
 190 {
 191         return 0;
 192 }
 193
 194 void View::zoom(double steps)
 195 {
 196         zoom(steps, _viewport->width() / 2);
 197 }
 198
 199 void View::zoom(double steps, int offset)
 200 {
 201         set_zoom(_scale * pow(3.0/2.0, -steps), offset);
 202 }
 203
 204 void View::zoom_fit()
 205 {
 206         const pair<double, double> extents = get_time_extents();
 207         const double delta = extents.second - extents.first;
 208         if (delta < 1e-12)
 209                 return;
 210
 211         assert(_viewport);
 212         const int w = _viewport->width();
 213         if (w <= 0)
 214                 return;
 215
 216         const double scale = max(min(delta / w, MaxScale), MinScale);
 217         set_scale_offset(scale, extents.first);
 218 }
 219
 220 void View::zoom_one_to_one()
 221 {
 222         using pv::data::SignalData;
 223
 224         // Make a set of all the visible data objects
 225         set< shared_ptr<SignalData> > visible_data = get_visible_data();
 226         if (visible_data.empty())
 227                 return;
 228
 229         double samplerate = 0.0;
 230         for (const shared_ptr<SignalData> d : visible_data) {
 231                 assert(d);
 232                 samplerate = max(samplerate, d->samplerate());
 233         }
 234
 235         if (samplerate == 0.0)
 236                 return;
 237
 238         assert(_viewport);
 239         const int w = _viewport->width();
 240         if (w <= 0)
 241                 return;
 242
 243         set_zoom(1.0 / samplerate, w / 2);
 244 }
 245
 246 void View::set_scale_offset(double scale, double offset)
 247 {
 248         _scale = scale;
 249         _offset = offset;
 250
 251         update_scroll();
 252         _ruler->update();
 253         _cursorheader->update();
 254         _viewport->update();
 255         scale_offset_changed();
 256 }
 257
 258 set< shared_ptr<SignalData> > View::get_visible_data() const
 259 {
 260         shared_lock<shared_mutex> lock(session().signals_mutex());
 261         const vector< shared_ptr<Signal> > &sigs(session().signals());
 262
 263         // Make a set of all the visible data objects
 264         set< shared_ptr<SignalData> > visible_data;
 265         for (const shared_ptr<Signal> sig : sigs)
 266                 if (sig->enabled())
 267                         visible_data.insert(sig->data());
 268
 269         return visible_data;
 270 }
 271
 272 pair<double, double> View::get_time_extents() const
 273 {
 274         const set< shared_ptr<SignalData> > visible_data = get_visible_data();
 275         if (visible_data.empty())
 276                 return make_pair(0.0, 0.0);
 277
 278         double left_time = DBL_MAX, right_time = DBL_MIN;
 279         for (const shared_ptr<SignalData> d : visible_data)
 280         {
 281                 const double start_time = d->get_start_time();
 282                 double samplerate = d->samplerate();
 283                 samplerate = (samplerate <= 0.0) ? 1.0 : samplerate;
 284
 285                 left_time = min(left_time, start_time);
 286                 right_time = max(right_time, start_time +
 287                         d->get_max_sample_count() / samplerate);
 288         }
 289
 290         assert(left_time < right_time);
 291         return make_pair(left_time, right_time);
 292 }
 293
 294 bool View::cursors_shown() const
 295 {
 296         return _show_cursors;
 297 }
 298
 299 void View::show_cursors(bool show)
 300 {
 301         _show_cursors = show;
 302         _cursorheader->update();
 303         _viewport->update();
 304 }
 305
 306 void View::centre_cursors()
 307 {
 308         const double time_width = _scale * _viewport->width();
 309         _cursors.first()->set_time(_offset + time_width * 0.4);
 310         _cursors.second()->set_time(_offset + time_width * 0.6);
 311         _cursorheader->update();
 312         _viewport->update();
 313 }
 314
 315 CursorPair& View::cursors()
 316 {
 317         return _cursors;
 318 }
 319
 320 const CursorPair& View::cursors() const
 321 {
 322         return _cursors;
 323 }
 324
 325 const QPoint& View::hover_point() const
 326 {
 327         return _hover_point;
 328 }
 329
 330 void View::update_viewport()
 331 {
 332         assert(_viewport);
 333         _viewport->update();
 334 }
 335
 336 void View::get_scroll_layout(double &length, double &offset) const
 337 {
 338         const pair<double, double> extents = get_time_extents();
 339         length = (extents.second - extents.first) / _scale;
 340         offset = _offset / _scale;
 341 }
 342
 343 void View::set_zoom(double scale, int offset)
 344 {
 345         const double cursor_offset = _offset + _scale * offset;
 346         const double new_scale = max(min(scale, MaxScale), MinScale);
 347         const double new_offset = cursor_offset - new_scale * offset;
 348         set_scale_offset(new_scale, new_offset);
 349 }
 350
 351 void View::update_scroll()
 352 {
 353         assert(_viewport);
 354
 355         const QSize areaSize = _viewport->size();
 356
 357         // Set the horizontal scroll bar
 358         double length = 0, offset = 0;
 359         get_scroll_layout(length, offset);
 360         length = max(length - areaSize.width(), 0.0);
 361
 362         horizontalScrollBar()->setPageStep(areaSize.width() / 2);
 363
 364         _updating_scroll = true;
 365
 366         if (length < MaxScrollValue) {
 367                 horizontalScrollBar()->setRange(0, length);
 368                 horizontalScrollBar()->setSliderPosition(offset);
 369         } else {
 370                 horizontalScrollBar()->setRange(0, MaxScrollValue);
 371                 horizontalScrollBar()->setSliderPosition(
 372                         _offset * MaxScrollValue / (_scale * length));
 373         }
 374
 375         _updating_scroll = false;
 376
 377         // Set the vertical scrollbar
 378         verticalScrollBar()->setPageStep(areaSize.height());
 379
 380         const pair<int, int> extents = v_extents();
 381         const int extra_scroll_height = (extents.second - extents.first) / 4;
 382         verticalScrollBar()->setRange(extents.first - extra_scroll_height,
 383                 extents.first + extra_scroll_height);
 384 }
 385
 386 void View::update_layout()
 387 {
 388         setViewportMargins(
 389                 _header->sizeHint().width() - pv::view::Header::BaselineOffset,
 390                 _ruler->sizeHint().height(), 0, 0);
 391         _ruler->setGeometry(_viewport->x(), 0,
 392                 _viewport->width(), _viewport->y());
 393         _cursorheader->setGeometry(
 394                 _viewport->x(),
 395                 _ruler->sizeHint().height() - _cursorheader->sizeHint().height() / 2,
 396                 _viewport->width(), _cursorheader->sizeHint().height());
 397         _header->setGeometry(0, _viewport->y(),
 398                 _header->sizeHint().width(), _viewport->height());
 399         update_scroll();
 400 }
 401
 402 void View::paint_label(QPainter &p, int right, bool hover)
 403 {
 404         (void)p;
 405         (void)right;
 406         (void)hover;
 407 }
 408
 409 QRectF View::label_rect(int right)
 410 {
 411         (void)right;
 412         return QRectF();
 413 }
 414
 415 bool View::eventFilter(QObject *object, QEvent *event)
 416 {
 417         const QEvent::Type type = event->type();
 418         if (type == QEvent::MouseMove) {
 419
 420                 const QMouseEvent *const mouse_event = (QMouseEvent*)event;
 421                 if (object == _viewport)
 422                         _hover_point = mouse_event->pos();
 423                 else if (object == _ruler || object == _cursorheader)
 424                         _hover_point = QPoint(mouse_event->x(), 0);
 425                 else if (object == _header)
 426                         _hover_point = QPoint(0, mouse_event->y());
 427                 else
 428                         _hover_point = QPoint(-1, -1);
 429
 430                 hover_point_changed();
 431
 432         } else if (type == QEvent::Leave) {
 433                 _hover_point = QPoint(-1, -1);
 434                 hover_point_changed();
 435         }
 436
 437         return QObject::eventFilter(object, event);
 438 }
 439
 440 bool View::viewportEvent(QEvent *e)
 441 {
 442         switch(e->type()) {
 443         case QEvent::Paint:
 444         case QEvent::MouseButtonPress:
 445         case QEvent::MouseButtonRelease:
 446         case QEvent::MouseButtonDblClick:
 447         case QEvent::MouseMove:
 448         case QEvent::Wheel:
 449         case QEvent::TouchBegin:
 450         case QEvent::TouchUpdate:
 451         case QEvent::TouchEnd:
 452                 return false;
 453
 454         default:
 455                 return QAbstractScrollArea::viewportEvent(e);
 456         }
 457 }
 458
 459 void View::resizeEvent(QResizeEvent*)
 460 {
 461         update_layout();
 462 }
 463
 464 void View::appearance_changed(bool label, bool content)
 465 {
 466         if (label)
 467                 _header->update();
 468         if (content)
 469                 _viewport->update();
 470 }
 471
 472 void View::extents_changed(bool horz, bool vert)
 473 {
 474         _sticky_events |=
 475                 (horz ? SelectableItemHExtentsChanged : 0) |
 476                 (vert ? SelectableItemVExtentsChanged : 0);
 477         _lazy_event_handler.start();
 478 }
 479
 480 void View::h_scroll_value_changed(int value)
 481 {
 482         if (_updating_scroll)
 483                 return;
 484
 485         const int range = horizontalScrollBar()->maximum();
 486         if (range < MaxScrollValue)
 487                 _offset = _scale * value;
 488         else {
 489                 double length = 0, offset;
 490                 get_scroll_layout(length, offset);
 491                 _offset = _scale * length * value / MaxScrollValue;
 492         }
 493
 494         _ruler->update();
 495         _cursorheader->update();
 496         _viewport->update();
 497 }
 498
 499 void View::v_scroll_value_changed(int value)
 500 {
 501         _v_offset = value;
 502         _header->update();
 503         _viewport->update();
 504 }
 505
 506 void View::signals_changed()
 507 {
 508         // Populate the traces
 509         clear_child_items();
 510
 511         shared_lock<shared_mutex> lock(session().signals_mutex());
 512         const vector< shared_ptr<Signal> > &sigs(session().signals());
 513         for (auto s : sigs)
 514                 add_child_item(s);
 515
 516 #ifdef ENABLE_DECODE
 517         const vector< shared_ptr<DecodeTrace> > decode_sigs(
 518                 session().get_decode_signals());
 519         for (auto s : decode_sigs)
 520                 add_child_item(s);
 521 #endif
 522
 523         // Create the initial layout
 524         int offset = 0;
 525         for (shared_ptr<RowItem> r : *this) {
 526                 const pair<int, int> extents = r->v_extents();
 527                 if (r->enabled())
 528                         offset += -extents.first;
 529                 r->force_to_v_offset(offset);
 530                 if (r->enabled())
 531                         offset += extents.second;
 532         }
 533
 534         update_layout();
 535 }
 536
 537 void View::data_updated()
 538 {
 539         // Update the scroll bars
 540         update_scroll();
 541
 542         // Repaint the view
 543         _viewport->update();
 544 }
 545
 546 void View::marker_time_changed()
 547 {
 548         _cursorheader->update();
 549         _viewport->update();
 550 }
 551
 552 void View::on_signals_moved()
 553 {
 554         update_scroll();
 555         signals_moved();
 556 }
 557
 558 void View::process_sticky_events()
 559 {
 560         if (_sticky_events & SelectableItemHExtentsChanged)
 561                 update_layout();
 562         if (_sticky_events & SelectableItemVExtentsChanged) {
 563                 _viewport->update();
 564                 _header->update();
 565         }
 566
 567         // Clear the sticky events
 568         _sticky_events = 0;
 569 }
 570
 571 void View::on_hover_point_changed()
 572 {
 573         for (shared_ptr<RowItem> r : *this)
 574                 r->hover_point_changed();
 575 }
 576
 577 } // namespace view
 578 } // namespace pv