[pulseview.git] / pv / subwindows / decoder_selector / subwindow.cpp

/*
 * This file is part of the PulseView project.
 *
 * Copyright (C) 2018 Soeren Apel <soeren@apelpie.net>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, see <http://www.gnu.org/licenses/>.
 */

#include <algorithm>

#include <QApplication>
#include <QDebug>
#include <QFontMetrics>
#include <QInputDialog>
#include <QLabel>
#include <QLineEdit>
#include <QPushButton>
#include <QScrollArea>
#include <QVBoxLayout>

#include "pv/session.hpp"
#include "pv/subwindows/decoder_selector/subwindow.hpp"

using std::reverse;
using std::shared_ptr;

namespace pv {
namespace subwindows {
namespace decoder_selector {

const QString initial_notice = QApplication::tr("Select a decoder to see its description here.");
const int min_width_margin = 75;


bool QCustomSortFilterProxyModel::filterAcceptsRow(int source_row,
	const QModelIndex& source_parent) const
{
	// Search model recursively

	if (QSortFilterProxyModel::filterAcceptsRow(source_row, source_parent))
		return true;

	const QModelIndex index = sourceModel()->index(source_row, 0, source_parent);

	for (int i = 0; i < sourceModel()->rowCount(index); i++)
		if (filterAcceptsRow(i, index))
			return true;

	return false;
}


void QCustomTreeView::currentChanged(const QModelIndex& current,
	const QModelIndex& previous)
{
	QTreeView::currentChanged(current, previous);
	currentChanged(current);
}


SubWindow::SubWindow(Session& session, QWidget* parent) :
	SubWindowBase(session, parent),
	splitter_(new QSplitter()),
	tree_view_(new QCustomTreeView()),
	info_box_(new QWidget()),
	info_label_header_(new QLabel()),
	info_label_body_(new QLabel()),
	info_label_footer_(new QLabel()),
	model_(new DecoderCollectionModel()),
	sort_filter_model_(new QCustomSortFilterProxyModel())
{
	QVBoxLayout* root_layout = new QVBoxLayout(this);
	root_layout->setContentsMargins(0, 0, 0, 0);
	root_layout->addWidget(splitter_);

	QWidget* upper_container = new QWidget();
	QVBoxLayout* upper_layout = new QVBoxLayout(upper_container);
	upper_layout->setContentsMargins(0, 5, 0, 0);
	QLineEdit* filter = new QLineEdit();
	upper_layout->addWidget(filter);
	upper_layout->addWidget(tree_view_);

	splitter_->setOrientation(Qt::Vertical);
	splitter_->addWidget(upper_container);
	splitter_->addWidget(info_box_);

	const QIcon filter_icon(QIcon::fromTheme("search",
		QIcon(":/icons/search.svg")));
	filter->setClearButtonEnabled(true);
	filter->addAction(filter_icon, QLineEdit::LeadingPosition);

	sort_filter_model_->setSourceModel(model_);
	sort_filter_model_->setFilterCaseSensitivity(Qt::CaseInsensitive);

	tree_view_->setModel(sort_filter_model_);
	tree_view_->setRootIsDecorated(true);
	tree_view_->setSortingEnabled(true);
	tree_view_->sortByColumn(0, Qt::AscendingOrder);

	// Hide the columns that hold the detailed item information
	tree_view_->hideColumn(2);  // ID

	// Ensure that all decoder tag names are fully visible by default
	tree_view_->resizeColumnToContents(0);

	tree_view_->setIndentation(10);

	QScrollArea* info_label_body_container = new QScrollArea();
	info_label_body_container->setWidget(info_label_body_);
	info_label_body_container->setWidgetResizable(true);

	info_box_->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
	QVBoxLayout* info_box_layout = new QVBoxLayout(info_box_);
	info_box_layout->addWidget(info_label_header_);
	info_box_layout->addWidget(info_label_body_container);
	info_box_layout->addWidget(info_label_footer_);
	info_box_layout->setAlignment(Qt::AlignTop);
	Qt::TextInteractionFlags flags = Qt::TextSelectableByMouse | Qt::TextSelectableByKeyboard;
	info_label_header_->setWordWrap(true);
	info_label_header_->setTextInteractionFlags(flags);
	info_label_body_->setWordWrap(true);
	info_label_body_->setTextInteractionFlags(flags);
	info_label_body_->setText(initial_notice);
	info_label_footer_->setWordWrap(true);
	info_label_footer_->setTextInteractionFlags(flags);

	connect(filter, SIGNAL(textChanged(const QString&)),
		this, SLOT(on_filter_changed(const QString&)));

	connect(tree_view_, SIGNAL(currentChanged(const QModelIndex&)),
		this, SLOT(on_item_changed(const QModelIndex&)));
	connect(tree_view_, SIGNAL(activated(const QModelIndex&)),
		this, SLOT(on_item_activated(const QModelIndex&)));

	connect(this, SIGNAL(new_decoders_selected(vector<const srd_decoder*>)),
		&session, SLOT(on_new_decoders_selected(vector<const srd_decoder*>)));
}

bool SubWindow::has_toolbar() const
{
	return true;
}

QToolBar* SubWindow::create_toolbar(QWidget *parent) const
{
	QToolBar* toolbar = new QToolBar(parent);

	return toolbar;
}

int SubWindow::minimum_width() const
{
	QFontMetrics m(info_label_body_->font());
	const int label_width = m.width(initial_notice);

	return label_width + min_width_margin;
}

vector<const char*> SubWindow::get_decoder_inputs(const srd_decoder* d) const
{
	vector<const char*> ret_val;

	for (GSList* li = d->inputs; li; li = li->next)
		ret_val.push_back((const char*)li->data);

	return ret_val;
}

vector<const srd_decoder*> SubWindow::get_decoders_providing(const char* output) const
{
	vector<const srd_decoder*> ret_val;

	for (GSList* li = (GSList*)srd_decoder_list(); li; li = li->next) {
		const srd_decoder* d = (srd_decoder*)li->data;
		assert(d);

		if (!d->outputs)
			continue;

		// TODO For now we ignore that d->outputs is actually a list
		if (strncmp((char*)(d->outputs->data), output, strlen(output)) == 0)
			ret_val.push_back(d);
	}

	return ret_val;
}

void SubWindow::on_item_changed(const QModelIndex& index)
{
	if (!index.isValid())
		return;

	QModelIndex id_index = index.model()->index(index.row(), 2, index.parent());
	QString decoder_name = index.model()->data(id_index, Qt::DisplayRole).toString();

	if (decoder_name.isEmpty())
		return;

	const srd_decoder* d = srd_decoder_get_by_id(decoder_name.toUtf8());

	const QString id = QString::fromUtf8(d->id);
	const QString longname = QString::fromUtf8(d->longname);
	const QString desc = QString::fromUtf8(d->desc);
	const QString doc = QString::fromUtf8(srd_decoder_doc_get(d)).trimmed();

	QString tags;
	for (GSList* li = (GSList*)d->tags; li; li = li->next) {
		QString s = (li == (GSList*)d->tags) ?
			tr((char*)li->data) :
			QString(tr(", %1")).arg(tr((char*)li->data));
		tags.append(s);
	}

	info_label_header_->setText(QString("<span style='font-size:large'><b>%1 (%2)</b></span><br><i>%3</i>")
		.arg(longname, id, desc));
	info_label_body_->setText(doc);
	info_label_footer_->setText(tr("<p align='right'>Tags: %1</p>").arg(tags));
}

void SubWindow::on_item_activated(const QModelIndex& index)
{
	if (!index.isValid())
		return;

	QModelIndex id_index = index.model()->index(index.row(), 2, index.parent());
	QString decoder_name = index.model()->data(id_index, Qt::DisplayRole).toString();

	const srd_decoder* chosen_decoder = srd_decoder_get_by_id(decoder_name.toUtf8());
	if (chosen_decoder == nullptr)
		return;

	vector<const srd_decoder*> decoders;
	decoders.push_back(chosen_decoder);

	// If the decoder only depends on logic inputs, we add it and are done
	vector<const char*> inputs = get_decoder_inputs(decoders.front());
	if (inputs.size() == 0) {
		qWarning() << "Protocol decoder" << decoder_name << "cannot have 0 inputs!";
		return;
	}

	if (strncmp(inputs.at(0), "logic", 5) == 0) {
		new_decoders_selected(decoders);
		return;
	}

	// Check if we can automatically fulfill the stacking requirements
	while (strncmp(inputs.at(0), "logic", 5) != 0) {
		vector<const srd_decoder*> prov_decoders = get_decoders_providing(inputs.at(0));

		if (prov_decoders.size() == 0) {
			// Emit warning and add the stack that we could gather so far
			qWarning() << "Protocol decoder" << QString::fromUtf8(decoders.back()->id) \
				<< "has input that no other decoder provides:" << QString::fromUtf8(inputs.at(0));
			break;
		}

		if (prov_decoders.size() == 1) {
			decoders.push_back(prov_decoders.front());
		} else {
			// Let user decide which one to use
			QString caption = QString(tr("Protocol decoder <b>%1</b> requires input type <b>%2</b> " \
				"which several decoders provide.<br>Choose which one to use:<br>"))
					.arg(QString::fromUtf8(decoders.back()->id), QString::fromUtf8(inputs.at(0)));

			QStringList items;
			for (const srd_decoder* d : prov_decoders)
				items << QString::fromUtf8(d->id) + " (" + QString::fromUtf8(d->longname) + ")";
			bool ok_clicked;
			QString item = QInputDialog::getItem(this, tr("Choose Decoder"),
				tr(caption.toUtf8()), items, 0, false, &ok_clicked);

			if ((!ok_clicked) || (item.isEmpty()))
				return;

			QString d = item.section(' ', 0, 0);
			decoders.push_back(srd_decoder_get_by_id(d.toUtf8()));
		}

		inputs = get_decoder_inputs(decoders.back());
	}

	// Reverse decoder list and add the stack
	reverse(decoders.begin(), decoders.end());
	new_decoders_selected(decoders);
}

void SubWindow::on_filter_changed(const QString& text)
{
	sort_filter_model_->setFilterFixedString(text);
}

} // namespace decoder_selector
} // namespace subwindows
} // namespace pv
Commit	Line	Data
97378470 SA	1	/*
	2	* This file is part of the PulseView project.
	3	*
	4	* Copyright (C) 2018 Soeren Apel <soeren@apelpie.net>
	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
c52493c9	22	#include <QApplication>
97378470	23	#include <QDebug>
c52493c9	24	#include <QFontMetrics>
97378470 SA	25	#include <QInputDialog>
97378470 SA	26	#include <QLabel>
b229a1b7	27	#include <QLineEdit>
97378470	28	#include <QPushButton>
9c4ba1c1	29	#include <QScrollArea>
97378470 SA	30	#include <QVBoxLayout>
	31
	32	#include "pv/session.hpp"
	33	#include "pv/subwindows/decoder_selector/subwindow.hpp"
	34
	35	using std::reverse;
	36	using std::shared_ptr;
	37
	38	namespace pv {
	39	namespace subwindows {
	40	namespace decoder_selector {
	41
c52493c9 SA	42	const QString initial_notice = QApplication::tr("Select a decoder to see its description here.");
	43	const int min_width_margin = 75;
	44
97378470	45
b229a1b7 SA	46	bool QCustomSortFilterProxyModel::filterAcceptsRow(int source_row,
	47	const QModelIndex& source_parent) const
	48	{
	49	// Search model recursively
	50
	51	if (QSortFilterProxyModel::filterAcceptsRow(source_row, source_parent))
	52	return true;
	53
	54	const QModelIndex index = sourceModel()->index(source_row, 0, source_parent);
	55
	56	for (int i = 0; i < sourceModel()->rowCount(index); i++)
	57	if (filterAcceptsRow(i, index))
	58	return true;
	59
	60	return false;
	61	}
	62
	63
e10848e8 SA	64	void QCustomTreeView::currentChanged(const QModelIndex& current,
	65	const QModelIndex& previous)
	66	{
	67	QTreeView::currentChanged(current, previous);
	68	currentChanged(current);
	69	}
	70
	71
97378470 SA	72	SubWindow::SubWindow(Session& session, QWidget* parent) :
	73	SubWindowBase(session, parent),
	74	splitter_(new QSplitter()),
e10848e8	75	tree_view_(new QCustomTreeView()),
c2b80ad9 SA	76	info_box_(new QWidget()),
	77	info_label_header_(new QLabel()),
	78	info_label_body_(new QLabel()),
	79	info_label_footer_(new QLabel()),
a6fab024	80	model_(new DecoderCollectionModel()),
b229a1b7	81	sort_filter_model_(new QCustomSortFilterProxyModel())
97378470 SA	82	{
	83	QVBoxLayout* root_layout = new QVBoxLayout(this);
	84	root_layout->setContentsMargins(0, 0, 0, 0);
	85	root_layout->addWidget(splitter_);
	86
b229a1b7 SA	87	QWidget* upper_container = new QWidget();
	88	QVBoxLayout* upper_layout = new QVBoxLayout(upper_container);
	89	upper_layout->setContentsMargins(0, 5, 0, 0);
	90	QLineEdit* filter = new QLineEdit();
	91	upper_layout->addWidget(filter);
	92	upper_layout->addWidget(tree_view_);
	93
c2b80ad9	94	splitter_->setOrientation(Qt::Vertical);
b229a1b7	95	splitter_->addWidget(upper_container);
c2b80ad9	96	splitter_->addWidget(info_box_);
97378470	97
b229a1b7 SA	98	const QIcon filter_icon(QIcon::fromTheme("search",
	99	QIcon(":/icons/search.svg")));
	100	filter->setClearButtonEnabled(true);
	101	filter->addAction(filter_icon, QLineEdit::LeadingPosition);
	102
a6fab024	103	sort_filter_model_->setSourceModel(model_);
b229a1b7	104	sort_filter_model_->setFilterCaseSensitivity(Qt::CaseInsensitive);
a6fab024 SA	105
a6fab024 SA	106	tree_view_->setModel(sort_filter_model_);
97378470	107	tree_view_->setRootIsDecorated(true);
a6fab024 SA	108	tree_view_->setSortingEnabled(true);
a6fab024 SA	109	tree_view_->sortByColumn(0, Qt::AscendingOrder);
97378470 SA	110
	111	// Hide the columns that hold the detailed item information
	112	tree_view_->hideColumn(2); // ID
	113
b54aeaea UH	114	// Ensure that all decoder tag names are fully visible by default
	115	tree_view_->resizeColumnToContents(0);
	116
5da32ad6 UH	117	tree_view_->setIndentation(10);
5da32ad6 UH	118
9c4ba1c1 SA	119	QScrollArea* info_label_body_container = new QScrollArea();
	120	info_label_body_container->setWidget(info_label_body_);
	121	info_label_body_container->setWidgetResizable(true);
	122
c2b80ad9 SA	123	info_box_->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
	124	QVBoxLayout* info_box_layout = new QVBoxLayout(info_box_);
	125	info_box_layout->addWidget(info_label_header_);
9c4ba1c1	126	info_box_layout->addWidget(info_label_body_container);
c2b80ad9	127	info_box_layout->addWidget(info_label_footer_);
a7961b36	128	info_box_layout->setAlignment(Qt::AlignTop);
0a7cdbf7	129	Qt::TextInteractionFlags flags = Qt::TextSelectableByMouse \| Qt::TextSelectableByKeyboard;
a8ea0620	130	info_label_header_->setWordWrap(true);
0a7cdbf7	131	info_label_header_->setTextInteractionFlags(flags);
c2b80ad9	132	info_label_body_->setWordWrap(true);
0a7cdbf7	133	info_label_body_->setTextInteractionFlags(flags);
c52493c9	134	info_label_body_->setText(initial_notice);
a8ea0620	135	info_label_footer_->setWordWrap(true);
0a7cdbf7	136	info_label_footer_->setTextInteractionFlags(flags);
c2b80ad9	137
b229a1b7 SA	138	connect(filter, SIGNAL(textChanged(const QString&)),
	139	this, SLOT(on_filter_changed(const QString&)));
	140
e10848e8 SA	141	connect(tree_view_, SIGNAL(currentChanged(const QModelIndex&)),
	142	this, SLOT(on_item_changed(const QModelIndex&)));
	143	connect(tree_view_, SIGNAL(activated(const QModelIndex&)),
	144	this, SLOT(on_item_activated(const QModelIndex&)));
97378470 SA	145
	146	connect(this, SIGNAL(new_decoders_selected(vector<const srd_decoder*>)),
	147	&session, SLOT(on_new_decoders_selected(vector<const srd_decoder*>)));
	148	}
	149
	150	bool SubWindow::has_toolbar() const
	151	{
	152	return true;
	153	}
	154
	155	QToolBar* SubWindow::create_toolbar(QWidget *parent) const
	156	{
	157	QToolBar* toolbar = new QToolBar(parent);
	158
	159	return toolbar;
	160	}
	161
c52493c9 SA	162	int SubWindow::minimum_width() const
	163	{
	164	QFontMetrics m(info_label_body_->font());
	165	const int label_width = m.width(initial_notice);
	166
	167	return label_width + min_width_margin;
	168	}
	169
8f7c2dce	170	vector<const char> SubWindow::get_decoder_inputs(const srd_decoder d) const
97378470 SA	171	{
	172	vector<const char*> ret_val;
	173
486bcf01 SA	174	for (GSList* li = d->inputs; li; li = li->next)
486bcf01 SA	175	ret_val.push_back((const char*)li->data);
97378470 SA	176
	177	return ret_val;
	178	}
	179
8f7c2dce	180	vector<const srd_decoder> SubWindow::get_decoders_providing(const char output) const
97378470 SA	181	{
	182	vector<const srd_decoder*> ret_val;
	183
486bcf01	184	for (GSList* li = (GSList*)srd_decoder_list(); li; li = li->next) {
97378470 SA	185	const srd_decoder* d = (srd_decoder*)li->data;
	186	assert(d);
	187
	188	if (!d->outputs)
	189	continue;
	190
	191	// TODO For now we ignore that d->outputs is actually a list
	192	if (strncmp((char*)(d->outputs->data), output, strlen(output)) == 0)
	193	ret_val.push_back(d);
	194	}
97378470 SA	195
	196	return ret_val;
	197	}
	198
e10848e8	199	void SubWindow::on_item_changed(const QModelIndex& index)
c2b80ad9 SA	200	{
	201	if (!index.isValid())
	202	return;
	203
	204	QModelIndex id_index = index.model()->index(index.row(), 2, index.parent());
	205	QString decoder_name = index.model()->data(id_index, Qt::DisplayRole).toString();
	206
	207	if (decoder_name.isEmpty())
	208	return;
	209
644462a7	210	const srd_decoder* d = srd_decoder_get_by_id(decoder_name.toUtf8());
c2b80ad9 SA	211
	212	const QString id = QString::fromUtf8(d->id);
	213	const QString longname = QString::fromUtf8(d->longname);
	214	const QString desc = QString::fromUtf8(d->desc);
9c4ba1c1	215	const QString doc = QString::fromUtf8(srd_decoder_doc_get(d)).trimmed();
c2b80ad9 SA	216
c2b80ad9 SA	217	QString tags;
486bcf01 SA	218	for (GSList* li = (GSList*)d->tags; li; li = li->next) {
486bcf01 SA	219	QString s = (li == (GSList*)d->tags) ?
c2b80ad9 SA	220	tr((char*)li->data) :
	221	QString(tr(", %1")).arg(tr((char*)li->data));
	222	tags.append(s);
	223	}
c2b80ad9	224
a51c7f7d	225	info_label_header_->setText(QString("<span style='font-size:large'><b>%1 (%2)</b></span><br><i>%3</i>")
c2b80ad9 SA	226	.arg(longname, id, desc));
	227	info_label_body_->setText(doc);
	228	info_label_footer_->setText(tr("<p align='right'>Tags: %1</p>").arg(tags));
	229	}
	230
e10848e8	231	void SubWindow::on_item_activated(const QModelIndex& index)
97378470 SA	232	{
	233	if (!index.isValid())
	234	return;
	235
	236	QModelIndex id_index = index.model()->index(index.row(), 2, index.parent());
	237	QString decoder_name = index.model()->data(id_index, Qt::DisplayRole).toString();
	238
644462a7	239	const srd_decoder* chosen_decoder = srd_decoder_get_by_id(decoder_name.toUtf8());
97378470 SA	240	if (chosen_decoder == nullptr)
	241	return;
	242
	243	vector<const srd_decoder*> decoders;
	244	decoders.push_back(chosen_decoder);
	245
	246	// If the decoder only depends on logic inputs, we add it and are done
8f7c2dce	247	vector<const char*> inputs = get_decoder_inputs(decoders.front());
97378470 SA	248	if (inputs.size() == 0) {
	249	qWarning() << "Protocol decoder" << decoder_name << "cannot have 0 inputs!";
	250	return;
	251	}
	252
	253	if (strncmp(inputs.at(0), "logic", 5) == 0) {
	254	new_decoders_selected(decoders);
	255	return;
	256	}
	257
	258	// Check if we can automatically fulfill the stacking requirements
	259	while (strncmp(inputs.at(0), "logic", 5) != 0) {
8f7c2dce	260	vector<const srd_decoder*> prov_decoders = get_decoders_providing(inputs.at(0));
97378470 SA	261
	262	if (prov_decoders.size() == 0) {
	263	// Emit warning and add the stack that we could gather so far
	264	qWarning() << "Protocol decoder" << QString::fromUtf8(decoders.back()->id) \
	265	<< "has input that no other decoder provides:" << QString::fromUtf8(inputs.at(0));
	266	break;
	267	}
	268
	269	if (prov_decoders.size() == 1) {
	270	decoders.push_back(prov_decoders.front());
	271	} else {
	272	// Let user decide which one to use
	273	QString caption = QString(tr("Protocol decoder <b>%1</b> requires input type <b>%2</b> " \
	274	"which several decoders provide.<br>Choose which one to use:<br>"))
	275	.arg(QString::fromUtf8(decoders.back()->id), QString::fromUtf8(inputs.at(0)));
	276
	277	QStringList items;
	278	for (const srd_decoder* d : prov_decoders)
	279	items << QString::fromUtf8(d->id) + " (" + QString::fromUtf8(d->longname) + ")";
	280	bool ok_clicked;
	281	QString item = QInputDialog::getItem(this, tr("Choose Decoder"),
	282	tr(caption.toUtf8()), items, 0, false, &ok_clicked);
	283
	284	if ((!ok_clicked) \|\| (item.isEmpty()))
	285	return;
	286
	287	QString d = item.section(' ', 0, 0);
644462a7	288	decoders.push_back(srd_decoder_get_by_id(d.toUtf8()));
97378470 SA	289	}
97378470 SA	290
8f7c2dce	291	inputs = get_decoder_inputs(decoders.back());
97378470 SA	292	}
	293
	294	// Reverse decoder list and add the stack
	295	reverse(decoders.begin(), decoders.end());
	296	new_decoders_selected(decoders);
	297	}
	298
b229a1b7 SA	299	void SubWindow::on_filter_changed(const QString& text)
	300	{
	301	sort_filter_model_->setFilterFixedString(text);
	302	}
	303
97378470 SA	304	} // namespace decoder_selector
	305	} // namespace subwindows
	306	} // namespace pv