[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_body_->setAlignment(Qt::AlignTop);
	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);
e0cfcb0e	135	info_label_body_->setAlignment(Qt::AlignTop);
a8ea0620	136	info_label_footer_->setWordWrap(true);
0a7cdbf7	137	info_label_footer_->setTextInteractionFlags(flags);
c2b80ad9	138
b229a1b7 SA	139	connect(filter, SIGNAL(textChanged(const QString&)),
	140	this, SLOT(on_filter_changed(const QString&)));
	141
e10848e8 SA	142	connect(tree_view_, SIGNAL(currentChanged(const QModelIndex&)),
	143	this, SLOT(on_item_changed(const QModelIndex&)));
	144	connect(tree_view_, SIGNAL(activated(const QModelIndex&)),
	145	this, SLOT(on_item_activated(const QModelIndex&)));
97378470 SA	146
	147	connect(this, SIGNAL(new_decoders_selected(vector<const srd_decoder*>)),
	148	&session, SLOT(on_new_decoders_selected(vector<const srd_decoder*>)));
	149	}
	150
	151	bool SubWindow::has_toolbar() const
	152	{
	153	return true;
	154	}
	155
	156	QToolBar* SubWindow::create_toolbar(QWidget *parent) const
	157	{
	158	QToolBar* toolbar = new QToolBar(parent);
	159
	160	return toolbar;
	161	}
	162
c52493c9 SA	163	int SubWindow::minimum_width() const
	164	{
	165	QFontMetrics m(info_label_body_->font());
	166	const int label_width = m.width(initial_notice);
	167
	168	return label_width + min_width_margin;
	169	}
	170
8f7c2dce	171	vector<const char> SubWindow::get_decoder_inputs(const srd_decoder d) const
97378470 SA	172	{
	173	vector<const char*> ret_val;
	174
486bcf01 SA	175	for (GSList* li = d->inputs; li; li = li->next)
486bcf01 SA	176	ret_val.push_back((const char*)li->data);
97378470 SA	177
	178	return ret_val;
	179	}
	180
8f7c2dce	181	vector<const srd_decoder> SubWindow::get_decoders_providing(const char output) const
97378470 SA	182	{
	183	vector<const srd_decoder*> ret_val;
	184
486bcf01	185	for (GSList* li = (GSList*)srd_decoder_list(); li; li = li->next) {
97378470 SA	186	const srd_decoder* d = (srd_decoder*)li->data;
	187	assert(d);
	188
	189	if (!d->outputs)
	190	continue;
	191
	192	// TODO For now we ignore that d->outputs is actually a list
	193	if (strncmp((char*)(d->outputs->data), output, strlen(output)) == 0)
	194	ret_val.push_back(d);
	195	}
97378470 SA	196
	197	return ret_val;
	198	}
	199
e10848e8	200	void SubWindow::on_item_changed(const QModelIndex& index)
c2b80ad9 SA	201	{
	202	if (!index.isValid())
	203	return;
	204
	205	QModelIndex id_index = index.model()->index(index.row(), 2, index.parent());
	206	QString decoder_name = index.model()->data(id_index, Qt::DisplayRole).toString();
	207
	208	if (decoder_name.isEmpty())
	209	return;
	210
644462a7	211	const srd_decoder* d = srd_decoder_get_by_id(decoder_name.toUtf8());
c2b80ad9 SA	212
	213	const QString id = QString::fromUtf8(d->id);
	214	const QString longname = QString::fromUtf8(d->longname);
	215	const QString desc = QString::fromUtf8(d->desc);
9c4ba1c1	216	const QString doc = QString::fromUtf8(srd_decoder_doc_get(d)).trimmed();
c2b80ad9 SA	217
c2b80ad9 SA	218	QString tags;
486bcf01 SA	219	for (GSList* li = (GSList*)d->tags; li; li = li->next) {
486bcf01 SA	220	QString s = (li == (GSList*)d->tags) ?
c2b80ad9 SA	221	tr((char*)li->data) :
	222	QString(tr(", %1")).arg(tr((char*)li->data));
	223	tags.append(s);
	224	}
c2b80ad9	225
a51c7f7d	226	info_label_header_->setText(QString("<span style='font-size:large'><b>%1 (%2)</b></span><br><i>%3</i>")
c2b80ad9 SA	227	.arg(longname, id, desc));
	228	info_label_body_->setText(doc);
	229	info_label_footer_->setText(tr("<p align='right'>Tags: %1</p>").arg(tags));
	230	}
	231
