]> sigrok.org Git - pulseview.git/blame - pv/view/decodetrace.cpp
pv::view::DecodeTrace: Draw annotation rows according to PD metadata.
[pulseview.git] / pv / view / decodetrace.cpp
CommitLineData
55d3603d
JH
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
21extern "C" {
22#include <libsigrokdecode/libsigrokdecode.h>
23}
24
06bb4e6a
JH
25#include <extdef.h>
26
b213ef09
JH
27#include <boost/foreach.hpp>
28
c51482b3 29#include <QAction>
d7c0ca4a 30#include <QApplication>
4e5a4405
JH
31#include <QComboBox>
32#include <QFormLayout>
33#include <QLabel>
b213ef09 34#include <QMenu>
ce94e4fd 35#include <QPushButton>
c51482b3 36
b9329558 37#include "decodetrace.h"
55d3603d 38
06bb4e6a 39#include <pv/sigsession.h>
6e89374a 40#include <pv/data/decoderstack.h>
7491a29f 41#include <pv/data/decode/decoder.h>
5dfeb70f
JH
42#include <pv/data/logic.h>
43#include <pv/data/logicsnapshot.h>
06e810f2 44#include <pv/data/decode/annotation.h>
4e5a4405 45#include <pv/view/logicsignal.h>
e0fc5810 46#include <pv/view/view.h>
204bae45 47#include <pv/widgets/decodergroupbox.h>
ce94e4fd 48#include <pv/widgets/decodermenu.h>
119aff65 49
819f4c25
JH
50using boost::dynamic_pointer_cast;
51using boost::shared_ptr;
52using std::list;
53using std::max;
54using std::map;
55using std::min;
56using std::vector;
55d3603d
JH
57
58namespace pv {
59namespace view {
60
b9329558 61const QColor DecodeTrace::DecodeColours[4] = {
06bb4e6a
JH
62 QColor(0xEF, 0x29, 0x29), // Red
63 QColor(0xFC, 0xE9, 0x4F), // Yellow
64 QColor(0x8A, 0xE2, 0x34), // Green
65 QColor(0x72, 0x9F, 0xCF) // Blue
66};
67
b9329558 68const QColor DecodeTrace::ErrorBgColour = QColor(0xEF, 0x29, 0x29);
5dfeb70f 69const QColor DecodeTrace::NoDecodeColour = QColor(0x88, 0x8A, 0x85);
ad50ac1a 70
06e810f2
JH
71const double DecodeTrace::EndCapWidth = 5;
72const int DecodeTrace::DrawPadding = 100;
73
74const QColor DecodeTrace::Colours[7] = {
75 QColor(0xFC, 0xE9, 0x4F), // Light Butter
76 QColor(0xFC, 0xAF, 0x3E), // Light Orange
77 QColor(0xE9, 0xB9, 0x6E), // Light Chocolate
78 QColor(0x8A, 0xE2, 0x34), // Light Green
79 QColor(0x72, 0x9F, 0xCF), // Light Blue
80 QColor(0xAD, 0x7F, 0xA8), // Light Plum
81 QColor(0xEF, 0x29, 0x29) // Light Red
82};
83
b9329558 84DecodeTrace::DecodeTrace(pv::SigSession &session,
6e89374a 85 boost::shared_ptr<pv::data::DecoderStack> decoder_stack, int index) :
27e8df22
JH
86 Trace(session, QString::fromUtf8(
87 decoder_stack->stack().front()->decoder()->name)),
613d097c
JH
88 _decoder_stack(decoder_stack),
89 _delete_mapper(this)
55d3603d 90{
6e89374a 91 assert(_decoder_stack);
e0fc5810 92
06bb4e6a 93 _colour = DecodeColours[index % countof(DecodeColours)];
9cef9567 94
6e89374a 95 connect(_decoder_stack.get(), SIGNAL(new_decode_data()),
9cef9567 96 this, SLOT(on_new_decode_data()));
613d097c
JH
97 connect(&_delete_mapper, SIGNAL(mapped(int)),
98 this, SLOT(on_delete_decoder(int)));
55d3603d
JH
99}
100
b9329558 101bool DecodeTrace::enabled() const
55d3603d
JH
102{
103 return true;
104}
105
6e89374a 106const boost::shared_ptr<pv::data::DecoderStack>& DecodeTrace::decoder() const
b6b267bb 107{
6e89374a 108 return _decoder_stack;
b6b267bb
JH
109}
110
b9329558 111void DecodeTrace::set_view(pv::view::View *view)
e0fc5810
JH
112{
113 assert(view);
114 Trace::set_view(view);
115}
116
b9329558 117void DecodeTrace::paint_back(QPainter &p, int left, int right)
fe08b6e8 118{
5dfeb70f 119 Trace::paint_back(p, left, right);
fe08b6e8
JH
120 paint_axis(p, get_y(), left, right);
121}
122
b9329558 123void DecodeTrace::paint_mid(QPainter &p, int left, int right)
55d3603d 124{
06e810f2 125 using pv::data::decode::Annotation;
9472f447 126
9472f447
JH
127 const double scale = _view->scale();
128 assert(scale > 0);
129
9d28da5a 130 double samplerate = _decoder_stack->samplerate();
9472f447
JH
131
132 // Show sample rate as 1Hz when it is unknown
133 if (samplerate == 0.0)
134 samplerate = 1.0;
135
136 const double pixels_offset = (_view->offset() -
6e89374a 137 _decoder_stack->get_start_time()) / scale;
9472f447
JH
138 const double samples_per_pixel = samplerate * scale;
139
d7c0ca4a
JH
140 QFontMetrics m(QApplication::font());
141 const int h = (m.boundingRect(QRect(), 0, "Tg").height() * 5) / 4;
5dfeb70f
JH
142
143 assert(_decoder_stack);
144 const QString err = _decoder_stack->error_message();
145 if (!err.isEmpty())
146 {
147 draw_error(p, err, left, right);
148 draw_unresolved_period(p, h, left, right, samples_per_pixel,
149 pixels_offset);
150 return;
151 }
152
153 assert(_view);
154 const int y = get_y();
155
6e89374a 156 assert(_decoder_stack);
db62bbfd 157 vector<Annotation> annotations(_decoder_stack->annotations());
7e674e43
UH
158
159 BOOST_FOREACH(const Annotation &a, annotations) {
160 // Every annotation row is 20 pixels further down.
161 int y_ann_row_offset = a.row() * 20;
162
06e810f2 163 draw_annotation(a, p, get_text_colour(), h, left, right,
7e674e43
UH
164 samples_per_pixel, pixels_offset,
165 y + y_ann_row_offset);
166 }
5dfeb70f
JH
167
168 draw_unresolved_period(p, h, left, right,
169 samples_per_pixel, pixels_offset);
55d3603d
JH
170}
171
b9329558 172void DecodeTrace::populate_popup_form(QWidget *parent, QFormLayout *form)
4e5a4405 173{
613d097c
JH
174 using pv::data::decode::Decoder;
175
4e5a4405
JH
176 assert(form);
177 assert(parent);
6e89374a 178 assert(_decoder_stack);
4e5a4405 179
7491a29f 180 // Add the standard options
4e5a4405
JH
181 Trace::populate_popup_form(parent, form);
182
7491a29f
JH
183 // Add the decoder options
184 _bindings.clear();
185 _probe_selectors.clear();
4e5a4405 186
613d097c 187 const list< shared_ptr<Decoder> >& stack = _decoder_stack->stack();
4e5a4405 188
5069084a
JH
189 if (stack.empty())
190 {
191 QLabel *const l = new QLabel(
192 tr("<p><i>No decoders in the stack</i></p>"));
193 l->setAlignment(Qt::AlignCenter);
194 form->addRow(l);
195 }
196 else
197 {
198 list< shared_ptr<Decoder> >::const_iterator iter =
199 stack.begin();
200 for (int i = 0; i < (int)stack.size(); i++, iter++) {
201 shared_ptr<Decoder> dec(*iter);
202 create_decoder_form(i, dec, parent, form);
203 }
204
205 form->addRow(new QLabel(
206 tr("<i>* Required Probes</i>"), parent));
207 }
4e5a4405 208
ce94e4fd 209 // Add stacking button
ce94e4fd
JH
210 pv::widgets::DecoderMenu *const decoder_menu =
211 new pv::widgets::DecoderMenu(parent);
7491a29f
JH
212 connect(decoder_menu, SIGNAL(decoder_selected(srd_decoder*)),
213 this, SLOT(on_stack_decoder(srd_decoder*)));
214
215 QPushButton *const stack_button =
216 new QPushButton(tr("Stack Decoder"), parent);
ce94e4fd
JH
217 stack_button->setMenu(decoder_menu);
218
219 QHBoxLayout *stack_button_box = new QHBoxLayout;
220 stack_button_box->addWidget(stack_button, 0, Qt::AlignRight);
221 form->addRow(stack_button_box);
4e5a4405
JH
222}
223
b9329558 224QMenu* DecodeTrace::create_context_menu(QWidget *parent)
c51482b3
JH
225{
226 QMenu *const menu = Trace::create_context_menu(parent);
227
228 menu->addSeparator();
229
230 QAction *const del = new QAction(tr("Delete"), this);
a2d21018 231 del->setShortcuts(QKeySequence::Delete);
c51482b3
JH
232 connect(del, SIGNAL(triggered()), this, SLOT(on_delete()));
233 menu->addAction(del);
234
235 return menu;
236}
237
06e810f2
JH
238void DecodeTrace::draw_annotation(const pv::data::decode::Annotation &a, QPainter &p,
239 QColor text_color, int h, int left, int right, double samples_per_pixel,
240 double pixels_offset, int y) const
241{
242 const double start = a.start_sample() / samples_per_pixel -
243 pixels_offset;
244 const double end = a.end_sample() / samples_per_pixel -
245 pixels_offset;
246 const QColor fill = Colours[(a.format() * (countof(Colours) / 2 + 1)) %
247 countof(Colours)];
248 const QColor outline(fill.darker());
249
250 if (start > right + DrawPadding || end < left - DrawPadding)
251 return;
252
253 if (a.start_sample() == a.end_sample())
254 draw_instant(a, p, fill, outline, text_color, h,
255 start, y);
256 else
257 draw_range(a, p, fill, outline, text_color, h,
258 start, end, y);
259}
260
261void DecodeTrace::draw_instant(const pv::data::decode::Annotation &a, QPainter &p,
262 QColor fill, QColor outline, QColor text_color, int h, double x, int y) const
263{
264 const QString text = a.annotations().empty() ?
265 QString() : a.annotations().back();
266 const double w = min(p.boundingRect(QRectF(), 0, text).width(),
267 0.0) + h;
268 const QRectF rect(x - w / 2, y - h / 2, w, h);
269
270 p.setPen(outline);
271 p.setBrush(fill);
272 p.drawRoundedRect(rect, h / 2, h / 2);
273
274 p.setPen(text_color);
275 p.drawText(rect, Qt::AlignCenter | Qt::AlignVCenter, text);
276}
277
278void DecodeTrace::draw_range(const pv::data::decode::Annotation &a, QPainter &p,
279 QColor fill, QColor outline, QColor text_color, int h, double start,
280 double end, int y) const
281{
282 const double top = y + .5 - h / 2;
283 const double bottom = y + .5 + h / 2;
284 const vector<QString> annotations = a.annotations();
285
286 p.setPen(outline);
287 p.setBrush(fill);
288
289 // If the two ends are within 1 pixel, draw a vertical line
290 if (start + 1.0 > end)
291 {
292 p.drawLine(QPointF(start, top), QPointF(start, bottom));
293 return;
294 }
295
296 const double cap_width = min((end - start) / 4, EndCapWidth);
297
298 QPointF pts[] = {
299 QPointF(start, y + .5f),
300 QPointF(start + cap_width, top),
301 QPointF(end - cap_width, top),
302 QPointF(end, y + .5f),
303 QPointF(end - cap_width, bottom),
304 QPointF(start + cap_width, bottom)
305 };
306
307 p.drawConvexPolygon(pts, countof(pts));
308
309 if (annotations.empty())
310 return;
311
312 QRectF rect(start + cap_width, y - h / 2,
313 end - start - cap_width * 2, h);
314 p.setPen(text_color);
315
316 // Try to find an annotation that will fit
317 QString best_annotation;
318 int best_width = 0;
319
320 BOOST_FOREACH(const QString &a, annotations) {
321 const int w = p.boundingRect(QRectF(), 0, a).width();
322 if (w <= rect.width() && w > best_width)
323 best_annotation = a, best_width = w;
324 }
325
326 if (best_annotation.isEmpty())
327 best_annotation = annotations.back();
328
329 // If not ellide the last in the list
330 p.drawText(rect, Qt::AlignCenter, p.fontMetrics().elidedText(
331 best_annotation, Qt::ElideRight, rect.width()));
332}
333
b9329558 334void DecodeTrace::draw_error(QPainter &p, const QString &message,
ad50ac1a
JH
335 int left, int right)
336{
337 const int y = get_y();
338
339 p.setPen(ErrorBgColour.darker());
340 p.setBrush(ErrorBgColour);
341
342 const QRectF bounding_rect =
343 QRectF(left, INT_MIN / 2 + y, right - left, INT_MAX);
344 const QRectF text_rect = p.boundingRect(bounding_rect,
345 Qt::AlignCenter, message);
346 const float r = text_rect.height() / 4;
347
348 p.drawRoundedRect(text_rect.adjusted(-r, -r, r, r), r, r,
349 Qt::AbsoluteSize);
350
351 p.setPen(get_text_colour());
352 p.drawText(text_rect, message);
353}
354
5dfeb70f
JH
355void DecodeTrace::draw_unresolved_period(QPainter &p, int h, int left,
356 int right, double samples_per_pixel, double pixels_offset)
357{
358 using namespace pv::data;
359 using pv::data::decode::Decoder;
360
361 assert(_decoder_stack);
362
363 shared_ptr<Logic> data;
364 shared_ptr<LogicSignal> logic_signal;
365
366 const list< shared_ptr<Decoder> > &stack = _decoder_stack->stack();
367
368 // We get the logic data of the first probe in the list.
369 // This works because we are currently assuming all
370 // LogicSignals have the same data/snapshot
371 BOOST_FOREACH (const shared_ptr<Decoder> &dec, stack)
372 if (dec && !dec->probes().empty() &&
373 ((logic_signal = (*dec->probes().begin()).second)) &&
7aa09b00 374 ((data = logic_signal->logic_data())))
5dfeb70f
JH
375 break;
376
377 if (!data || data->get_snapshots().empty())
378 return;
379
380 const shared_ptr<LogicSnapshot> snapshot =
381 data->get_snapshots().front();
382 assert(snapshot);
383 const int64_t sample_count = (int64_t)snapshot->get_sample_count();
384 if (sample_count == 0)
385 return;
386
387 const int64_t samples_decoded = _decoder_stack->samples_decoded();
388 if (sample_count == samples_decoded)
389 return;
390
391 const int y = get_y();
392 const double start = max(samples_decoded /
393 samples_per_pixel - pixels_offset, left - 1.0);
394 const double end = min(sample_count / samples_per_pixel -
395 pixels_offset, right + 1.0);
396 const QRectF no_decode_rect(start, y - h/2 + 0.5, end - start, h);
397
398 p.setPen(QPen(Qt::NoPen));
399 p.setBrush(Qt::white);
400 p.drawRect(no_decode_rect);
401
402 p.setPen(NoDecodeColour);
403 p.setBrush(QBrush(NoDecodeColour, Qt::Dense6Pattern));
404 p.drawRect(no_decode_rect);
405}
406
613d097c
JH
407void DecodeTrace::create_decoder_form(int index,
408 shared_ptr<data::decode::Decoder> &dec, QWidget *parent,
409 QFormLayout *form)
7491a29f
JH
410{
411 const GSList *probe;
412
413 assert(dec);
414 const srd_decoder *const decoder = dec->decoder();
415 assert(decoder);
416
204bae45 417 pv::widgets::DecoderGroupBox *const group =
27e8df22
JH
418 new pv::widgets::DecoderGroupBox(
419 QString::fromUtf8(decoder->name));
613d097c
JH
420
421 _delete_mapper.setMapping(group, index);
422 connect(group, SIGNAL(delete_decoder()), &_delete_mapper, SLOT(map()));
423
204bae45
JH
424 QFormLayout *const decoder_form = new QFormLayout;
425 group->add_layout(decoder_form);
7491a29f
JH
426
427 // Add the mandatory probes
428 for(probe = decoder->probes; probe; probe = probe->next) {
429 const struct srd_probe *const p =
430 (struct srd_probe *)probe->data;
431 QComboBox *const combo = create_probe_selector(parent, dec, p);
432 connect(combo, SIGNAL(currentIndexChanged(int)),
433 this, SLOT(on_probe_selected(int)));
204bae45 434 decoder_form->addRow(tr("<b>%1</b> (%2) *")
7491a29f
JH
435 .arg(p->name).arg(p->desc), combo);
436
437 const ProbeSelector s = {combo, dec, p};
438 _probe_selectors.push_back(s);
439 }
440
441 // Add the optional probes
442 for(probe = decoder->opt_probes; probe; probe = probe->next) {
443 const struct srd_probe *const p =
444 (struct srd_probe *)probe->data;
445 QComboBox *const combo = create_probe_selector(parent, dec, p);
446 connect(combo, SIGNAL(currentIndexChanged(int)),
447 this, SLOT(on_probe_selected(int)));
204bae45 448 decoder_form->addRow(tr("<b>%1</b> (%2)")
7491a29f
JH
449 .arg(p->name).arg(p->desc), combo);
450
451 const ProbeSelector s = {combo, dec, p};
452 _probe_selectors.push_back(s);
453 }
454
455 // Add the options
456 shared_ptr<prop::binding::DecoderOptions> binding(
457 new prop::binding::DecoderOptions(_decoder_stack, dec));
204bae45 458 binding->add_properties_to_form(decoder_form, true);
7491a29f
JH
459
460 _bindings.push_back(binding);
204bae45
JH
461
462 form->addRow(group);
7491a29f
JH
463}
464
b9329558 465QComboBox* DecodeTrace::create_probe_selector(
7491a29f
JH
466 QWidget *parent, const shared_ptr<data::decode::Decoder> &dec,
467 const srd_probe *const probe)
4e5a4405 468{
7491a29f
JH
469 assert(dec);
470
4e5a4405
JH
471 const vector< shared_ptr<Signal> > sigs = _session.get_signals();
472
6e89374a 473 assert(_decoder_stack);
4e5a4405
JH
474 const map<const srd_probe*,
475 shared_ptr<LogicSignal> >::const_iterator probe_iter =
7491a29f 476 dec->probes().find(probe);
4e5a4405
JH
477
478 QComboBox *selector = new QComboBox(parent);
479
480 selector->addItem("-", qVariantFromValue((void*)NULL));
481
7491a29f 482 if (probe_iter == dec->probes().end())
4e5a4405
JH
483 selector->setCurrentIndex(0);
484
485 for(size_t i = 0; i < sigs.size(); i++) {
486 const shared_ptr<view::Signal> s(sigs[i]);
487 assert(s);
488
489 if (dynamic_pointer_cast<LogicSignal>(s) && s->enabled())
490 {
491 selector->addItem(s->get_name(),
492 qVariantFromValue((void*)s.get()));
493 if ((*probe_iter).second == s)
494 selector->setCurrentIndex(i + 1);
495 }
496 }
497
498 return selector;
499}
500
7491a29f 501void DecodeTrace::commit_decoder_probes(shared_ptr<data::decode::Decoder> &dec)
4e5a4405 502{
7491a29f 503 assert(dec);
4e5a4405
JH
504
505 map<const srd_probe*, shared_ptr<LogicSignal> > probe_map;
506 const vector< shared_ptr<Signal> > sigs = _session.get_signals();
507
7491a29f 508 BOOST_FOREACH(const ProbeSelector &s, _probe_selectors)
4e5a4405 509 {
7491a29f
JH
510 if(s._decoder != dec)
511 break;
512
4e5a4405 513 const LogicSignal *const selection =
7491a29f
JH
514 (LogicSignal*)s._combo->itemData(
515 s._combo->currentIndex()).value<void*>();
4e5a4405 516
7491a29f
JH
517 BOOST_FOREACH(shared_ptr<Signal> sig, sigs)
518 if(sig.get() == selection) {
519 probe_map[s._probe] =
520 dynamic_pointer_cast<LogicSignal>(sig);
4e5a4405
JH
521 break;
522 }
523 }
524
7491a29f
JH
525 dec->set_probes(probe_map);
526}
527
528void DecodeTrace::commit_probes()
529{
530 assert(_decoder_stack);
531 BOOST_FOREACH(shared_ptr<data::decode::Decoder> dec,
532 _decoder_stack->stack())
533 commit_decoder_probes(dec);
534
535 _decoder_stack->begin_decode();
4e5a4405
JH
536}
537
b9329558 538void DecodeTrace::on_new_decode_data()
9cef9567
JH
539{
540 if (_view)
541 _view->update_viewport();
542}
543
b9329558 544void DecodeTrace::delete_pressed()
5ed1adf5
JH
545{
546 on_delete();
547}
548
b9329558 549void DecodeTrace::on_delete()
c51482b3
JH
550{
551 _session.remove_decode_signal(this);
552}
553
b9329558 554void DecodeTrace::on_probe_selected(int)
4e5a4405
JH
555{
556 commit_probes();
557}
558
7491a29f
JH
559void DecodeTrace::on_stack_decoder(srd_decoder *decoder)
560{
561 assert(decoder);
562 assert(_decoder_stack);
563 _decoder_stack->push(shared_ptr<data::decode::Decoder>(
564 new data::decode::Decoder(decoder)));
565 _decoder_stack->begin_decode();
37fd11b1
JH
566
567 create_popup_form();
7491a29f
JH
568}
569
613d097c
JH
570void DecodeTrace::on_delete_decoder(int index)
571{
572 _decoder_stack->remove(index);
573
574 // Update the popup
575 create_popup_form();
576
577 _decoder_stack->begin_decode();
578}
579
55d3603d
JH
580} // namespace view
581} // namespace pv