e10848e8	232	void SubWindow::on_item_activated(const QModelIndex& index)
97378470 SA	233	{
	234	if (!index.isValid())
	235	return;
	236
	237	QModelIndex id_index = index.model()->index(index.row(), 2, index.parent());
	238	QString decoder_name = index.model()->data(id_index, Qt::DisplayRole).toString();
	239
644462a7	240	const srd_decoder* chosen_decoder = srd_decoder_get_by_id(decoder_name.toUtf8());
97378470 SA	241	if (chosen_decoder == nullptr)
	242	return;
	243
	244	vector<const srd_decoder*> decoders;
	245	decoders.push_back(chosen_decoder);
	246
	247	// If the decoder only depends on logic inputs, we add it and are done
8f7c2dce	248	vector<const char*> inputs = get_decoder_inputs(decoders.front());
97378470 SA	249	if (inputs.size() == 0) {
	250	qWarning() << "Protocol decoder" << decoder_name << "cannot have 0 inputs!";
	251	return;
	252	}
	253
	254	if (strncmp(inputs.at(0), "logic", 5) == 0) {
	255	new_decoders_selected(decoders);
	256	return;
	257	}
	258
	259	// Check if we can automatically fulfill the stacking requirements
	260	while (strncmp(inputs.at(0), "logic", 5) != 0) {
8f7c2dce	261	vector<const srd_decoder*> prov_decoders = get_decoders_providing(inputs.at(0));
97378470 SA	262
	263	if (prov_decoders.size() == 0) {
	264	// Emit warning and add the stack that we could gather so far
	265	qWarning() << "Protocol decoder" << QString::fromUtf8(decoders.back()->id) \
	266	<< "has input that no other decoder provides:" << QString::fromUtf8(inputs.at(0));
	267	break;
	268	}
	269
	270	if (prov_decoders.size() == 1) {
	271	decoders.push_back(prov_decoders.front());
	272	} else {
	273	// Let user decide which one to use
	274	QString caption = QString(tr("Protocol decoder <b>%1</b> requires input type <b>%2</b> " \
	275	"which several decoders provide.<br>Choose which one to use:<br>"))
	276	.arg(QString::fromUtf8(decoders.back()->id), QString::fromUtf8(inputs.at(0)));
	277
	278	QStringList items;
	279	for (const srd_decoder* d : prov_decoders)
	280	items << QString::fromUtf8(d->id) + " (" + QString::fromUtf8(d->longname) + ")";
	281	bool ok_clicked;
	282	QString item = QInputDialog::getItem(this, tr("Choose Decoder"),
	283	tr(caption.toUtf8()), items, 0, false, &ok_clicked);
	284
	285	if ((!ok_clicked) \|\| (item.isEmpty()))
	286	return;
	287
	288	QString d = item.section(' ', 0, 0);
644462a7	289	decoders.push_back(srd_decoder_get_by_id(d.toUtf8()));
97378470 SA	290	}
97378470 SA	291
8f7c2dce	292	inputs = get_decoder_inputs(decoders.back());
97378470 SA	293	}
	294
	295	// Reverse decoder list and add the stack
	296	reverse(decoders.begin(), decoders.end());
	297	new_decoders_selected(decoders);
	298	}
	299
b229a1b7 SA	300	void SubWindow::on_filter_changed(const QString& text)
	301	{
	302	sort_filter_model_->setFilterFixedString(text);
	303	}
	304
97378470 SA	305	} // namespace decoder_selector
	306	} // namespace subwindows
	307	} // namespace pv